Compartilhar via


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

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

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.

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.