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
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.ServiceLinkerDica
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 forRegistered, o Conector de Serviço já foi registrado.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 tableDica
Se o comando
az springnão for reconhecido pelo sistema, verifique se você instalou a extensão necessária executandoaz 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.
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.
Execute o comando
az spring connection createpara criar uma conexão de serviço com um Armazenamento de Blobs usando uma identidade gerenciada atribuída pelo sistemaForneça as seguintes informações na CLI ou na solicitação do Cloud Shell:
az spring connection create storage-blob --system-identityConfiguração Descrição The resource group which contains the spring-cloudO nome do grupo de recursos que contém um aplicativo hospedado pelos Aplicativos de Azure Spring. Name of the spring-cloud serviceO nome do recurso dos Aplicativos de Azure Spring. Name of the spring-cloud appO nome do aplicativo hospedado pelos Aplicativos de Azure Spring que se conecta ao serviço de destino. The resource group which contains the storage accountO nome do grupo de recursos com a conta de armazenamento. Name of the storage accountO 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.
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.