Guia de início rápido: criar uma conexão de serviço no Serviço de Aplicativo com a CLI do Azure

Artigo
10/15/2024

Este guia de início rápido descreve as etapas para criar uma conexão de serviço no Serviço de Aplicativo do Azure com a CLI do Azure.

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

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.

Este início rápido requer a versão 2.30.0 ou superior da CLI do Azure. Se estiver usando o Azure Cloud Shell, a versão mais recente já está instalada.
Este início rápido pressupõe que você já tenha pelo menos um Serviço de Aplicativo em execução no Azure. Se você não tiver um Serviço de Aplicativo, crie um.

Configuração inicial

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.
Opcionalmente, use o comando Azure CLI az webapp connection list-support-types para obter uma lista de serviços de destino suportados para o Serviço de Aplicativo.
```
az webapp connection list-support-types --output table
```

Importante

Usar a Identidade Gerenciada requer que você tenha permissão para a atribuição de função do Microsoft Entra. Sem essa permissão, a criação de uma conexão falhará. Pode pedir ao proprietário da sua subscrição para lhe conceder esta permissão ou utilizar uma chave de acesso para criar a ligação.

Use o comando Azure CLI az webapp connection para criar uma conexão de serviço com um Armazenamento de Blob com uma Identidade Gerenciada atribuída pelo sistema, fornecendo as seguintes informações:

O nome do grupo de recursos que contém o Serviço de Aplicativo
O nome do Serviço de Aplicativo
O nome do grupo de recursos que contém a conta de armazenamento
O nome da conta de armazenamento

az webapp connection create storage-blob

Nota

Se você não tiver um Armazenamento de Blob, poderá executar az webapp connection create storage-blob --new --system-identity para provisionar um novo recurso de Armazenamento de Blob e conectá-lo diretamente à sua instância do Serviço de Aplicativo.

Aviso

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.

Use o comando Azure CLI az webapp connection create para criar uma conexão de serviço com um Armazenamento de Blob do Azure com uma chave de acesso, fornecendo as seguintes informações:

Nome do grupo de recursos do serviço de computação de origem: o nome do grupo de recursos do Serviço de Aplicativo.
Nome do Serviço de Aplicativo: o nome do seu Serviço de Aplicativo que se conecta ao serviço de destino.
Nome do grupo de recursos do serviço de destino: o nome do grupo de recursos do Armazenamento de Blobs.
Nome da conta de armazenamento: o nome da conta do seu Armazenamento de Blobs.

az webapp connection create storage-blob --secret

Gorjeta

Se você não tiver um Armazenamento de Blob, execute az webapp connection create storage-blob --new --secret para provisionar um novo e se conectar diretamente ao recurso do Serviço de Aplicativo.

Ver conexões

Execute o comando Azure CLI az webapp connection para listar conexões com seu Serviço de Aplicativo, fornecendo as seguintes informações:

O nome do grupo de recursos que contém o Serviço de Aplicativo
O nome do Serviço de Aplicativo

az webapp connection list -g "<your-app-service-resource-group>" -n "<your-app-service-name>" --output table

Próximos passos

Siga os tutoriais abaixo para começar a criar seu próprio aplicativo com o Service Connector.

Tutorial: WebApp + Armazenamento com CLI do Azure

Tutorial: WebApp + PostgreSQL com CLI do Azure

Partilhar via