Guia de Início Rápido: Criar uma conexão de serviço nos Aplicativos do Azure Spring com a CLI do Azure

Este início rápido mostra como conectar os Aplicativos do Azure Spring 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.

Pré-requisitos

• Uma assinatura do Azure. Caso você não tenha uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.

• Pelo menos um aplicativo hospedado pelos Aplicativos do Azure Spring em uma região com suporte do Service Connector. Se você não tiver um, implante o seu primeiro aplicativo nos Aplicativos do Azure Spring.

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

• Versão 2.37.0 ou superior da CLI do Azure. Para fazer a atualização para a versão mais recente, execute az upgrade. Se você está usando o Azure Cloud Shell, a versão mais recente já está instalada.

• A extensão dos Aplicativos do Azure Spring deve ser instalada na CLI do Azure ou no Cloud Shell. Para instalar, execute az extension add --name spring.

Configuração inicial

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

2. Opcionalmente, execute o comando az spring connection list-support-types para obter uma lista dos serviços de destino com suporte para os Aplicativos Spring do Azure.

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

   Dica

   Se o comando az spring não for reconhecido pelo sistema, verifique se você instalou a extensão necessária executando az extension add --name spring.

Criar uma conexão de serviço

Crie uma conexão dos Aplicativos Spring do Azure usando uma identidade gerenciada ou uma chave de acesso.

Identidade gerenciada

Importante

Para usar uma identidade gerenciada, você deve ter a permissão para modificar as atribuições de função no Microsoft Entra ID. Sem essa permissão, a criação da conexão falhará. Solicite ao proprietário da assinatura que conceda a você uma permissão de atribuição de função ou use uma chave de acesso para criar a conexão.

1. Execute o comando az spring connection create para criar uma conexão de serviço com um Armazenamento de Blobs usando uma identidade gerenciada atribuída pelo sistema

2. Forneça as seguintes informações na CLI ou na solicitação do Cloud Shell:

   az spring connection create storage-blob --system-identity
   

   Configuração	Descrição
   The resource group which contains the spring-cloud	O nome do grupo de recursos que contém um aplicativo hospedado pelos Aplicativos de Azure Spring.
   Name of the spring-cloud service	O nome do recurso dos Aplicativos de Azure Spring.
   Name of the spring-cloud app	O nome do aplicativo hospedado pelos Aplicativos de Azure Spring que se conecta ao serviço de destino.
   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 Blobs.

Dica

Se você não tiver um Armazenamento de Blobs, execute az spring connection create storage-blob --new --system-identity para provisionar um novo Armazenamento de Blobs e conectá-lo diretamente ao seu aplicativo hospedado pelos Aplicativos do Azure Spring usando uma identidade gerenciada.

Chave de acesso

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.

1. Execute o comando az spring connection create para criar uma conexão de serviço entre os Aplicativos Spring do Azure e um Armazenamento de Blobs do Azure usando uma chave de acesso.

   az spring connection create storage-blob --secret
   

2. Forneça as seguintes informações na CLI ou na solicitação do Cloud Shell:

   Configuração	Descrição
   The resource group which contains the spring-cloud	O nome do grupo de recursos que contém o aplicativo hospedado pelos Aplicativos de Azure Spring.
   Name of the spring-cloud service	O nome do recurso dos Aplicativos de Azure Spring.
   Name of the spring-cloud app	O nome do aplicativo hospedado pelos Aplicativos de Azure Spring que se conecta ao serviço de destino.
   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 Blobs.

Dica

Se você não tiver um Armazenamento de Blobs, execute az spring connection create storage-blob --new --secret para provisionar um novo Armazenamento de Blobs e conectá-lo diretamente ao seu aplicativo hospedado pelos Aplicativos do Azure Spring usando uma cadeia de conexão.

Exibir conexões

Execute o comando az spring connection list para listar todas as conexões provisionadas dos Aplicativos do Azure Spring.

Substitua os espaços reservados <azure-spring-apps-resource-group>, <azure-spring-apps-name> e <app-name>, no comando abaixo, pelo nome do grupo de recursos dos Aplicativos do Azure Spring, pelo nome do recurso dos Aplicativos do Azure Spring e pelo nome do aplicativo. Você também pode remover a opção --output table para exibir mais informações sobre suas conexões.

az spring connection list --resource-group <azure-spring-apps-resource-group> --service <azure-spring-apps-name> --app <app-name>--output table

A saída também exibe o estado de provisionamento de suas conexões: falha ou êxito.

Próximas etapas

Confira os guias abaixo para obter mais informações sobre o Conector do Serviço e os Aplicativos Spring do Azure.

Tutorial: Azure Spring Apps + MySQL

Tutorial: Azure Spring Apps + Apache Kafka no Confluent Cloud