Wersja robocza dla Azure Kubernetes Service (AKS) (wersja zapoznawcza)

Draft jest projektem typu open source, który usprawnia tworzenie aplikacji na Kubernetes, generując z niekonteneryzowanej aplikacji Dockerfile, manifesty Kubernetes, wykresy Helm, konfiguracje Kustomize i inne artefakty związane z aplikacją konteneryzowaną. Wersja robocza może również utworzyć plik workflow GitHub Actions, umożliwiający szybkie kompilowanie i wdrażanie aplikacji w dowolnym klastrze Kubernetes.

Jak to działa

Wersja robocza zawiera następujące polecenia, które ułatwiają programowanie na platformie Kubernetes:

  • draft create: tworzy plik Dockerfile i stosowne pliki manifestów.
  • draft setup-gh: Konfiguruje GitHub OIDC.
  • draft generate-workflow: Generuje plik przepływu pracy GitHub Action do wdrażania w twoim klastrze.
  • draft up: Konfiguruje GitHub OIDC i generuje plik przepływu pracy GitHub Action, łącząc dwa poprzednie polecenia.

Wymagania wstępne

  • Jeśli nie masz subskrypcji Azure, przed rozpoczęciem utwórz konto free.
  • Zainstaluj najnowszą wersję rozszerzenia Azure CLI i aks-preview.
  • Jeśli jeszcze go nie masz, powinieneś utworzyć klaster AKS i jedno wystąpienie Azure Container Registry.

Instalowanie rozszerzenia aks-preview Azure CLI

Ważne

Funkcje usługi AKS w wersji zapoznawczej są dostępne na zasadzie samoobsługi i wymagają zapisania się. Wersje zapoznawcze są udostępniane w wersji "as is" i "jako dostępne" i są wykluczone z umów dotyczących poziomu usług i ograniczonej gwarancji. Wersje zapoznawcze usługi AKS są częściowo objęte wsparciem technicznym dla klientów w miarę możliwości. W związku z tym te funkcje nie są przeznaczone do użytku produkcyjnego. Aby uzyskać więcej informacji, zobacz następujące artykuły pomocy technicznej:

  1. Zainstaluj rozszerzenie aks-preview przy użyciu polecenia az extension add.

    az extension add --name aks-preview
    
  2. Zaktualizuj rozszerzenie, aby upewnić się, że masz najnowszą wersję przy użyciu az extension update polecenia .

    az extension update --name aks-preview
    

Tworzenie artefaktów przy użyciu polecenia draft create

Możesz użyć draft create do utworzenia plików Dockerfile, wykresów Helm, manifestów Kubernetes lub plików Kustomize potrzebnych do wdrożenia aplikacji w klastrze AKS.

  • Utwórz artefakt przy użyciu az aks draft create polecenia .

    az aks draft create
    
    • Możesz również uruchomić polecenie w określonym katalogu przy użyciu flagi --destination , jak pokazano w poniższym przykładzie:

      az aks draft create --destination /Workspaces/ContosoAir
      

Konfigurowanie GitHub OIDC przy użyciu draft setup-gh

Aby użyć wersji roboczej, musisz zarejestrować aplikację w GitHub przy użyciu draft setup-gh. Ten krok należy wykonać tylko raz dla repozytorium.

  • Zarejestruj aplikację przy użyciu GitHub przy użyciu polecenia az aks draft setup-gh.

    az aks draft setup-gh
    

Generowanie pliku workflowu GitHub Action do wdrożenia przy użyciu draft generate-workflow

Po utworzeniu artefaktów i skonfigurowaniu GitHub OIDC można użyć draft generate-workflow do wygenerowania pliku workflow GitHub Action, co umożliwia stworzenie akcji wdrażającej aplikację w klastrze AKS. Po wygenerowaniu pliku przepływu pracy musisz zatwierdzić go w repozytorium, aby zainicjować akcję GitHub.

  • Użyj polecenia az aks draft generate-workflow, aby wygenerować plik workflow GitHub Action.

    az aks draft generate-workflow
    
    • Możesz również uruchomić polecenie w określonym katalogu przy użyciu flagi --destination , jak pokazano w poniższym przykładzie:

      az aks draft generate-workflow --destination /Workspaces/ContosoAir
      

Skonfiguruj protokół GitHub OpenID Connect (OIDC) i wygeneruj plik przepływu pracy akcji GitHub przy użyciu draft up

draft up to pojedyncze polecenie używane do skonfigurowania OIDC na GitHub i wygenerowania pliku workflow GitHub Actions na potrzeby wdrożenia. Skutecznie łączy polecenia draft setup-gh i draft generate-workflow , co oznacza, że jest najczęściej używany podczas rozpoczynania pracy w nowym repozytorium po raz pierwszy i musi być uruchamiany tylko raz. Kolejne aktualizacje pliku przepływu pracy akcji GitHub można wykonać przy użyciu draft generate-workflow.

  • Skonfiguruj GitHub OIDC i wygeneruj plik przepływu pracy akcji GitHub przy użyciu polecenia az aks draft up.

    az aks draft up
    
    • Możesz również uruchomić polecenie w określonym katalogu przy użyciu flagi --destination , jak pokazano w poniższym przykładzie:

      az aks draft up --destination /Workspaces/ContosoAir
      

Użyj routingu aplikacji z wersją roboczą, aby umożliwić dostęp do aplikacji przez Internet

Routing aplikacji to najprostszy sposób bezpiecznego uruchamiania aplikacji internetowej na platformie Kubernetes. Routing aplikacji usuwa złożoność związaną z kontrolerami ruchu przychodzącego oraz zarządzaniem certyfikatami i DNS, a także oferuje możliwości konfiguracji dla przedsiębiorstw, które chcą korzystać z własnych rozwiązań. Routing aplikacji oferuje zarządzany kontroler ruchu przychodzącego oparty na nginx, który można używać bez ograniczeń, a także integruje się od razu z Open Service Mesh, aby zabezpieczyć komunikację wewnątrz klastra.

  • Skonfiguruj wersję roboczą z routingiem aplikacji za pomocą az aks draft update i po wyświetleniu monitu przekaż nazwę DNS oraz certyfikat przechowywany w Azure Key Vault.

    az aks draft update
    
    • Możesz również uruchomić polecenie w określonym katalogu przy użyciu flagi --destination , jak pokazano w poniższym przykładzie:

      az aks draft update --destination /Workspaces/ContosoAir