Início Rápido: Conectar Aplicativos Spring do Azure a bancos de dados e serviços com o Conector de Serviço

Introdução ao Conector de Serviço para conectar seus Aplicativos Spring do Azure a bancos de dados, contas de armazenamento e outros serviços do Azure. O Conector de Serviço simplifica a autenticação e a configuração, permitindo que você se conecte a recursos usando identidades gerenciadas e outros métodos de autenticação.

Este artigo fornece instruções passo a passo para o portal do Azure e a CLI do Azure. Escolha seu método preferencial usando as guias acima.

Observação

Os planos Básico, Standard e Enterprise entraram em período de aposentadoria em 17 de março de 2025. Para mais informações, confira o anúncio de desativação dos Aplicativos Spring do Azure.

Pré-requisitos

Uma conta do Azure com uma assinatura ativa. Criar uma conta do Azure gratuitamente.
Um aplicativo implantado nos Aplicativos Spring do Azure em uma região com suporte do Conector de Serviço.
Um recurso de destino ao qual conectar o Azure Spring Apps. Por exemplo, um Azure Key Vault.
As permissões necessárias para criar e gerenciar conexões de serviço.

Uma conta do Azure com uma assinatura ativa. Criar uma conta do Azure gratuitamente.
Um aplicativo implantado nos Aplicativos Spring do Azure em uma região com suporte do Conector de Serviço.
Um recurso de destino ao qual conectar o Azure Spring Apps. Por exemplo, um Azure Key Vault.
As permissões necessárias para criar e gerenciar conexões de serviço.

Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Introdução ao Azure Cloud Shell.
Se você preferir executar 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, consulte Como executar a CLI do Azure em um contêiner do Docker.
- Se você estiver usando uma instalação local, entre na CLI do Azure usando o comando az login . Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para obter outras opções de entrada, consulte Autenticar no Azure usando 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 e gerenciar extensões com a CLI do Azure.
- Execute az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar 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.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.
Opcionalmente, execute o seguinte comando para obter uma lista de 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

Use o Conector de Serviço para criar uma conexão de serviço segura entre os Aplicativos Spring do Azure e o Armazenamento de Blobs do Azure. Este exemplo demonstra a conexão com o Armazenamento de Blobs, mas você pode usar o mesmo processo para outros serviços do Azure com suporte.

Selecione a barra de pesquisa de Pesquisar recursos, serviços e documentos (G +/) na parte superior do portal do Azure, digite Aplicativos Spring do Azure no filtro e selecione Aplicativos Spring do Azure.
Selecione o nome da instância do Azure Spring Apps que você deseja conectar a um recurso de destino.
Em Configurações, selecione Aplicativos e selecione o aplicativo na lista.
Selecione Conector de Serviço no menu de serviço e selecione Criar.

Na guia Básico, selecione ou insira as seguintes configurações. Captura de tela do portal do Azure, preencha informações básicas para criar uma conexão.

Configuração	Exemplo	Descrição
Tipo de serviço	Cofre de chaves	O tipo de serviço que você vai conectar seu aplicativo.
Nome da conexão	keyvault_17d38	O nome da conexão que identifica a conexão entre seu aplicativo e o serviço de destino. Use o nome da conexão fornecido pelo Conector de Serviço ou insira um nome de conexão próprio.
Assinatura	my-subscription	A assinatura que contém o serviço de destino (o serviço ao qual você deseja se conectar). O valor padrão é a assinatura que contém o aplicativo implantado no Azure Spring Apps.
Cofre de chaves	my-keyvault-name	O Key Vault de destino ao qual você deseja se conectar. Se você escolher um tipo de serviço diferente, selecione a instância de serviço de destino correspondente.
Tipo de cliente	SpringBoot	A pilha de aplicativos que funciona com o serviço de destino selecionado. Além do SpringBoot e do Java, também há suporte para outras pilhas.

Selecione Próximo: autenticação para selecionar o tipo de autenticação. É recomendável usar uma identidade gerenciada atribuída pelo sistema para se conectar ao Key Vault.
Selecione Avançar: Rede para selecionar a configuração de rede e selecione Configurar regras de firewall para habilitar o acesso ao serviço de destino para que o aplicativo possa acessar o Armazenamento de Blobs.
Selecione Avançar: Examinar + Criar para examinar as informações fornecidas. Aguarde alguns segundos para que o Conector de Serviço valide as informações e selecione Criar para criar a conexão de serviço.

Identidade gerenciada (recomendável)
Cadeia de conexão

Execute o comando az spring connection create para conectar um aplicativo implantado nos Aplicativos Spring do Azure a um recurso de Armazenamento de Blobs, com uma identidade gerenciada atribuída pelo sistema. Você pode executar esse comando de duas maneiras diferentes:

Gere a nova conexão passo a passo.

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

Gere a nova conexão de uma vez. Substitua os espaços reservados por suas próprias informações: <source-subscription>, <source_resource_group>, <azure-spring-apps-resource>, <app>, <target-subscription>, <target_resource_group> e <account>.

   az spring connection create storage-blob \                         
   --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.AppPlatform/Spring/<azure-spring-apps-resource>/apps/<app> \
   --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \
   --system-identity

Dica

Caso não tenha uma conta de Armazenamento de Blobs, execute az spring connection create storage-blob --new --system-identity para criar uma e conectá-la ao aplicativo hospedado nos Aplicativos Spring do Azure usando uma identidade gerenciada.

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.

Execute o comando az spring connection create para conectar um aplicativo implantado aos Aplicativos Spring do Azure a um recurso de Armazenamento de Blobs, com cadeia de conexão. Você pode executar esse comando de duas maneiras diferentes:

Gere a nova conexão passo a passo.

az spring connection create storage-blob --secret

az spring connection create storage-blob \                         
   --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.AppPlatform/Spring/<azure-spring-apps-resource>/apps/<app> \
   --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \
    --secret name=<secret-name> secret=<secret>

Dica

Caso não tenha uma conta de Armazenamento de Blobs, execute az spring connection create storage-blob --new --secret para criar uma e conectá-la ao aplicativo hospedado nos Aplicativos Spring do Azure usando uma cadeia de conexão.

Visualizar conexões de serviço

As conexões do Azure Spring Apps são exibidas em Configurações > Conector de serviço.

Selecione > para expandir a lista e acessar as propriedades exigidas pelo seu aplicativo.
Selecione Validar para verificar o status da conexão e selecione Saiba mais para examinar os detalhes da validação da conexão.

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-resource-name> e <app-name> do comando abaixo por suas próprias informações. 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-resource-name> --app <app-name> --output table

A saída também exibe o estado de provisionamento de suas conexões.

Confira os guias abaixo para obter mais informações sobre o Conector de Serviço e Azure Spring Apps:

Comentários

Esta página foi útil?

Last updated on 2025-10-31