Partilhar via

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 (visualização)

  • Artigo

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 (visualização). 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.

Pré-requisitos

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

Configurar o ambiente

  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 (visualização)

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

Importante

Para usar uma identidade gerenciada, você deve ter a permissão para modificar a atribuição de função do Microsoft Entra. 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 <container-app-name> do comando abaixo pelo grupo de recursos e 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.