Draft per il servizio Azure Kubernetes (anteprima)

Draft è un progetto open source che semplifica lo sviluppo di Kubernetes prendendo un'applicazione non in contenitori e generando i Dockerfile, i manifesti Kubernetes, i grafici Helm, le configurazioni Kustomize e altri artefatti associati a un'applicazione in contenitori. È anche possibile usare Draft per creare un file del flusso di lavoro di GitHub Action allo scopo di compilare e distribuire rapidamente le applicazioni in qualsiasi cluster Kubernetes.

Funzionamento

Draft include i comandi seguenti che semplificano lo sviluppo in Kubernetes:

• draft create: crea il Dockerfile e i file manifesto appropriati.
• draft setup-gh: configura OIDC in GitHub.
• draft generate-workflow: genera il file del flusso di lavoro di GitHub Action per la distribuzione nel cluster.
• draft up: configura OIDC in GitHub e genera un file del flusso di lavoro di GitHub Action, combinando i due comandi precedenti.

Prerequisiti

• Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.
• Installare la versione più recente dell'interfaccia della riga di comando di Azure e l'estensione aks-preview.
• Se non è già disponibile, è necessario creare un cluster del servizio Azure Kubernetes e un'istanza del Registro Azure Container.

Installare l'estensione aks-preview dell'interfaccia della riga di comando di Azure.

Importante

Le funzionalità di anteprima del servizio Azure Kubernetes sono disponibili in modalità self-service e opzionale. Le anteprime vengono fornite "così come sono" e "come disponibili" e sono escluse dai contratti di servizio e dalla garanzia limitata. Le anteprime del servizio Azure Kubernetes sono parzialmente coperte dal supporto clienti con la massima diligenza possibile. Di conseguenza, queste funzionalità non sono destinate all'uso in produzione. Per altre informazioni, vedere gli articoli di supporto seguenti:

• Criteri di supporto del Servizio Azure Kubernetes (AKS)
• Domande frequenti relative al supporto tecnico di Azure

1. Installare l'estensioneaks-preview usando il comando az extension add.

   az extension add --name aks-preview
   

2. Aggiornare l'estensione per assicurarsi di avere la versione più recente usando il comando az extension update.

   az extension update --name aks-preview
   

Creare artefatti usando draft create

È possibile usare draft create per creare i Dockerfile, i grafici Helm, i manifesti Kubernetes o i file Kustomize necessari per distribuire l'applicazione in un cluster del servizio Azure Kubernetes.

• Creare un artefatto usando il comandoaz aks draft create.

  az aks draft create
  

  • È anche possibile eseguire il comando in una directory specifica usando il flag--destination, come illustrato nell'esempio seguente:

    az aks draft create --destination /Workspaces/ContosoAir
    

Configurare OIDC in GitHub usando draft setup-gh

Per usare Draft, è necessario registrare l'applicazione in GitHub usando draft setup-gh. Questo passaggio deve essere eseguito una volta sola per ogni repository.

• Registrare l'applicazione in GitHub usando il comando az aks draft setup-gh.

  az aks draft setup-gh
  

Generare un file del flusso di lavoro di GitHub Action per la distribuzione usando draft generate-workflow

Dopo aver creato gli artefatti e configurato OIDC in GitHub, è possibile usare draft generate-workflow per generare un file del flusso di lavoro di GitHub Action, creando un'azione che distribuisce l'applicazione nel cluster del servizio Azure Kubernetes. Dopo aver generato il file del flusso di lavoro, è necessario eseguirne il commit nel repository per avviare GitHub Action.

• Generare un file del flusso di lavoro di GitHub Action usando il comandoaz aks draft generate-workflow.

  az aks draft generate-workflow
  

  • È anche possibile eseguire il comando in una directory specifica usando il flag--destination, come illustrato nell'esempio seguente:

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

Configurare OpenID Connect (OIDC) in GitHub e generare un file del flusso di lavoro di GitHub Action usando draft up

draft up è un singolo comando che consente di eseguire la configurazione di OIDC in GitHub e generare un file del flusso di lavoro di GitHub Action per la distribuzione. Combina in modo efficace i comandi draft setup-gh e draft generate-workflow, ovvero viene usato più comunemente quando si inizia a usare un nuovo repository per la prima volta e deve essere eseguito una sola volta. Gli aggiornamenti successivi al file del flusso di lavoro di GitHub Action possono essere eseguiti usando draft generate-workflow.

• Configurare OIDC in GitHub e generare un file del flusso di lavoro di GitHub Action usando il comando az aks draft up.

  az aks draft up
  

  • È anche possibile eseguire il comando in una directory specifica usando il flag--destination, come illustrato nell'esempio seguente:

    az aks draft up --destination /Workspaces/ContosoAir
    

Usare Instradamento dell’applicazione con Draft per rendere l'applicazione accessibile tramite Internet

Instradamento dell’applicazione]app-routing è il modo più semplice per rendere operativa l'applicazione Web in Kubernetes in modo sicuro. Instradamento dell’applicazione rimuove la complessità dei controller in ingresso, dei certificati e della gestione DNS e offre una configurazione per le aziende che desiderano usare il proprio. Instradamento dell’applicazione offre un controller in ingresso gestito basato su nginx che è possibile usare senza restrizioni e che si integra con Open Service Mesh per proteggere le comunicazioni all'interno del cluster.

• Configurare Draft con Instradamento dell’applicazione usando az aks draft update e passare il nome DNS e il certificato archiviato in Azure Key Vault quando richiesto.

  az aks draft update
  

  • È anche possibile eseguire il comando in una directory specifica usando il flag--destination, come illustrato nell'esempio seguente:

    az aks draft update --destination /Workspaces/ContosoAir