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

Este guia de início rápido mostra como conectar o Azure Functions 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.

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

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, use o comando Azure CLI az functionapp connection list-support-types para obter uma lista de serviços de destino suportados para o Function App.

   az functionapp connection list-support-types --output table
   

Criar uma conexão de serviço

Usando uma identidade gerenciada

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á. Pode pedir a permissão ao proprietário da subscrição ou utilizar uma chave de acesso para criar a ligação.

Use o comando Azure CLI az functionapp 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:

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

Nota

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

Utilizar uma chave de acesso

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 functionapp 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 Aplicativo de Função.
• Nome do aplicativo de função: o nome do seu aplicativo de função 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 functionapp connection create storage-blob --secret

Nota

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

Ver conexões

Use o comando Azure CLI az functionapp connection list para listar conexões com seu Aplicativo de Função, 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ção.
• Nome do aplicativo de função: o nome do seu aplicativo de função 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óximos passos

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

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 Tabela do Azure como saída