Automatyzowanie zadań za pomocą interfejsu wiersza polecenia platformy Azure

  • Artykuł

Automatyzacja zadań platformy Azure jest typowym wymaganiem dla ciągłego wdrażania w środowiskach hostujących. Interfejs wiersza polecenia platformy Azure jest zalecanym wyborem dla deweloperów języka JavaScript, którzy zarządzają zadaniami i wdrażają je z dowolnej lokalizacji.

Poznaj typowe polecenia zadań dla deweloperów języka JavaScript.

Automatyzacja za pomocą interfejsu wiersza polecenia platformy Azure

Aby zautomatyzować interfejs wiersza polecenia platformy Azure, interfejs wiersza polecenia musi być zainstalowany w środowisku. Typowe metody to:

Używanie przykładowych poleceń

  1. Zastąp zmienne w nawiasach kwadratowych własnymi <...>wartościami.
  2. Wartość <MY_GITHUB_DEFAULT_BRANCH_NAME> repozytorium GitHub jest specyficzna dla używanego repozytorium. Obecnie typowe wartości to main, lub default. Starsze repozytoria mogą używać polecenia master.

Uwierzytelnianie przy użyciu tożsamości zarządzanej na potrzeby zautomatyzowanych zadań za pomocą interfejsu wiersza polecenia platformy Azure

W przypadku automatyzacji uwierzytelnianie za pomocą polecenia az login do interfejsu wiersza polecenia platformy Azure przy użyciu tożsamości zarządzanej.

az login --identity

Uwierzytelnianie za pomocą jednostki usługi na potrzeby zautomatyzowanych zadań za pomocą interfejsu wiersza polecenia platformy Azure

Po utworzeniu jednostki usługi zaloguj się przy użyciu jednostki usługi użytkownika.

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

Uwierzytelnianie przy użyciu poświadczeń użytkownika na potrzeby zautomatyzowanych zadań za pomocą interfejsu wiersza polecenia platformy Azure

Użyj następującego polecenia, aby uwierzytelnić się przy użyciu poświadczeń użytkownika.

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

Tworzenie grupy zasobów dla zasobów

Grupa zasobów to logiczna kolekcja zasobów platformy Azure. Grupowanie logiczne jest oparte na usługach potrzebnych w określonym regionie dla projektu. Dowiedz się więcej o konwencjach nazewnictwa. Użyj polecenia az group create, aby utworzyć grupę zasobów przed utworzeniem zasobów usługi platformy Azure.

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

Tworzenie statycznej aplikacji internetowej platformy Azure

Użyj polecenia az staticwebapp create, aby utworzyć nową statyczną aplikację internetową.

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>

Wdrażanie statycznej aplikacji internetowej platformy Azure

Aby wdrożyć aplikację, wypchnij do zdalnego zestawu gałęzi GitHub podczas tworzenia zasobów w poprzednim zestawie.

git push <REMOTE_NAME> <MY_GITHUB_DEFAULT_BRANCH_NAME>

Przykładem tego polecenia jest:

git push origin main

Usuwanie statycznej aplikacji internetowej

Użyj polecenia az staticwebapp delete, aby usunąć statyczną aplikację internetową.

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

Tworzenie aplikacji funkcji platformy Azure

Aplikacja funkcji oparta na użyciu wymaga zarówno aplikacji funkcji, jak i zasobu magazynu.

  1. Utwórz zasób magazynu za pomocą polecenia 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. Utwórz zasób aplikacji funkcji za pomocą polecenia 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

Tworzenie punktu końcowego interfejsu API funkcji platformy Azure

Nie ma polecenia interfejsu wiersza polecenia platformy Azure służącego do tworzenia punktu końcowego interfejsu API funkcji platformy Azure dla lokalnego projektu programistycznego . Rozszerzenie funkcji platformy Azure programu Visual Studio Code jest zalecanym sposobem tworzenia lokalnego projektu funkcji platformy Azure i dodawania punktów końcowych interfejsu API do projektu.

Tworzenie miejsca wdrożenia funkcji platformy Azure

Utworzenie miejsca wdrożenia, a następnie zamiana umożliwia szybkie przywrócenie wdrożenia. Utwórz wdrożenie wolno za pomocą polecenia 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>

Wdrażanie funkcji platformy Azure z usługi git

Zarządzanie wdrożeniem z repozytoriów git lub Mercurial za pomocą polecenia az functionapp deployment source config. Wybierz jeden typ repozytorium dla --repository-type ustawienia z opcji: 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> \

Zamiana miejsc funkcji platformy Azure

Użyj polecenia az functionapp deployment slot swap, aby zamienić miejsca. Opcje akcji miejsca to: podgląd, resetowanie, zamiana

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>

Usuwanie funkcji platformy Azure

Użyj polecenia [az functionapp delete], aby usunąć aplikację funkcji.

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

Następne kroki