Note sulla versione per il motore del servizio Azure Kubernetes nell'hub di Azure Stack

Si applica alla versione 0.80.2 del motore del servizio Azure Kubernetes.

Questo articolo descrive il contenuto del motore servizio Azure Kubernetes (AKS) nell'aggiornamento dell'hub di Azure Stack. L'aggiornamento include miglioramenti e correzioni per la versione più recente del motore del servizio Azure Kubernetes destinata alla piattaforma hub di Azure Stack. Questo articolo non è destinato a documentare le informazioni sulla versione per il motore del servizio Azure Kubernetes per Azure globale.

Considerazioni sull'aggiornamento

  • Si usano gli elementi del marketplace corretti, la distribuzione dell'immagine di Ubuntu 20.04 di base del servizio Azure Kubernetes per la versione del motore del servizio Azure Kubernetes? Le versioni sono disponibili nella sezione Scaricare nuove immagini e motore del servizio Azure Kubernetes.
  • Si usano le specifiche del cluster corrette (apimodel.json) e il gruppo di risorse per il cluster di destinazione? Quando è stato originariamente distribuito il cluster, questo file è stato generato nella directory di output. Vedere i parametri dei comandi deploy Deploy a Kubernetes cluster (Distribuire un cluster Kubernetes).
  • Si sta usando un computer affidabile per eseguire il motore del servizio Azure Kubernetes e da cui si eseguono operazioni di aggiornamento?
  • Se si aggiorna un cluster operativo con carichi di lavoro attivi, è possibile applicare l'aggiornamento senza influire su di essi, presupponendo che il cluster sia sottoposto a carico normale. Tuttavia, è necessario disporre di un cluster di backup nel caso in cui sia necessario reindirizzare gli utenti. È consigliabile usare un cluster di backup.
  • Se possibile, eseguire il comando da una macchina virtuale nell'ambiente dell'hub di Azure Stack per ridurre gli hop di rete e i potenziali errori di connettività.
  • Assicurarsi che la sottoscrizione disponga di una quota sufficiente per l'intero processo. Il processo alloca nuove macchine virtuali durante il processo. Il numero risultante di macchine virtuali sarà lo stesso dell'originale, ma pianificare la creazione di altre macchine virtuali durante il processo.
  • Non sono pianificati aggiornamenti di sistema o attività pianificate.
  • Configurare un aggiornamento a fasi in un cluster configurato con gli stessi valori del cluster di produzione e testare l'aggiornamento prima di farlo nel cluster di produzione.

Usare il comando di aggiornamento

È necessario usare il aks-engine upgrade comando come descritto in Aggiornare un cluster Kubernetes nell'hub di Azure Stack.

Interruzioni dell'aggiornamento

A volte fattori imprevisti interrompono l'aggiornamento del cluster. Un'interruzione può verificarsi quando il motore del servizio Azure Kubernetes segnala un errore o si verifica un errore nel processo di esecuzione del motore del servizio Azure Kubernetes. Esaminare la causa dell'interruzione, risolverla e inviare nuovamente lo stesso upgrade comando per continuare il processo di aggiornamento. Il upgrade comando è idempotente e deve riprendere l'aggiornamento del cluster dopo la reinviazione del comando. In genere, le interruzioni aumentano il tempo necessario per completare l'aggiornamento, ma non dovrebbero influire sul completamento.

Tempo stimato per l'aggiornamento

Il tempo di aggiornamento stimato è compreso tra 12 e 15 minuti per macchina virtuale nel cluster. Ad esempio, l'aggiornamento di un cluster a 20 nodi può richiedere circa 5 ore.

Istruzioni per l'uso del motore del servizio Azure Kubernetes 0.70.0 e versioni successive

Scaricare una nuova immagine e il motore del servizio Azure Kubernetes

Scaricare le nuove versioni dell'immagine ubuntu di base del servizio Azure Kubernetes e del motore del servizio Azure Kubernetes.

Come illustrato nella documentazione relativa al motore del servizio Azure Kubernetes per l'hub di Azure Stack, la distribuzione di un cluster Kubernetes richiede:

  • Binario del motore del servizio Azure Kubernetes (obbligatorio).
  • Distribuzione dell'immagine Ubuntu 16.04-LTS di base del servizio Azure Kubernetes (deprecata: non più usare, modificare il modello API per usare invece la versione 20.04).
  • Distribuzione dell'immagine ubuntu di base del servizio Azure Kubernetes 18.04-LTS (deprecata- non più usata, modifica nel modello API per l'uso della versione 20.04).
  • Distribuzione dell'immagine Ubuntu 20.04-LTS di base del servizio Azure Kubernetes (necessaria per gli agenti Linux).
  • Immagine Windows Server di base del servizio Azure Kubernetes (per gli agenti Windows è necessaria una delle immagini seguenti):
    • Contenitore di immagini windows server di base del servizio Azure Kubernetes.
    • Docker dell'immagine windows server di base del servizio Azure Kubernetes.

Con questo aggiornamento sono disponibili nuove versioni di queste immagini:

Aggiornamento dei cluster Kubernetes creati con la distribuzione ubuntu 16.04

A partire dal motore del servizio Azure Kubernetes v0.63.0, la distribuzione di Ubuntu 16.04 non è più un'opzione supportata, perché il sistema operativo ha raggiunto la fine della durata. Per il motore del servizio Azure Kubernetes v0.67.0 o versioni successive, l'aggiornamento del motore del servizio Azure Kubernetes sovrascrive automaticamente il valore di distribuzione non supportato aks-ubuntu-16.04 con con aks-ubuntu-18.04. Per il motore del servizio Azure Kubernetes v0.75.3 o versioni successive, se si usa Kubernetes v1.24 o versione successiva, l'aggiornamento di aks-engine-azurestack sovrascrive automaticamente il valore di distribuzione non supportato aks-ubuntu-16.04 con aks-ubuntu-20.04.

Aggiornamento dei cluster Kubernetes creati con la distribuzione ubuntu 18.04

A partire dal motore del servizio Azure Kubernetes v0.75.3, la distribuzione di Ubuntu 18.04 non è più un'opzione supportata, perché il sistema operativo ha raggiunto la fine della durata. Per il motore del servizio Azure Kubernetes v0.75.3 o versioni successive, l'aggiornamento aks-engine-azurestack sovrascrive automaticamente il valore di distribuzione non supportato aks-ubuntu-18.04 con aks-ubuntu-20.04.

Aggiornamento dei cluster Kubernetes creati con il runtime del contenitore Docker

In Kubernetes v1.24 il componente dockershim è stato rimosso da kubelet. Di conseguenza, il runtime del contenitore Docker non è più un'opzione supportata. Per altre informazioni, vedere le note sulla versione di Kubernetes v1.24. Per il motore del servizio Azure Kubernetes v0.75.3 o versioni successive, l'aggiornamento aks-engine-azurestack sovrascrive automaticamente il valore non supportato docker containerRuntime con containerd.

Per il motore del servizio Azure Kubernetes versione 0.75.3, i cluster con nodi Windows in Kubernetes v1.23 possono usare l'immagine di base di Windows con il runtime Docker. I cluster con nodi Windows in Kubernetes v1.24 possono usare l'immagine di base di Windows con il runtime in contenitori.

