Início Rápido: Criar uma conexão de serviço nos Aplicativos de Contêiner do Azure com a CLI do Azure (versão prévia)

Esse início rápido mostrará como conectar Aplicativos de Contêiner do Azure a outros recursos da Nuvem usando a CLI do Azure e o Conector de Serviço (versão prévia). O Conector de Serviço permite conectar rapidamente os serviços de computação aos serviços de nuvem, enquanto gerencia as configurações de autenticação e rede da sua conexão.

Pré-requisitos

• Uma assinatura ativa do Azure. Caso você não tenha uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.

• Pelo menos um aplicativo implantado em Aplicativos de Contêiner do Azure em uma região com suporte pelo Conector de Serviço. Se você não tiver um, crie e implante um contêiner nos Aplicativos de Contêiner.

• Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Início Rápido para Bash no Azure Cloud Shell.

  

• Se preferir executar os 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, confira Como executar a CLI do Azure em um contêiner do Docker.

  • Se estiver usando uma instalação local, entre com a CLI do Azure usando o comando az login. Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para ver outras opções de entrada, confira Conectar-se com 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 extensões com a CLI do Azure.

  • Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para fazer a atualização para a versão mais recente, execute az upgrade.

• Versão 2.37.0 ou superior da CLI do Azure deve ser instalada. 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.

• A extensão aplicativos de contêiner deve ser instalada na CLI do Azure ou no Cloud Shell. Para instalar, execute az extension add --name containerapp.

Configure seu ambiente

1. 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.

2. 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)

Crie uma conexão usando uma identidade gerenciada ou uma chave de acesso.

Identidade gerenciada

Importante

Para usar uma identidade gerenciada, você deve ter a permissão para modificar a atribuição de função do Microsoft Entra. Solicite que o proprietário da assinatura conceda essa permissão a você ou use uma chave de acesso para criar a conexão.

1. 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.

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

2. Forneça as seguintes informações na solicitação da CLI do Azure:

   Configuração	Descrição
   The resource group that contains the container app	O nome do grupo de recursos com o aplicativo de contêiner.
   Name of the container app	O nome do aplicativo de contêiner.
   The container where the connection information will be saved	O nome do contêiner do aplicativo de contêiner.
   The resource group which contains the storage account	O nome do grupo de recursos com a conta de armazenamento.
   Name of the storage account	O nome da conta de armazenamento à qual você deseja se conectar. Neste guia, estamos usando um Armazenamento de Blobs.

Observação

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

Chave de acesso

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.

1. Execute o comando az containerapp connection create para criar uma conexão de serviço entre os Aplicativos de Contêiner e o Armazenamento de Blobs do Azure usando uma chave de acesso.

   az containerapp connection create storage-blob --secret
   

2. Forneça as seguintes informações na solicitação da CLI do Azure:

   Configuração	Descrição
   The resource group that contains the container app	O nome do grupo de recursos com o aplicativo de contêiner.
   Name of the container app	O nome do aplicativo de contêiner.
   The container where the connection information will be saved	O nome do contêiner do aplicativo de contêiner.
   The resource group which contains the storage account	O nome do grupo de recursos com a conta de armazenamento.
   Name of the storage account	O nome da conta de armazenamento à qual você deseja se conectar. Neste guia, estamos usando um Armazenamento de Blobs.

Dica

Se você não tiver um Armazenamento de Blobs, execute az containerapp connection create storage-blob --new --secret para provisionar um novo Armazenamento de Blobs e conectá-lo diretamente ao seu aplicativo de contêiner usando uma cadeia de conexão.

Exibir conexões

Use o comando az containerapp connection list da CLI do Azure para listar todas as conexões provisionadas do aplicativo de contêiner. Substitua os espaços reservados <container-app-resource-group> e <container-app-name> do comando abaixo pelo grupo de recursos e o nome do aplicativo de contêiner. Você também pode remover a opção --output table para exibir mais informações sobre suas conexões.

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

A saída também exibe o estado de provisionamento de suas conexões: falha ou êxito.

Links relacionados

• 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