Guia de início rápido: conectar aplicativos de contêiner do Azure a bancos de dados e serviços com o Service Connector (visualização)

2025-09-19

Introdução ao Service Connector para conectar seus Aplicativos de Contêiner do Azure a bancos de dados, contas de armazenamento e outros serviços do Azure. O Service Connector simplifica a autenticação e a configuração, permitindo que você se conecte a recursos usando identidades gerenciadas ou outros métodos de autenticação.

Este artigo fornece instruções passo a passo para o portal do Azure e a CLI do Azure. Escolha o seu método preferido usando as guias acima.

Importante

O suporte para o Service Connector (visualização) em Aplicativos de Contêiner do Azure termina em 30 de março de 2026. Após essa data, novas conexões de serviços usando o Service Connector (pré-visualização) não estarão disponíveis por meio de nenhuma interface. Para obter mais informações, consulte RETIREMENT: Service Connector (Preview) em Aplicativos de Contêiner do Azure.

Prerequisites

Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
Um aplicativo implantado em Aplicativos de Contêiner em uma região suportada pelo Service Connector.
Um recurso de destino ao qual conectar seus Aplicativos de Contêiner, como uma conta de Armazenamento de Blob.
As permissões necessárias para criar e gerenciar conexões de serviço.

Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
Um aplicativo implantado em Aplicativos de Contêiner em uma região suportada pelo Service Connector.
Um recurso de destino ao qual conectar seus Aplicativos de Contêiner, como uma conta de Armazenamento de Blob.
As permissões necessárias para criar e gerenciar conexões de serviço.

Use o ambiente Bash no Azure Cloud Shell. Para mais informações, veja Get started with Azure Cloud Shell.
Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a usar Windows ou macOS, considere executar o Azure CLI num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.
- Se estiver a usar uma instalação local, inicie sessão no Azure CLI utilizando o comando az login. Para concluir o processo de autenticação, siga os passos exibidos no seu terminal. Para outras opções de entrada, consulte Autenticar no Azure usando a CLI do Azure.
- Quando solicitado, instale a extensão do Azure CLI na primeira utilização. Para obter mais informações sobre extensões, consulte Usar e gerenciar extensões com a CLI do Azure.
- Execute az version para encontrar a versão e as bibliotecas dependentes que estão instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.

Este início rápido requer a versão 2.30.0 ou superior da CLI do Azure. Para atualizar para a versão mais recente, execute az upgrade. Se estiver usando o Azure Cloud Shell, a versão mais recente já está instalada.

Configurar o ambiente

Se você estiver usando o Service Connector pela primeira vez, comece executando o comando az provider register para registrar o provedor de recursos do Service Connector.
```
az provider register -n Microsoft.ServiceLinker
```
Sugestão

Você pode verificar se o provedor de recursos já foi registrado executando o comando az provider show -n "Microsoft.ServiceLinker" --query registrationState. Se a saída for Registered, o Service Connector já foi registrado.
Opcionalmente, execute o comando az containerapp connection list-support-types para obter uma lista de serviços de destino suportados para Container Apps.
```
az containerapp connection list-support-types --output table
```

Criar uma conexão de serviço (visualização)

Use o Service Connector para criar uma conexão de serviço entre seus Aplicativos de Contêiner do Azure e o Armazenamento de Blobs do Azure. Este exemplo demonstra a conexão com o Armazenamento de Blob, mas você pode usar o mesmo processo para outros serviços do Azure com suporte.

Selecione a barra de pesquisa Pesquisar recursos, serviços e documentos (G +/) na parte superior do portal do Azure, digite Aplicativos de Contêiner no filtro e selecione Aplicativos de Contêiner.
Selecione o nome do recurso Aplicativos de contêiner que você deseja conectar a um recurso de destino.
Selecione Service Connector (visualização) no sumário esquerdo. Em seguida, selecione Criar.

Na guia Noções básicas , selecione ou insira as seguintes configurações.

Setting	Example	Description
Container	my-container-app	O contêiner em seu aplicativo de contêiner.
Tipo de serviço	Armazenamento - Blob	O tipo de serviço que você deseja conectar ao seu aplicativo de contêiner.
Subscription	my-subscription	A assinatura que contém o serviço ao qual você deseja se conectar. O valor padrão é a assinatura que contém esse aplicativo de contêiner.
Nome da conexão	storageblob_700ae	O nome da conexão que identifica a conexão entre seu aplicativo de contêiner e o serviço de destino. Use o nome da conexão fornecido pelo Service Connector ou escolha seu próprio nome de conexão.
Conta de armazenamento	my-storage-account	A conta de armazenamento de destino à qual você deseja se conectar. Se você escolher um tipo de serviço diferente, selecione a instância de serviço de destino correspondente.
Tipo de cliente	.NET	A pilha de aplicativos que funciona com o serviço de destino selecionado. O valor padrão é None, que gera uma lista de configurações. Se você souber a pilha de aplicativos ou o SDK do cliente selecionado, selecione a mesma pilha de aplicativos para o tipo de cliente.

