Share via


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 chave de acesso ou uma identidade gerenciada.

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

    az spring connection create storage-blob --secret
    
  2. Forneça as seguintes informações a pedido da CLI ou do Cloud Shell:

    Definição Descrição
    The resource group which contains the spring-cloud O nome do grupo de recursos que contém o 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 --secret para provisionar um novo Armazenamento de Blob e conectá-lo diretamente ao seu aplicativo hospedado pelo Azure Spring Apps usando uma cadeia de conexão.

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 , e do comando abaixo pelo nome do seu grupo de recursos do Azure Spring Apps, <azure-spring-apps-name>o nome do seu recurso do Azure Spring Apps e <app-name> 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.