Configurare gli aggiornamenti per i membri della rete dell'applicazione Azure Kubernetes (anteprima)

Importante

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

La rete dell'applicazione Azure Kubernetes offre un controllo flessibile sulla modalità di applicazione degli aggiornamenti delle versioni secondarie ai membri. Ogni cluster membro registrato in una risorsa di rete dell'applicazione Azure Kubernetes può usare una delle due modalità di aggiornamento a seconda del livello di controllo richiesto: autogestito (SelfManaged) o completamente gestito (FullyManaged). Queste modalità operano a livello di membro, consentendo di scegliere se gli aggiornamenti vengono eseguiti manualmente o automaticamente per ogni cluster.

Questo articolo illustra le differenze tra queste modalità di aggiornamento, come configurarle per i membri della rete dell'applicazione Azure Kubernetes e considerazioni importanti da tenere presenti quando si gestiscono gli aggiornamenti.

Considerazioni generali sulla modalità di aggiornamento

Quando si configurano le modalità di aggiornamento per i membri della rete dell'applicazione Azure Kubernetes, tenere presenti le limitazioni e le considerazioni seguenti:

Le modalità di aggiornamento della rete dell'applicazione Azure Kubernetes si applicano solo alle versioni secondarie dei componenti di rete dell'applicazione Azure Kubernetes. Non controllano o influiscono sugli aggiornamenti a livello di cluster, ad esempio le versioni di Kubernetes o gli aggiornamenti delle immagini dei nodi.
Gli aggiornamenti delle patch vengono sempre applicati automaticamente, indipendentemente dalla modalità.
Selezionare la modalità di aggiornamento per ogni membro durante il processo di join. Una volta selezionata, la modalità rimane attiva per il membro fino a quando non viene rimossa dalla risorsa rete dell'applicazione Azure Kubernetes. Non è possibile modificare la modalità di aggiornamento per un membro senza prima rimuoverlo e ricollegarlo alla risorsa rete dell'applicazione Azure Kubernetes.
Se non si specifica una modalità di aggiornamento durante l'adesione di un membro, viene impostato automaticamente su SelfManaged.

Modalità autogestita

In SelfManaged modalità, si specifica la versione secondaria di Azure Kubernetes Application Network per installare e controllare quando si verificano gli aggiornamenti. Questa modalità è destinata agli scenari in cui si vuole gestire manualmente il processo di aggiornamento secondario anziché basarsi sugli aggiornamenti automatizzati. In questa modalità, se --version non viene specificato, la versione predefinita è la prima disponibile N-1. Questa modalità è anche l'impostazione predefinita se non viene specificata alcuna modalità di aggiornamento durante il join del membro.

Considerazioni sulla modalità autogestita

Quando si usa la SelfManaged modalità, tenere presenti le considerazioni seguenti:

