Connect a container app to a cloud service with Service Connector

Azure Container Apps allows you to use Service Connector to connect to cloud services in just a few steps. Service Connector manages the configuration of the network settings and connection information between different services. To view all supported services, learn more about Service Connector.

In this article, you learn to connect a container app to Azure Blob Storage.

Important

This feature in Container Apps is currently in preview. See the Supplemental Terms of Use for Microsoft Azure Previews for legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.

Prerequisites

• An Azure account with an active subscription. Create an account for free.
• An application deployed to Container Apps in a region supported by Service Connector. If you don't have one yet, create and deploy a container to Container Apps
• An Azure Blob Storage account

Sign in to Azure

First, sign in to Azure.

Portal

Sign in to the Azure portal at https://portal.azure.com/ with your Azure account.

Azure CLI

az login

This command prompts your web browser to launch and load an Azure sign in page. If the browser fails to open, use device code flow with az login --use-device-code. For more sign in options, go to sign in with the Azure CLI.

Create a new service connection

Use Service Connector to create a new service connection in Container Apps using the Azure portal or the CLI.

Portal

1. Navigate to the Azure portal.

2. Select All resources on the left of the Azure portal.

3. Enter Container Apps in the filter and select the name of the container app you want to use in the list.

4. Select Service Connector from the left table of contents.

5. Select Create.

   

6. Select or enter the following settings.

   Setting	Suggested value	Description
   Container	Your container name	Select your Container Apps.
   Service type	Blob Storage	This is the target service type. If you don't have a Storage Blob container, you can create one or use another service type.
   Subscription	One of your subscriptions	The subscription containing your target service. The default value is the subscription for your container app.
   Connection name	Generated unique name	The connection name that identifies the connection between your container app and target service.
   Storage account	Your storage account name	The target storage account to which you want to connect. If you choose a different service type, select the corresponding target service instance.
   Client type	The app stack in your selected container	Your application stack that works with the target service you selected. The default value is none, which generates a list of configurations. If you know about the app stack or the client SDK in the container you selected, select the same app stack for the client type.

7. Select Next: Authentication to select the authentication type. Then select Connection string to use access key to connect your Blob Storage account.

8. Select Next: Network to select the network configuration. Then select Enable firewall settings to update firewall allowlist in Blob Storage so that your container apps can reach the Blob Storage.

9. Then select Next: Review + Create to review the provided information. Running the final validation takes a few seconds. Then select Create to create the service connection. It might take a minute or so to complete the operation.

Azure CLI

The following steps create a service connection using an access key or a system-assigned managed identity.

1. Use the Azure CLI command az containerapp connection list-support-types to view all supported target services.

   az provider register -n Microsoft.ServiceLinker
   az containerapp connection list-support-types --output table
   

2. Use the Azure CLI command az containerapp connection connection create to create a service connection from a container app.

   If you're connecting with an access key, run the code below:

   az containerapp connection create storage-blob --secret
   

   If you're connecting with a system-assigned managed identity, run the code below:

   az containerapp connection create storage-blob --system-identity
   

3. Provide the following information at the Azure CLI's request:

   • The resource group which contains the container app: the name of the resource group with the container app.
   • Name of the container app: the name of your container app.
   • The container where the connection information will be saved: the name of the container, in your container app, that connects to the target service
   • The resource group which contains the storage account: the name of the resource group name with the storage account. In this guide, we're using a Blob Storage.
   • Name of the storage account: the name of the storage account that contains your blob.

   Important

   To use Managed Identity, you must have the permission to manage Microsoft Entra role assignments. If you don't have this permission, you won't be able to create a connection. You can ask your subscription owner to grant you this permission or use an access key instead to create the connection.

   Note

   If you don't have a Blob Storage, you can run az containerapp connection create storage-blob --new --secret to provision a new one.

View service connections in Container Apps

View your existing service connections using the Azure portal or the CLI.

Portal

1. In Service Connector, select Refresh and you'll see a Container Apps connection displayed.

2. Select > to expand the list. You can see the environment variables required by your application code.

3. Select ... and then Validate. You can see the connection validation details in the pop-up panel on the right.

   

Azure CLI

Use the Azure CLI command az containerapp connection list to list all your container app's provisioned connections. Provide the following information:

• Source compute service resource group name: the resource group name of the container app.
• Container app name: the name of your container app.

az containerapp connection list -g "<your-container-app-resource-group>" --name "<your-container-app-name>" --output table

The output also displays the provisioning state of your connections: failed or succeeded.

Next steps

Environments in Azure Container Apps