You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/container-apps/services.md
+70-15Lines changed: 70 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,11 +12,11 @@ ms.author: cshoe
12
12
# Connect to services in Azure Container Apps (preview)
13
13
14
14
> [!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.
16
16
17
17
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.
18
18
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.
20
20
21
21
If you're ready for your app to use a production level service, you can connect your application to an Azure managed service.
22
22
@@ -30,26 +30,81 @@ Please note, you're responsible for data continuity between your add-on and your
30
30
31
31
If you're ready for a production level service, follow these steps to transition your add-on to an Azure managed service.
32
32
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
+
```
39
70
40
71
### Option 2: Continue with new OSS quickstarts
41
72
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:
42
73
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
+
```
48
103
49
-
## Add-ons (retiring on 30 September 2025)
104
+
## Add-ons (retiring on September 30th, 2025)
50
105
51
106
> [!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.
0 commit comments