Aggiornare Astra Control Center
Per aggiornare Astra Control Center, scaricare il pacchetto di installazione dal NetApp Support Site e completare queste istruzioni. È possibile utilizzare questa procedura per aggiornare Astra Control Center in ambienti connessi a Internet o con connessione ad aria.
Prima di eseguire l'aggiornamento, assicurarsi che l'ambiente soddisfi ancora "Requisiti minimi per l'implementazione di Astra Control Center". L'ambiente deve avere i seguenti requisiti:
-
Una versione supportata di Astra Trident
Details
Determinare la versione di Trident in esecuzione:
kubectl get tridentversion -n trident
Fare riferimento a. "Documentazione di Astra Trident" per eseguire l'aggiornamento da una versione precedente.
Devi eseguire l'aggiornamento ad Astra Trident 22.10 * PRIOR* per eseguire l'aggiornamento a Kubernetes 1.25. -
Una distribuzione Kubernetes supportata
Details
Determinare la versione di Kubernetes in esecuzione:
kubectl get nodes -o wide
-
Risorse cluster sufficienti
Details
Determinare le risorse del cluster disponibili:
kubectl describe node <node name>
-
Un registro che puoi utilizzare per inviare e caricare le immagini di Astra Control Center
-
Una classe di storage predefinita
Details
Determinare la classe di storage predefinita:
kubectl get storageclass
-
Servizi API sani e disponibili
Details
Assicurarsi che tutti i servizi API siano in buono stato e disponibili:
kubectl get apiservices
-
(Solo OpenShift) operatori di cluster sani e disponibili
Details
Assicurarsi che tutti gli operatori del cluster siano in buono stato e disponibili.
kubectl get clusteroperators
Nell'ambito di questa procedura, è necessario Se si sta aggiornando Astra Control Center. Non è possibile eseguire l'aggiornamento alle versioni precedenti di Astra Control Center utilizzando questo operatore aggiornato. |
Il processo di aggiornamento di Astra Control Center ti guida attraverso le seguenti fasi di alto livello:
Disconnettersi dall'interfaccia utente di Astra Control Center prima di iniziare l'aggiornamento. |
Non eliminare l'operatore di Astra Control Center (ad esempio, kubectl delete -f astra_control_center_operator_deploy.yaml ) In qualsiasi momento durante l'aggiornamento o l'operazione di Astra Control Center per evitare di eliminare i pod.
|
Eseguire gli aggiornamenti in una finestra di manutenzione quando pianificazioni, backup e snapshot non sono in esecuzione. |
Scarica ed estrai Astra Control Center
-
Accedere alla "Pagina di download del prodotto Astra Control Center" Sul sito di supporto NetApp. È possibile selezionare la versione più recente o un'altra versione desiderata dal menu a discesa.
-
(Consigliato ma opzionale) Scarica il bundle di certificati e firme per Astra Control Center (
astra-control-center-certs-[version].tar.gz
) per verificare la firma del bundle.Espandere per i dettagli
tar -vxzf astra-control-center-certs-[version].tar.gz
openssl dgst -sha256 -verify certs/AstraControlCenter-public.pub -signature certs/astra-control-center-[version].tar.gz.sig astra-control-center-[version].tar.gz
Viene visualizzato l'output
Verified OK
una volta completata la verifica. -
Estrarre le immagini dal bundle Astra Control Center:
tar -vxzf astra-control-center-[version].tar.gz
Rimuovere il plug-in NetApp Astra kubectl e installarlo di nuovo
È possibile utilizzare il plug-in della riga di comando di NetApp Astra kubectl per inviare immagini a un repository Docker locale.
-
Determinare se il plug-in è installato:
kubectl astra
-
Eseguire una delle seguenti operazioni:
-
Se il plugin è installato, il comando dovrebbe restituire il plugin kubectl help ed è possibile rimuovere la versione esistente di kubectl-astra:
delete /usr/local/bin/kubectl-astra
. -
Se il comando restituisce un errore, il plug-in non è installato ed è possibile procedere con la fase successiva per installarlo.
-
-
Installare il plug-in:
-
Elencare i binari del plugin NetApp Astra kubectl disponibili e annotare il nome del file necessario per il sistema operativo e l'architettura della CPU:
La libreria di plugin kubectl fa parte del bundle tar e viene estratta nella cartella kubectl-astra
.
ls kubectl-astra/
-
Spostare il binario corretto nel percorso corrente e rinominarlo
kubectl-astra
:cp kubectl-astra/<binary-name> /usr/local/bin/kubectl-astra
-
Aggiungere le immagini al registro locale
-
Completare la sequenza di passaggi appropriata per il motore dei container:
-
Passare alla directory root del tarball. Viene visualizzata la
acc.manifest.bundle.yaml
file e queste directory:acc/
kubectl-astra/
acc.manifest.bundle.yaml
-
Trasferire le immagini del pacchetto nella directory delle immagini di Astra Control Center nel registro locale. Eseguire le seguenti sostituzioni prima di eseguire
push-images
comando:-
Sostituire <BUNDLE_FILE> con il nome del file bundle di controllo Astra (
acc.manifest.bundle.yaml
). -
Sostituire <MY_FULL_REGISTRY_PATH> con l'URL del repository Docker; ad esempio, "https://<docker-registry>".
-
Sostituire <MY_REGISTRY_USER> con il nome utente.
-
Sostituire <MY_REGISTRY_TOKEN> con un token autorizzato per il registro.
kubectl astra packages push-images -m <BUNDLE_FILE> -r <MY_FULL_REGISTRY_PATH> -u <MY_REGISTRY_USER> -p <MY_REGISTRY_TOKEN>
-
-
Passare alla directory root del tarball. Vengono visualizzati il file e la directory seguenti:
acc.manifest.bundle.yaml
acc/
-
Accedere al Registro di sistema:
podman login <YOUR_REGISTRY>
-
Preparare ed eseguire uno dei seguenti script personalizzato per la versione di Podman utilizzata. Sostituire <MY_FULL_REGISTRY_PATH> con l'URL del repository che include le sottodirectory.
Podman 4
export REGISTRY=<MY_FULL_REGISTRY_PATH> export PACKAGENAME=acc export PACKAGEVERSION=23.07.0-25 export DIRECTORYNAME=acc for astraImageFile in $(ls ${DIRECTORYNAME}/images/*.tar) ; do astraImage=$(podman load --input ${astraImageFile} | sed 's/Loaded image: //') astraImageNoPath=$(echo ${astraImage} | sed 's:.*/::') podman tag ${astraImageNoPath} ${REGISTRY}/netapp/astra/${PACKAGENAME}/${PACKAGEVERSION}/${astraImageNoPath} podman push ${REGISTRY}/netapp/astra/${PACKAGENAME}/${PACKAGEVERSION}/${astraImageNoPath} done
Podman 3
export REGISTRY=<MY_FULL_REGISTRY_PATH> export PACKAGENAME=acc export PACKAGEVERSION=23.07.0-25 export DIRECTORYNAME=acc for astraImageFile in $(ls ${DIRECTORYNAME}/images/*.tar) ; do astraImage=$(podman load --input ${astraImageFile} | sed 's/Loaded image: //') astraImageNoPath=$(echo ${astraImage} | sed 's:.*/::') podman tag ${astraImageNoPath} ${REGISTRY}/netapp/astra/${PACKAGENAME}/${PACKAGEVERSION}/${astraImageNoPath} podman push ${REGISTRY}/netapp/astra/${PACKAGENAME}/${PACKAGEVERSION}/${astraImageNoPath} done
Il percorso dell'immagine creato dallo script deve essere simile al seguente, a seconda della configurazione del Registro di sistema: https://netappdownloads.jfrog.io/docker-astra-control-prod/netapp/astra/acc/23.07.0-25/image:version
Installare l'operatore Astra Control Center aggiornato
-
Modificare la directory:
cd manifests
-
Modificare l'yaml di implementazione dell'operatore di Astra Control Center (
astra_control_center_operator_deploy.yaml
) per fare riferimento al registro locale e al segreto.vim astra_control_center_operator_deploy.yaml
-
Se si utilizza un registro che richiede l'autenticazione, sostituire o modificare la riga predefinita di
imagePullSecrets: []
con i seguenti elementi:imagePullSecrets: [{name: astra-registry-cred}]
-
Cambiare
ASTRA_IMAGE_REGISTRY
perkube-rbac-proxy
al percorso del registro in cui sono state inviate le immagini in a. passaggio precedente. -
Cambiare
ASTRA_IMAGE_REGISTRY
peracc-operator
al percorso del registro in cui sono state inviate le immagini in a. passaggio precedente. -
Aggiungere i seguenti valori a
env
sezione:- name: ACCOP_HELM_UPGRADETIMEOUT value: 300m
Esempio astra_control_center_operator_deploy.yaml:
apiVersion: apps/v1 kind: Deployment metadata: labels: control-plane: controller-manager name: acc-operator-controller-manager namespace: netapp-acc-operator spec: replicas: 1 selector: matchLabels: control-plane: controller-manager strategy: type: Recreate template: metadata: labels: control-plane: controller-manager spec: containers: - args: - --secure-listen-address=0.0.0.0:8443 - --upstream=http://127.0.0.1:8080/ - --logtostderr=true - --v=10 image: ASTRA_IMAGE_REGISTRY/kube-rbac-proxy:v4.8.0 name: kube-rbac-proxy ports: - containerPort: 8443 name: https - args: - --health-probe-bind-address=:8081 - --metrics-bind-address=127.0.0.1:8080 - --leader-elect env: - name: ACCOP_LOG_LEVEL value: "2" - name: ACCOP_HELM_UPGRADETIMEOUT value: 300m image: ASTRA_IMAGE_REGISTRY/acc-operator:23.07.25 imagePullPolicy: IfNotPresent livenessProbe: httpGet: path: /healthz port: 8081 initialDelaySeconds: 15 periodSeconds: 20 name: manager readinessProbe: httpGet: path: /readyz port: 8081 initialDelaySeconds: 5 periodSeconds: 10 resources: limits: cpu: 300m memory: 750Mi requests: cpu: 100m memory: 75Mi securityContext: allowPrivilegeEscalation: false imagePullSecrets: [] securityContext: runAsUser: 65532 terminationGracePeriodSeconds: 10
-
-
Installare l'operatore Astra Control Center aggiornato:
kubectl apply -f astra_control_center_operator_deploy.yaml
Esempio di risposta:
namespace/netapp-acc-operator unchanged customresourcedefinition.apiextensions.k8s.io/astracontrolcenters.astra.netapp.io configured role.rbac.authorization.k8s.io/acc-operator-leader-election-role unchanged clusterrole.rbac.authorization.k8s.io/acc-operator-manager-role configured clusterrole.rbac.authorization.k8s.io/acc-operator-metrics-reader unchanged clusterrole.rbac.authorization.k8s.io/acc-operator-proxy-role unchanged rolebinding.rbac.authorization.k8s.io/acc-operator-leader-election-rolebinding unchanged clusterrolebinding.rbac.authorization.k8s.io/acc-operator-manager-rolebinding configured clusterrolebinding.rbac.authorization.k8s.io/acc-operator-proxy-rolebinding unchanged configmap/acc-operator-manager-config unchanged service/acc-operator-controller-manager-metrics-service unchanged deployment.apps/acc-operator-controller-manager configured
-
Verificare che i pod siano in esecuzione:
kubectl get pods -n netapp-acc-operator
Aggiornare Astra Control Center
-
Modificare la risorsa personalizzata Astra Control Center (CR):
kubectl edit AstraControlCenter -n [netapp-acc or custom namespace]
-
Modificare il numero di versione di Astra (
astraVersion
all'interno dispec
) alla versione alla quale si sta eseguendo l'aggiornamento:spec: accountName: "Example" astraVersion: "[Version number]"
-
Verificare che il percorso del Registro di sistema dell'immagine corrisponda al percorso del Registro di sistema in cui sono state inviate le immagini in passaggio precedente. Aggiornare
imageRegistry
all'interno dispec
se il registro di sistema è stato modificato dall'ultima installazione.imageRegistry: name: "[your_registry_path]"
-
Aggiungere quanto segue al
crds
configurazione all'interno dispec
:crds: shouldUpgrade: true
-
Aggiungere le seguenti righe all'interno di
additionalValues
all'interno dispec
In Astra Control Center CR:additionalValues: nautilus: startupProbe: periodSeconds: 30 failureThreshold: 600 polaris-keycloak: livenessProbe: initialDelaySeconds: 180 readinessProbe: initialDelaySeconds: 180
-
Salvare e uscire dall'editor di file. Le modifiche verranno applicate e l'aggiornamento avrà inizio.
-
(Facoltativo) verificare che i pod terminino e diventino nuovamente disponibili:
watch kubectl get pods -n [netapp-acc or custom namespace]
-
Attendere che le condizioni di stato di Astra Control indichino che l'aggiornamento è completo e pronto (
True
):kubectl get AstraControlCenter -n [netapp-acc or custom namespace]
Risposta:
NAME UUID VERSION ADDRESS READY astra 9aa5fdae-4214-4cb7-9976-5d8b4c0ce27f 23.07.0-25 10.111.111.111 True
Per monitorare lo stato dell'aggiornamento durante l'operazione, eseguire il seguente comando: kubectl get AstraControlCenter -o yaml -n [netapp-acc or custom namespace]
Per esaminare i registri dell'operatore di Astra Control Center, eseguire il seguente comando:
kubectl logs deploy/acc-operator-controller-manager -n netapp-acc-operator -c manager -f
Verificare lo stato del sistema
-
Accedere ad Astra Control Center.
-
Verificare che la versione sia stata aggiornata. Consultare la pagina supporto nell'interfaccia utente.
-
Verificare che tutti i cluster e le applicazioni gestiti siano ancora presenti e protetti.