Selecione Avançar: Autenticação para escolher um método de autenticação: identidade gerenciada atribuída pelo sistema (SMI), identidade gerenciada atribuída pelo usuário (UMI), cadeia de conexão ou entidade de serviço.
Selecione Identidade gerenciada atribuída ao sistema para se conectar por meio de uma identidade gerada automaticamente no ID do Microsoft Entra e vinculada ao ciclo de vida da instância de serviço. Esta é a opção de autenticação recomendada.
Selecione Identidade gerenciada atribuída pelo usuário para autenticar por meio de uma identidade autônoma atribuída a uma ou mais instâncias de um serviço do Azure. Selecione uma subscrição que contenha uma identidade gerida atribuída pelo utilizador e, em seguida, selecione a identidade.

Se você ainda não tiver uma identidade gerenciada atribuída pelo usuário, crie uma:
1. Abra a plataforma Azure em uma nova guia e procure identidades gerenciadas.
2. Selecione Identidades gerenciadas e selecione Criar.
3. Insira uma assinatura, grupo de recursos, região e nome de instância.
4. Selecione Rever + criar e, em seguida, Criar
5. Depois que sua identidade gerenciada tiver sido implantada, retorne à guia Service Connector, selecione Anterior e, em seguida, Avançar para atualizar os dados do formulário. Em Identidade gerenciada atribuída pelo usuário, selecione a identidade que você criou.
Para obter mais informações, consulte Criar uma identidade gerenciada atribuída pelo usuário.
1. Selecione Entidade de serviço para usar uma entidade de serviço que define a política de acesso e as permissões para o usuário/aplicativo no ID do Microsoft Entra.
2. Selecione uma entidade de serviço na lista e insira um segredo
Warning

A Microsoft recomenda que você use o fluxo de autenticação mais seguro disponível. O fluxo de autenticação descrito neste procedimento requer um grau muito alto de confiança no aplicativo e acarreta riscos que não estão presentes em outros fluxos. Você só deve usar esse fluxo quando outros fluxos mais seguros, como identidades gerenciadas, não forem viáveis.

Selecione Cadeia de conexão para gerar ou configurar um ou vários pares chave-valor com segredos ou tokens puros.
Selecione Avançar: Rede para selecionar a configuração de rede e selecione Configurar regras de firewall para habilitar o acesso ao serviço de destino para que seu aplicativo de contêiner possa acessar o Armazenamento de Blob.
Selecione Seguinte: Rever + Criar para rever as informações fornecidas. A execução da validação final leva alguns segundos.
Selecione Criar para criar a conexão de serviço. A operação pode levar até um minuto para ser concluída.

Identidade gerenciada (recomendado)
Cadeia de conexão

Execute o az containerapp connection create comando para criar uma conexão de serviço de Aplicativos de Contêiner para um Armazenamento de Blob com uma identidade gerenciada atribuída pelo sistema. Você pode executar esse comando de duas maneiras diferentes:

Gere a nova conexão passo a passo.

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

Gere a nova conexão de uma só vez. Substitua os espaços reservados por suas próprias informações: <source-subscription>, <source_resource_group>, <app>, <target-subscription>, <target_resource_group>e <account>.

az containerapp connection create storage-blob \                         
   --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.App/containerApps/<app> \
   --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \
   --system-identity

Sugestão

Se você não tiver uma conta de Armazenamento de Blob, execute az containerapp connection create storage-blob --new --system-identity para criar uma e conecte-a ao seu aplicativo de contêiner usando uma identidade gerenciada.

Warning

A Microsoft recomenda que você use o fluxo de autenticação mais seguro disponível. O fluxo de autenticação descrito neste procedimento requer um grau muito alto de confiança no aplicativo e acarreta riscos que não estão presentes em outros fluxos. Você só deve usar esse fluxo quando outros fluxos mais seguros, como identidades gerenciadas, não forem viáveis.

Execute o az containerapp connection create comando para criar uma conexão de serviço de Aplicativos de Contêiner para um Armazenamento de Blob com uma cadeia de conexão. Você pode executar esse comando de duas maneiras diferentes:

Gere a nova conexão passo a passo.

az containerapp connection create storage-blob --secret

az containerapp connection create storage-blob \                         
   --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.App/containerApps/<app> \
   --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \
   --secret name=<secret-name> secret=<secret>

Sugestão

Se você não tiver uma conta de Armazenamento de Blob, execute az containerapp connection create storage-blob --new --secret para criar uma e conecte-a ao seu aplicativo de contêiner usando uma identidade gerenciada.

Exibir conexões de serviço

As conexões de aplicativos de contêiner são exibidas em Configurações > do Conector de Serviço (visualização). Selecione > esta opção para expandir a lista e ver as propriedades exigidas pelo seu aplicativo.
Selecione sua conexão e, em seguida, Validar para solicitar que o Service Connector verifique sua conexão.
Selecione Saiba mais para rever os detalhes da validação da ligação.

Execute o comando az containerapp connection list para listar todas as conexões provisionadas do seu aplicativo de contêiner. Substitua os espaços reservados <container-app-resource-group> e <container-app-name> do comando abaixo por suas próprias informações. Você também pode remover a --output table opção para exibir mais informações sobre suas conexões.

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

A saída também exibe o estado de provisionamento de suas conexões.

Consulte os seguintes guias para obter mais informações sobre o Service Connector:

Partilhar via

Guia de início rápido: conectar aplicativos de contêiner do Azure a bancos de dados e serviços com o Service Connector (visualização)

Prerequisites

Configurar o ambiente

Criar uma conexão de serviço (visualização)

Exibir conexões de serviço

Conteúdo relacionado

Comentários

Recursos adicionais