Guia de início rápido: conectar o Azure Spring Apps a bancos de dados e serviços com o Service Connector

2025-08-19

Introdução ao Service Connector para conectar seus aplicativos Azure Spring a bancos de dados, contas de armazenamento e outros serviços do Azure. O Service Connector simplifica a autenticação e a configuração, permitindo que você se conecte a recursos usando identidades gerenciadas de 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 o seu método preferido usando as guias acima.

Nota

Os planos Basic, Standard e Enterprise entraram em um período de aposentadoria em 17 de março de 2025. Para obter mais informações, consulte o anúncio de aposentadoria do Azure Spring Apps.

O plano de consumo padrão e dedicado entrou em um período de aposentadoria em 30 de setembro de 2024, com uma paralisação completa até o final de março de 2025. Para mais informações, consulte Migrar o Consumo Padrão e o Plano Dedicado do Azure Spring Apps para Azure Container Apps.

Pré-requisitos

Uma conta do Azure com uma subscrição ativa. Crie uma conta do Azure gratuitamente.
Um aplicativo implantado no Azure Spring Apps em uma região suportada pelo Service Connector.
Um recurso de destino ao qual conectar o Azure Spring Apps. Por exemplo, um Cofre da Chave do Azure.
As permissões necessárias para criar e gerenciar conexões de serviço.

Uma conta do Azure com uma subscrição ativa. Crie uma conta do Azure gratuitamente.
Um aplicativo implantado no Azure Spring Apps em uma região suportada pelo Service Connector.
Um recurso de destino ao qual conectar o Azure Spring Apps. Por exemplo, um Cofre da Chave do Azure.
As permissões necessárias para criar e gerenciar conexões de serviço.

Use o ambiente Bash no Azure Cloud Shell. Para mais informações, veja Get started with Azure Cloud Shell.
Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a usar Windows ou macOS, considere executar o Azure CLI num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.
- Se estiver a usar uma instalação local, inicie sessão no Azure CLI utilizando o comando az login. Para concluir o processo de autenticação, siga os passos exibidos no seu terminal. Para outras opções de entrada, consulte Autenticar no Azure usando a CLI do Azure.
- Quando solicitado, instale a extensão do Azure CLI na primeira utilização. Para obter mais informações sobre extensões, consulte Usar e gerenciar extensões com a CLI do Azure.
- Execute az version para encontrar a versão e as bibliotecas dependentes que estão 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

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
```
Sugestão

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

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

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

Selecione a barra de pesquisa Pesquisar recursos, serviços e documentos (G +/) na parte superior do portal do Azure, digite Azure Spring Apps no filtro e selecione Azure Spring Apps.
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 Service Connector no menu de serviço e selecione Criar.

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

Definição	Exemplo	Description
Tipo de serviço	Cofre da Chave	O tipo de serviço ao qual você vai conectar seu aplicativo.
Nome da ligaçã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 de conexão fornecido pelo Service Connector ou digite seu próprio nome de conexão.
Subscrição	A minha subscrição	A assinatura que contém seu 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-nome	O Cofre da Chave 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 de SpringBoot e Java, outras pilhas também são suportadas.

Selecione Next: Authentication para selecionar o tipo de autenticação. Recomendamos que você use uma identidade gerenciada atribuída ao sistema para se conectar ao Cofre da Chave.
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 seu aplicativo possa acessar o Armazenamento de Blob.
Selecione Seguinte: Rever + Criar para rever as informações fornecidas. Aguarde alguns segundos para que o Service Connector valide as informações e selecione Criar para criar a conexão de serviço.

Identidade gerenciada (recomendado)
Cadeia de conexão

Execute o comando para conectar um aplicativo implantado az spring connection create no Azure Spring Apps a um recurso de Armazenamento de Blob, 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 só 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 containerapp 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

Sugestão

Se você não tiver uma conta de Armazenamento de Blob, execute az spring connection create storage-blob --new --system-identity para criar uma e conectá-la ao seu aplicativo hospedado no Azure Spring Apps usando uma identidade gerenciada.

Advertência

A Microsoft recomenda que você use o fluxo de autenticação mais seguro disponível. O fluxo de autenticação descrito neste procedimento requer um grau muito alto de confiança no aplicativo e acarreta 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 uma aplicação implantada no Azure Spring Apps a um recurso de Armazenamento de Blob, 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 containerapp 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>

Sugestão

Se você não tiver uma conta de Armazenamento de Blob, execute az spring connection create storage-blob --new --secret para criar uma e conectá-la ao seu aplicativo hospedado no Azure Spring Apps usando uma cadeia de conexão.

Exibir conexões de serviço

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

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

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

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 --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-resource-name> --app <app-name> --output table

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

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

Comentários

Esta página foi útil?