Guia de início rápido: criar uma conexão de serviço nos Aplicativos de Contêiner do Azure com a CLI do Azure

Este guia de início rápido mostra como conectar os Aplicativos de Contêiner do Azure a outros recursos de Nuvem usando a CLI do Azure e o Service Connector. O Service Connector permite-lhe ligar rapidamente serviços de computação a serviços na nuvem, ao mesmo tempo que gere as definições de autenticação e rede da sua ligação.

Importante

O Conector de Serviço em Aplicativos de Contêiner está atualmente em visualização. Veja Termos de Utilização Complementares da Pré-visualizações do Microsoft Azure para obter os termos legais que se aplicam às funcionalidades do Azure que estão na versão beta, na pré-visualização ou que ainda não foram lançadas para disponibilidade geral.

Pré-requisitos

• Uma subscrição do Azure. Se não tiver uma subscrição do Azure, crie uma conta gratuita do Azure antes de começar.

• Pelo menos um aplicativo implantado em Aplicativos de Contêiner em uma região suportada pelo Service Connector. Se você não tiver um, crie e implante um contêiner em Aplicativos de Contêiner.

• Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, consulte Guia de início rápido para Bash no Azure Cloud Shell.

  

• Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.

  • Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de entrada, consulte Entrar com a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.

  • Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.

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

• A extensão Container Apps deve ser instalada na CLI do Azure ou no Cloud Shell. Para instalá-lo, execute az extension add --name containerapp.

Configuração inicial

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

   Gorjeta

   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.

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

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

Chave de acesso

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

   az containerapp connection create storage-blob --secret
   

2. Forneça as seguintes informações a pedido da CLI do Azure:

   Definição	Descrição
   The resource group that contains the container app	O nome do grupo de recursos com o aplicativo 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 Blob.

Gorjeta

Se você não tiver um Armazenamento de Blob, poderá executar 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.

Identidade gerida

Importante

Para usar uma identidade gerenciada, você deve ter a permissão para modificar a atribuição de função do Microsoft Entra. Sem essa permissão, a criação da conexão falhará. Peça ao proprietário da sua subscrição para lhe conceder esta permissão ou utilize uma chave de acesso para criar a ligação.

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

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

2. Forneça as seguintes informações a pedido da CLI do Azure:

   Definição	Descrição
   The resource group that contains the container app	O nome do grupo de recursos com o aplicativo 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 Blob.

Nota

Se você não tiver um Armazenamento de Blob, poderá executar 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.

Ver conexões

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

Próximos passos

Componentes internos do Service Connector