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

Artigo
10/16/2024

Este início rápido mostra como conectar o Azure Functions a outros recursos de nuvem usando a CLI do Azure e o Conector de Serviço. 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.

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.
Este início rápido pressupõe que você já tenha uma Função do Azure. Se não for o caso, crie uma Função do Azure.
Este início rápido pressupõe que você já tenha uma conta do Armazenamento do Microsoft Azure. Se você ainda não tiver uma, crie uma conta de Armazenamento do Azure.

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 functionapp connection list-support-types da CLI do Azure para obter uma lista de serviços de destino com suporte no Aplicativo de funções.
```
az functionapp connection list-support-types --output table
```

Importante

Usar a identidade gerenciada requer que você tenha a permissão para a atribuição de função do Azure AD. Se você não tiver a permissão, a criação da conexão falhará. Você pode solicitar ao proprietário da assinatura a permissão ou usar uma chave de acesso para criar a conexão.

Use o comando az functionapp connection da CLI do Azure para criar uma conexão de serviço a um Armazenamento de Blobs com uma Identidade gerenciada atribuída pelo sistema, com as seguintes informações:

Nome do grupo de recursos do serviço de computação de origem: o nome do grupo de recursos do Aplicativo de Funções.
Nome do aplicativo de funções: o nome do aplicativo de funções 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 functionapp connection create storage-blob --system-identity

Observação

Se você não tiver um Armazenamento de Blobs, poderá executar az functionapp connection create storage-blob --new --system-identity para provisionar um novo e conectar-se diretamente ao aplicativo de funções.

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 functionapp connection create da CLI do Azure para criar uma conexão de serviço com um Armazenamento de Blobs do Azure por meio 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 Aplicativo de Funções.
Nome do Aplicativo de Funções: o nome do aplicativo de funções 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 functionapp connection create storage-blob --secret

Observação

Se você não tiver um Armazenamento de Blobs, poderá executar az functionapp connection create storage-blob --new --secret para provisionar um novo e conectar-se diretamente ao aplicativo de funções.

Exibir conexões

Use o comando az functionapp connection list da CLI do Azure para listar conexões com seu Aplicativo de Funções, 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 Aplicativo de Funções.
Nome do Aplicativo de Funções: o nome do aplicativo de funções que se conecta ao serviço de destino.

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

Próximas etapas

Siga os tutoriais abaixo para começar a criar seu próprio aplicativo de funções com o Conector de Serviço.

Tutorial: Função Python com o Armazenamento de Filas do Azure como gatilho

Tutorial: Função Python com o Armazenamento de Blobs do Azure como entrada

Tutorial: Função Python com o Armazenamento de Tabelas do Azure como saída

Compartilhar via