Gli aggiornamenti sono consentiti solo tra versioni secondarie consecutive ( ad esempio, dalla versione N secondaria a N+1). Saltare le versioni (ad esempio, l'aggiornamento da 1.1 a 1.3) non è supportato.
È possibile eseguire il rollback solo alla versione immediatamente precedente (N-1), purché sia stata installata in precedenza nello stesso cluster. Il rollback a qualsiasi altra versione precedente non è supportato.
Non sono supportati rollback multipli consecutivi. È possibile eseguire il rollback di un massimo di una versione.

Eseguire la registrazione in modalità autogestita e selezionare la versione durante l'iscrizione come membro

Registrare in modalità SelfManaged e selezionare esplicitamente una versione durante l'iscrizione del membro usando il comando az appnet member join con il parametro --upgrade-mode SelfManaged e il parametro --version impostato sulla versione desiderata.

az appnet member join \
    --resource-group $APPNET_RG \
    --appnet-name $APPNET_NAME \
    --member-name $APPNET_MEMBER_NAME \
    --member-resource-id /subscriptions/$SUBSCRIPTION/resourcegroups/$AKS_RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER_NAME \
    --upgrade-mode SelfManaged \
    --version $VERSION

Controllare la versione corrente

Controllare quale versione è attualmente installata in un membro usando il az appnet member show comando e fare riferimento alla Version proprietà nell'output.
```
az appnet member show --member-name $APPNET_MEMBER_NAME --appnet-name $APPNET_NAME --resource-group $APPNET_RG
```

Controllare le versioni di aggiornamento disponibili

Controllare quali versioni sono disponibili per ogni modalità operativa e versione di Kubernetes nella regione usando il comando az appnet list-versions con il parametro --location impostato sulla regione di interesse. Nell'output fare riferimento alla AvailableUpgrades colonna per vedere quali versioni sono disponibili.
```
az appnet list-versions --location $LOCATION -o table
```

Avviare un aggiornamento

Avviare un aggiornamento usando il az appnet member update comando con il --version parametro impostato sulla versione desiderata a cui eseguire l'aggiornamento.
```
az appnet member update --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME --version $VERSION
```

Eseguire il rollback di una versione precedente

Eseguire il rollback a una versione installata in precedenza utilizzando il comando az appnet member update con il parametro --version impostato sulla versione desiderata per il rollback. Tenere presente che è supportato solo il rollback alla versione immediatamente precedente (N-1).
```
az appnet member update --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME --version $VERSION
```

Modalità completamente gestita

In FullyManaged modalità Azure Kubernetes Application Network gestisce automaticamente gli aggiornamenti delle versioni per ogni membro in base al canale di versione selezionato. È consigliabile usare questa modalità se si preferisce la rete dell'applicazione Azure Kubernetes per gestire la valutazione della stabilità della versione, la tempistica dell'implementazione e gli aggiornamenti continui senza intervento manuale.

Quando si usa la FullyManaged modalità di aggiornamento, si sceglie un canale di rilascio che determina la velocità con cui i cluster membri adottano nuove versioni. Azure Kubernetes Application Network monitora l'idoneità delle versioni e aggiorna i membri in base ai criteri di stabilità del canale.

Per la modalità FullyManaged sono disponibili i seguenti canali di rilascio:

Rapido: offre la versione più recente della rete dell'applicazione non appena diventa disponibile. Questo canale è destinato agli ambienti non di produzione o di convalida anticipata in cui il test di nuove funzionalità e funzionalità è prioritario rispetto al tempo di convalida esteso.
Stabile: offre versioni che hanno completato la convalida e il test aggiuntivi. Questo canale è destinato agli ambienti di produzione e in genere è allineato alla versione N-1secondaria, garantendo un'affidabilità più elevata e risolvendo eventuali problemi identificati nelle versioni precedenti.

Quando FullyManaged la modalità è selezionata, è possibile specificare il canale di rilascio su stable o rapid. Se omesso, il canale predefinito è stable.

Importante

In FullyManaged la modalità, Azure Kubernetes Application Network applica automaticamente gli aggiornamenti man mano che le nuove versioni vengono distribuite tramite canali di rilascio. Il controllo manuale dell'intervallo di aggiornamento o della selezione della versione non è supportato.

Controllare le versioni di aggiornamento disponibili per la modalità completamente gestita

Controllare a quale versione corrisponde ogni canale per una determinata regione e versione di Kubernetes usando il comando az appnet list-versions e grep per la modalità FullyManaged.
```
az appnet list-versions --location $LOCATION -o table | grep FullyManaged
```

Esegui la registrazione in modalità completamente gestita e seleziona il canale di rilascio durante l'adesione dei membri

Iscriversi in modalità FullyManaged e selezionare un canale di rilascio durante l'adesione di un membro utilizzando il comando az appnet member join con il parametro --upgrade-mode FullyManaged e il parametro --release-channel impostati sul canale desiderato. Nell'esempio seguente viene illustrato come selezionare il canale Rapid quando un membro si unisce.

az appnet member join \
    --resource-group $APPNET_RG \
    --appnet-name $APPNET_NAME \
    --member-name $APPNET_MEMBER_NAME \
    --member-resource-id /subscriptions/$SUBSCRIPTION/resourcegroups/$AKS_RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER_NAME \
    --upgrade-mode FullyManaged \
    --release-channel Rapid \
    --member-location $LOCATION

Aggiornare la selezione del canale di rilascio

È possibile aggiornare la versione selezionata in qualsiasi momento. Tutte le modifiche apportate al canale di rilascio diventano effettive immediatamente.

Aggiornare la selezione del canale di rilascio per un membro esistente usando il az appnet member update comando con il --release-channel parametro impostato sul canale desiderato. L'esempio seguente illustra come passare al Stable canale per un membro esistente:
```
az appnet member update --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME --release-channel Stable
```

Per altre informazioni sulla rete applicativa di Azure Kubernetes, vedere gli articoli seguenti:

Commenti e suggerimenti

Questa pagina è stata utile?

Ultimo aggiornamento: 2026-03-23