Guida rapida: Distribuire un'applicazione in un nuovo cluster Servizio Azure Kubernetes (AKS) automatizzato da un repository di codice

Si applica a: ✔️ Servizio Azure Kubernetes Automatico

Usare le distribuzioni automatizzate per compilare e distribuire un'applicazione da un repository di codice in un cluster del servizio Azure Kubernetes Automatico nuovo o esistente. Le distribuzioni automatizzate semplificano il processo di configurazione di un flusso di lavoro GitHub Action per compilare e distribuire il codice. Dopo la connessione, ogni nuovo commit eseguito avvia la pipeline. Le distribuzioni automatizzate si basano su draft.sh. Quando si crea un nuovo flusso di lavoro di distribuzione, è possibile usare un Dockerfile esistente, generare un Dockerfile, usare manifesti Kubernetes esistenti o generare manifesti Kubernetes. I manifesti generati vengono creati tenendo presenti le procedure consigliate per la sicurezza e la resilienza. Il servizio AKS Automatic include anche un [SLA per la prontezza dei pod] che garantisce il 99,9% delle operazioni di prontezza dei pod qualificate completate entro 5 minuti, garantendo un'infrastruttura affidabile e auto-riparante per le applicazioni.

Con questa guida introduttiva, si potrà:

• Connettersi a un repository di codice.
• Distribuire l'applicazione in un contenitore.
• Configurare i manifesti Kubernetes.
• Creare un cluster del Servizio Azure Kubernetes Automatico.
• Distribuire l'applicazione tramite una richiesta pull.

Prima di iniziare

• Disporre di un account GitHub con l'applicazione da distribuire.
• Il servizio AKS Automatic abiliterà Criteri di Azure sul cluster AKS, ma dovresti preregistrare il provider delle risorse Microsoft.PolicyInsights nella sottoscrizione per un'esperienza più fluida. Per ulteriori informazioni, vedere provider e tipi di risorse di Azure.

Limitazioni

Le seguenti limitazioni si applicano ai cluster automatici di AKS:

• AKS Automatic è generalmente disponibile nelle seguenti regioni: australiaeast, austriaeast, belgiumcentral, brazilsouth, canadacentral, centralindia, centralus, chilecentral, denmarkeast, eastasia, eastus, eastus2, francecentral, germanywestcentral, indonesiacentral, israelcentral, italynorth, japaneast, japanwest, koreacentral, malaysiawest, mexicocentral, newzealandnorth, northeurope, norwayeast, polandcentral, southafricanorth, southcentralus, southeastasia, spaincentral, swedencentral, switzerlandnorth, uaenorth, uksouth, westeurope, westus2, westus3.
  • Per impostazione predefinita, i nuovi cluster automatici di AKS abilitano i pool di nodi di sistema gestiti e LocalDNS. Non è possibile creare cluster automatici di AKS senza pool di nodi di sistema gestiti in nessuna regione.
• Il cluster Automatico di AKS ha il blocco del gruppo di risorse del nodo preconfigurato, che non consente modifiche al gruppo di risorse MC_, impedendo i collegamenti alla rete virtuale nella zona DNS privato predefinita. Per scenari DNS tra reti virtuali (VNet) o DNS personalizzati, utilizzare una rete personalizzata e un DNS privato seguendo Crea un cluster privato di Servizio Azure Kubernetes (AKS) automatico in una rete virtuale personalizzata.
• interfaccia della riga di comando di Azure è necessaria la versione 2.86.0 o successiva. Per trovare la versione, eseguire az --version il comando . Se è necessario installare o aggiornare, vedere Installare interfaccia della riga di comando di Azure.
• Le estensioni seguenti non sono supportate:
  • Dapr
  • Azure Machine Learning
• I nodi Di Windows non sono supportati.
• Il componente aggiuntivo basato su Istio per il service mesh di AKS (Azure Kubernetes Service) non è supportato.
• La migrazione tra lo SKU Base di AKS e lo SKU Automatico non è supportata.
• Le migrazioni tra cluster automatici del servizio Azure Kubernetes senza pool di nodi di sistema gestiti e cluster automatici del servizio Azure Kubernetes con pool di nodi di sistema gestiti non sono supportate.
• La configurazione dello scraping personalizzato delle metriche e dellaraccolta di log di Prometheus non è supportata.
• L'abilitazione dell'osservabilità ACNS durante la creazione automatica del cluster non è supportata. È possibile abilitare l'osservabilità ACNS dopo la creazione del cluster.

