Share via

Automatize tarefas com a CLI do Azure

  • Artigo

Automatizar tarefas do Azure é um requisito comum para implantação contínua em ambientes de hospedagem. A CLI do Azure é a escolha recomendada para desenvolvedores JavaScript gerenciando tarefas e implantando de qualquer local.

Aprenda comandos de tarefas comuns para desenvolvedores JavaScript.

Automação com a CLI do Azure

Para automatizar a CLI do Azure, a CLI deve ser instalada no ambiente. Os métodos comuns são:

Usando os comandos de exemplo

  1. Substitua variáveis entre parênteses, , <...>pelos seus próprios valores.
  2. O valor do repositório GitHub for <MY_GITHUB_DEFAULT_BRANCH_NAME> é específico para o repositório usado. Atualmente, os valores típicos são main, ou default. Repositórios mais antigos podem usar mastero .

Autenticação com identidade gerenciada para tarefas automatizadas com a CLI do Azure

Para automação, autenticação com az login na CLI do Azure com identidade gerenciada.

az login --identity

Autenticação com entidade de serviço para tarefas automatizadas com a CLI do Azure

Depois que a Entidade de Serviço for criada, faça login com a Entidade de Serviço de um usuário.

read -sp "Azure password: " AZ_PASS && echo && \ 
    az login --service-principal \
    -u <MY-SP-APP-URL> \
    -p $AZ_PASS \
    --tenant <MY-TENANT>

Autenticação com credenciais de usuário para tarefas automatizadas com a CLI do Azure

Use o comando a seguir para autenticar com credenciais de usuário.

az login -u <MY_AZURE_USERNAME> -p <MY_AZURE_PASSWORD>

Criar grupo de recursos para recursos

Um grupo de recursos é uma coleção lógica de seus recursos do Azure. O agrupamento lógico é baseado nos serviços necessários em uma região específica para um projeto. Saiba mais sobre convenções de nomenclatura. Use o comando az group create para criar seu grupo de recursos antes de criar recursos de serviço do Azure.

az group create \
    --name <MY-AZURE-RESOURCE_GROUP_NAME> \
    --location <AZURE_REGION_LOCATION>

Criar aplicativo Web estático do Azure

Use o comando az staticwebapp create para criar um novo aplicativo Web estático.

az staticwebapp create \
    --name <MY_AZURE_WEB_APP_NAME> \
    --resource-group <MY-AZURE-RESOURCE_GROUP_NAME> \
    --source https://github.com/<MY_GITHUB_ACCOUNT_NAME>/<MY_AZURE_WEB_APP_NAME> \
    --location <AZURE_REGION_LOCATION> \
    --branch <MY_GITHUB_DEFAULT_BRANCH_NAME> \
    --app-artifact-location "<MY_WEB_APP_BUILD_DIRECTORY_NAME>" \
    --token <MY_GITHUB_PERSONAL_ACCESS_TOKEN>

Implantar o aplicativo Web estático do Azure

Para implantar seu aplicativo, envie por push para o conjunto de ramificações remotas do GitHub durante a criação de recursos no conjunto anterior.

git push <REMOTE_NAME> <MY_GITHUB_DEFAULT_BRANCH_NAME>

Um exemplo deste comando é:

git push origin main

Excluir aplicativo Web estático

Use o comando az staticwebapp delete para excluir seu aplicativo Web estático.

az staticwebapp delete && \
    --name <MY_AZURE_WEB_APP_NAME> && \
    --resource-group <MY-AZURE-RESOURCE_GROUP_NAME>

Criar aplicativo Azure Function

Um aplicativo de função baseado em consumo precisa do aplicativo de função e de um recurso de armazenamento.

  1. Crie o recurso de armazenamento com az storage account create:

    az storage account create \
  --name <MY-AZURE-STORAGE> \
  --location <AZURE_REGION_LOCATION> \
  --resource-group <MY-AZURE-RESOURCE_GROUP_NAME> \
  --sku Standard_LRS

  2. Crie o recurso de aplicativo de função com az functionapp create:

    az functionapp create \
  --name <MY-AZURE-FUNCTION> \
  --storage-account <MY-AZURE-STORAGE> \
  --consumption-plan-location <AZURE_REGION_LOCATION> \
  --resource-group <MY-AZURE-RESOURCE_GROUP_NAME> \
  --functions-version 2

Criar ponto de extremidade da API do Azure Function

Não há um comando da CLI do Azure para criar um ponto de extremidade da API do Azure Function para seu projeto de desenvolvimento local . A extensão Visual Studio Code Azure Function é a maneira recomendada de criar um projeto local do Azure Function e adicionar pontos de extremidade de API ao projeto.

Criar slot de implantação do Azure Function

Criar um slot de implantação e, em seguida, trocar permite que você reverta rapidamente uma implantação. Crie uma implantação lenta com o comando az functionapp deployment slot create .

az functionapp deployment slot create \
    --name <MY-AZURE-FUNCTION> \
    --resource-group <MY-AZURE-RESOURCE_GROUP_NAME> \
    --slot <MY-SLOT-NAME> \
    --configuration-source <MY-PRODUCTION-SLOT>

Implantar o Azure Function a partir do git

Gerencie a implantação a partir de repositórios git ou Mercurial com az functionapp deployment source config. Selecione um tipo de repositório para a --repository-type configuração entre as opções: externalgit, git, github, localgit, mercurial.

az functionapp deployment source config --repo-url \
    --branch <MY-REPO-BRANCH> \
    --git-token <MY-GIT-TOKEN> \
    --name <MY-AZURE-FUNCTION> \
    --repository-type <MY-REPO-TYPE> \
    --resource-group <MY-AZURE-RESOURCE_GROUP_NAME> \
    --slot <MY-SLOT-NAME> \

Trocar slots do Azure Function

Use o comando az functionapp deployment slot swap para trocar slots. As opções de ação do slot são: visualização, redefinição, troca

az functionapp deployment slot swap \
    --resource-group <MY-AZURE-RESOURCE_GROUP_NAME> \
    --name <MY-AZURE-FUNCTION> \
    --slot <MY-SLOT-NAME> \
    --action <YOUR-ACTION> \
    --target-slot <MY-OTHER-SLOT-NAME>

Excluir função do Azure

Use o comando [az functionapp delete] para excluir seu aplicativo de função.

az functionapp delete \
    --resource-group <MY-AZURE-RESOURCE_GROUP_NAME> \
    --name <MY-AZURE-FUNCTION>

Próximos passos