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

  • Artikel

Draft ist ein Open-Source-Projekt zur Optimierung der Kubernetes-Entwicklung, das die Dockerfiles, Kubernetes-Manifeste, Helm-Charts, Kustomize-Konfigurationen und andere Artefakte containerisierter Anwendungen für eine nicht containerisierte Anwendung generiert. Von Draft kann auch eine GitHub Actions-Workflowdatei erstellt werden, um Anwendungen schnell zu erstellen und in einem beliebigen Kubernetes-Cluster 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 GitHub OIDC ein.
  • draft generate-workflow: Generiert die GitHub Actions-Workflowdatei für die Bereitstellung in Ihrem Cluster.
  • draft up: Richtet GitHub OIDC ein und generiert eine GitHub Actions-Workflowdatei. Hierbei handelt es sich also um eine Kombination der beiden vorherigen Befehle.

Voraussetzungen

  • Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.
  • Bevor Sie beginnen, installieren Sie die neueste Version der Azure-Befehlszeilenschnittstelle und die Erweiterung aks-preview.
  • Wenn Sie noch keinen besitzen, müssen Sie einen solchen AKS-Cluster sowie eine Azure Container Registry-Instanz erstellen.

Installieren der Azure CLI-Erweiterung aks-preview

Wichtig

AKS-Previewfunktionen stehen gemäß dem Self-Service- und Aktivierungsprinzip zur Verfügung. Vorschauversionen werden „wie besehen“ und „wie verfügbar“ bereitgestellt und sind von den Vereinbarungen zum Service Level und der eingeschränkten Garantie ausgeschlossen. AKS-Vorschauversionen werden teilweise vom Kundensupport auf Grundlage der bestmöglichen Leistung abgedeckt. Daher sind diese Funktionen nicht für die Verwendung in der Produktion vorgesehen. Weitere Informationen finden Sie in den folgenden Supportartikeln:

  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 mithilfe von draft setup-gh

Um Draft verwenden zu können, müssen Sie Ihre Anwendung mithilfe von draft setup-gh bei GitHub registrieren. Dieser Schritt ist nur einmal pro Repository erforderlich.

Generieren einer GitHub Actions-Workflowdatei 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 Actions-Workflowdatei mit einer Aktion zu generieren, die Ihre Anwendung in Ihrem AKS-Cluster bereitstellt. Nachdem Ihre Workflowdatei generiert wurde, müssen Sie sie in Ihrem Repository committen, um die GitHub-Aktion zu initiieren.

  • Generieren Sie eine GitHub Actions-Workflowdatei mit dem Befehl 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

Einrichten von GitHub OpenID Connect (OIDC) und Generieren einer GitHub Actions-Workflowdatei mithilfe von draft up

draft up ermöglicht es, mit nur einem Befehl GitHub OIDC einzurichten und eine GitHub Actions-Workflowdatei 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. Für nachfolgende Aktualisierungen der GitHub Actions-Workflowdatei kann draft generate-workflow verwendet werden.

  • Richten Sie GitHub OIDC ein, und generieren Sie eine GitHub Actions-Workflowdatei mit dem Befehl az aks draft up.

    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] Das Anwendungsrouting ist die einfachste Möglichkeit, Ihre Webanwendung sicher und ordnungsgemäß in Kubernetes 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. Anwendungsrouting bietet einen verwalteten NGINX-basierten Eingangsdatencontroller, den Sie ohne Einschränkungen verwenden können und der sich zum Schutz der clusterinternen Kommunikation ohne weitere Anpassung in Open Service Mesh integrieren lässt.

  • Verwenden Sie az aks draft update, und übergeben Sie bei entsprechender Aufforderung den DNS-Namen und das in Azure Key Vault gespeicherte Zertifikat, um Draft mit Anwendungsrouting einzurichten.

    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