Início Rápido: Conectar aplicativos de contêiner do Azure a bancos de dados e serviços com o Conector de Serviço (versão prévia)

Introdução ao Conector de Serviço para conectar seus Aplicativos de Contêiner do Azure a bancos de dados, contas de armazenamento e outros serviços do Azure. O Conector de Serviço 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 seu método preferencial usando as guias acima.

Importante

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

Pré-requisitos

Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
Um aplicativo implantado nos Aplicativos de Contêiner em uma região com suporte do Conector de Serviço.
Um recurso de destino para conectar seus Aplicativos de Contêiner, como uma conta de Armazenamento de Blobs.
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 nos Aplicativos de Contêiner em uma região com suporte do Conector de Serviço.
Um recurso de destino para conectar seus Aplicativos de Contêiner, como uma conta de Armazenamento de Blobs.
As permissões necessárias para criar e gerenciar conexões de serviço.

Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Introdução ao Azure Cloud Shell.
Se você preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Para execuções no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.
- Se você estiver usando uma instalação local, entre na CLI do Azure usando o comando az login . Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para obter outras opções de entrada, consulte Autenticar no Azure usando a CLI do Azure.
- Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar e gerenciar extensões com a CLI do Azure.
- Execute az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute az upgrade.

Este guia de início rápido exige a versão 2.30.0 ou superior da CLI do Azure. Para fazer a atualização para a versão mais recente, execute az upgrade. Se você está usando o Azure Cloud Shell, a versão mais recente já está instalada.

Configure seu ambiente

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

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 Conector de Serviço já foi registrado.
Opcionalmente, execute o comando az containerapp connection list-support-types para obter uma lista dos serviços de destino com suporte para os Aplicativos de Contêiner do Azure.
```
az containerapp connection list-support-types --output table
```

Criar uma conexão de serviço (versão prévia)

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

Selecione a barra de pesquisa de 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 de Aplicativos de Contêiner que você deseja conectar a um recurso de destino.
Selecione Conector de Serviço (versão prévia) na tabela de conteúdo à esquerda. Em seguida, selecione Criar.

Na guia Básico, selecione ou insira as seguintes configurações.

Configuração	Exemplo	Descrição
Contêiner	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.
Assinatura	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 o aplicativo de contêiner e o serviço de destino. Use o nome da conexão fornecido pelo Conector de Serviço ou escolha um nome de conexão próprio.
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 é Nenhum, o que gera uma lista de configurações. Se você souber a pilha de aplicativos ou o SDK do cliente em sua seleção, selecione a mesma pilha de aplicativos para o tipo de cliente.

Selecione Avançar: Autenticação para escolher um método de autenticação: SMI (identidade gerenciada atribuída pelo sistema), UMI (identidade gerenciada) atribuída pelo usuário, cadeia de conexão ou entidade de serviço.
Selecione a Identidade gerenciada atribuída ao sistema para se conectar por meio de uma identidade gerada automaticamente no Microsoft Entra ID e vinculada ao ciclo de vida da instância de serviço. Essa é a opção de autenticação recomendada.
Selecione a Identidade gerenciada atribuída pelo usuário para se autenticar usando uma identidade autônoma atribuída a uma ou mais instâncias de um serviço do Azure. Selecione uma assinatura que contenha uma identidade gerenciada atribuída pelo usuário 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 do Azure em uma nova guia e pesquise Identidades gerenciadas.
2. Selecionar Identidades gerenciadas e selecionar Criar.
3. Insira uma assinatura, grupo de recursos, região e nome da instância.
4. Selecione Examinar + criar e depois Criar
5. Depois que sua identidade gerenciada tiver sido implantada, retorne à guia Conector de Serviço, 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 criada.
Para obter mais informações, confira Criar uma identidade gerenciada atribuída pelo usuário.
1. Selecione Entidade de serviço para usar uma entidade de serviço que defina a política de acesso e as permissões para o usuário/aplicativo no Microsoft Entra ID.
2. Selecione uma entidade de serviço na lista e insira um segredo
Aviso

A Microsoft recomenda usar o fluxo de autenticação mais seguro disponível. O fluxo de autenticação descrito neste procedimento exige um grau muito alto de confiança no aplicativo e traz 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 a 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 selecionar 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 Blobs.
Selecione Avançar: Examinar + Criar para examinar as informações fornecidas. Executar a validação final leva alguns segundos.
Selecione Criar para criar a conexão de serviço. Essa operação pode levar até um minuto para ser concluída.

Identidade gerenciada (recomendável)
Cadeia de conexão

Execute o comando az containerapp connection create para criar uma conexão de serviço dos Aplicativos de Contêiner com um Armazenamento de Blobs usando 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 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

Dica

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

Aviso

A Microsoft recomenda usar o fluxo de autenticação mais seguro disponível. O fluxo de autenticação descrito neste procedimento exige um grau muito alto de confiança no aplicativo e traz 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 comando az containerapp connection create para criar uma conexão de serviço de Aplicativos de Contêiner para um Armazenamento de Blobs 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>

Dica

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

Visualizar conexões de serviço

As conexões dos Aplicativos de Contêiner são exibidas em Configurações do > Conector de Serviço (versão prévia). Selecione > para expandir a lista e acessar as propriedades exigidas pelo seu aplicativo.
Selecione sua conexão e clique em Validar para solicitar que o Conector de Serviço verifique sua conexão.
Selecione Saiba mais para examinar os detalhes da validação da conexã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 opção --output table 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.

Verifique as seguintes guias para obter mais informações sobre o Conector de Serviço:

Elementos internos do Conector de Serviço
Aplicativos de Contêiner: Conectar o aplicativo Java Quarkus ao PostgreSQL
Aplicativos de Contêiner: Conectar o aplicativo ASP.NET Core à Configuração do Aplicativo

Comentários

Esta página foi útil?

Last updated on 2025-09-19