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

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

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.

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

  • A extensão do Azure Spring Apps deve ser instalada na CLI do Azure ou no Cloud Shell. Para instalá-lo, execute az extension add --name spring.

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, execute o comando az spring connection list-support-types para obter uma lista de serviços de destino suportados para o Azure Spring Apps.

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

    Gorjeta

    Se o az spring comando 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 do Azure Spring Apps usando uma identidade gerenciada ou uma chave de acesso.

Importante

Para usar uma identidade gerenciada, você deve ter a permissão para modificar atribuições de função no Microsoft Entra ID. Sem essa permissão, a criação da conexão falhará. Peça ao proprietário da sua subscrição para lhe conceder uma permissão de atribuição de função ou utilize uma chave de acesso para criar a ligação.

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

  2. Forneça as seguintes informações a pedido da CLI ou do Cloud Shell:

    az spring connection create storage-blob --system-identity
    
    Definição Descrição
    The resource group which contains the spring-cloud O nome do grupo de recursos que contém um aplicativo hospedado pelo Azure Spring Apps.
    Name of the spring-cloud service O nome do recurso Azure Spring Apps.
    Name of the spring-cloud app O nome do aplicativo hospedado pelo Azure Spring Apps 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 Blob.

Gorjeta

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

Ver conexões

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

Substitua os espaços <azure-spring-apps-resource-group>reservados , <azure-spring-apps-name>e <app-name> do comando abaixo pelo nome do seu grupo de recursos do Azure Spring Apps, o nome do seu recurso do Azure Spring Apps e o nome do seu aplicativo. Você também pode remover a --output table opção 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óximos passos

Consulte os guias abaixo para obter mais informações sobre o Service Connector e o Azure Spring Apps.