Entwurf für Azure Kubernetes Service (AKS) (Vorschau)

Draft ist ein Open-Source-Projekt, das die Kubernetes-Entwicklung optimiert, indem eine nicht containerisierte Anwendung verwendet und dockerfiles, Kubernetes-Manifeste, Helmdiagramme, Kustomize-Konfigurationen und andere Artefakte generiert werden, die einer containerisierten Anwendung zugeordnet sind. Draft kann auch eine GitHub-Aktionsworkflowdatei erstellen, um Anwendungen schnell auf jedem Kubernetes-Cluster zu bauen und bereitzustellen.

Funktionsweise

Draft verfügt über die folgenden Befehle, um Ihre Entwicklung für Kubernetes zu vereinfachen:

• draft create: Erstellt das Dockerfile und die richtigen Manifestdateien.
• draft setup-gh: Richtet Ihre GitHub OIDC ein.
• draft generate-workflow: Generiert die GitHub Aktionsworkflowdatei für die Bereitstellung in Ihrem Cluster.
• draft up: Richtet Ihre GitHub OIDC ein und generiert eine GitHub Aktionsworkflowdatei, wobei die beiden vorherigen Befehle kombiniert werden.

Voraussetzungen

• Wenn Sie kein Azure-Abonnement haben, erstellen Sie ein free-Konto, bevor Sie beginnen.
• Installieren Sie die neueste Version der Azure CLI und die Erweiterung aks-preview.
• Wenn Sie noch keines haben, müssen Sie einen AKS-Cluster und eine Azure Container Registry Instanz erstellen.

Installieren der Erweiterung aks-preview Azure CLI

1. Installieren Sie die „aks-preview“-Erweiterung mithilfe des Befehls „az extension add“.

   az extension add --name aks-preview
   

2. Aktualisieren Sie die Erweiterung mit dem Befehl az extension update, um sicherzustellen, dass Sie über die neueste Version verfügen.

   az extension update --name aks-preview
   

Erstellen von Artefakten mithilfe von draft create

Sie können draft create verwenden, um Dockerfiles, Helm-Diagramme, Kubernetes-Manifeste oder Kustomize-Dateien zu erstellen, die zum Bereitstellen Ihrer Anwendung in einem AKS-Cluster benötigt werden.

• Erstellen Sie mit dem Befehl az aks draft create ein Artefakt.

  az aks draft create
  

  • Sie können den Befehl auch in einem bestimmten Verzeichnis ausführen, indem Sie das --destination-Flag verwenden, wie im folgenden Beispiel gezeigt:

    az aks draft create --destination /Workspaces/ContosoAir
    

Einrichten von GitHub OIDC mit draft setup-gh

Um "Entwurf" zu verwenden, müssen Sie Ihre Anwendung mit GitHub mit draft setup-gh registrieren. Dieser Schritt ist nur einmal pro Repository erforderlich.

• Registrieren Sie Ihre Anwendung mit GitHub mithilfe des Befehls az aks draft setup-gh.

  az aks draft setup-gh
  

Generieren einer GitHub-Aktionsworkflowdatei für die Bereitstellung mithilfe von draft generate-workflow

Nachdem Sie Ihre Artefakte erstellt und GitHub OIDC eingerichtet haben, können Sie draft generate-workflow verwenden, um eine GitHub Aktionsworkflowdatei zu generieren und eine Aktion zu erstellen, die Ihre Anwendung auf Ihrem AKS-Cluster bereitstellt. Nachdem die Workflowdatei generiert wurde, müssen Sie sie in Ihr Repository committen, um die GitHub-Aktion zu initiieren.

• Generieren Sie eine GitHub Aktionsworkflowdatei mithilfe des Befehls az aks draft generate-workflow.

  az aks draft generate-workflow
  

  • Sie können den Befehl auch in einem bestimmten Verzeichnis ausführen, indem Sie das --destination-Flag verwenden, wie im folgenden Beispiel gezeigt:

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

Richten Sie GitHub OpenID Connect (OIDC) ein und generieren Sie eine GitHub Action-Workflowdatei mit draft up

draft up ist ein einzelner Befehl, um GitHub OIDC-Setup auszuführen und eine GitHub Aktionsworkflowdatei für die Bereitstellung zu generieren. Der Befehl kombiniert im Prinzip die Befehle draft setup-gh und draft generate-workflow. Er wird daher in der Regel bei den ersten Schritten in einem neuen Repository verwendet und muss nur einmal ausgeführt werden. Nachfolgende Aktualisierungen der GitHub Aktionsworkflowdatei können mit draft generate-workflow erfolgen.

• Richten Sie GitHub OIDC ein, und generieren Sie mithilfe des Befehls az aks draft up eine GitHub Aktionsworkflowdatei.

  az aks draft up
  

  • Sie können den Befehl auch in einem bestimmten Verzeichnis ausführen, indem Sie das --destination-Flag verwenden, wie im folgenden Beispiel gezeigt:

    az aks draft up --destination /Workspaces/ContosoAir
    

Verwenden von Anwendungsrouting mit Draft, um Ihre Anwendung über das Internet zugänglich zu machen

Anwendungsrouting ist die einfachste Möglichkeit, Ihre Webanwendung sicher in Kubernetes zu starten und auszuführen. Durch das Anwendungsrouting entfällt die Komplexität, die durch Eingangsdatencontroller und die Zertifikat- und DNS-Verwaltung verursacht wird. Außerdem erhalten Unternehmen, die ihre eigenen Lösungen einbringen möchten, Konfigurationsmöglichkeiten. Das Anwendungsrouting bietet einen verwalteten Ingress-Controller auf NGINX-Basis, den Sie ohne Einschränkungen verwenden können und der ohne weitere Anpassungen in Open Service Mesh integriert ist, um die Kommunikation innerhalb des Clusters zu sichern.

• Richten Sie Draft mit Anwendungsrouting ein, indem Sie az aks draft update verwenden und den DNS-Namen sowie das im Azure Key Vault gespeicherte Zertifikat übermitteln, wenn dazu aufgefordert.

  az aks draft update
  

  • Sie können den Befehl auch in einem bestimmten Verzeichnis ausführen, indem Sie das --destination-Flag verwenden, wie im folgenden Beispiel gezeigt:

    az aks draft update --destination /Workspaces/ContosoAir