Skip to content

Commit 84c1f73

Browse files
authored
Update retirement date format and migration steps
1 parent ebde457 commit 84c1f73

File tree

1 file changed

+70
-15
lines changed

1 file changed

+70
-15
lines changed

articles/container-apps/services.md

Lines changed: 70 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -12,11 +12,11 @@ ms.author: cshoe
1212
# Connect to services in Azure Container Apps (preview)
1313

1414
> [!IMPORTANT]
15-
> The public preview add-ons feature will be retired on 30 September 2025. Please transition to Azure-managed services, such as Azure Cache for Redis or Azure Database for PostgreSQL, if you’re ready to use a production-level service. Alternatively you can try one of our new OSS quickstarts to continue using these services for dev/test purposes.
15+
> The public preview add-ons feature will be retired on September 30th, 2025. To prepare for this change, transition to Azure-managed services, such as Azure Cache for Redis or Azure Database for PostgreSQL for production-level service. For development and testing purposes, review the supported OSS quickstarts.
1616
1717
As you develop applications in Azure Container Apps, you often need to connect to different services. Rather than creating services ahead of time and manually connecting them to your container app, you can quickly create instances of development-grade services that are designed for nonproduction environments known as add-ons.
1818

19-
Add-ons allow you to use OSS services without the burden of manual downloads, creation, and configuration. Since add-ons will be retired on 30 September 2025, we recommend you use our new OSS quickstarts if you want to continue using these OSS services for nonproduction envrionments.
19+
Add-ons allow you to use OSS services without the burden of manual downloads, creation, and configuration. Since add-ons will be retired on September 30th, 2025, we recommend you use our new OSS quickstarts if you want to continue using these OSS services for nonproduction envrionments.
2020

2121
If you're ready for your app to use a production level service, you can connect your application to an Azure managed service.
2222

@@ -30,26 +30,81 @@ Please note, you're responsible for data continuity between your add-on and your
3030

3131
If you're ready for a production level service, follow these steps to transition your add-on to an Azure managed service.
3232

33-
1. **Identify add-ons:** Run `az containerapp add-on list --environment <ENV_NAME> --resource-group <RESOURCE_GROUP>` to locate all existing add-ons in your environment.
34-
1. **Plan data continuity:** Create a backup or snapshot of your data in the current add-on if applicable.
35-
1. **Provision the new managed service:** For example, create an [Azure Cache for Redis](../azure-cache-for-redis/scripts/create-manage-cache?pivots=azure-cache-redis) or [Azure Database for PostgreSQL](https://learn.microsoft.com/azure/postgresql/) instance using the Azure portal or CLI.
36-
1. **Create a new Container App:**: Create a new app using the [Azure Portal](quickstart-portal.md) or [CLI](get-started?tabs=bash).
37-
1. **Configure connection settings:** In your new Container App configuration, set the environment variables and network settings to point to your new managed service’s connection string, credentials, and endpoints.
38-
1. **Decommission the add-on:** Delete the add-on itself with `az containerapp add-on <SERVICE_TYPE> delete --name <ADDON_NAME> --resource-group <RESOURCE-GROUP>` once it’s no longer needed.
33+
1. Identify add-ons in use. Run the following command to locate all existing add-ons in your environment.
34+
35+
Before you run the following command, make sure to replace the placeholders surrounded by `<>` with you values.
36+
37+
```azurecli
38+
az containerapp add-on list \
39+
--environment <ENVIRONMENT_NAME> \
40+
--resource-group <RESOURCE_GROUP>
41+
```
42+
43+
1. Plan data continuity.
44+
45+
Create a backup or snapshot of your data in the current add-on if applicable.
46+
47+
1. Deploy the new managed service.
48+
49+
For example, create an [Azure Cache for Redis](/azure/azure-cache-for-redis/scripts/create-manage-cache?pivots=azure-managed-redis) or [Azure Database for PostgreSQL](/azure/postgresql/) instance using the Azure portal or CLI.
50+
51+
1. Create a new container app.
52+
53+
Create a new app using the [Azure Portal](quickstart-portal.md) or [CLI](get-started?tabs=bash).
54+
55+
1. Configure connection settings.
56+
57+
In your new container app configuration, set the environment variables and network settings to point to your new managed service’s connection string, credentials, and endpoints.
58+
59+
1. Remove the add-on.
60+
61+
Once the add-on is no longer needed, delete it with the following command.
62+
63+
Before you run the following command, make sure to replace the placeholders surrounded by `<>` with you values.
64+
65+
```azurecli
66+
az containerapp add-on <SERVICE_TYPE> delete \
67+
--name <ADDON_NAME> \
68+
--resource-group <RESOURCE-GROUP>
69+
```
3970
4071
### Option 2: Continue with new OSS quickstarts
4172
If you only need these services for development or testing environments and do not require production-level guarantees, follow these steps to switch to our new open-source quickstarts:
4273
43-
1. **Identify add-ons:** Run `az containerapp add-on list --environment <ENV_NAME> --resource-group <RESOURCE_GROUP>` to locate all existing add-ons in your environment.
44-
1. **Review available quickstarts:** We have open-source quickstarts for Redis, PostgreSQL, MariaDB, Qdrant, and Kafka.
45-
1. **Plan data continuity:** Create a backup or snapshot of your data in the current add-on if applicable.
46-
1. **Create a new Container App:** Create a new [Container App](quickstart-portal.md) using one of our new quickstarts.
47-
1. **Decommission the add-on:** Delete the add-on itself with `az containerapp add-on <SERVICE_TYPE> delete --name <ADDON_NAME> --resource-group <RESOURCE-GROUP>` once it’s no longer needed.
74+
1. Identify add-ons in use. Run the following command to locate all existing add-ons in your environment.
75+
76+
Before you run the following command, make sure to replace the placeholders surrounded by `<>` with you values.
77+
78+
```azurecli
79+
az containerapp add-on list \
80+
--environment <ENVIRONMENT_NAME> \
81+
--resource-group <RESOURCE_GROUP>
82+
```
83+
84+
1. Review available quickstarts for Redis, PostgreSQL, MariaDB, Qdrant, and Kafka.
85+
86+
1. Plan data continuity.
87+
88+
Create a backup or snapshot of your data in the current add-on if applicable.
89+
90+
1. Create a new [Container App](quickstart-portal.md).
91+
92+
1. Remove the add-on.
93+
94+
Once the add-on is no longer needed, delete it with the following command.
95+
96+
Before you run the following command, make sure to replace the placeholders surrounded by `<>` with you values.
97+
98+
```azurecli
99+
az containerapp add-on <SERVICE_TYPE> delete \
100+
--name <ADDON_NAME> \
101+
--resource-group <RESOURCE-GROUP>
102+
```
48103
49-
## Add-ons (retiring on 30 September 2025)
104+
## Add-ons (retiring on September 30th, 2025)
50105
51106
> [!IMPORTANT]
52-
> The public preview add-ons feature will be retired on 30 September 2025. Please transition to Azure-managed services, such as Azure Cache for Redis or Azure Database for PostgreSQL, if you’re ready to use a production-level service. Alternatively you can try one of our new OSS quickstarts to continue using these services for dev/test purposes.
107+
> The public preview add-ons feature will be retired on September 30th, 2025. To prepare for this change, transition to Azure-managed services, such as Azure Cache for Redis or Azure Database for PostgreSQL for production-level service. For development and testing purposes, review the supported open-source quickstarts.
53108
54109
Services available as an add-on include:
55110

0 commit comments

Comments
 (0)