Compartilhar via

Como habilitar seu armazenamento persistente no plano de consumo Standard e dedicado dos Aplicativos Spring do Azure

  • Artigo

Observação

Os planos Básico, Standard e Enterprise serão preteridos a partir de meados de março de 2025, com um período de desativação de 3 anos. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para mais informações, confira o anúncio de desativação dos Aplicativos Spring do Azure.

O plano consumo e dedicado Standard será preterido a partir de 30 de setembro de 2024, com um desligamento completo após seis meses. Recomendamos a transição para os Aplicativos de Contêiner do Azure. Para mais informações, confira Migrar o plano dedicado e consumo Standard dos Aplicativos Spring do Azure para os Aplicativos de Contêiner do Azure.

Este artigo se aplica a:✅ consumo Standard e dedicado (Versão Prévia) ❎ Básico/Standard ❎ Enterprise

Este artigo descreve como habilitar seu próprio armazenamento persistente nos Aplicativos Spring do Azure.

Seu próprio armazenamento e o armazenamento persistente interno nos Aplicativos Spring do Azure diferem das seguintes maneiras:

  • No armazenamento interno, artefatos gerados pelo seu aplicativo são carregados para contas de armazenamento do Azure. No seu próprio armazenamento, artefatos gerados pelo seu aplicativo são enviados para uma conta de armazenamento que você controla.

  • No armazenamento interno, o Microsoft Azure controla a criptografia inativa e as políticas de gerenciamento do tempo de vida desses artefatos. No seu próprio armazenamento, você controla a política de criptografia inativa, a política de gerenciamento do tempo de vida e o acesso à rede.

Você também pode montar seu próprio armazenamento persistente não apenas nos Aplicativos Spring do Azure, mas também em outras instâncias de serviço no ambiente, como Aplicativos de Contêiner do Azure. Essa capacidade é possível porque sua instância dos Aplicativos Spring do Azure está implantada no ambiente dos Aplicativos de Contêiner do Azure.

Pré-requisitos

Configurar o ambiente

Use os seguintes comandos para definir as seguintes variáveis com os nomes dos seus recursos e a configuração da região atual.

export RESOURCE_GROUP="<resource-group-name>"
export LOCATION="eastus"
export AZURE_CONTAINER_APPS_ENVIRONMENT="<Azure-Container-Apps-environment-name>"
export AZURE_SPRING_APPS_INSTANCE="<Azure-Spring-Apps-instance-name>"
export APP_NAME="<Spring-app-name>"

Configurar uma conta de armazenamento

Use as seguintes etapas para criar uma conta de armazenamento e estabelecer um compartilhamento de arquivos para montar no aplicativo Spring.

  1. Crie uma conta de Armazenamento do Azure usando os seguintes comandos. A STORAGE_ACCOUNT_NAME variável inclui um sufixo gerado aleatoriamente para garantir a exclusividade.

    export STORAGE_ACCOUNT_NAME="myasastorageaccount$RANDOM"

az storage account create \
    --resource-group $RESOURCE_GROUP \
    --name $STORAGE_ACCOUNT_NAME \
    --location "$LOCATION" \
    --kind StorageV2 \
    --sku Standard_LRS \
    --query provisioningState \
    --enable-large-file-share

    Este comando retorna uma mensagem de sucesso após a conclusão bem-sucedida.

  2. Crie o compartilhamento de arquivos do Armazenamento do Azure usando os seguintes comandos:

    export FILE_SHARE_NAME="<file-share-name>"

az storage share-rm create \
    --resource-group $RESOURCE_GROUP \
    --storage-account $STORAGE_ACCOUNT_NAME \
    --name $FILE_SHARE_NAME \
    --quota 1024 \
    --enabled-protocols SMB \
    --output table

  3. Obtenha a chave da Conta de Armazenamento usando o seguinte comando:

    export STORAGE_ACCOUNT_KEY=$(az storage account keys list \
    --account-name $STORAGE_ACCOUNT_NAME \
    --query "[0].value" \
    --output tsv)

    A chave da conta de armazenamento é obrigatória para criar o link de armazenamento no seu ambiente de Aplicativos de Contêiner do Azure.

Crie o link de armazenamento no ambiente dos Aplicativos de Contêiner do Azure usando os seguintes comandos. O comando az containerapp env storage set cria um link entre o ambiente e o compartilhamento de arquivos criado com o comando az storage share-rm.

export STORAGE_MOUNT_NAME="<storage-account-name>"

az containerapp env storage set \
    --resource-group $RESOURCE_GROUP \
    --name $AZURE_CONTAINER_APPS_ENVIRONMENT \
    --storage-name $STORAGE_MOUNT_NAME \
    --azure-file-account-name $STORAGE_ACCOUNT_NAME \
    --azure-file-account-key $STORAGE_ACCOUNT_KEY \
    --azure-file-share-name $FILE_SHARE_NAME \
    --access-mode ReadWrite \
    --output table

Agora que a conta de armazenamento e o ambiente estão vinculados, você pode usar o ponto de montagem do armazenamento na sua instância dos Aplicativos Spring do Azure.

Adicionar armazenamento a um aplicativo.

Adicione o armazenamento persistente ao seu aplicativo existente usando o seguinte comando:

az spring app append-persistent-storage \
    --resource-group $RESOURCE_GROUP \
    --service $AZURE_SPRING_APPS_INSTANCE \
    --name $APP_NAME \
    --persistent-storage-type AzureFileVolume \
    --mount-path /var/log/nginx \
    --storage-name $STORAGE_MOUNT_NAME

Limpar recursos

Exclua os recursos que você criou neste artigo quando não precisar mais deles. Para excluir os recursos, basta excluir o grupo de recursos que os contém. Você pode excluir o grupo de recursos usando o portal do Azure. Como alternativa, para excluir o grupo de recursos usando a CLI do Azure, use os comandos a seguir:

echo "Enter the Resource Group name:" &&
read resourceGroupName &&
az group delete --name $resourceGroupName &&
echo "Press [ENTER] to continue ..."

Próximas etapas