Note sulla versione per il motore del servizio Azure Kubernetes nell'hub di Azure Stack
Si applica alla versione v0.80.2 del motore del servizio Azure Kubernetes.
Questo articolo descrive il contenuto del motore servizio Azure Kubernetes (Servizio Azure Kubernetes) nell'aggiornamento dell'hub di Azure Stack. L'aggiornamento include miglioramenti e correzioni per la versione più recente del motore del servizio Azure Kubernetes destinato alla piattaforma hub di Azure Stack. Questo articolo non è destinato a documentare le informazioni sulla versione per il motore del servizio Azure Kubernetes globale.
Considerazioni sull'aggiornamento
- Si usano gli elementi del marketplace corretti, AKS Base Ubuntu 20.04 Image Distro o AKS Base Windows Server per la versione del motore del servizio Azure Kubernetes? È possibile trovare le versioni nella sezione Scaricare nuove immagini e motore del servizio Azure Kubernetes.
- Si usa la specifica del cluster corretta (apimodel.json) e il gruppo di risorse per il cluster di destinazione? Quando è stato distribuito originariamente il cluster, questo file è stato generato nella directory di output. Vedere i parametri di distribuzione dei comandi Distribuisci un cluster Kubernetes.
- Si usa un computer affidabile per eseguire il motore del servizio Azure Kubernetes e da cui si esegue 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 in carico normale. Tuttavia, è necessario disporre di un cluster di backup nel caso in cui sia necessario reindirizzare gli utenti. È consigliabile un cluster di backup.
- Se possibile, eseguire il comando da una macchina virtuale all'interno dell'ambiente hub di Azure Stack per ridurre gli hop di rete e 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 sarebbe lo stesso dell'originale, ma pianificare la creazione di alcune macchine virtuali durante il processo.
- Non sono pianificati aggiornamenti di sistema o attività pianificate.
- Configurare un aggiornamento in fase in un cluster configurato con gli stessi valori del cluster di produzione e testare l'aggiornamento prima di eseguire questa operazione nel cluster di produzione.
Usare il comando di aggiornamento
È necessario usare il comando come descritto in Aggiornare un cluster Kubernetes nell'hubaks-engine upgrade di Azure Stack.
Interruzioni dell'aggiornamento
Talvolta 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 aver ripristinato il comando. In genere, le interruzioni aumentano il tempo per completare l'aggiornamento, ma non dovrebbero influire sul completamento.
Tempo di aggiornamento stimato
Il tempo di aggiornamento stimato è compreso tra 12 e 15 minuti per macchina virtuale nel cluster. Ad esempio, un cluster a 20 nodi può richiedere circa 5 ore per eseguire l'aggiornamento.
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 del motore del servizio Azure Kubernetes per l'hub di Azure Stack, è necessario distribuire un cluster Kubernetes:
- Binario del motore del servizio Azure Kubernetes (obbligatorio).
- AKS Base Ubuntu 16.04-LTS Image Distro (deprecato - non più usato, modificare il modello API per usare invece 20.04).
- AKS Base Ubuntu 18.04-LTS Image Distro (deprecato - non più usato, modificare il modello API per usare invece 20.04).
- Distribuzione dell'immagine ubuntu 20.04-LTS di base del servizio Azure Kubernetes (richiesta per gli agenti Linux).
- Immagine di Windows Server base del servizio Azure Kubernetes (è necessaria una delle immagini seguenti per gli agenti Windows):
- Contenitore immagini windows server di base del servizio Azure Kubernetes.
- Docker dell'immagine di Windows Server di base del servizio Azure Kubernetes.
Le nuove versioni di queste immagini sono disponibili con questo aggiornamento:
Controllare la tabella di mapping delle versioni del servizio Azure Kubernetes e del motore del servizio Azure Kubernetes per le immagini di base del servizio Azure Kubernetes necessarie.
Seguire le istruzioni riportate in Aggiungere i prerequisiti del motore Di Azure Kubernetes Services (AKS) al Marketplace dell'hub di Azure Stack.
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 get-akse.sh , seguire la stessa procedura descritta in Installa in un ambiente connesso. Lo stesso processo si applica se si installa in un sistema Windows: installare il motore del servizio Azure Kubernetes in Windows in Azure Stack Hub.
Aggiornamento dei cluster Kubernetes creati con la distribuzione di Ubuntu 16.04
A partire dal motore del servizio Azure Kubernetes v0.63.0, la distribuzione ubuntu 16.04 non è più supportata, perché il sistema operativo ha raggiunto la fine della vita. 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 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 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 ubuntu 18.04 non è più supportata, perché il sistema operativo ha raggiunto la fine della vita. 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 dockercontainerRuntime 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 containerd.
Mapping della versione del servizio Azure Kubernetes e del mapping delle versioni 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* |
Nota
*Supportati. Per altre informazioni, vedere i criteri di supporto della versione del motore del servizio Azure Kubernetes .
Motore del servizio Azure Kubernetes e mapping delle immagini corrispondenti
È 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 versioni supportate in Azure globale e in 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 ubuntu 16.04-LTS di base del servizio Azure Kubernetes, maggio 2020 (2020.05.13), immagine di Windows 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 ubuntu 16.04-LTS di base del servizio Azure Kubernetes, agosto 2020 (2020.08.24), immagine di Windows 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 del servizio Azure Kubernetes Base Ubuntu 16.04-LTS, settembre 2020 (2020.09.14), Immagine di Windows 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 Ubuntu 18.04-LTS base del servizio Azure Kubernetes 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 | AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q2 (2021.05.24),Immagine di Windows 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 | AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q3 (2021.09.27),Immagine di Windows base del servizio Azure Kubernetes (17763.2213.210927) | 1.19.15, 1.20.11 | Esempi di modelli API (Linux, Windows) |
| v0.67.3 | AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q3 (2021.09.27),Immagine di Windows base del servizio Azure Kubernetes (17763.2213.210927) | 1.19.15, 1.20.11 | Esempi di modelli API (Linux, Windows) |
| v0.70.0 | AKS Base Ubuntu 18.04-LTS Image Distro, 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 ubuntu 18.04-LTS base del servizio Azure Kubernetes, 2022 Q3 (2022.08.12),immagine di Windows base del servizio Azure Kubernetes (17763.3232.220805) | 1.22.7*, 1.23.6* | Esempi di modelli API (Linux, Windows) |
| v0.73.0 | Distribuzione delle immagini di Ubuntu 18.04-LTS base del servizio Azure Kubernetes, 2022 Q4 (2022.11.02),Immagine di 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 | AKS Base Ubuntu 20.04-LTS Image Distro (2023.032.2), AKS BaseWindows Server 2019 Image Docker (17763.3887.20230332), AKS Base Windows Server 2019 Image Containerd (17763.3887.20230332) | 1.23.15*, 1.24.9** | Esempi di modelli API (Linux, Windows) |
| v0.76.0 | AKS Base Ubuntu 20.04-LTS Image Distro (2023.116.3), AKS Base Windows Server 2019 Image Containerd (17763.4252.20231163) | 1.24.11**, 1.25.7** | Esempi di modelli API (Linux, Windows) |
| v0.77.0 | Distribuzione delle immagini ubuntu 20.04-LTS di base del servizio Azure Kubernetes (2023.206.1), contenitore di immagini di Base windows server 2019 del servizio Azure Kubernetes (17763.4645.20232061) | 1.25.7**, 1.26.6** | Esempi di modelli API (Linux, Windows) |
| v0.78.0 | Distribuzione delle immagini ubuntu 20.04-LTS (2023.242.3) del servizio Azure Kubernetes base Windows Server 2019 Image Containerd (17763.4737.20232423) | 1.25.13**, 1.26.8** | Esempi di modelli API (Linux, Windows) |
| v0.79.0 | Distribuzione delle immagini ubuntu 20.04-LTS di base del servizio Azure Kubernetes (2023.296.1) , Contenitore di immagini di Base windows server 2019 del servizio Azure Kubernetes (17763.4974.20232961) | 1.26.9**, 1.27.6** | Esempi di modelli API (Linux, Windows) |
| v0.80.2 | AKS Base Ubuntu 20.04-LTS Image Distro (2024.032.1), AKS Base Windows Server 2019 Image Containerd (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 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 le macchine virtuali , la rete, l'archiviazione, kubernetes e le 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 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 dal nuovo repository aks-engine-azurestack. Di conseguenza, tutti i aks-engine comandi devono essere sostituiti con aks-engine-azurestack. I comandi per ottenere la versione più recente del motore del servizio Azure Kubernetes nell'hub di Azure Stack sono stati modificati anche. È possibile visualizzare i nuovi comandi in Creare client Linux e creare il client Windows. Creare un problema nel nuovo repository se si riscontrano problemi.
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 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 containerd.
Per altre funzionalità, vedere la pagina GitHub v0.75.3.
Istruzioni per l'uso del motore del servizio Azure Kubernetes 0.70.0 e versioni successive
Microsoft ha aggiornato il provider di cloud di Azure nella versione 0.70.0. Il provider di cloud di Azure è un componente principale condiviso tra azure del 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 tentando di 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 . Impossibile includere la nuova impostazione genera un errore di distribuzione.
Se si usano volumi di archiviazione: assicurarsi di usare il driver AzureDiskCSI . Versione 0.70.0 e versioni successive supportano solo i driver CSI, non il provider di archiviazione in albero legacy. Per eseguire l'aggiornamento, seguire le istruzioni riportate nell'aggiornamento 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 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 potrebbero portare a credere che lo strumento supporti altre versioni di Kubernetes e piattaforma del sistema operativo oltre a quelle elencate in precedenza. È possibile ignorarli e usare la tabella di versione precedente come guida ufficiale per questo aggiornamento.
- Il motore del servizio Azure Kubernetes v0.67.0 usa l'immagine windows errata durante la distribuzione di cluster Windows. Usare v0.70.0 per risolvere questo problema.
Riferimento
L'elenco seguente è il set completo di note sulla versione per Azure e Azure Stack Hub combinato:
- https://github.com/Azure/aks-engine/releases/tag/v0.64.0
- https://github.com/Azure/aks-engine/releases/tag/v0.65.0
- https://github.com/Azure/aks-engine/releases/tag/v0.65.1
- https://github.com/Azure/aks-engine/releases/tag/v0.66.0
- https://github.com/Azure/aks-engine/releases/tag/v0.66.1
- https://github.com/Azure/aks-engine/releases/tag/v0.67.0
- https://github.com/Azure/aks-engine/releases/tag/v0.70.0
- https://github.com/Azure/aks-engine/releases/tag/v0.71.0
- https://github.com/Azure/aks-engine/releases/tag/v0.73.0
- https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.75.3
- https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.76.0
- https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.77.0
- https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.78.0
- https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.79.0
Si applica alla versione v0.67.0 del motore del servizio Azure Kubernetes.
Questo articolo descrive il contenuto del motore servizio Azure Kubernetes (Servizio Azure Kubernetes) nell'aggiornamento dell'hub di Azure Stack. L'aggiornamento include miglioramenti e correzioni per la versione più recente del motore del servizio Azure Kubernetes destinato alla piattaforma hub di Azure Stack. Questo articolo non è destinato a documentare le informazioni sulla versione per il motore del servizio Azure Kubernetes 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 , le attività di rete, archiviazione, Kubernetes e 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, AKS Base Ubuntu 16.04-LTS o 18.04 Image Distro o AKS Base Windows Server per la versione del motore del servizio Azure Kubernetes? È possibile trovare le versioni nella sezione "Scaricare nuove immagini e motore del servizio Azure Kubernetes".
- Si usa la specifica del cluster corretta (apimodel.json) e il gruppo di risorse per il cluster di destinazione? Quando è stato distribuito originariamente il cluster, questo file è stato generato nella directory di output. Vedere i parametri di distribuzione dei comandi Distribuisci un cluster Kubernetes.
- Si usa un computer affidabile per eseguire il motore del servizio Azure Kubernetes e da cui si esegue 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 in carico normale. Tuttavia, è necessario disporre di un cluster di backup nel caso in cui sia necessario reindirizzare gli utenti. È consigliabile un cluster di backup.
- Se possibile, eseguire il comando da una macchina virtuale all'interno dell'ambiente hub di Azure Stack per ridurre gli hop di rete e 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 sarebbe lo stesso dell'originale, ma pianificare la creazione di alcune macchine virtuali durante il processo.
- Non sono pianificati aggiornamenti di sistema o attività pianificate.
- Configurare un aggiornamento in fase in un cluster configurato con gli stessi valori del cluster di produzione e testare l'aggiornamento prima di eseguire questa operazione nel cluster di produzione.
Usare il comando di aggiornamento
È necessario usare il comando come descritto in Aggiornare un cluster Kubernetes nell'hubaks-engine upgrade di Azure Stack.
Interruzioni dell'aggiornamento
Talvolta 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 aver ripristinato il comando. In genere, le interruzioni aumentano il tempo per completare l'aggiornamento, ma non dovrebbero influire sul completamento.
Tempo di aggiornamento stimato
Il tempo di aggiornamento stimato è compreso tra 12 e 15 minuti per macchina virtuale nel cluster. Ad esempio, un cluster a 20 nodi può richiedere circa 5 ore per eseguire l'aggiornamento.
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 del motore del servizio Azure Kubernetes per l'hub di Azure Stack, è necessario distribuire un cluster Kubernetes:
- Binario del motore del servizio Azure Kubernetes (obbligatorio).
- AKS Base Ubuntu 16.04-LTS Image Distro (deprecato - non più usato, modificare il modello API per usare invece 18.04).
- Distribuzione dell'immagine ubuntu 18.04-LTS di base del servizio Azure Kubernetes (richiesta per gli agenti Linux).
- Distribuzione dell'immagine di Windows Server di base del servizio Azure Kubernetes (richiesta per gli agenti Windows).
Le nuove versioni di queste immagini sono disponibili con questo aggiornamento:
Controllare la tabella di mapping delle versioni del servizio Azure Kubernetes e del motore del servizio Azure Kubernetes per le immagini di base del servizio Azure Kubernetes necessarie.
Seguire le istruzioni riportate in Aggiungere i prerequisiti del motore Di Azure Kubernetes Services (AKS) al Marketplace dell'hub di Azure Stack.
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 get-akse.sh , seguire la stessa procedura descritta in Installa in un ambiente connesso. Lo stesso processo si applica se si installa in un sistema Windows: installare il motore del servizio Azure Kubernetes in Windows in Azure Stack Hub.
Aggiornamento dei cluster Kubernetes creati con la distribuzione di Ubuntu 16.04
A partire dal motore del servizio Azure Kubernetes v0.67.0, la distribuzione ubuntu 16.04 non è più supportata, perché il sistema operativo ha raggiunto la fine della vita. Per aggiornare un cluster, assicurarsi di impostare la distribuzione aks-ubuntu-18.04 del sistema operativo 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 della versione del servizio Azure Kubernetes e del mapping delle versioni 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 kubernetes nel motore del servizio Azure Kubernetes v0.67.0
È possibile trovare la versione corrente e la versione di aggiornamento per l'hub di Azure Stack 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 versioni supportate in Azure globale e in 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 AKS Base Ubuntu 16.04-LTS, 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 AKS Base Ubuntu 18.04-LTS, 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 aks-engine è un repository di codice sorgente condiviso in Azure e nell'hub di Azure Stack, l'esame delle numerose note sulla versione e delle richieste pull potrebbe portare a credere 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:
- https://github.com/Azure/aks-engine/releases/tag/v0.64.0
- https://github.com/Azure/aks-engine/releases/tag/v0.65.0
- https://github.com/Azure/aks-engine/releases/tag/v0.65.1
- https://github.com/Azure/aks-engine/releases/tag/v0.66.0
- https://github.com/Azure/aks-engine/releases/tag/v0.66.1
- https://github.com/Azure/aks-engine/releases/tag/v0.67.0
Si applica alla versione 0.60.1 del motore del servizio Azure Kubernetes.
Questo articolo descrive il contenuto del motore del servizio Azure Kubernetes (servizio Azure Kubernetes) nell'aggiornamento dell'hub di Azure Stack. L'aggiornamento include miglioramenti e correzioni per la versione più recente del motore del servizio Azure Kubernetes destinato alla piattaforma hub di Azure Stack. Questo articolo non è progettato per 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 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, la versione di base del servizio Azure Kubernetes Ubuntu 16.04-LTS o 18.04 Image Distro o AKS Base Windows Server 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 il cluster è stato distribuito originariamente, questo file è stato generato nella directory di output. Vedere i parametri del comando 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 a tale cluster. È consigliabile usare un cluster di backup.
- Se possibile, eseguire il comando da una macchina virtuale all'interno dell'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 corrisponde all'originale, ma prevede 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
Talvolta 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 aver inviato di nuovo il 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 ogni 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 del servizio Azure Kubernetes di Base Ubuntu 16.04-LTS (deprecata: non più usata, modifica nel modello API per l'uso della versione 18.04).
- Distribuzione dell'immagine AKS Base Ubuntu 18.04-LTS (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:
Distribuzione di immagini di base di Ubuntu per il servizio Azure Kubernetes 16.04-LTS, 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)
Seguire le istruzioni in Aggiungere i prerequisiti del motore dei servizi Azure Kubernetes al Marketplace dell'hub di Azure Stack.
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 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 delle versioni 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 AKS Base Ubuntu 16.04-LTS, 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:
- Disponibilità generale di Ubuntu 18.04.
- Anteprima pubblica rotazione certificati n. 4214.
- T4 Nvidia GPU Private Preview #4259.
- Anteprima privata dell'integrazione di Azure Active Directory.
- Driver CSI per l'anteprima privata dei BLOB di Azure #712.
- CSI Driver Azure Disks Public Preview #712.CSI Driver Azure Disks Public Preview #712.
- CSI Driver NFS Public Preview #712.
- Supporto per Kubernetes 1. 17.17 #4188 e 1.18.15 #4187.
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 aks-engine è un repository di codice sorgente condiviso in Azure e nell'hub di Azure Stack, l'esame delle numerose note sulla versione e delle richieste pull potrebbe portare a credere 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 del servizio Azure Kubernetes (servizio Azure Kubernetes) nell'aggiornamento dell'hub di Azure Stack. L'aggiornamento include miglioramenti e correzioni per la versione più recente del motore del servizio Azure Kubernetes destinato alla piattaforma hub di Azure Stack. Questo articolo non è progettato per 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 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 usa l'elemento del marketplace corretto, 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 "Scarica nuova immagine 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 il cluster è stato distribuito originariamente, questo file è stato generato nella directory di output. Vedere i parametri del comando 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 a tale cluster. È consigliabile usare un cluster di backup.
- Se possibile, eseguire il comando da una macchina virtuale all'interno dell'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 sarebbe lo stesso dell'originale, ma pianificare la creazione di alcune macchine virtuali durante il processo.
- Non sono pianificati aggiornamenti di sistema o attività pianificate.
- Configurare un aggiornamento in fase in un cluster configurato con gli stessi valori del cluster di produzione e testare l'aggiornamento prima di eseguire questa operazione nel cluster di produzione.
Usare il comando di aggiornamento
È necessario usare il comando come descritto in Aggiornare un cluster Kubernetes nell'hubaks-engine upgrade di Azure Stack.
Interruzioni dell'aggiornamento
Talvolta 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 aver ripristinato il comando. In genere, le interruzioni aumentano il tempo per completare l'aggiornamento, ma non dovrebbero influire sul completamento.
Tempo di aggiornamento stimato
Il tempo di aggiornamento stimato è compreso tra 12 e 15 minuti per macchina virtuale nel cluster. Ad esempio, un cluster a 20 nodi può richiedere circa 5 ore per eseguire l'aggiornamento.
Scaricare una nuova immagine e il motore del servizio Azure Kubernetes
Scaricare le nuove versioni del motore Ubuntu Image e del servizio Azure Kubernetes di base del servizio Azure Kubernetes.
Come illustrato nella documentazione del 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 delle immagini ubuntu 16.04-LTS di base del servizio Azure Kubernetes
Le nuove versioni di queste immagini sono disponibili con questo aggiornamento:
L'operatore hub di Azure Stack deve scaricare una nuova immagine Ubuntu di base del servizio Azure Kubernetes nel marketplace di stamp:
Nome: Distribuzione dell'immagine ubuntu 16.04-LTS di base del servizio Azure Kubernetes, settembre 2020 (2020.09.14)
Versione: 2020.09.14
Seguire le istruzioni riportate in Aggiungere i prerequisiti del motore Di Azure Kubernetes Services (AKS) al Marketplace dell'hub di Azure Stack.
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 get-akse.sh , seguire la stessa procedura descritta in Installa in un ambiente connesso. Lo stesso processo si applica se si installa in un sistema Windows: installare il motore del servizio Azure Kubernetes in Windows in Azure Stack Hub.
Mapping della versione del servizio Azure Kubernetes e del mapping delle versioni 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 kubernetes nel motore del servizio Azure Kubernetes v0.55.4
È possibile trovare la versione corrente e la versione di aggiornamento per l'hub di Azure Stack 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 versioni supportate in Azure globale e in 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 delle immagini corrispondenti
| 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 a 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 a 2020.09.14 #3750
- Aggiornamento del disco rigido virtuale Windows a agosto #3730
- Aggiorna le metriche kubernetes al server v0.3.7 #3669
- Aggiorna la versione docker per correggere il problema di rotazione del log #3693
- Aggiorna CoreDNS alla versione 1.7.0 #3608
- Usare 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 aks-engine
get-versions, l'output produce informazioni applicabili all'hub di Azure e Azure Stack. Tuttavia, non esiste alcun 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 di aggiornamento descritta nella sezione precedente. - Poiché lo strumento del motore 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 potrebbero portare a credere che lo strumento supporti altre versioni di Kubernetes e piattaforma del sistema operativo oltre a quelle elencate in precedenza. È possibile ignorarli e usare la tabella di versione precedente come guida ufficiale per questo aggiornamento.
Riferimento
Questo è il set completo di note sulla versione per Azure e Azure Stack Hub combinato:
- https://github.com/Azure/aks-engine/releases/tag/v0.51.1
- https://github.com/Azure/aks-engine/releases/tag/v0.52.1
- https://github.com/Azure/aks-engine/releases/tag/v0.53.1
- https://github.com/Azure/aks-engine/releases/tag/v0.54.1
- https://github.com/Azure/aks-engine/releases/tag/v0.55.0
- https://github.com/Azure/aks-engine/releases/tag/v0.55.4
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 (Servizio Azure Kubernetes) nell'aggiornamento dell'hub di Azure Stack. L'aggiornamento include miglioramenti e correzioni per la versione più recente del motore del servizio Azure Kubernetes destinato alla piattaforma hub di Azure Stack. Questo articolo non è destinato a documentare le informazioni sulla versione per il motore del servizio Azure Kubernetes globale.
Pianificazione degli aggiornamenti
Il comando del motore upgrade del servizio Azure Kubernetes automatizza completamente il processo di aggiornamento del cluster e gestisce le macchine virtuali , 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 usa l'elemento del marketplace corretto, La distribuzione delle immagini ubuntu ubuntu 16.04-LTS corretta per la versione del motore del servizio Azure Kubernetes? È possibile trovare le versioni nella sezione Scaricare le nuove versioni del motore Ubuntu ubuntu e del motore del servizio Azure Kubernetes di base del servizio Azure Kubernetes.
- Si usa la specifica del cluster corretta (apimodel.json) e il gruppo di risorse per il cluster di destinazione? Quando è stato distribuito originariamente il cluster, questo file è stato generato nella directory di output. Vedere i parametri di distribuzione dei comandi Distribuisci un cluster Kubernetes.
- Si usa un computer affidabile per eseguire il motore del servizio Azure Kubernetes e da cui si esegue 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 in carico normale. Tuttavia, è necessario disporre di un cluster di backup nel caso in cui sia necessario reindirizzare gli utenti. È consigliabile un cluster di backup.
- Se possibile, eseguire il comando da una macchina virtuale all'interno dell'ambiente hub di Azure Stack per ridurre gli hop di rete e 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 sarebbe lo stesso dell'originale, ma pianificare la creazione di alcune macchine virtuali durante il processo.
- Non sono pianificati aggiornamenti di sistema o attività pianificate.
- Configurare un aggiornamento in fase in un cluster configurato con gli stessi valori del cluster di produzione e testare l'aggiornamento prima di eseguire questa operazione nel cluster di produzione.
Usare il comando di aggiornamento
È necessario usare il comando come descritto in Aggiornare un cluster Kubernetes nell'hubaks-engine upgrade di Azure Stack.
Interruzioni dell'aggiornamento
Talvolta 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 aver ripristinato il comando. In genere, le interruzioni aumentano il tempo per completare l'aggiornamento, ma non dovrebbero influire sul completamento.
Tempo di aggiornamento stimato
Il tempo di aggiornamento stimato è compreso tra 12 e 15 minuti per macchina virtuale nel cluster. Ad esempio, un cluster a 20 nodi può richiedere circa 5 ore per eseguire l'aggiornamento.
Scaricare una nuova immagine e il motore del servizio Azure Kubernetes
Scaricare le nuove versioni del motore Ubuntu Image e del servizio Azure Kubernetes di base del servizio Azure Kubernetes.
Come illustrato nella documentazione del 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:
L'operatore hub di Azure Stack deve scaricare le nuove immagini di base del servizio Azure Kubernetes nel marketplace di stamp:
Nome:
AKS Base Ubuntu 16.04-LTS Image Distro, March 2020Versione:
2020.03.19Seguire le istruzioni riportate in Aggiungere i prerequisiti del motore Di Azure Kubernetes Services (AKS) al Marketplace dell'hub di Azure Stack.
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 get-akse.sh , seguire la stessa procedura descritta in Installa in un ambiente connesso. Lo stesso processo si applica se si installa in un sistema Windows: installare il motore del servizio Azure Kubernetes in Windows in Azure Stack Hub.
Percorso di aggiornamento della versione di Kubernetes
È possibile trovare la versione corrente e la versione di aggiornamento per l'hub di Azure Stack 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 versioni supportate in Azure globale e in 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 file del modello API .json (noto anche come file di definizione del cluster), specificare sia il numero di versione che il numero di versione secondaria nel formato seguente. Per un file di definizione del cluster di esempio, vedere kubernetes-azurestack.json.
"orchestratorRelease": "1.15,"orchestratorVersion": "1.15.10"
Nota
Se la versione kubernetes non viene specificata in modo esplicito nel modello API .json file, verrà usata la versione 1.15 (#2932) e l'orchestratorVersion verrà predefinito a 1.15.11, che comporterà un errore durante la distribuzione del cluster.
Con aks-engine v0.43.1, le impostazioni di frequenza predefinite per il provider di cloud per eseguire il ciclo di controllo e altre attività non funzionano correttamente con l'hub di Azure Stack Resource Manager limiti di soglia per le richieste in ingresso. Questo aggiornamento modifica le impostazioni predefinite per l'hub di Azure Stack per ridurre il carico di ripetizione dei tentativi nell'hub di Azure Stack Resource Manager (#2861).
Il nuovo passaggio di verifica nel motore azure Kubernetes comporterà l'arresto dell'esecuzione 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 aks convalida 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 l'hub di Azure Stack Resource Manager.
La nuova opzione del motore aks "--control-plane-only" nel
upgradecomando consente all'utente di aggiornare le operazioni di destinazione solo alla Macchine virtuali master (#2635).Aggiornamenti a 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 Kubernetes versioni 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, è possibile eseguirlo da SSH in un master.
Aggiornamenti per il componente aggiuntivo Monitoraggio azure Container con la versione più recente di febbraio 2020 (#2850).
Aggiornamento alla
corednsversione 1.6.6 (#2555).Eseguire l'aggiornamento
etcdalla versione 3.3.18 (#2462).Eseguire l'aggiornamento
mobyalla versione 3.0.11 (#2887).Con questa versione il motore del servizio Azure Kubernetes taglia le dipendenze da
k8s.gcr.ioa questo momento usare l'ufficialeKubernetes MCR registry @ mcr.microsoft.comdurante la compilazione delle sue 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 di un motore
get-versionsazure kubernetes produce informazioni applicabili all'hub di Azure e Azure Stack. Tuttavia, non esiste alcun 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 di aggiornamento descritta nella sezione precedente. - Poiché lo strumento del motore 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 potrebbero portare a credere che lo strumento supporti altre versioni di Kubernetes e piattaforma del sistema operativo oltre a quelle elencate in precedenza. È possibile ignorarli e usare la tabella di versione precedente come guida ufficiale per questo aggiornamento.
Riferimento
Di seguito è riportato un elenco di alcuni bug risolti 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 Azure Stack Hub.
Correzioni di bug
userAssignedIdentityIdin Windows azure.json virgolette mancanti (#2327)I componenti aggiuntivi
update configsono di sola aggiornamento (#2282)Timeout di urto per ottenere l'IP di gestione nei nodi Windows (#2284)
Aggiungere il file CNI .zip di 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 yaml omsagent singolo per tutte le versioni K8s per evitare eventuali errori manuali e facilità di manutenzione (#2692)
Note sulla versione
Questo è il set completo di note sulla versione per Azure e Azure Stack Hub combinato:
- https://github.com/Azure/aks-engine/releases/tag/v0.44.0
- https://github.com/Azure/aks-engine/releases/tag/v0.44.1
- https://github.com/Azure/aks-engine/releases/tag/v0.44.2
- https://github.com/Azure/aks-engine/releases/tag/v0.45.0
- https://github.com/Azure/aks-engine/releases/tag/v0.46.0
- https://github.com/Azure/aks-engine/releases/tag/v0.46.1
- https://github.com/Azure/aks-engine/releases/tag/v0.46.2
- https://github.com/Azure/aks-engine/releases/tag/v0.46.3
- https://github.com/Azure/aks-engine/releases/tag/v0.47.0
- https://github.com/Azure/aks-engine/releases/tag/v0.48.0
Passaggi successivi
- Informazioni sul motore del servizio Azure Kubernetes nell'hub di Azure Stack
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per