Partilhar via

Guia de início rápido: automatize implantações

Nota

Os planos Basic, Standarde 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.

Este artigo aplica-se a: ❎ Basic/Standard ✅ Enterprise

Este guia de início rápido mostra como automatizar implantações para o plano do Azure Spring Apps Enterprise usando o GitHub Actions e o Terraform.

Pré-requisitos

  • Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
  • A CLI do Azure versão 2.45.0 ou superior.
  • Git.
  • JQ
  • A extensão do plano do Azure Spring Apps Enterprise. Use o comando a seguir para remover versões anteriores e instalar a extensão de plano Enterprise mais recente. Se você instalou spring-cloud a extensão anteriormente, desinstale-a para evitar incompatibilidades de configuração e versão. 
    az extension add --upgrade --name spring
az extension remove --name spring-cloud

Configurar um repositório GitHub e autenticar

A automação associada ao aplicativo de exemplo requer uma conta de armazenamento para manter o estado Terraform. As etapas a seguir mostram como criar uma conta de armazenamento para uso com o GitHub Actions e o Terraform.

  1. Use o seguinte comando para criar um novo grupo de recursos para conter a Conta de Armazenamento:

    az group create \
    --name <storage-resource-group> \
    --location <location>

  2. Use o seguinte comando para criar uma conta de armazenamento:

    az storage account create \
    --resource-group <storage-resource-group> \
    --name <storage-account-name> \
    --location <location> \
    --sku Standard_RAGRS \
    --kind StorageV2

  3. Use o seguinte comando para criar um contêiner de armazenamento na conta de armazenamento:

    az storage container create \
    --resource-group <storage-resource-group> \
    --name terraform-state-container \
    --account-name <storage-account-name> \
    --auth-mode login

  4. Use os comandos a seguir para obter uma credencial do Azure. Você precisa de uma credencial de entidade de serviço do Azure para autorizar a ação de início de sessão no Azure.

    az login
az ad sp create-for-rbac \
    --role contributor \
    --scopes /subscriptions/<SUBSCRIPTION_ID> \
    --json-auth

    O comando deve gerar um objeto JSON:

    {
    "clientId": "<GUID>",
    "clientSecret": "<GUID>",
    "subscriptionId": "<GUID>",
    "tenantId": "<GUID>",
    ...
}

  5. Este exemplo utiliza a amostra de loja de artigos de fitness no GitHub. Bifurque o exemplo, abra a página do repositório GitHub e selecione a guia Configurações. Abra o menu Segredos e selecione Adicionar um novo segredo, conforme mostrado na captura de tela a seguir.

    Captura de tela mostrando as configurações do GitHub Adicionar novo segredo.

  6. Defina o nome secreto como AZURE_CREDENTIALS e defina seu valor para a cadeia de caracteres JSON que você encontrou sob o título Configurar seu repositório GitHub e autenticar.

    Captura de tela mostrando as configurações do GitHub Definir dados secretos.

  7. Adicione os seguintes segredos às Ações do GitHub:

  8. Adicione o segredo TF_BACKEND_CONFIG às Ações do GitHub com o seguinte valor:

    resource_group_name  = "<storage-resource-group>"
storage_account_name = "<storage-account-name>"
container_name       = "terraform-state-container"
key                  = "dev.terraform.tfstate"

Automatize com ações do GitHub

Agora você pode executar ações do GitHub em seu repositório. O fluxo de trabalho de provisionamento provisiona todos os recursos necessários para executar o aplicativo de exemplo. A captura de tela a seguir mostra um exemplo de execução:

Captura de tela do GitHub mostrando a saída do fluxo de trabalho de provisionamento.

Cada aplicativo tem um fluxo de trabalho de implantação que reimplantará o aplicativo quando forem feitas alterações nesse aplicativo. A captura de tela a seguir mostra alguns exemplos de saída do serviço de catálogo:

Captura de tela do GitHub mostrando a saída do fluxo de trabalho Implantar catálogo.

O fluxo de trabalho de limpeza pode ser executado manualmente para excluir todos os recursos criados pelo provision fluxo de trabalho. A captura de tela a seguir mostra a saída:

Captura de tela do GitHub mostrando a saída do fluxo de trabalho de limpeza.

Limpar recursos

Se você planeja continuar trabalhando com guias de início rápido e tutoriais subsequentes, convém deixar esses recursos no lugar. Quando não for mais necessário, exclua o grupo de recursos, que exclui os recursos do grupo de recursos. Para excluir o grupo de recursos usando a CLI do Azure, use os seguintes comandos:

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

Próximos passos

Continue para qualquer um dos seguintes inícios rápidos opcionais:

  • Last updated on