Share via


Draft pour Azure Kubernetes Service (AKS) (préversion)

Draft est un projet open source qui simplifie le développement Kubernetes en prenant une application non conteneurisée et en générant les fichiers Dockerfiles, les manifestes Kubernetes, les graphiques Helm, les configurations Kustomize, ainsi que d’autres artefacts associés à une application conteneurisée. Draft peut également créer un fichier de flux de travail GitHub Action pour générer et déployer rapidement des applications sur n’importe quel cluster Kubernetes.

Fonctionnement

Draft comporte les commandes suivantes pour faciliter votre développement sur Kubernetes :

  • draft create : crée le fichier Dockerfile et les fichiers manifeste appropriés.
  • draft setup-gh : configure votre GitHub OIDC.
  • draft generate-workflow : génère le fichier de flux de travail GitHub Action pour le déploiement sur votre cluster.
  • draft up : configure votre GitHub OIDC et génère un fichier de flux de travail GitHub Action, en combinant les deux commandes précédentes.

Prérequis

  • Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.
  • Installez la dernière version d’Azure CLI et de l’extension aks-preview.
  • Si vous n’en avez pas déjà, vous devez créer un cluster AKS et une instance Azure Container Registry.

Installer l’extension Azure CLI aks-preview

Important

Les fonctionnalités d’évaluation AKS sont disponibles en libre-service et font l’objet d’un abonnement. Les préversions sont fournies « en l’état » et « en fonction des disponibilités », et sont exclues des contrats de niveau de service et de la garantie limitée. Les préversions AKS sont, dans la mesure du possible, partiellement couvertes par le service clientèle. Telles quelles, ces fonctionnalités ne sont pas destinées à une utilisation en production. Pour plus d’informations, consultez les articles de support suivants :

  1. Installez l'extension aks-preview à l'aide de la commande az extension add.

    az extension add --name aks-preview
    
  2. Mettez à jour l’extension pour vous assurer que vous disposez de la dernière version à l’aide de la commande az extension update.

    az extension update --name aks-preview
    

Créer des artefacts avec draft create

Vous pouvez utiliser draft create pour créer des Dockerfiles, des graphiques Helm, des manifestes Kubernetes ou des fichiers Kustomize nécessaires au déploiement de votre application sur un cluster AKS.

  • Créez un artefact à l’aide de la commande az aks draft create.

    az aks draft create
    
    • Vous pouvez également exécuter la commande sur un répertoire spécifique à l’aide de l’indicateur --destination, comme illustré dans l’exemple suivant :

      az aks draft create --destination /Workspaces/ContosoAir
      

Configurer GitHub OIDC à l’aide de draft setup-gh

Pour utiliser Draft, vous devez inscrire votre application auprès de GitHub à l’aide de draft setup-gh. Cette étape ne doit être effectuée qu’une fois par référentiel.

  • Inscrivez votre application auprès de GitHub à l’aide de la commande az aks draft setup-gh.

    az aks draft setup-gh
    

Générer un fichier de flux de travail GitHub Action pour le déploiement à l’aide de draft generate-workflow

Après avoir créé vos artefacts et configuré GitHub OIDC, vous pouvez utiliser draft generate-workflow pour générer un fichier de flux de travail GitHub Action, en créant une action qui déploie votre application sur votre cluster AKS. Une fois votre fichier de flux de travail généré, vous devez le valider (commit) dans votre référentiel pour lancer GitHub Action.

  • Générez un fichier de flux de travail GitHub Action à l’aide de la commande az aks draft generate-workflow.

    az aks draft generate-workflow
    
    • Vous pouvez également exécuter la commande sur un répertoire spécifique à l’aide de l’indicateur --destination, comme illustré dans l’exemple suivant :

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

Configurer GitHub OIDC (OpenID Connect) et générer un fichier de flux de travail GitHub Action à l’aide de draft up

draft up est une commande unique permettant d’effectuer la configuration de GitHub OIDC et de générer un fichier de flux de travail GitHub Action pour le déploiement. Elle combine efficacement les commandes draft setup-gh et draft generate-workflow, ce qui signifie qu’il s’agit de la commande la plus couramment utilisée pour bien démarrer avec un nouveau référentiel et qu’elle ne doit être exécutée qu’une seule fois. Les mises à jour suivantes du fichier de flux de travail GitHub Action peuvent être effectuées à l’aide de draft generate-workflow.

  • Configurez GitHub OIDC et générez un fichier de flux de travail GitHub Action à l’aide de la commande az aks draft up.

    az aks draft up
    
    • Vous pouvez également exécuter la commande sur un répertoire spécifique à l’aide de l’indicateur --destination, comme illustré dans l’exemple suivant :

      az aks draft up --destination /Workspaces/ContosoAir
      

Utiliser le routage d’applications avec Draft pour rendre votre application accessible par Internet

Routage d’application] app-routing est le moyen le plus simple de rendre votre application web opérationnelle dans Kubernetes en toute sécurité. Le routage des applications élimine la complexité des contrôleurs d’entrée, tout comme celle de la gestion des certificats et DNS, et offre une configuration aux entreprises désireuses de mettre en place leur propre système. Le routage des applications offre un contrôleur d’entrée managé basé sur NGINX que vous pouvez utiliser sans restriction. Cette solution prête à l’emploi s’intègre à Open Service Mesh pour sécuriser les communications au sein du cluster.

  • Configurez Draft avec le routage d’applications à l’aide de az aks draft update et indiquez le nom DNS et le certificat stocké dans Azure Key Vault lorsque vous y êtes invité.

    az aks draft update
    
    • Vous pouvez également exécuter la commande sur un répertoire spécifique à l’aide de l’indicateur --destination, comme illustré dans l’exemple suivant :

      az aks draft update --destination /Workspaces/ContosoAir