Mapping del motore del servizio Azure Kubernetes e della versione di Azure Stack

Versione dell'hub di Azure Stack Versione del motore del servizio Azure Kubernetes
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4
2008 0.55.4, 0.60.1
2102 0.60.1, 0.63.0, 0.67.0, 0.67.3
2108 0.63.0, 0.67.0, 0.67.3, 0.70.0, 0.71.0, 0.73.0, 0.75.3, 0.76.0
2206 0.70.0, 0.71.0, 0.73.0, 0.75.3, 0.76.0, 0.77.0
2301 0.75.3, 0.76.0, 0.77.0, 0.78.0, 0.79.0
2306 0.78.0, 0.79.0*, 0.80.2*
2311 0.80.2*
2406 0.80.2*

Nota

Supportato.* Per altre informazioni, vedere i criteri di supporto della versione del motore del servizio Azure Kubernetes.

Motore del servizio Azure Kubernetes e mapping di immagini corrispondente

È possibile trovare le versioni di Kubernetes supportate per il motore del servizio Azure Kubernetes nell'hub di Azure Stack nella tabella seguente. Non usare il comando aks-engine get-versions , che restituisce le versioni supportate in Azure globale e nell'hub di Azure Stack.

Motore del servizio Azure Kubernetes Immagine di base del servizio Azure Kubernetes Versioni di Kubernetes Esempi di modelli API
v0.43.1 Distribuzione di immagini di base di Ubuntu per il servizio Azure Kubernetes 16.04-LTS, ottobre 2019 (2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 Distribuzione di immagini di base di Ubuntu per il servizio Azure Kubernetes 16.04-LTS, marzo 2020 (2020.03.19) 1.15.10, 1.14.7
v0.51.0 Distribuzione dell'immagine AKS Base Ubuntu 16.04-LTS, maggio 2020 (2020.05.13), immagine windows di base del servizio Azure Kubernetes (17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Windows
v0.55.0 Distribuzione dell'immagine AKS Base Ubuntu 16.04-LTS, agosto 2020 (2020.08.24), immagine windows di base del servizio Azure Kubernetes (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
v0.55.4 Distribuzione dell'immagine AKS Base Ubuntu 16.04-LTS, settembre 2020 (2020.09.14), immagine windows di base del servizio Azure Kubernetes (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
V0.60.1 Distribuzione dell'immagine Ubuntu 16.04-LTS di base del servizio Azure Kubernetes, gennaio 2021 (2021.01.28),
Distribuzione dell'immagine AKS Base Ubuntu 18.04-LTS, 2021 Q1 (2021.01.28),
Immagine di base di Windows per il servizio Azure Kubernetes (17763.1697.210129)
1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows
v0.63.0 Distribuzione dell'immagine AKS Base Ubuntu 18.04-LTS, 2021 Q2 (2021.05.24), Immagine windows di base del servizio Azure Kubernetes (17763.1935.210520) 1.18.18, 1.19.10, 1.20.6 Esempi di modelli API (Linux, Windows)
v0.67.0 Distribuzione dell'immagine Ubuntu 18.04-LTS di base del servizio Azure Kubernetes, 2021 Q3 (2021.09.27), immagine windows di base del servizio Azure Kubernetes (17763.2213.210927) 1.19.15, 1.20.11 Esempi di modelli API (Linux, Windows)
v0.67.3 Distribuzione dell'immagine Ubuntu 18.04-LTS di base del servizio Azure Kubernetes, 2021 Q3 (2021.09.27), immagine windows di base del servizio Azure Kubernetes (17763.2213.210927) 1.19.15, 1.20.11 Esempi di modelli API (Linux, Windows)
v0.70.0 Distribuzione dell'immagine AKS Base Ubuntu 18.04-LTS, 2022 Q2 (2022.04.07), Immagine windows di base del servizio Azure Kubernetes (17763.2565.220408) 1.21.10*, 1.22.7* Esempi di modelli API (Linux, Windows)
v0.71.0 Distribuzione dell'immagine AKS Base Ubuntu 18.04-LTS, 2022 Q3 (2022.08.12), immagine windows di base del servizio Azure Kubernetes (17763.3232.220805) 1.22.7*, 1.23.6* Esempi di modelli API (Linux, Windows)
v0.73.0 Distribuzione dell'immagine AKS Base Ubuntu 18.04-LTS, 2022 Q4 (2022.11.02), immagine windows di base del servizio Azure Kubernetes (17763.3532.221102) 1.22.15*, 1.23.13* Esempi di modelli API (Linux, Windows)
v0.75.3 Distribuzione dell'immagine AKS Base Ubuntu 20.04-LTS (2023.032.2), AKS Base Windows Server 2019 Image Docker (17763.3887.20230332) del servizio Azure Kubernetes Base Windows Server 2019 Image Containerd (17763.3887.20230332) 1.23.15*, 1.24.9** Esempi di modelli API (Linux, Windows)
v0.76.0 Distribuzione dell'immagine Ubuntu 20.04-LTS di base del servizio Azure Kubernetes (2023.116.3), contenitore di immagini windows server di base del servizio Azure Kubernetes 2019 (17763.4252.20231163) 1.24.11**, 1.25.7** Esempi di modelli API (Linux, Windows)
v0.77.0 Distribuzione dell'immagine Ubuntu 20.04-LTS di base del servizio Azure Kubernetes (2023.206.1), contenitore di immagini windows server di base del servizio Azure Kubernetes 2019 (17763.4645.20232061) 1.25.7**, 1.26.6** Esempi di modelli API (Linux, Windows)
v0.78.0 Distribuzione dell'immagine Ubuntu 20.04-LTS di base del servizio Azure Kubernetes (2023.242.3), contenitore di immagini windows server di base del servizio Azure Kubernetes 2019 (17763.4737.20232423) 1.25.13**, 1.26.8** Esempi di modelli API (Linux, Windows)
v0.79.0 Distribuzione dell'immagine Ubuntu 20.04-LTS di base del servizio Azure Kubernetes (2023.296.1), contenitore di immagini di Base del servizio Azure Kubernetes windows Server 2019 (17763.4974.20232961) 1.26.9**, 1.27.6** Esempi di modelli API (Linux, Windows)
v0.80.2 Distribuzione dell'immagine ubuntu di base del servizio Azure Kubernetes 20.04-LTS (2024.032.1), contenitore di immagini windows server di base del servizio Azure Kubernetes 2019 (17763.5329.20240321) 1.27.10**, 1.28.6** Esempi di modelli API (Linux, Windows)

Nota

*A partire da Kubernetes v1.21, solo il provider di servizi cloud per Azure è supportato nell'hub di Azure Stack.

Nota

** A partire da Kubernetes v1.24, è supportato solo il runtime del containerd contenitore. Per altre informazioni, vedere la sezione Aggiornamento dei cluster Kubernetes creati con il runtime del contenitore Docker.

Pianificazione degli aggiornamenti

Il comando del motore upgrade del servizio Azure Kubernetes automatizza completamente il processo di aggiornamento del cluster e gestisce macchine virtuali (VM), rete, archiviazione, Kubernetes e attività di orchestrazione. Prima di applicare l'aggiornamento, assicurarsi di esaminare le informazioni sulla nota sulla versione.

Novità di AKSe 0.76.0

  • Aggiunta del supporto per Kubernetes v1.24.11 e v1.25.7.
  • È possibile trovare altre funzionalità nella pagina di GitHub v0.76.0.

Novità di AKSe 0.75.3 e versioni successive

Il motore del servizio Azure Kubernetes versione 0.75.3 e tutte le versioni future del motore del servizio Azure Kubernetes nell'hub di Azure Stack saranno disponibili nel nuovo repository aks-engine-azurestack. Di conseguenza, tutti i aks-engine comandi devono essere sostituiti con aks-engine-azurestack. Sono stati modificati anche i comandi per ottenere la versione più recente del motore del servizio Azure Kubernetes nell'hub di Azure Stack. È possibile visualizzare i nuovi comandi in Creare un client Linux e Creare un client Windows. Se si verificano problemi, creare un problema nel nuovo repository .

Il motore del servizio Azure Kubernetes versione 0.75.3 nell'hub di Azure Stack offre Ubuntu 20.04 LTS come immagine di base Linux. A partire da questa versione, Ubuntu 18.04 non è più supportato. Per altre informazioni, vedere Aggiornamento dei cluster Kubernetes creati con la distribuzione di Ubuntu 18.04.

A partire da Kubernetes v1.24, è supportato solo il containerd runtime. Per altre informazioni, vedere Aggiornamento dei cluster Kubernetes creati con il runtime docker. Per il motore del servizio Azure Kubernetes versione 0.75.3, i cluster con nodi Windows in Kubernetes v1.23 possono usare l'immagine di base di Windows con il runtime Docker. I cluster con nodi Windows in Kubernetes v1.24 possono usare l'immagine di base di Windows con il runtime contenitore.

Altre funzionalità sono disponibili nella pagina GitHub v0.75.3.

Istruzioni per l'uso del motore del servizio Azure Kubernetes 0.70.0 e versioni successive

Microsoft ha aggiornato Azure Cloud Provider nella versione 0.70.0. Il provider di servizi cloud di Azure è un componente di base condiviso tra Il servizio Azure Kubernetes e il motore del servizio Azure Kubernetes nell'hub di Azure Stack.

Per usare il motore del servizio Azure Kubernetes 0.70.0 e versioni successive:

  • Se si sta provando a creare un nuovo cluster Kubernetes per la prima volta: usare il modello API di esempio fornito per la versione appropriata nel motore del servizio Azure Kubernetes e nella tabella di mapping delle immagini corrispondente.

  • Se si sta creando un nuovo cluster, ma si vuole usare il modello API esistente: Modificare il modello API seguendo le istruzioni di Cloud Provider per Azure . Se non si include la nuova impostazione, viene generato un errore di distribuzione.

  • Se si usano volumi di archiviazione: assicurarsi di usare il driver AzureDiskCSI . La versione 0.70.0 e successive supporta solo i driver CSI, non il provider di archiviazione nell'albero legacy. Per eseguire l'aggiornamento, seguire le istruzioni riportate in Aggiornare durante l'uso dei volumi di archiviazione.

Problemi noti

  • La distribuzione di più servizi Kubernetes in parallelo all'interno di un singolo cluster può causare un errore nella configurazione del servizio di bilanciamento del carico di base. È consigliabile distribuire un servizio alla volta.
  • Poiché lo strumento del motore del servizio Azure Kubernetes è un repository di codice sorgente condiviso in Azure e nell'hub di Azure Stack, esaminando le numerose note sulla versione e le richieste pull, è possibile che lo strumento supporti altre versioni di Kubernetes e della piattaforma del sistema operativo oltre a quelle elencate in precedenza. È possibile ignorarli e usare la tabella della versione precedente come guida ufficiale per questo aggiornamento.
  • Il motore del servizio Azure Kubernetes v0.67.0 usa l'immagine di Windows errata durante la distribuzione di cluster Windows. Usare v0.70.0 per risolvere il problema.

Riferimento

L'elenco seguente è il set completo di note sulla versione per Azure e l'hub di Azure Stack combinati:

Si applica alla versione 0.67.0 del motore del servizio Azure Kubernetes.

Questo articolo descrive il contenuto del motore servizio Azure Kubernetes (AKS) nell'aggiornamento dell'hub di Azure Stack. L'aggiornamento include miglioramenti e correzioni per la versione più recente del motore del servizio Azure Kubernetes destinata alla piattaforma hub di Azure Stack. Questo articolo non è destinato a documentare le informazioni sulla versione per il motore del servizio Azure Kubernetes per Azure globale.

Pianificazione degli aggiornamenti

Il comando del motore upgrade del servizio Azure Kubernetes automatizza completamente il processo di aggiornamento del cluster. Gestisce le macchine virtuali (VM), la rete, l'archiviazione, Kubernetes e le attività di orchestrazione. Prima di applicare l'aggiornamento, assicurarsi di esaminare le informazioni sulla nota sulla versione.

Considerazioni sull'aggiornamento

  • Si usano gli elementi del Marketplace corretti, il servizio Azure Kubernetes base Ubuntu 16.04-LTS o la distribuzione dell'immagine 18.04 o Windows Server di base del servizio Azure Kubernetes per la versione del motore del servizio Azure Kubernetes? Le versioni sono disponibili nella sezione "Scaricare nuove immagini e motore del servizio Azure Kubernetes".
  • Si usano le specifiche del cluster corrette (apimodel.json) e il gruppo di risorse per il cluster di destinazione? Quando è stato originariamente distribuito il cluster, questo file è stato generato nella directory di output. Vedere i parametri dei comandi deploy Deploy a Kubernetes cluster (Distribuire un cluster Kubernetes).
  • Si sta usando un computer affidabile per eseguire il motore del servizio Azure Kubernetes e da cui si eseguono operazioni di aggiornamento?
  • Se si aggiorna un cluster operativo con carichi di lavoro attivi, è possibile applicare l'aggiornamento senza influire su di essi, presupponendo che il cluster sia sottoposto a carico normale. Tuttavia, è necessario disporre di un cluster di backup nel caso in cui sia necessario reindirizzare gli utenti. È consigliabile usare un cluster di backup.
  • Se possibile, eseguire il comando da una macchina virtuale nell'ambiente dell'hub di Azure Stack per ridurre gli hop di rete e i potenziali errori di connettività.
  • Assicurarsi che la sottoscrizione disponga di una quota sufficiente per l'intero processo. Il processo alloca nuove macchine virtuali durante il processo. Il numero risultante di macchine virtuali sarà lo stesso dell'originale, ma pianificare la creazione di altre macchine virtuali durante il processo.
  • Non sono pianificati aggiornamenti di sistema o attività pianificate.
  • Configurare un aggiornamento a fasi in un cluster configurato con gli stessi valori del cluster di produzione e testare l'aggiornamento prima di farlo nel cluster di produzione.

Usare il comando di aggiornamento

È necessario usare il aks-engine upgrade comando come descritto in Aggiornare un cluster Kubernetes nell'hub di Azure Stack.

Interruzioni dell'aggiornamento

A volte fattori imprevisti interrompono l'aggiornamento del cluster. Un'interruzione può verificarsi quando il motore del servizio Azure Kubernetes segnala un errore o si verifica un errore nel processo di esecuzione del motore del servizio Azure Kubernetes. Esaminare la causa dell'interruzione, risolverla e inviare nuovamente lo stesso upgrade comando per continuare il processo di aggiornamento. Il upgrade comando è idempotente e deve riprendere l'aggiornamento del cluster dopo la reinviazione del comando. In genere, le interruzioni aumentano il tempo necessario per completare l'aggiornamento, ma non dovrebbero influire sul completamento.

Tempo stimato per l'aggiornamento

Il tempo di aggiornamento stimato è compreso tra 12 e 15 minuti per macchina virtuale nel cluster. Ad esempio, l'aggiornamento di un cluster a 20 nodi può richiedere circa 5 ore.

Scaricare una nuova immagine e il motore del servizio Azure Kubernetes

Scaricare le nuove versioni dell'immagine ubuntu di base del servizio Azure Kubernetes e del motore del servizio Azure Kubernetes.

Come illustrato nella documentazione relativa al motore del servizio Azure Kubernetes per l'hub di Azure Stack, la distribuzione di un cluster Kubernetes richiede:

  • Binario del motore del servizio Azure Kubernetes (obbligatorio).
  • Distribuzione dell'immagine ubuntu di base del servizio Azure Kubernetes 16.04-LTS (deprecata: non più usare, modificare il modello API per usare invece la versione 18.04).
  • Distribuzione dell'immagine Ubuntu 18.04-LTS di base del servizio Azure Kubernetes (necessaria per gli agenti Linux).
  • Distribuzione dell'immagine windows server di base del servizio Azure Kubernetes (necessaria per gli agenti Windows).

Con questo aggiornamento sono disponibili nuove versioni di queste immagini:

Aggiornamento dei cluster Kubernetes creati con la distribuzione ubuntu 16.04

A partire dal motore del servizio Azure Kubernetes v0.67.0, la distribuzione di Ubuntu 16.04 non è più un'opzione supportata, perché il sistema operativo ha raggiunto la fine del ciclo di vita. Per aggiornare un cluster, assicurarsi di impostare la distribuzione aks-ubuntu-18.04 del sistema operativo su nel modello api di input, quella generata da aks-engine deploy e passata come input a aks-engine upgrade:

"masterProfile": {
    "distro": "aks-ubuntu-18.04"
},

"agentPoolProfiles": [{
    "distro": "aks-ubuntu-18.04"
}]

Mapping del motore del servizio Azure Kubernetes e della versione di Azure Stack

Versione dell'hub di Azure Stack Versione del motore del servizio Azure Kubernetes
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4
2008 0.55.4, 0.60.1
2102 0.60.1, 0.63.0, 0.67.0
2108 0.63.0, 0.67.0

Percorso di aggiornamento della versione di Kubernetes nel motore del servizio Azure Kubernetes v0.67.0

La versione corrente e la versione di aggiornamento per l'hub di Azure Stack sono disponibili nella tabella seguente. Questa tabella si applica al cluster del motore del servizio Azure Kubernetes nell'hub di Azure Stack. Non usare il comando aks-engine get-versions , che restituisce le versioni supportate in Azure globale e nell'hub di Azure Stack.

Versione corrente Aggiornamento disponibile
1.15.12 1.16.14, 1.16.15
1.16.14 1.16.15, 1.17.17
1.17.11, 1.17.17 1.18.18
1.18.15, 1.18.18 1.19.10
1.19.10 1.19.15, 1.20.11
1.20.6 1.20.11

Nel file JSON del modello API specificare i valori di versione e versione nella orchestratorProfile sezione . Ad esempio, se si prevede di distribuire Kubernetes 1.17.17, è necessario impostare i due valori seguenti (vedere l'esempio kubernetes-azurestack.json):

-   "orchestratorRelease": "1.17",
-   "orchestratorVersion": "1.17.17"

Motore del servizio Azure Kubernetes e mapping di immagini corrispondente

Motore del servizio Azure Kubernetes Immagine di base del servizio Azure Kubernetes Versioni di Kubernetes Esempi di modelli API
v0.43.1 Distribuzione di immagini di base di Ubuntu per il servizio Azure Kubernetes 16.04-LTS, ottobre 2019 (2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 Distribuzione di immagini di base di Ubuntu per il servizio Azure Kubernetes 16.04-LTS, marzo 2020 (2020.03.19) 1.15.10, 1.14.7
v0.51.0 Distribuzione dell'immagine AKS Base Ubuntu 16.04-LTS, maggio 2020 (2020.05.13), immagine windows di base del servizio Azure Kubernetes (17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Windows
v0.55.0 Distribuzione dell'immagine AKS Base Ubuntu 16.04-LTS, agosto 2020 (2020.08.24), immagine windows di base del servizio Azure Kubernetes (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
v0.55.4 Distribuzione dell'immagine AKS Base Ubuntu 16.04-LTS, settembre 2020 (2020.09.14), immagine windows di base del servizio Azure Kubernetes (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
V0.60.1 Distribuzione dell'immagine Ubuntu 16.04-LTS di base del servizio Azure Kubernetes, gennaio 2021 (2021.01.28),
Distribuzione dell'immagine AKS Base Ubuntu 18.04-LTS, 2021 Q1 (2021.01.28),
Immagine di base di Windows per il servizio Azure Kubernetes (17763.1697.210129)
1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows
v0.63.0 Distribuzione dell'immagine AKS Base Ubuntu 18.04-LTS, 2021 Q2 (2021.05.24), Immagine windows di base del servizio Azure Kubernetes (17763.1935.210520) 1.18.18, 1.19.10, 1.20.6 Esempi di modelli API (Linux, Windows)
v0.67.0 Distribuzione dell'immagine Ubuntu 18.04-LTS di base del servizio Azure Kubernetes, 2021 Q3 (2021.09.27), immagine windows di base del servizio Azure Kubernetes (17763.2213.210927) 1.19.15, 1.20.11 Esempi di modelli API (Linux, Windows)

Novità

Se si è interessati a partecipare a un'anteprima privata, è possibile richiedere l'accesso in anteprima.

Le nuove funzionalità includono:

  • Supporto per Kubernetes 1.19.15 e 1.20.11

Problemi noti

  • La distribuzione di più servizi Kubernetes in parallelo all'interno di un singolo cluster può causare un errore nella configurazione del servizio di bilanciamento del carico di base. È consigliabile distribuire un servizio alla volta.
  • Poiché lo strumento del motore del servizio Azure Kubernetes è un repository di codice sorgente condiviso in Azure e nell'hub di Azure Stack, esaminando le numerose note sulla versione e le richieste pull, è possibile che lo strumento supporti altre versioni di Kubernetes e della piattaforma del sistema operativo oltre a quelle elencate in precedenza. È possibile ignorarli e usare la tabella della versione precedente come guida ufficiale per questo aggiornamento.

Riferimento

L'elenco seguente è il set completo di note sulla versione per Azure e l'hub di Azure Stack combinati:

Si applica alla versione 0.60.1 del motore del servizio Azure Kubernetes.

Questo articolo descrive il contenuto del motore servizio Azure Kubernetes (AKS) nell'aggiornamento dell'hub di Azure Stack. L'aggiornamento include miglioramenti e correzioni per la versione più recente del motore del servizio Azure Kubernetes destinata alla piattaforma hub di Azure Stack. Questo articolo non è destinato a documentare le informazioni sulla versione per il motore del servizio Azure Kubernetes per Azure globale.

Pianificazione degli aggiornamenti

Il comando del motore upgrade del servizio Azure Kubernetes automatizza completamente il processo di aggiornamento del cluster e gestisce macchine virtuali (VM), rete, archiviazione, Kubernetes e attività di orchestrazione. Prima di applicare l'aggiornamento, assicurarsi di esaminare le informazioni sulla nota sulla versione.

Considerazioni sull'aggiornamento

  • Si usano gli elementi del Marketplace corretti, il servizio Azure Kubernetes base Ubuntu 16.04-LTS o la distribuzione dell'immagine 18.04 o Windows Server di base del servizio Azure Kubernetes per la versione del motore del servizio Azure Kubernetes? Le versioni sono disponibili nella sezione "Scaricare nuove immagini e motore del servizio Azure Kubernetes".
  • Si usano le specifiche del cluster corrette (apimodel.json) e il gruppo di risorse per il cluster di destinazione? Quando è stato originariamente distribuito il cluster, questo file è stato generato nella directory di output. Vedere i parametri dei comandi deploy Deploy a Kubernetes cluster (Distribuire un cluster Kubernetes).
  • Si sta usando un computer affidabile per eseguire il motore del servizio Azure Kubernetes e da cui si eseguono operazioni di aggiornamento?
  • Se si aggiorna un cluster operativo con carichi di lavoro attivi, è possibile applicare l'aggiornamento senza influire su di essi, presupponendo che il cluster sia sottoposto a carico normale. Tuttavia, è necessario disporre di un cluster di backup nel caso in cui sia necessario reindirizzare gli utenti. È consigliabile usare un cluster di backup.
  • Se possibile, eseguire il comando da una macchina virtuale nell'ambiente dell'hub di Azure Stack per ridurre gli hop di rete e i potenziali errori di connettività.
  • Assicurarsi che la sottoscrizione disponga di una quota sufficiente per l'intero processo. Il processo alloca nuove macchine virtuali durante il processo. Il numero risultante di macchine virtuali sarà lo stesso dell'originale, ma pianificare la creazione di altre macchine virtuali durante il processo.
  • Non sono pianificati aggiornamenti di sistema o attività pianificate.
  • Configurare un aggiornamento a fasi in un cluster configurato con gli stessi valori del cluster di produzione e testare l'aggiornamento prima di farlo nel cluster di produzione.

Usare il comando di aggiornamento

È necessario usare il aks-engine upgrade comando come descritto in Aggiornare un cluster Kubernetes nell'hub di Azure Stack.

Interruzioni dell'aggiornamento

A volte fattori imprevisti interrompono l'aggiornamento del cluster. Un'interruzione può verificarsi quando il motore del servizio Azure Kubernetes segnala un errore o si verifica un errore nel processo di esecuzione del motore del servizio Azure Kubernetes. Esaminare la causa dell'interruzione, risolverla e inviare nuovamente lo stesso upgrade comando per continuare il processo di aggiornamento. Il upgrade comando è idempotente e deve riprendere l'aggiornamento del cluster dopo la reinviazione del comando. In genere, le interruzioni aumentano il tempo necessario per completare l'aggiornamento, ma non dovrebbero influire sul completamento.

Tempo stimato per l'aggiornamento

Il tempo di aggiornamento stimato è compreso tra 12 e 15 minuti per macchina virtuale nel cluster. Ad esempio, l'aggiornamento di un cluster a 20 nodi può richiedere circa 5 ore.

Scaricare una nuova immagine e il motore del servizio Azure Kubernetes

Scaricare le nuove versioni dell'immagine ubuntu di base del servizio Azure Kubernetes e del motore del servizio Azure Kubernetes.

Come illustrato nella documentazione relativa al motore del servizio Azure Kubernetes nell'hub di Azure Stack, la distribuzione di un cluster Kubernetes richiede:

  • Binario del motore del servizio Azure Kubernetes (obbligatorio).
  • Distribuzione dell'immagine ubuntu di base del servizio Azure Kubernetes 16.04-LTS (deprecata: non più usare, modificare il modello API per usare invece la versione 18.04).
  • Distribuzione dell'immagine Ubuntu 18.04-LTS di base del servizio Azure Kubernetes (necessaria per gli agenti Linux).
  • Distribuzione dell'immagine windows server di base del servizio Azure Kubernetes (necessaria per gli agenti Windows).

Le nuove versioni di queste sono disponibili con questo aggiornamento:

  • L'operatore hub di Azure Stack deve scaricare le nuove immagini di base del servizio Azure Kubernetes nel marketplace stamp:

  • L'amministratore del cluster Kubernetes (in genere un utente tenant dell'hub di Azure Stack) deve scaricare il nuovo motore del servizio Azure Kubernetes. Vedere le istruzioni in Installare il motore del servizio Azure Kubernetes in Linux nell'hub di Azure Stack (o nell'articolo equivalente di Windows). È possibile seguire lo stesso processo usato per installare il cluster per la prima volta. L'aggiornamento sovrascrive il file binario precedente. Ad esempio, se è stato usato lo script di get-akse.sh , seguire la stessa procedura descritta in Installare in un ambiente connesso. Lo stesso processo si applica se si esegue l'installazione in un sistema Windows: Installare il motore del servizio Azure Kubernetes in Windows nell'hub di Azure Stack.

Mapping del motore del servizio Azure Kubernetes e della versione di Azure Stack

Versione dell'hub di Azure Stack Versione del motore del servizio Azure Kubernetes
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4
2008 0.55.4, 0.60.1

Percorso di aggiornamento della versione di Kubernetes nel motore del servizio Azure Kubernetes v0.60.1

La versione corrente e la versione di aggiornamento per l'hub di Azure Stack sono disponibili nella tabella seguente. Questa tabella si applica al cluster del motore del servizio Azure Kubernetes nell'hub di Azure Stack. Non usare il comando aks-engine get-versions , che restituisce le versioni supportate in Azure globale e nell'hub di Azure Stack.

Versione corrente Aggiornamento disponibile
1.15.12 1.16.14, 1.16.15
1.16.14 1.16.15, 1.17.17
1.17.11 1.17.17, 1.18.15
1.17.17 1.18.15

Nel file JSON del modello API specificare i valori di versione e versione nella orchestratorProfile sezione . Ad esempio, se si prevede di distribuire Kubernetes 1.17.17, è necessario impostare i due valori seguenti (vedere l'esempio kubernetes-azurestack.json):

-   "orchestratorRelease": "1.17",
-   "orchestratorVersion": "1.17.17"

Motore del servizio Azure Kubernetes e mapping di immagini corrispondente

Motore del servizio Azure Kubernetes Immagine di base del servizio Azure Kubernetes Versioni di Kubernetes Esempi di modelli API
v0.43.1 Distribuzione di immagini di base di Ubuntu per il servizio Azure Kubernetes 16.04-LTS, ottobre 2019 (2019.10.24) 1.15.5, 1.15.4, 1.14.8, 1.14.7
v0.48.0 Distribuzione di immagini di base di Ubuntu per il servizio Azure Kubernetes 16.04-LTS, marzo 2020 (2020.03.19) 1.15.10, 1.14.7
v0.51.0 Distribuzione dell'immagine AKS Base Ubuntu 16.04-LTS, maggio 2020 (2020.05.13), immagine windows di base del servizio Azure Kubernetes (17763.1217.200513) 1.15.12, 1.16.8, 1.16.9 Linux, Windows
v0.55.0 Distribuzione dell'immagine AKS Base Ubuntu 16.04-LTS, agosto 2020 (2020.08.24), immagine windows di base del servizio Azure Kubernetes (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
v0.55.4 Distribuzione dell'immagine AKS Base Ubuntu 16.04-LTS, settembre 2020 (2020.09.14), immagine windows di base del servizio Azure Kubernetes (17763.1397.200820) 1.15.12, 1.16.14, 1.17.11 Linux, Windows
V0.60.1 Distribuzione dell'immagine Ubuntu 16.04-LTS di base del servizio Azure Kubernetes, gennaio 2021 (2021.01.28),
Distribuzione dell'immagine AKS Base Ubuntu 18.04-LTS, 2021 Q1 (2021.01.28),
Immagine di base di Windows per il servizio Azure Kubernetes (17763.1697.210129)
1.16.14, 1.16.15, 1.17.17, 1.18.15 Linux, Windows

Novità

Se si è interessati a partecipare a un'anteprima privata, è possibile richiedere l'accesso in anteprima.

Le nuove funzionalità includono:

Problemi noti

  • La distribuzione di più servizi Kubernetes in parallelo all'interno di un singolo cluster può causare un errore nella configurazione del servizio di bilanciamento del carico di base. È consigliabile distribuire un servizio alla volta.
  • Poiché lo strumento del motore del servizio Azure Kubernetes è un repository di codice sorgente condiviso in Azure e nell'hub di Azure Stack, esaminando le numerose note sulla versione e le richieste pull, è possibile che lo strumento supporti altre versioni di Kubernetes e della piattaforma del sistema operativo oltre a quelle elencate in precedenza. È possibile ignorarli e usare la tabella della versione precedente come guida ufficiale per questo aggiornamento.

Riferimento

L'elenco seguente è il set completo di note sulla versione per Azure e l'hub di Azure Stack combinati:

Si applica alla versione 0.55.4 del motore del servizio Azure Kubernetes.

Questo articolo descrive il contenuto del motore servizio Azure Kubernetes (AKS) nell'aggiornamento dell'hub di Azure Stack. L'aggiornamento include miglioramenti e correzioni per la versione più recente del motore del servizio Azure Kubernetes destinata alla piattaforma hub di Azure Stack. Questo articolo non è destinato a documentare le informazioni sulla versione per il motore del servizio Azure Kubernetes per Azure globale.

Pianificazione degli aggiornamenti

Il comando del motore upgrade del servizio Azure Kubernetes automatizza completamente il processo di aggiornamento del cluster e gestisce macchine virtuali (VM), rete, archiviazione, Kubernetes e attività di orchestrazione. Prima di applicare l'aggiornamento, assicurarsi di esaminare le informazioni sulla nota sulla versione.

Considerazioni sull'aggiornamento

  • Si usa l'elemento del marketplace corretto, la distribuzione dell'immagine Ubuntu 16.04-LTS di base del servizio Azure Kubernetes per la versione del motore del servizio Azure Kubernetes? Le versioni sono disponibili nella sezione "Scaricare una nuova immagine e il motore del servizio Azure Kubernetes".
  • Si usano le specifiche del cluster corrette (apimodel.json) e il gruppo di risorse per il cluster di destinazione? Quando è stato originariamente distribuito il cluster, questo file è stato generato nella directory di output. Vedere i parametri dei comandi deploy Deploy a Kubernetes cluster (Distribuire un cluster Kubernetes).
  • Si sta usando un computer affidabile per eseguire il motore del servizio Azure Kubernetes e da cui si eseguono operazioni di aggiornamento?
  • Se si aggiorna un cluster operativo con carichi di lavoro attivi, è possibile applicare l'aggiornamento senza influire su di essi, presupponendo che il cluster sia sottoposto a carico normale. Tuttavia, è necessario disporre di un cluster di backup nel caso in cui sia necessario reindirizzare gli utenti. È consigliabile usare un cluster di backup.
  • Se possibile, eseguire il comando da una macchina virtuale nell'ambiente dell'hub di Azure Stack per ridurre gli hop di rete e i potenziali errori di connettività.
  • Assicurarsi che la sottoscrizione disponga di una quota sufficiente per l'intero processo. Il processo alloca nuove macchine virtuali durante il processo. Il numero risultante di macchine virtuali sarà lo stesso dell'originale, ma pianificare la creazione di altre macchine virtuali durante il processo.
  • Non sono pianificati aggiornamenti di sistema o attività pianificate.
  • Configurare un aggiornamento a fasi in un cluster configurato con gli stessi valori del cluster di produzione e testare l'aggiornamento prima di farlo nel cluster di produzione.

Usare il comando di aggiornamento

È necessario usare il aks-engine upgrade comando come descritto in Aggiornare un cluster Kubernetes nell'hub di Azure Stack.

Interruzioni dell'aggiornamento

A volte fattori imprevisti interrompono l'aggiornamento del cluster. Un'interruzione può verificarsi quando il motore del servizio Azure Kubernetes segnala un errore o si verifica un errore nel processo di esecuzione del motore del servizio Azure Kubernetes. Esaminare la causa dell'interruzione, risolverla e inviare nuovamente lo stesso upgrade comando per continuare il processo di aggiornamento. Il upgrade comando è idempotente e deve riprendere l'aggiornamento del cluster dopo la reinviazione del comando. In genere, le interruzioni aumentano il tempo necessario per completare l'aggiornamento, ma non dovrebbero influire sul completamento.

Tempo stimato per l'aggiornamento

Il tempo di aggiornamento stimato è compreso tra 12 e 15 minuti per macchina virtuale nel cluster. Ad esempio, l'aggiornamento di un cluster a 20 nodi può richiedere circa 5 ore.

Scaricare una nuova immagine e il motore del servizio Azure Kubernetes

Scaricare le nuove versioni del motore ubuntu e dell'immagine Ubuntu di base del servizio Azure Kubernetes.

Come illustrato nella documentazione relativa al motore del servizio Azure Kubernetes nell'hub di Azure Stack, la distribuzione di un cluster Kubernetes richiede due componenti principali:

  • Binario del motore del servizio Azure Kubernetes (obbligatorio).
  • Distribuzione dell'immagine Ubuntu 16.04-LTS di base del servizio Azure Kubernetes

Con questo aggiornamento sono disponibili nuove versioni di queste immagini:

Mapping del motore del servizio Azure Kubernetes e della versione di Azure Stack

Versione dell'hub di Azure Stack Versione del motore del servizio Azure Kubernetes
1910 0.43.0, 0.43.1
2002 0.48.0, 0.51.0
2005 0.48.0, 0.51.0, 0.55.0, 0.55.4

Percorso di aggiornamento della versione di Kubernetes nel motore del servizio Azure Kubernetes v0.55.4

La versione corrente e la versione di aggiornamento per l'hub di Azure Stack sono disponibili nella tabella seguente. Questa tabella si applica al cluster del motore del servizio Azure Kubernetes nell'hub di Azure Stack. Non usare il comando aks-engine get-versions , che restituisce le versioni supportate in Azure globale e nell'hub di Azure Stack.

Versione corrente Aggiornamento disponibile
1.15.10 1.15.12
1.15.12, 1.16.8, 1.16.9 1.16.14
1.16.8, 1.16.9, 1.16.14 1.17.11

Nel file JSON del modello API specificare i valori di versione e versione nella orchestratorProfile sezione . Ad esempio, se si prevede di distribuire Kubernetes 1.17.17, è necessario impostare i due valori seguenti (vedere l'esempio kubernetes-azurestack.json):

    -   "orchestratorRelease": "1.16",
    -   "orchestratorVersion": "1.16.14"

Motore del servizio Azure Kubernetes e mapping di immagini corrispondente

Versioni di Kubernetes Note
1.15.5, 1.15.4, 1.14.8, 1.14.7
1.15.10, 1.14.7
1.15.12, 1.16.8, 1.16.9 Esempi di modelli API (Linux, Windows)
1.15.12, 1.16.14, 1.17.11 Esempi di modelli API (Linux, Windows)
1.15.12, 1.16.14, 1.17.11 Esempi di modelli API (Linux, Windows)

Novità

  • Aggiornare il disco rigido virtuale Linux di Azure Stack alla versione 2020.09.14 #3828
  • Aggiunge il supporto per K8s v1.17.11 in Azure Stack #3702
  • Aggiunge il supporto per K8s v1.16.14 in Azure Stack #3704
  • Aggiornamento del disco rigido virtuale Linux alla versione 2020.09.14 #3750
  • Aggiornamento del disco rigido virtuale Windows al numero 3730 di agosto
  • Aggiorna metrics-server Kubernetes a v0.3.7 #3669
  • Aggiorna la versione di Docker per risolvere il problema di rotazione dei log #3693
  • Aggiorna CoreDNS alla versione 1.7.0 #3608
  • Usare i pacchetti moby 19.03.x #3549
  • Correzioni alla strategia di aggiornamento azure-cni #3571

Problemi noti

  • La distribuzione di più servizi Kubernetes in parallelo all'interno di un singolo cluster può causare un errore nella configurazione del servizio di bilanciamento del carico di base. È consigliabile distribuire un servizio alla volta.
  • Quando si esegue il motore get-versionsdel servizio Azure Kubernetes, l'output produce informazioni applicabili ad Azure e all'hub di Azure Stack. Tuttavia, non esiste un modo esplicito per distinguere ciò che corrisponde all'hub di Azure Stack. Non usare questo comando per determinare quali versioni sono disponibili per l'aggiornamento. Usare la tabella di riferimento per l'aggiornamento descritta nella sezione precedente.
  • Poiché lo strumento del motore del servizio Azure Kubernetes è un repository di codice sorgente condiviso in Azure e nell'hub di Azure Stack, esaminando le numerose note sulla versione e le richieste pull, è possibile che lo strumento supporti altre versioni di Kubernetes e della piattaforma del sistema operativo oltre a quelle elencate in precedenza. È possibile ignorarli e usare la tabella della versione precedente come guida ufficiale per questo aggiornamento.

Riferimento

Questo è il set completo di note sulla versione per Azure e l'hub di Azure Stack combinati:

Si applica alla versione 0.48.0 o precedente del motore del servizio Azure Kubernetes.

Questo articolo descrive il contenuto del motore servizio Azure Kubernetes (AKS) nell'aggiornamento dell'hub di Azure Stack. L'aggiornamento include miglioramenti e correzioni per la versione più recente del motore del servizio Azure Kubernetes destinata alla piattaforma hub di Azure Stack. Questo articolo non è destinato a documentare le informazioni sulla versione per il motore del servizio Azure Kubernetes per Azure globale.

Pianificazione degli aggiornamenti

Il comando del motore upgrade del servizio Azure Kubernetes automatizza completamente il processo di aggiornamento del cluster e gestisce macchine virtuali (VM), rete, archiviazione, Kubernetes e attività di orchestrazione. Prima di applicare l'aggiornamento, assicurarsi di esaminare le informazioni sulla nota sulla versione.

Considerazioni sull'aggiornamento

  • Si usa l'elemento del marketplace corretto, la distribuzione dell'immagine Ubuntu 16.04-LTS di base del servizio Azure Kubernetes per la versione del motore del servizio Azure Kubernetes? È possibile trovare le versioni nella sezione Scaricare le nuove versioni del motore ubuntu ubuntu di base del servizio Azure Kubernetes.
  • Si usano le specifiche del cluster corrette (apimodel.json) e il gruppo di risorse per il cluster di destinazione? Quando è stato originariamente distribuito il cluster, questo file è stato generato nella directory di output. Vedere i parametri dei comandi deploy Deploy a Kubernetes cluster (Distribuire un cluster Kubernetes).
  • Si sta usando un computer affidabile per eseguire il motore del servizio Azure Kubernetes e da cui si eseguono operazioni di aggiornamento?
  • Se si aggiorna un cluster operativo con carichi di lavoro attivi, è possibile applicare l'aggiornamento senza influire su di essi, presupponendo che il cluster sia sottoposto a carico normale. Tuttavia, è necessario disporre di un cluster di backup nel caso in cui sia necessario reindirizzare gli utenti. È consigliabile usare un cluster di backup.
  • Se possibile, eseguire il comando da una macchina virtuale nell'ambiente dell'hub di Azure Stack per ridurre gli hop di rete e i potenziali errori di connettività.
  • Assicurarsi che la sottoscrizione disponga di una quota sufficiente per l'intero processo. Il processo alloca nuove macchine virtuali durante il processo. Il numero risultante di macchine virtuali sarà lo stesso dell'originale, ma pianificare la creazione di altre macchine virtuali durante il processo.
  • Non sono pianificati aggiornamenti di sistema o attività pianificate.
  • Configurare un aggiornamento a fasi in un cluster configurato con gli stessi valori del cluster di produzione e testare l'aggiornamento prima di farlo nel cluster di produzione.

Usare il comando di aggiornamento

È necessario usare il aks-engine upgrade comando come descritto in Aggiornare un cluster Kubernetes nell'hub di Azure Stack.

Interruzioni dell'aggiornamento

A volte fattori imprevisti interrompono l'aggiornamento del cluster. Un'interruzione può verificarsi quando il motore del servizio Azure Kubernetes segnala un errore o si verifica un errore nel processo di esecuzione del motore del servizio Azure Kubernetes. Esaminare la causa dell'interruzione, risolverla e inviare nuovamente lo stesso upgrade comando per continuare il processo di aggiornamento. Il upgrade comando è idempotente e deve riprendere l'aggiornamento del cluster dopo la reinviazione del comando. In genere, le interruzioni aumentano il tempo necessario per completare l'aggiornamento, ma non dovrebbero influire sul completamento.

Tempo stimato per l'aggiornamento

Il tempo di aggiornamento stimato è compreso tra 12 e 15 minuti per macchina virtuale nel cluster. Ad esempio, l'aggiornamento di un cluster a 20 nodi può richiedere circa 5 ore.

Scaricare una nuova immagine e il motore del servizio Azure Kubernetes

Scaricare le nuove versioni del motore ubuntu e dell'immagine Ubuntu di base del servizio Azure Kubernetes.

Come illustrato nella documentazione relativa al motore del servizio Azure Kubernetes nell'hub di Azure Stack, la distribuzione di un cluster Kubernetes richiede due componenti principali:

  • Binario del motore del servizio Azure Kubernetes (obbligatorio).
  • Distribuzione dell'immagine Ubuntu 16.04-LTS di base del servizio Azure Kubernetes.

Le nuove versioni di queste sono disponibili con questo aggiornamento:

Percorso di aggiornamento della versione di Kubernetes

La versione corrente e la versione di aggiornamento per l'hub di Azure Stack sono disponibili nella tabella seguente. Questa tabella si applica al cluster del motore del servizio Azure Kubernetes nell'hub di Azure Stack. Non usare il comando aks-engine get-versions , che restituisce le versioni supportate in Azure globale e nell'hub di Azure Stack.

Versione corrente Aggiornamento disponibile
1.14.7 1.15.10
1.14.8 1.15.10
1.15.4 1.15.10
1.15.5 1.15.10

Novità

  • Supporto per Kubernetes versione 1.15.10 (#2834). Quando si distribuisce un nuovo cluster, nel modello API .json file (noto anche come file di definizione del cluster), specificare sia il numero di versione finale che il numero di versione secondaria nel formato seguente. Per un esempio di file di definizione del cluster, vedere kubernetes-azurestack.json.

    • "orchestratorRelease": "1.15,

    • "orchestratorVersion": "1.15.10"

    Nota

    Se la versione di Kubernetes non viene specificata in modo esplicito nel file del modello API .json, verrà usata la versione 1.15 (#2932) e orchestratorVersion verrà predefinito 1.15.11, che genererà un errore durante la distribuzione del cluster.

  • Con aks-engine v0.43.1, le impostazioni di frequenza predefinite per il provider di servizi cloud per eseguire il ciclo di controllo e altre attività non funzionano correttamente con i limiti di soglia di Resource Manager dell'hub di Azure Stack per le richieste in ingresso. Questo aggiornamento modifica le impostazioni predefinite per l'hub di Azure Stack per ridurre il caricamento dei tentativi in Azure Stack Hub Resource Manager (#2861).

  • Il nuovo passaggio di verifica nel motore del servizio Azure Kubernetes comporterà l'arresto o la visualizzazione di avvisi se il modello API .json file contiene proprietà non supportate dall'hub di Azure Stack (#2717).

  • Con un nuovo check-in di verifica, il motore del servizio Azure Kubernetes convaliderà la disponibilità della versione dell'immagine di base del servizio Azure Kubernetes necessaria per la versione del motore del servizio Azure Kubernetes in esecuzione (#2342). Ciò si verifica dopo l'analisi del modello API .json file e prima di chiamare Azure Stack Hub Resource Manager.

  • La nuova opzione del motore del servizio Azure Kubernetes "--control-plane-only" nel upgrade comando consente all'utente di aggiornare le operazioni di destinazione solo al Macchine virtuali master (#2635).

  • Aggiornamenti al kernel Linux versione 4.15.0-1071-azure per Ubuntu 16.04-LTS. Per informazioni dettagliate, vedere "Package: linux-image-4.15.0-1071-azure (4.15.0-1071.76) [security]".

  • Nuovi aggiornamenti hyperkube per supportare le versioni di Kubernetes 1.14.8 e 1.15.10.

  • Aggiornare kubectl in modo che corrisponda alla versione di Kubernetes per il cluster. Questo componente è disponibile nei nodi del piano di controllo del cluster Kubernetes ed è possibile eseguirlo tramite SSH in un master.

  • Aggiornamenti per il componente aggiuntivo Monitoraggio Azure Container con la versione più recente di febbraio 2020 (#2850).

  • Aggiornamento alla coredns versione 1.6.6 (#2555).

  • Eseguire l'aggiornamento etcd alla versione 3.3.18 (#2462).

  • Eseguire l'aggiornamento moby alla versione 3.0.11 (#2887).

  • Con questa versione il motore del servizio Azure Kubernetes riduce la dipendenza da k8s.gcr.io per usare ora l'elemento ufficiale Kubernetes MCR registry @ mcr.microsoft.com durante la compilazione delle immagini (#2722).

Problemi noti

  • La distribuzione di più servizi Kubernetes in parallelo all'interno di un singolo cluster può causare un errore nella configurazione del servizio di bilanciamento del carico di base. È consigliabile distribuire un servizio alla volta.
  • L'esecuzione del motore get-versions azure Kubernetes produce informazioni applicabili ad Azure e all'hub di Azure Stack. Tuttavia, non esiste un modo esplicito per distinguere ciò che corrisponde all'hub di Azure Stack. Non usare questo comando per determinare quali versioni sono disponibili per l'aggiornamento. Usare la tabella di riferimento per l'aggiornamento descritta nella sezione precedente.
  • Poiché lo strumento del motore del servizio Azure Kubernetes è un repository di codice sorgente condiviso in Azure e nell'hub di Azure Stack, esaminando le numerose note sulla versione e le richieste pull, è possibile che lo strumento supporti altre versioni di Kubernetes e della piattaforma del sistema operativo oltre a quelle elencate in precedenza. È possibile ignorarli e usare la tabella della versione precedente come guida ufficiale per questo aggiornamento.

Riferimento

Di seguito è riportato un elenco di alcuni bug corretti e il set completo di note sulla versione dalla versione 0.44.0 alla versione 0.48.0. Le note sulla versione includono sia Azure che l'hub di Azure Stack.

Correzioni di bug

  • userAssignedIdentityId in Windows azure.json virgolette mancanti (#2327)

  • I componenti aggiuntivi update config sono solo aggiornamenti (#2282)

  • Timeout di urto per ottenere l'indirizzo IP di gestione nei nodi Windows (#2284)

  • Aggiungere il file .zip azure CNI 1.0.28 nel disco rigido virtuale Windows (#2268)

  • Correggere l'ordine predefinito per l'impostazione IPAddressCount (#2358)

  • Aggiornamento per l'uso di un singolo yaml omsagent per tutte le versioni K8s per evitare errori manuali e facilità di manutenzione (#2692)

Note sulla versione

Questo è il set completo di note sulla versione per Azure e l'hub di Azure Stack combinati:

Passaggi successivi