Aggiungere il codice sorgente dell'applicazione

Per distribuire un'applicazione da un repository di codice, iniziare dalla home page Azure portale.

1. Cercare i servizi Kubernetes nella barra di ricerca superiore.
2. Selezionare Kubernetes services nei risultati della ricerca.
3. Selezionare il pulsante Crea e selezionare Distribuisci applicazione.

Connettersi al repository del codice sorgente

Creare e automatizzare il flusso di lavoro di distribuzione e autorizzarlo a connettersi al repository del codice sorgente desiderato.

1. Nella scheda Informazioni di base selezionare Distribuire l'applicazione.
2. In Project details scegliere il Subscription, Resource Group e Region.
3. In Repository details immettere un nome per il flusso di lavoro, quindi selezionare Authorize access per connettersi al repository di GitHub desiderato.
4. Scegliere Repository e Ramo.
5. Selezionare il pulsante Avanti.

Scegliere la configurazione dell'immagine del contenitore

Per preparare un'applicazione per Kubernetes, è necessario compilarla in un'immagine del contenitore e archiviata in un registro contenitori. Si usa un Dockerfile per fornire istruzioni su come compilare l'immagine del contenitore. Se il repository del codice sorgente non ha già un Dockerfile, le distribuzioni automatizzate possono generarne una automaticamente. In caso contrario, è possibile usare un Dockerfile esistente.

Scegliere la configurazione del manifesto Kubernetes

Un'applicazione in esecuzione in Kubernetes è costituita da molti componenti primitivi Kubernetes. Questi componenti descrivono l'immagine del contenitore da usare, il numero di repliche da eseguire, se è necessario un indirizzo IP pubblico per esporre l'applicazione e così via. Per altre informazioni, vedere la documentazione ufficiale di Kubernetes. Se il repository del codice sorgente non dispone già dei manifesti Kubernetes di base da distribuire, le distribuzioni automatizzate possono generarle automaticamente. In caso contrario, è possibile usare un set di manifesti esistenti. È anche possibile scegliere un grafico Helm esistente.

Selezionare la posizione in cui si vuole distribuire l'applicazione

Esaminare la configurazione e la distribuzione

Esaminare la configurazione per il cluster, l'applicazione e i manifesti Kubernetes, quindi selezionare Distribuisci. La creazione di un cluster richiede alcuni minuti, non uscire dalla pagina di distribuzione.

1. Viene creato un nuovo cluster del servizio Azure Kubernetes Automatico o ne è stato configurato uno esistente.
2. Viene creato un registro contenitori o ne è configurato uno esistente con il cluster.
3. Le credenziali federate vengono create per consentire al flusso di lavoro GitHub Azione di distribuire nel cluster.
4. Viene creata una richiesta pull nel repository di codice con tutti i file generati e il flusso di lavoro.

Esaminare e unire una richiesta pull

Quando la distribuzione ha esito positivo, selezionare il pulsante Visualizza richiesta pull per visualizzare i dettagli della richiesta pull generata nel repository di codice.

1. Esaminare le modifiche in File modificati e apportare le modifiche desiderate.
2. Selezionare Unisci richiesta pull per unire le modifiche nel repository di codice.

L'unione della modifica innesca il flusso di lavoro GitHub Actions che crea l'immagine del contenitore della tua applicazione, la archivia in Registro Azure Container e la distribuisce nel cluster.

Controllare le risorse distribuite

Al termine della pipeline, è possibile esaminare il Kubernetes Service creato nel portale di Azure selezionando Servizi e ingresses nel menu del servizio risorse di Kubernetes.

Se si seleziona l'Indirizzo IP esterno, sarà visualizzata una nuova pagina del browser con l'applicazione in esecuzione.

Eliminare risorse

Al termine dell'operazione con il cluster, è possibile eliminarlo per evitare di incorrere in addebiti Azure.

1. Nel portale di Azure passare al gruppo di risorse.
2. Selezionare Elimina gruppo di risorse.
3. Immettere il nome del gruppo di risorse per confermare l'eliminazione e selezionare Elimina.
4. Nella finestra di dialogo conferma eliminazione selezionare Elimina.

Passaggi successivi

In questa guida introduttiva è stata distribuita un'applicazione in un cluster Kubernetes usando il servizio Azure Kubernetes Automatico e si è configurata una pipeline di integrazione continua/distribuzione continua (CI/CD) da un repository di codice.

Per ulteriori informazioni sul servizio Azure Kubernetes automatico, continuare con l'introduzione.