Panoramica dell'aggiornamento alla versione 1.4.4.
Le procedure per l'upgrade di Apigee hybrid sono organizzate nelle seguenti sezioni:
- Esegui il backup dell'installazione ibrida.
- Controlla la versione di Kubernetes ed esegui l'upgrade in modo appropriato.
- Esegui l'upgrade di ASM.
- Installare il runtime ibrido versione 1.4.
Prerequisito
- Apigee hybrid versione 1.3. Se esegui l'aggiornamento da una versione precedente, consulta le istruzioni. per Upgrade di Apigee hybrid alla versione 1.3.
Esegui l'upgrade alla versione 1.4
- (Consigliato) Crea una copia di backup della directory
$APIGEECTL_HOME/
della versione 1.3. Ad esempio:tar -czvf $APIGEECTL_HOME/../apigeectl-v1.3-backup.tar.gz $APIGEECTL_HOME
- (Consigliato) Esegui il backup del database Cassandra seguendo le istruzioni riportate in Backup e recupero di Cassandra
- Esegui l'upgrade della tua piattaforma Kubernetes come segue. Se hai bisogno di aiuto, segui la documentazione della tua piattaforma:
Piattaforma Esegui l'upgrade alla versione GKE 1,18,x GKE On-Prem (Anthos) 1.5.x AKS 1.18.x utilizzando Anthos cluster collegati EKS 1.18.x utilizzando Anthos cluster collegati - Aggiorna ASM alla versione 1.6.x.
- Esegui l'upgrade utilizzando la documentazione di ASM:
- GKE On-Prem (Anthos): Upgrade in corso Anthos Service Mesh on-premise
- Tutte le altre piattaforme: Upgrade in corso Anthos Service Mesh su GKE
- Specifica le seguenti porte in entrata e imposta la proprietà
runAsRoot
sutrue
nel tuo fileistio-operator.yaml
"… … … ports: - port: 15021 name: status-port targetPort: 15021 - port: 80 name: http2 targetPort: 80 - port: 443 name: https targetPort: 443 … … … values: gateways: istio-ingressgateway: runAsRoot: true
- Crea RP PeerAuthentication per la disattivazione di mTLS in
istio-operator.yaml
file:--- apiVersion: security.istio.io/v1beta1 kind: PeerAuthentication metadata: name: apigee-system namespace: apigee-system spec: mtls: mode: DISABLE --- apiVersion: security.istio.io/v1beta1 kind: PeerAuthentication metadata: name: user-namespace namespace: user-namespace spec: mtls: mode: DISABLE
- Applica queste modifiche con
istioctl
come descritto nella documentazione di ASM: - GKE On-Prem (Anthos): Aggiornare il piano di controllo
- Tutte le altre piattaforme: Aggiornare il piano di controllo
- Esegui l'upgrade utilizzando la documentazione di ASM:
Installazione del runtime ibrido 1.4.4
- Memorizza il numero dell'ultima versione in una variabile:
export VERSION=$(curl -s \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt?ignoreCache=1)
- Verifica che la variabile sia stata compilata con un numero di versione. Se vuoi utilizzare un altro
puoi salvarlo in una variabile di ambiente. Ad esempio:
echo $VERSION
1.4.4
Scarica il pacchetto di release per il tuo sistema operativo:
Mac a 64 bit:
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_64.tar.gz
Linux a 64 bit:
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_64.tar.gz
Mac 32 bit:
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_32.tar.gz
Linux a 32 bit:
curl -LO \ https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_32.tar.gz
- Rinomina la directory
apigeectl/
attuale con il nome della directory di backup. Ad esempio:mv $APIGEECTL_HOME/ $APIGEECTL_HOME-v1.2/
-
Estrai il contenuto del file gzip scaricato nella directory base ibrida. Ad esempio:
tar xvzf filename.tar.gz -C hybrid-base-directory
cd
alla directory di base.-
Per impostazione predefinita, i contenuti tar vengono espansi in una directory con la versione e la piattaforma nome. Ad esempio:
./apigeectl_1.4.4-xxx_linux_64
. Rinomina la directory aapigeectl
:mv apigeectl_1.4.5-xxx_linux_64 apigeectl
- Nella nuova directory
apigeectl/
, eseguiapigeectl init
,apigeectl apply
eapigeectl check-ready
:- Inizializzare hybrid 1.4.4:
apigeectl init -f overrides.yaml
Dove overrides.yaml è il file override.yaml modificato.
- Verifica che sia stato inizializzato correttamente con i seguenti comandi:
apigeectl check-ready -f overrides.yaml
kubectl describe apigeeds -n apigee
L'output dovrebbe essere simile al seguente:
Status: Cassandra Data Replication: Cassandra Pod Ips: 10.8.2.204 Cassandra Ready Replicas: 1 Components: Cassandra: Last Successfully Released Version: Revision: v1-f8aa9a82b9f69613 Version: v1 Replicas: Available: 1 Ready: 1 Total: 1 Updated: 1 State: running Scaling: In Progress: false Operation: Requested Replicas: 0 State: running
- La sintassi del flag
apigeectl
--dry-run
dipende dalla versione dikubectl
in esecuzione. Controlla la versione dikubectl
:gcloud version
- Verifica la presenza di errori con una prova con il comando appropriato per la tua versione di
kubectl
:kubectl
1.17 e versioni precedenti:apigeectl apply -f overrides.yaml --dry-run=true
kubectl
1.18 e versioni successive:apigeectl apply -f overrides.yaml --dry-run=client
- Applica gli override. Seleziona e segui le istruzioni per gli ambienti di produzione oppure
ambienti demo/sperimentali, a seconda dell'installazione.
Produzione
Per gli ambienti di produzione dovresti eseguire l'upgrade di ogni componente ibrido individualmente, e controlla lo stato del componente di cui è stato eseguito l'upgrade prima di passare al componente successivo.
- Applica gli override per eseguire l'upgrade di Cassandra:
apigeectl apply -f overrides.yaml --datastore
- Verifica di completamento:
kubectl -n namespace get pods
apigeectl check-ready -f overrides.yaml
Dove namespace è il tuo spazio dei nomi ibrido Apigee.
Procedi al passaggio successivo solo quando i pod sono pronti.
- Applica gli override per eseguire l'upgrade dei componenti di telemetria e verificare il completamento:
apigeectl apply -f overrides.yaml --telemetry
kubectl -n namespace get pods
apigeectl check-ready -f overrides.yaml
- Applica gli override per eseguire l'upgrade dei componenti a livello di organizzazione (MART, Watcher e Apigee)
connettiti) e verifica il completamento:
apigeectl apply -f overrides.yaml --org
kubectl -n namespace get pods
apigeectl check-ready -f overrides.yaml
- Applica gli override per eseguire l'upgrade degli ambienti. Hai a disposizione due opzioni:
- Ambiente per ambiente: applica gli override a un ambiente alla volta e controlla il completamento. Ripeti
questo passaggio per ogni ambiente:
apigeectl apply -f overrides.yaml --env env_name
kubectl -n namespace get pods
apigeectl check-ready -f overrides.yaml
dove env_name è il nome dell'ambiente di cui esegui l'upgrade.
- Tutti gli ambienti contemporaneamente: applica gli override a tutti gli ambienti contemporaneamente e verifica il completamento:
apigeectl apply -f overrides.yaml --all-envs
kubectl -n namespace get pods
apigeectl check-ready -f overrides.yaml
- Ambiente per ambiente: applica gli override a un ambiente alla volta e controlla il completamento. Ripeti
questo passaggio per ogni ambiente:
Demo/sperimentale
Nella maggior parte degli ambienti demo o sperimentali, è possibile applicare override a tutti i componenti contemporaneamente. Se il tuo ambiente dimostrativo/sperimentale è ampio e complesso o imita da vicino una di produzione, ti consigliamo di utilizzare le istruzioni per eseguire l'upgrade ambienti di produzione
apigeectl apply -f overrides.yaml
- Controlla lo stato:
apigeectl check-ready -f overrides.yaml
- Applica gli override per eseguire l'upgrade di Cassandra:
Complimenti! Hai eseguito correttamente l'upgrade ad Apigee hybrid versione 1.4.4.
- Inizializzare hybrid 1.4.4: