Início Rápido: Criar uma conexão de serviço no Serviço de Aplicativo com a CLI do Azure

Artigo
10/17/2024

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

Caso você não tenha uma assinatura 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, 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.

Este guia de início rápido exige a versão 2.30.0 ou superior da CLI do Azure. Se você está usando o Azure Cloud Shell, a versão mais recente já está instalada.
Neste início rápido, partimos do princípio de que você já tem pelo menos um Serviço de Aplicativo em execução no Azure. Caso você não tenha um Serviço de Aplicativo, crie um.

Configuração inicial

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

Importante

O uso da Identidade Gerenciada requer que você tenha a permissão para atribuição de função do Microsoft Entra. Sem essa permissão, a criação de uma conexão falhará. Você pode pedir ao proprietário da assinatura que conceda essa permissão ou usar uma chave de acesso para criar a conexão.

Use o comando az webapp connection da CLI do Azure para criar uma conexão de serviço com um Armazenamento de Blobs 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

Observação

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

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.

Use o comando az webapp connection create da CLI do Azure para criar uma conexão de serviço com um Armazenamento de Blobs do Azure através de 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 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 Armazenamento de Blobs.

az webapp connection create storage-blob --secret

Dica

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

Exibir conexões

Execute o comando az webapp connection da CLI do Azure para listar conexões com o 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óximas etapas

Siga os tutoriais abaixo para começar a criar o seu próprio aplicativo com o conector de serviço.

Tutorial: WebApp + Armazenamento com a CLI do Azure

Tutorial: WebApp + PostgreSQL com a CLI do Azure

Compartilhar via