Ciągłe wdrażanie za pomocą kontenerów niestandardowych w usłudze Azure App Service

Wybierz źródło kodu

Z menu rozwijanego Źródło wybierz źródło wdrożenia na podstawie następujących kryteriów:

• Usługa Container Registry konfiguruje ciągłą integrację/ciągłe wdrażanie między rejestrem kontenerów a usługą App Service.
• Wybierz opcję GitHub Actions , jeśli zachowasz kod źródłowy obrazu kontenera w usłudze GitHub. Nowe zatwierdzenia w repozytorium GitHub wyzwalają akcję wdrażania, która może być uruchamiana docker build i docker push bezpośrednio w rejestrze kontenerów. Następnie aktualizuje aplikację App Service, aby uruchomić nowy wizerunek. Aby uzyskać więcej informacji, zobacz Jak CI/CD działa z GitHub Actions (Jak działa ciągła integracja/ciągłe wdrażanie z GitHub Actions).
  • Aby skonfigurować CI/CD za pomocą narzędzia Azure Pipelines, zobacz Wdrażanie kontenera aplikacji internetowej na platformie Azure z narzędzia Azure Pipelines.
  • W przypadku aplikacji Docker Compose wybierz pozycję Container Registry.

Jeśli wybierzesz pozycję GitHub Actions, wybierz pozycję Autoryzuj i postępuj zgodnie z monitami autoryzacji. Jeśli wcześniej masz autoryzację w usłudze GitHub, możesz wdrożyć z repozytorium innego użytkownika, wybierając pozycję Zmień konto.

Po autoryzczeniu konta platformy Azure za pomocą usługi GitHub wybierz pozycję Organizacja, Repozytorium i Gałąź , z której chcesz wdrożyć.

Konfigurowanie ustawień rejestru

Konfigurowanie ustawień rejestru

Aby wdrożyć aplikację z wieloma kontenerami (Docker Compose), wybierz pozycję Docker Compose w polu Typ kontenera. Jeśli nie widzisz listy rozwijanej Typ kontenera , przewiń z powrotem do pozycji Źródło i wybierz pozycję Rejestr kontenerów.

Włączanie ciągłej integracji/ciągłego wdrażania

Włącz ciągłą integrację/ciągłe wdrażanie

Jak działa CI/CD przy użyciu GitHub Actions

Jeśli wybierzesz pozycję GitHub Actions z menu rozwijanego Wybierz źródło kodu , usługa App Service skonfiguruje ciągłą integrację/ciągłe wdrażanie na następujące sposoby:

• Umieszcza plik przepływu pracy funkcji GitHub Actions w repozytorium GitHub w celu obsługi zadań kompilacji i wdrażania w usłudze App Service.
• Dodaje poświadczenia dla Twojego prywatnego rejestru jako tajemnice GitHub. Wygenerowany plik przepływu pracy uruchamia akcję Azure/docker-login logowania do prywatnego rejestru. Uruchamia docker push w celu wdrożenia.
• Dodaje profil publikowania dla twojej aplikacji jako tajny wpis GitHub. Wygenerowany plik przepływu pracy używa tego sekretu do uwierzytelniania w ramach usługi App Service. Następnie uruchamia Azure/webapps-deploy akcję w celu skonfigurowania zaktualizowanego obrazu, co wyzwala ponowne uruchomienie aplikacji w celu ściągnięcia zaktualizowanego obrazu.
• Przechwytuje informacje z dzienników uruchamiania przepływu pracy i wyświetla je na karcie Dzienniki w Centrum wdrażania aplikacji.

Możesz dostosować dostawcę kompilacji funkcji GitHub Actions w następujący sposób:

• Dostosuj plik przepływu pracy po jego wygenerowaniu w repozytorium GitHub. Aby wyzwolić ponowne uruchomienie aplikacji, przepływ pracy musi zakończyć się akcją Azure/webapps-deploy . Aby uzyskać więcej informacji, zobacz Składnia przepływu pracy dla funkcji GitHub Actions.
• Jeśli wybrana gałąź jest chroniona, nadal można wyświetlić podgląd pliku przepływu pracy bez zapisywania konfiguracji. Dodaj to oraz wymagane tajne informacje GitHub do repozytorium ręcznie. Ta metoda nie zapewnia integracji dziennika z witryną Azure Portal.
• Zamiast profilu publikowania, wdrażaj, używając zasadniczej usługi w Microsoft Entra ID.

Uwierzytelnianie za pomocą głównego identyfikatora usługi

Ta opcjonalna konfiguracja zastępuje domyślne uwierzytelnianie profilami publikowania w wygenerowanych plikach przepływu pracy.

Wygeneruj jednostkę usługi przy użyciu az ad sp create-for-rbac polecenia w interfejsie wiersza polecenia platformy Azure. W poniższym przykładzie zastąp <subscription-id>, <group-name> i <app-name> własnymi wartościami. Zapisz całe dane wyjściowe JSON w następnym kroku, w tym najwyższego poziomu {}.

az ad sp create-for-rbac --name "myAppDeployAuth" --role contributor \
                            --scopes /subscriptions/<subscription-id>/resourceGroups/<group-name>/providers/Microsoft.Web/sites/<app-name> \
                            --json-auth

W GitHubie przejdź do swojego repozytorium, a następnie wybierz pozycję Ustawienia>Sekrety>Dodaj nowy sekret. Wklej całe dane wyjściowe JSON z polecenia Azure CLI do pola wartości sekretu. Nadaj wpisowi tajnym nazwę, taką jak AZURE_CREDENTIALS.

W pliku przepływu pracy wygenerowany przez Centrum wdrażania popraw azure/webapps-deploy krok za pomocą kodu podobnego do następującego przykładu:

- name: Sign in to Azure 
# Use the GitHub secret you added
- uses: azure/login@v1
    with:
    creds: ${{ secrets.AZURE_CREDENTIALS }}
- name: Deploy to Azure Web App
# Remove publish-profile
- uses: azure/webapps-deploy@v2
    with:
    app-name: '<app-name>'
    slot-name: 'production'
    images: '<registry-server>/${{ secrets.AzureAppService_ContainerUsername_... }}/<image>:${{ github.sha }}'
    - name: Sign out of Azure
    run: |
    az logout

Aby skonfigurować aplikację z wieloma kontenerami (Docker Compose), przygotuj lokalnie plik Docker Compose, a następnie uruchom az webapp config container set z parametrem --multicontainer-config-file. Jeśli plik Docker Compose zawiera obrazy prywatne, dodaj parametry --docker-registry-server-*, jak pokazano w poprzednim przykładzie.

az webapp config container set --resource-group <group-name> --name <app-name> --multicontainer-config-file <docker-compose-file>