Mettre à niveau Apigee hybrid vers la version 1.11

Cette procédure concerne la mise à niveau d'Apigee hybrid de la version 1.10.x vers la version 1.11.1 et depuis les versions précédentes d'Apigee hybrid de la version 1.11.x vers la version 1.11.1.

Utilisez les mêmes procédures pour les mises à niveau de versions mineures (par exemple, de la version 1.10 vers la version 1.11) et pour les mises à niveau de versions de correctifs (par exemple, de la version 1.11.0 vers la version 1.11.1).

Si vous effectuez une mise à niveau à partir de la version 1.9 d'Apigee hybrid ou d'une version antérieure, vous devez d'abord passer à la version 1.10 avant de migrer vers la version 1.11.1. Consultez les instructions de mise à niveau d'Apigee hybrid vers la version 1.10.

Présentation de la mise à niveau vers la version 1.11.1

La mise à niveau vers la version 1.10 d'Apigee hybrid peut nécessiter un temps d'arrêt.

Lors de la mise à niveau du contrôleur Apigee vers la version 1.11.1, tous les déploiements Apigee font l'objet d'un redémarrage progressif. Pour minimiser les temps d'arrêt dans les environnements hybrides de production lors d'un redémarrage progressif, assurez-vous d'exécuter au moins deux clusters (dans la même région ou dans un centre de données différent). Dirigez l'ensemble du trafic de production vers un seul cluster et sélectionnez le cluster que vous êtes sur le point de mettre à niveau hors connexion, puis poursuivez le processus de mise à niveau. Répétez cette procédure pour chaque cluster.

Apigee recommande de mettre à niveau tous les clusters dès que possible afin de réduire les risques d'impact sur la production. Après la mise à niveau du premier cluster, il n'y a pas de date limite pour procéder à la mise à niveau de l'ensemble des clusters restants. Les opérations suivantes seront toutefois affectées, jusqu'à ce que tous les clusters restants aient été mis à niveau :

La sauvegarde et la restauration de bases de données Cassandra ne peuvent pas fonctionner avec les versions mixtes. Par exemple, une sauvegarde Hybrid 1.10 ne peut pas être utilisée pour restaurer une instance Hybrid 1.11.
Le flux de données Cassandra ne fonctionnera pas entre les versions hybrides mixtes. Par conséquent, vos clusters Cassandra ne peuvent pas subir de scaling horizontal.
L'extension de région et la mise hors service seront affectées, car ces opérations dépendent du flux de données Cassandra.

Les procédures de mise à niveau d'Apigee hybrid sont organisées dans les sections suivantes :

Préparez la mise à niveau.
Installez la version 1.11.1 de l'environnement d'exécution hybride.

Prérequis

Ces instructions de mise à niveau supposent que vous avez installé Apigee hybrid 1.10.x et que vous souhaitez le mettre à niveau vers la version 1.11.1. Si vous effectuez une mise à jour à partir d'une version antérieure, consultez les instructions figurant dans la section Mettre à niveau Apigee hybrid vers la version 1.10.

Charts Helm et `apigeectl`

Dans la version 1.11, vous pouvez choisir d'installer et de gérer Apigee hybrid avec des charts Helm ou apigeectl. Apigee recommande d'utiliser Helm pour gérer votre installation.

Migrer vers la version 1.11 avec Helm à partir de la version 1.10 avec `apigeectl`

Pour passer à Apigee hybrid v1.11 géré par Helm à partir d'une installation hybride v1.10 gérée avec apigeectl, procédez comme suit :

Commencez par migrer votre installation Helm v1.10 en suivant les instructions de la section Migrer des graphiques Apigee hybrid vers Helm depuis apigeectl.
Suivez les instructions des graphiques Helm ci-dessous pour mettre à niveau votre installation.
Remarque : Lors de la mise à niveau d'une installation migrée, vous devez insérer une option --force dans les commandes helm upgrade.

Préparer la mise à niveau vers la version 1.11

Sauvegarder votre installation hybride (recommandé)

Helm

Ces instructions utilisent la variable d'environnement APIGEE_HELM_CHARTS_HOME pour le répertoire de votre système de fichiers dans lequel vous avez installé les charts Helm. Si nécessaire, accédez au répertoire et définissez la variable en utilisant la commande suivante :
Linux
```
export APIGEE_HELM_CHARTS_HOME=$PWD
echo $APIGEE_HELM_CHARTS_HOME
```
macOS
```
export APIGEE_HELM_CHARTS_HOME=$PWD
echo $APIGEE_HELM_CHARTS_HOME
```
Windows
```
set APIGEE_HELM_CHARTS_HOME=%CD%
echo %APIGEE_HELM_CHARTS_HOME%
```
Créez une copie de sauvegarde de votre répertoire $APIGEE_HELM_CHARTS_HOME/ version 1.10. Vous pouvez utiliser n'importe quel processus de sauvegarde. Par exemple, vous pouvez créer un fichier tar contenant l'intégralité de votre répertoire à l'aide de la commande suivante :
```
tar -czvf $APIGEE_HELM_CHARTS_HOME/../apigee-helm-charts-v1.10-backup.tar.gz $APIGEE_HELM_CHARTS_HOME
```
Sauvegardez votre base de données Cassandra en suivant les instructions figurant sur la page Sauvegarde et récupération de Cassandra.

Si vous utilisez des fichiers de certificat de service (.json) dans vos remplacements pour authentifier les comptes de service, assurez-vous que vos fichiers de certificat de compte de service se trouvent dans le répertoire de chart Helm approprié. Les charts Helm ne peuvent pas lire les fichiers en dehors de chaque répertoire de chart.

Cette étape n'est pas nécessaire si vous utilisez des secrets Kubernetes ou Workload Identity pour authentifier des comptes de service.

Le tableau suivant indique la destination de chaque fichier de compte de service, en fonction de votre type d'installation :

Prod

Compte de service	Nom de fichier par défaut	Répertoire du chart Helm
`apigee-cassandra`	`PROJECT_ID-apigee-cassandra.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-datastore/`
`apigee-logger`	`PROJECT_ID-apigee-logger.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-telemetry/`
`apigee-mart`	`PROJECT_ID-apigee-mart.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-org/`
`apigee-metrics`	`PROJECT_ID-apigee-metrics.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-telemetry/`
`apigee-runtime`	`PROJECT_ID-apigee-runtime.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-env`
`apigee-synchronizer`	`PROJECT_ID-apigee-synchronizer.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-env/`
`apigee-udca`	`PROJECT_ID-apigee-udca.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-org/`
`apigee-watcher`	`PROJECT_ID-apigee-watcher.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-org/`

Hors production

Créez une copie du fichier de compte de service apigee-non-prod dans chacun des répertoires suivants :

Compte de service	Nom de fichier par défaut	Répertoires du chart Helm
`apigee-non-prod`	`PROJECT_ID-apigee-non-prod.json`	`$APIGEE_HELM_CHARTS_HOME/apigee-datastore/` `$APIGEE_HELM_CHARTS_HOME/apigee-telemetry/` `$APIGEE_HELM_CHARTS_HOME/apigee-org/` `$APIGEE_HELM_CHARTS_HOME/apigee-env/`

Assurez-vous que votre certificat TLS et vos fichiers de clé (.crt, .key et/ou .pem) se trouvent dans le répertoire $APIGEE_HELM_CHARTS_HOME/apigee-virtualhost/.

`apigeectl`

Les exemples de ces instructions utilisent la structure de répertoires suivante. Votre installation peut être différente. Ajustez les instructions à la structure de votre installation.

hybrid-v1.11-root-directory/
└── apigeectl/
    └── config/
    └── plugins/
    └── templates/
    └── tools/
└── hybrid-files/
    └── overrides/
    └── service-accounts/
    └── certs/
hybrid-v1.10-root-directory/

Ces instructions utilisent la variable d'environnement APIGEECTL_HOME pour le répertoire de votre système de fichiers sur lequel vous avez installé apigeectl. Si nécessaire, accédez au répertoire apigeectl et définissez la variable en utilisant la commande suivante :
Linux
```
export APIGEECTL_HOME=$PWD
echo $APIGEECTL_HOME
```
macOS
```
export APIGEECTL_HOME=$PWD
echo $APIGEECTL_HOME
```
Windows
```
set APIGEECTL_HOME=%CD%
echo %APIGEECTL_HOME%
```
Créez une copie de sauvegarde de votre répertoire $APIGEECTL_HOME/ version 1.10. Par exemple :
```
tar -czvf $APIGEECTL_HOME/../apigeectl-v1.10-backup.tar.gz $APIGEECTL_HOME
```
Sauvegardez votre base de données Cassandra en suivant les instructions figurant sur la page Sauvegarde et récupération de Cassandra.

Mettre à niveau votre version de Kubernetes

Vérifiez la version de votre plate-forme Kubernetes et, si nécessaire, mettez à niveau votre plate-forme Kubernetes vers une version compatible avec les versions 1.10 et 1.11 d'Apigee hybrid. Si vous avez besoin d'aide, consultez la documentation de votre plate-forme.

Cliquer pour développer la liste des plates-formes compatibles

	Versions Apigee hybrid
Plates-formes	1.8 ⁽³⁾	1.9 ⁽³⁾	1.10	1.11
Anthos (Google Cloud – GKE)	1.21.x ^{(≤ 1.8.3)} 1.22.x ^{(≤ 1.8.3)} 1.23.x ^{(≤ 1.8.4)} 1.24.x ^{(≥ 1.8.4)} 1.25.x ^{(≥ 1.8.4)}	1.23.x 1.24.x 1.25.x 1.26.x ^{(≥ 1.9.2)}	1.24.x 1.25.x 1.26.x	1.25.x 1.26.x 1.27.x
Anthos (AWS)	1.10.x 1.11.x 1.12.x 1.13.x 1.25⁽¹³⁾	1.12.x 1.13.x 1.25⁽¹³⁾	1.13.x 1.25⁽¹³⁾ 1.26⁽¹³⁾	1.14.x 1.25⁽¹³⁾ 1.26⁽¹³⁾
Anthos (Azure)	1.10.x 1.11.x 1.12.x 1.13.x 1.14.x	1.12.x 1.13.x 1.14.x	1.13.x 1.14.x 1.15.x	1.14.x 1.15.x 1.16.x
Anthos (sur site – VMware) ⁽¹⁾ ⁽¹⁴⁾	1.10.x ⁽⁴⁾ 1.11.x ⁽⁴⁾ 1.12.x ⁽⁴⁾ ⁽⁵⁾ 1.13.x ⁽⁵⁾ 1.14.x ⁽⁵⁾ 1.15.x	1.12.x ⁽⁴⁾ 1.13.x 1.14.x 1.15.x	1.13.x 1.14.x 1.15.x 1.16.x	1.14.x 1.15.x 1.16.x
Anthos (Bare Metal)⁽¹⁾	1.10.x ⁽⁴⁾ 1.11.x ⁽⁴⁾ 1.12.x ⁽⁴⁾ ⁽⁵⁾ 1.13.x ⁽⁵⁾ 1.14.x ⁽⁵⁾ 1.15.x	1.12.x ⁽⁴⁾ 1.13.x 1.14.x 1.15.x	1.13.x 1.14.x 1.15.x 1.16.x	1.14.x 1.15.x 1.16.x
EKS⁽⁷⁾	1.22.x ^{(≤ 1.8.3)} 1.23.x ^{(≤ 1.8.4)} 1.24.x ^{(≥ 1.8.4)} 1.25.x ^{(≥ 1.8.4)}	1.23.x 1.24.x 1.25.x 1.26.x ^{(≥ 1.9.2)}	1.24.x 1.25.x 1.26.x	1.25.x 1.26.x 1.27.x
AKS⁽⁷⁾	1.22.x ^{(≤ 1.8.3)} 1.23.x ^{(≤ 1.8.4)} 1.24.x ^{(≥ 1.8.4)} 1.25.x ^{(≥ 1.8.4)}	1.23.x 1.24.x 1.25.x 1.26.x ^{(≥ 1.9.2)}	1.24.x 1.25.x 1.26.x	1.25.x 1.26.x 1.27.x
OpenShift⁽⁷⁾	4.8 4.9 4.10	4.10 4.11	4.11 4.12	4.12 4.13 4.14
Rancher Kubernetes Engine (RKE)⁽⁷⁾	N/A	1.3.8	v1.26.2+rke2r1	v1.26.2+rke2r1 v1.27.x
Composants	1.8 ⁽³⁾	1.9 ⁽³⁾	1.10	1.11
Anthos Service Mesh (ASM)	1.11.x 1.12.x 1.13.x 1.14.x 1.15.x	1.17.x⁽¹¹⁾	1.17.x⁽¹¹⁾	1.18.x⁽¹¹⁾
JDK	JDK 11	JDK 11	JDK 11	JDK 11
cert-manager	1.7.x 1.8.x 1.9.x 1.10.x 1.11.x	1.10.x 1.11.x	1.10.x 1.11.x 1.12.x	1.11.x 1.12.x 1.13.x
Cassandra	3.11.9	3.11.9	3.11.9	3.11.9
⁽¹⁾ Sur les versions Anthos 1.8, 1.9 et 1.10 et ultérieures, suivez les instructions de ces documents pour éviter tout conflit avec `cert-manager` : Anthos 1.8.2+ : conflit avec `cert-manager` lors de la mise à niveau vers la version 1.8.2 ou ultérieure. Anthos 1.9 : conflit avec `cert-manager` lors de la mise à niveau vers la version 1.9.0 ou 1.9.1. Anthos 1.10+ : installation de `cert-manager` en conflit. ⁽²⁾ Compatibilité avec Apigee hybrid version 1.7.2 et ultérieure. ⁽³⁾ Les dates de fin de vie officielles des versions 1.9 et antérieures d'Apigee hybrid ont été atteintes. Les correctifs mensuels standards ne sont plus disponibles. Ces versions ne sont plus officiellement compatibles, sauf pour les clients bénéficiant d'exceptions explicites et officielles. Les autres clients doivent effectuer une mise à niveau. ⁽⁴⁾Anthos sur bare metal et VMWare versions 1.12 et antérieures ne sont plus compatibles. Consultez les règles de compatibilité des versions d'Anthos sur bare metal et les versions des clusters Anthos sur VMware. ⁽⁵⁾Anthos sur bare metal et VMWare nécessitent ASM 1.14 ou une version ultérieure. Nous vous recommandons de passer à la version 1.8 d'Apigee hybrid et de passer à la passerelle d'entrée Apigee, qui ne vous oblige plus à installer ASM sur votre cluster hybride. ⁽⁶⁾ Compatibilité avec Apigee hybrid 1.8.4 et versions ultérieures. ⁽⁷⁾ Les clusters associés ne sont pas requis pour Apigee hybrid v1.8 et les versions ultérieures utilisant la passerelle d'entrée Apigee. ⁽⁸⁾ Non compatible avec Apigee hybrid 1.8.4 et versions ultérieures. ⁽⁹⁾ Compatibilité avec Apigee hybrid 1.7.6 et versions ultérieures. ⁽¹⁰⁾ Non compatible avec Apigee hybrid 1.8.5 et versions ultérieures. ⁽¹¹⁾ ASM est automatiquement installé avec Apigee hybrid 1.9 et les versions ultérieures. ⁽¹²⁾ Compatibilité avec Apigee hybrid 1.9.2 et versions ultérieures. ⁽¹³⁾ Les numéros de version des clusters Anthos sur AWS (multicloud) reflètent désormais les versions de Kubernetes. Consultez la page Compatibilité des versions et des mises à niveau d'Anthos pour obtenir des informations sur les versions et sur les correctifs recommandés. ⁽¹⁴⁾ Vault n'est pas certifié sur Anthos (sur site - VMware).

À propos des clusters associés

Pour les versions 1.7.x et antérieures d'Apigee hybrid, vous devez utiliser des clusters associés à Anthos si vous souhaitez exécuter Apigee hybrid dans un contexte multicloud sur Elastic Kubernetes Service (EKS), Azure Kubernetes Service (AKS) ou un autre fournisseur de services Kubernetes tiers compatible. Le rattachement de cluster permet à Google de mesurer l'utilisation d'Anthos Service Mesh (ASM). L'enregistrement du cluster tiers est facultatif. Vous ne devez procéder à l'enregistrement que si vous souhaitez afficher le cluster associé dans la console Google Cloud. Pour plus d'informations, consultez la section Associer des clusters Kubernetes tiers à Google Cloud.

Pour les versions 1.8.x d'Apigee hybrid, les clusters associés à Anthos sont requis si vous utilisez Anthos Service Mesh pour votre passerelle d'entrée. Si vous utilisez une passerelle d'entrée Apigee, les clusters associés à Anthos sont facultatifs.

Installer l'environnement d'exécution hybride 1.11.1

Helm

Préparer la mise à niveau des charts Helm

Extrayez les graphiques Helm Apigee.

Les charts Apigee hybrid sont hébergés dans Google Artifact Registry :

oci://us-docker.pkg.dev/apigee-release/apigee-hybrid-helm-charts

À l'aide de la commande pull, copiez tous les charts Helm Apigee hybrid sur votre espace de stockage local à l'aide de la commande suivante :

export CHART_REPO=oci://us-docker.pkg.dev/apigee-release/apigee-hybrid-helm-charts
export CHART_VERSION=1.11.1
helm pull $CHART_REPO/apigee-operator --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-datastore --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-env --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-ingress-manager --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-org --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-redis --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-telemetry --version $CHART_VERSION --untar
helm pull $CHART_REPO/apigee-virtualhost --version $CHART_VERSION --untar

Installez cert-manager si nécessaire.
Si vous devez mettre à niveau votre version de cert-manager, installez la nouvelle version à l'aide de la commande suivante :
```
kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.11.1/cert-manager.yaml
```

Installez les CRD Apigee mises à jour :

Remarque : Il s'agit de la seule méthode compatible pour installer des CRD Apigee. N'utilisez pas kubectl apply sans -k. N'omettez pas --server-side.

Utilisez la fonctionnalité de simulation kubectl en exécutant la commande suivante :

kubectl apply -k  apigee-operator/etc/crds/default/ --server-side --force-conflicts --validate=false --dry-run=server

Après avoir validé la commande avec la simulation, exécutez la commande suivante :

kubectl apply -k  apigee-operator/etc/crds/default/ --server-side --force-conflicts --validate=false

Validez l'installation à l'aide de la commande kubectl get crds :

kubectl get crds | grep apigee

Le résultat doit se présenter sous la forme suivante :

apigeedatastores.apigee.cloud.google.com                    2023-10-09T14:48:30Z
apigeedeployments.apigee.cloud.google.com                   2023-10-09T14:48:30Z
apigeeenvironments.apigee.cloud.google.com                  2023-10-09T14:48:31Z
apigeeissues.apigee.cloud.google.com                        2023-10-09T14:48:31Z
apigeeorganizations.apigee.cloud.google.com                 2023-10-09T14:48:32Z
apigeeredis.apigee.cloud.google.com                         2023-10-09T14:48:33Z
apigeerouteconfigs.apigee.cloud.google.com                  2023-10-09T14:48:33Z
apigeeroutes.apigee.cloud.google.com                        2023-10-09T14:48:33Z
apigeetelemetries.apigee.cloud.google.com                   2023-10-09T14:48:34Z
cassandradatareplications.apigee.cloud.google.com           2023-10-09T14:48:35Z

Vérifiez les libellés sur les nœuds de cluster. Par défaut, Apigee planifie les pods de données sur les nœuds portant le libellé cloud.google.com/gke-nodepool=apigee-data et les pods d'exécution sont programmés sur les nœuds portant le libellé cloud.google.com/gke-nodepool=apigee-runtime. Vous pouvez personnaliser les libellés de votre pool de nœuds dans le fichier overrides.yaml.

Pour en savoir plus, consultez la page Configurer des pools de nœuds dédiés.

Installer les charts Helm Apigee hybrid

Remarque : Avant d'exécuter des commandes de mise à niveau ou d'installation Helm, utilisez la fonctionnalité de simulation de Helm en ajoutant --dry-run à la fin de la commande. Consultez helm -h pour répertorier les commandes, les options et l'utilisation compatibles.

Si ce n'est pas le cas, accédez à votre répertoire APIGEE_HELM_CHARTS_HOME. Exécutez les commandes suivantes à partir de ce répertoire.

Mettez à niveau l'opérateur ou le contrôleur Apigee :

Remarque : Cette étape nécessite des autorisations de cluster élevées. Exécutez helm -h ou helm upgrade -h pour en savoir plus

Simulation :

helm upgrade operator apigee-operator/ \
  --install \
  --create-namespace \
  --namespace apigee-system \
  -f OVERRIDES_FILE \
  --dry-run

Mettez à niveau le graphique :

helm upgrade operator apigee-operator/ \
  --install \
  --create-namespace \
  --namespace apigee-system \
  -f OVERRIDES_FILE

Remarque : Pour les installations migrées, utilisez :

helm upgrade operator apigee-operator/ \
  --install \
  --create-namespace \
  --namespace apigee-system \
  --force \
  -f OVERRIDES_FILE

Vérifiez l'installation de l'opérateur Apigee :

helm ls -n apigee-system

NAME           NAMESPACE       REVISION        UPDATED                                 STATUS          CHART                   APP VERSION
operator    apigee-system   3               2023-06-26 00:42:44.492009 -0800 PST    deployed        apigee-operator-1.11.1   1.11.1

Vérifiez qu'il est opérationnel en vérifiant sa disponibilité :

kubectl -n apigee-system get deploy apigee-controller-manager

NAME                        READY   UP-TO-DATE   AVAILABLE   AGE
apigee-controller-manager   1/1     1            1           7d20h

Mettez à niveau le datastore Apigee :

Simulation :

helm upgrade datastore apigee-datastore/ \
  --install \
  --namespace apigee \
  -f OVERRIDES_FILE \
  --dry-run

Mettez à niveau le graphique :

helm upgrade datastore apigee-datastore/ \
  --install \
  --namespace apigee \
  -f OVERRIDES_FILE

Remarque : Pour les installations migrées, utilisez :

helm upgrade datastore apigee-datastore/ \
  --install \
  --namespace apigee \
  --force \
  -f OVERRIDES_FILE

Vérifiez que apigeedatastore est opérationnel en vérifiant son état :

kubectl -n apigee get apigeedatastore default

NAME      STATE       AGE
default   running    2d

Mettez à niveau la télémétrie Apigee :

Simulation :

helm upgrade telemetry apigee-telemetry/ \
  --install \
  --namespace apigee \
  -f OVERRIDES_FILE \
  --dry-run

Mettez à niveau le graphique :

helm upgrade telemetry apigee-telemetry/ \
  --install \
  --namespace apigee \
  -f OVERRIDES_FILE

Remarque : Pour les installations migrées, utilisez :

helm upgrade telemetry apigee-telemetry/ \
  --install \
  --namespace apigee \
  --force \
  -f OVERRIDES_FILE

Vérifiez qu'il est opérationnel en vérifiant son état :

kubectl -n apigee get apigeetelemetry apigee-telemetry

NAME               STATE     AGE
apigee-telemetry   running   2d

Mettez à niveau Apigee Redis :

Simulation :

helm upgrade redis apigee-redis/ \
  --install \
  --namespace apigee \
  -f OVERRIDES_FILE \
  --dry-run

Mettez à niveau le graphique :

helm upgrade redis apigee-redis/ \
  --install \
  --namespace apigee \
  -f OVERRIDES_FILE

Remarque : Pour les installations migrées, utilisez :

helm upgrade redis apigee-redis/ \
  --install \
  --namespace apigee \
  --force \
  -f OVERRIDES_FILE

Vérifiez qu'il est opérationnel en vérifiant son état :

kubectl -n apigee get apigeeredis default

NAME      STATE     AGE
default   running   2d

Mettez à niveau le gestionnaire d'entrée Apigee :

Simulation :

helm upgrade ingress-manager apigee-ingress-manager/ \
  --install \
  --namespace apigee \
  -f OVERRIDES_FILE \
  --dry-run

Mettez à niveau le graphique :

helm upgrade ingress-manager apigee-ingress-manager/ \
  --install \
  --namespace apigee \
  -f OVERRIDES_FILE

Remarque : Pour les installations migrées, utilisez :

helm upgrade ingress-manager apigee-ingress-manager/ \
  --install \
  --namespace apigee \
  --force \
  -f OVERRIDES_FILE

Vérifiez qu'il est opérationnel en vérifiant sa disponibilité :

kubectl -n apigee get deployment apigee-ingressgateway-manager

NAME                            READY   UP-TO-DATE   AVAILABLE   AGE
apigee-ingressgateway-manager   2/2     2            2           2d

Mettez à niveau l'organisation Apigee :

Simulation :

helm upgrade ORG_NAME apigee-org/ \
  --install \
  --namespace apigee \
  -f OVERRIDES_FILE \
  --dry-run

Mettez à niveau le graphique :

helm upgrade ORG_NAME apigee-org/ \
  --install \
  --namespace apigee \
  -f OVERRIDES_FILE

Remarque : Pour les installations migrées, utilisez :

helm upgrade ORG_NAME apigee-org/ \
  --install \
  --namespace apigee \
  --force \
  -f OVERRIDES_FILE

Vérifiez qu'elle est opérationnelle en vérifiant l'état de l'organisation correspondante :

kubectl -n apigee get apigeeorg

NAME                      STATE     AGE
apigee-org1-xxxxx          running   2d

Mettez à niveau l'environnement.
Vous devez installer un environnement à la fois. Spécifiez l'environnement avec --set env=ENV_NAME :

Simulation :
```
helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace apigee \
  --set env=ENV_NAME \
  -f OVERRIDES_FILE \
  --dry-run
```
- ENV_RELEASE_NAME est le nom avec lequel vous avez déjà installé le graphique apigee-env. Dans la version 1.10 d'Apigee hybrid, il s'agit généralement de apigee-env-ENV_NAME. Dans Apigee hybrid v1.11 et versions ultérieures, il s'agit généralement de ENV_NAME.
- ENV_NAME est le nom de l'environnement que vous mettez à niveau.
- OVERRIDES_FILE est votre nouveau fichier de remplacement pour la version v1.11.1.
Mettez à niveau le graphique :
```
helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace apigee \
  --set env=ENV_NAME \
  -f OVERRIDES_FILE
```
Remarque : Pour les installations migrées, utilisez :
```
helm upgrade ENV_RELEASE_NAME apigee-env/ \
  --install \
  --namespace apigee \
  --set env=ENV_NAME \
  --force \
  -f OVERRIDES_FILE
```
Vérifiez qu'il est opérationnel en vérifiant l'état de l'environnement correspondant :
```
kubectl -n apigee get apigeeenv
```
```
NAME                          STATE       AGE   GATEWAYTYPE
apigee-org1-dev-xxx            running     2d
```
Mettez à jour les groupes d'environnement (virtualhosts).
1. Vous devez installer un groupe d'environnements (hôte virtuel) à la fois. Spécifiez le groupe d'environnement avec --set envgroup=ENV_GROUP_NAME. Répétez les commandes suivantes pour chaque groupe d'environnements mentionné dans le fichier overrides.yaml :
  Simulation :
```
helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
  --install \
  --namespace apigee \
  --set envgroup=ENV_GROUP_NAME \
  -f OVERRIDES_FILE \
  --dry-run
```
  ENV_GROUP_RELEASE_NAME est le nom avec lequel vous avez déjà installé le graphique apigee-virtualhost. Dans la version 1.10 d'Apigee hybrid, il s'agit généralement de apigee-virtualhost-ENV_GROUP_NAME. Dans Apigee hybrid v1.11 et versions ultérieures, il s'agit généralement de ENV_GROUP_NAME.
  
  Mettez à niveau le graphique :
```
helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
  --install \
  --namespace apigee \
  --set envgroup=ENV_GROUP_NAME \
  -f OVERRIDES_FILE
```
  Remarque : Pour les installations migrées, utilisez :
```
helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
  --install \
  --namespace apigee \
  --set envgroup=ENV_GROUP_NAME \
  --force \
  -f OVERRIDES_FILE
```
  Remarque : ENV_GROUP_NAME doit être unique dans l'espace de noms apigee. Par exemple, si vous disposez d'un environnement et d'un groupe d'environnements prod, vous devez définir ce nom sur prod-envgroup. Le nom du groupe d'environnements ultérieur doit toujours être prod.
2. Vérifiez l'état de la ressource ApigeeRoute (AR).
  L'installation de virtualhosts crée ApigeeRouteConfig (ARC) qui crée ApigeeRoute en interne une fois que l'observateur Apigee extrait les détails liés au groupe d'environnement du plan de contrôle. Par conséquent, vérifiez que l'état d'AR correspondant est en cours d'exécution :
```
kubectl -n apigee get arc
```
```
NAME                                STATE   AGE
apigee-org1-dev-egroup                       2d
```
```
kubectl -n apigee get ar
```
```
NAME                                        STATE     AGE
apigee-org1-dev-egroup-xxxxxx                running   2d
```

`apigeectl`

Stockez le dernier numéro de version dans une variable à l'aide de la commande suivante :

Linux

export VERSION=$(curl -s \
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt?ignoreCache=1)

macOS

export VERSION=$(curl -s \
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt)

Windows

for /f "tokens=*" %a in ('curl -s ^
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/current-version.txt') ^
do set VERSION=%a

À l'aide de la commande suivante, vérifiez que le numéro de version a bien été enregistré dans la variable. Si vous souhaitez utiliser une autre version, vous pouvez l'enregistrer dans une variable d'environnement à la place.
```
echo $VERSION
```
La dernière version d'Apigee hybrid devrait s'afficher :
```
  1.11.1
```
Vérifiez que vous êtes bien dans le répertoire de base hybrid (c'est-à-dire le répertoire parent du répertoire dans lequel se trouve le fichier exécutable apigeectl) :
```
cd $APIGEECTL_HOME/..
```

Téléchargez le package de la version correspondant à votre système d'exploitation à l'aide de la commande suivante : Veillez à sélectionner la bonne plate-forme dans le tableau suivant :

Linux

Linux 64 bits :

curl -LO \
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_linux_64.tar.gz

macOS

Mac 64 bits :

curl -LO \
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/$VERSION/apigeectl_mac_64.tar.gz

Windows

Windows 64 bits :

curl -LO ^
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/%VERSION%/apigeectl_windows_64.zip

Remplacez le nom du répertoire apigeectl/ actuel par un nom de répertoire de sauvegarde. Exemple :

Linux

mv $APIGEECTL_HOME/ $APIGEECTL_HOME-v1.10/

macOS

mv $APIGEECTL_HOME/ $APIGEECTL_HOME-v1.10/

Windows

rename %APIGEECTL_HOME% %APIGEECTL_HOME%-v1.10

Extrayez le contenu du fichier gzip téléchargé dans votre répertoire de base hybride. Le répertoire de base hybrid est le répertoire dans lequel se trouve le répertoire apigeectl-v1.10 renommé :
Linux
```
tar xvzf filename.tar.gz -C ./
```
macOS
```
tar xvzf filename.tar.gz -C ./
```
Windows
```
tar xvzf filename.zip -C ./
```
Par défaut, le contenu du fichier tar est décompressé dans un répertoire dont le nom contient la version et la plate-forme. Exemple : ./apigeectl_1.11.1-xxxxxxx_linux_64. Changez le nom de ce répertoire en apigeectl à l'aide de la commande suivante :
Linux
```
mv apigeectl_1.11.1-xxxxxxx_linux_64 apigeectl
```
macOS
```
mv apigeectl_1.11.1-xxxxxxx_mac_64 apigeectl
```
Windows
```
rename apigeectl_1.11.1-xxxxxxx_windows_64 apigeectl
```
Accédez au répertoire apigeectl :
```
cd ./apigeectl
```
Ce répertoire correspond au répertoire d'accueil apigeectl. Il s'agit de l'emplacement de la commande exécutable apigeectl.
Ces instructions utilisent la variable d'environnement $APIGEECTL_HOME pour le répertoire de votre système de fichiers dans lequel l'utilitaire apigeectl est installé. Si nécessaire, accédez au répertoire apigeectl et définissez la variable en utilisant la commande suivante :
Linux
```
export APIGEECTL_HOME=$PWD
```
```
echo $APIGEECTL_HOME
```
macOS
```
export APIGEECTL_HOME=$PWD
```
```
echo $APIGEECTL_HOME
```
Windows
```
set APIGEECTL_HOME=%CD%
```
```
echo %APIGEECTL_HOME%
```
Vérifiez la version de apigeectl à l'aide de la commande version :
```
./apigeectl version
```
```
Version: 1.11.1
```
Créez un répertoire hybrid-base-directory/hybrid-files, puis accédez-y. Le répertoire hybrid-files correspond à l'emplacement où se trouvent les fichiers de configuration, tels que le fichier de remplacement, les certificats et les comptes de service. Exemple :
Linux
```
mkdir $APIGEECTL_HOME/../hybrid-files
```
```
cd $APIGEECTL_HOME/../hybrid-files
```
macOS
```
mkdir $APIGEECTL_HOME/../hybrid-files
```
```
cd $APIGEECTL_HOME/../hybrid-files
```
Windows
```
mkdir %APIGEECTL_HOME%/../hybrid-files
```
```
cd %APIGEECTL_HOME%/../hybrid-files
```
Vérifiez que kubectl est défini sur le bon contexte à l'aide de la commande suivante. Le contexte actuel doit être défini sur le cluster dans lequel vous mettez à niveau Apigee hybrid.
```
kubectl config get-contexts | grep \*
```
Dans le répertoire hybrid-files :
1. Mettez à jour les liens symboliques suivants de sorte qu'ils pointent vers $APIGEECTL_HOME. Ces liens vous permettent d'exécuter la commande apigeectl nouvellement installée à partir du répertoire hybrid-files :
```
ln -nfs $APIGEECTL_HOME/tools tools
ln -nfs $APIGEECTL_HOME/config config
ln -nfs $APIGEECTL_HOME/templates templates
ln -nfs $APIGEECTL_HOME/plugins plugins
```
2. Pour vérifier que les liens symboliques ont été créés correctement, exécutez la commande suivante et assurez-vous que les chemins d'accès aux liens pointent vers les emplacements appropriés :
```
ls -l | grep ^l
```
Effectuez une initialisation en test à blanc (dry run) pour rechercher d'éventuelles erreurs :
```
${APIGEECTL_HOME}/apigeectl init -f OVERRIDES_FILE --dry-run=client
```
Où OVERRIDES_FILE est le nom de votre fichier de remplacement, par exemple ./overrides/overrides.yaml.

Conseil : Vous pouvez remplacer OVERRIDES_FILE dans l'exemple de code ci-dessus par le nom et le chemin d'accès à votre fichier de remplacement. Chaque instance de cette page sera remplacée.
Si aucune erreur ne s'affiche, initialisez Apigee hybrid 1.11.1 :
```
$APIGEECTL_HOME/apigeectl init -f OVERRIDES_FILE
```
Remarque : apigeectl installe et configure la passerelle d'entrée Apigee lorsque vous exécutez apigeectl init.
Vérifiez l'état d'initialisation :
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```
En cas de réussite, le résultat indique : All containers ready.
```
kubectl describe apigeeds -n apigee
```
Dans le résultat, recherchez State: running.
Recherchez les erreurs à l'aide d'une simulation de la commande apply utilisant l'option --dry-run :
```
$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --dry-run=client
```
Si aucune erreur ne s'affiche, appliquez vos remplacements. Sélectionnez et suivez les instructions pour les environnements de production ou hors production, selon votre installation.
Production

Pour les environnements de production, mettez à niveau chaque composant Apigee hybrid individuellement, puis vérifiez l'état du composant mis à niveau avant de passer au composant suivant.
1. Assurez-vous d'être dans le répertoire hybrid-files.
2. Appliquez vos remplacements pour mettre à niveau Cassandra :
```
$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --datastore
```
3. Vérifiez que l'opération est terminée :
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```
  Conseil : Si check-ready échoue, vous pouvez obtenir plus d'informations sur vos pods avec :
  kubectl -n NAMESPACE get pods
  
  Où NAMESPACE est votre espace de noms Apigee hybrid.
  Ne passez à l'étape suivante que lorsque les pods sont prêts.
4. Appliquez vos remplacements pour mettre à niveau les composants Telemetry, puis vérifiez que l'opération est terminée :
```
$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --telemetry
```
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```
5. Afficher les composants Redis :
```
$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --redis
```
6. Appliquez vos remplacements pour mettre à niveau les composants au niveau de l'organisation (MART, Watcher et Apigee Connect), puis vérifiez que l'opération est terminée :
```
$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --org
```
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```
7. Appliquez vos remplacements pour mettre à niveau vos environnements. Deux possibilités s'offrent à vous :
  - Environnement par environnement : appliquez vos remplacements à un environnement à la fois et vérifiez que l'opération est terminée. Répétez cette étape pour chaque environnement :
    $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --env ENV_NAME
    
    $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
    
    Où ENV_NAME est le nom de l'environnement que vous mettez à niveau.
  - Tous les environnements à la fois : appliquez vos remplacements à tous les environnements en même temps et vérifiez que l'opération est terminée :
    $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --all-envs
    
    $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
8. Appliquez vos remplacements pour mettre à niveau les composants virtualhosts, puis vérifiez que l'opération est terminée :
```
$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --settings virtualhosts
```
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```
Hors production

Dans la plupart des environnements hors production, de démonstration ou expérimentaux, vous pouvez appliquer vos remplacements simultanément sur tous les composants. Si votre environnement hors production est volumineux et complexe, ou s'il imite fidèlement un environnement de production, vous pouvez suivre les instructions de mise à niveau des environnements de production.
1. Assurez-vous d'être dans le répertoire hybrid-files.
2. ```
$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE
```
3. Vérifiez l'état :
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```

Installez `1.11.1-hotfix.1`.

Exécutez les commandes suivantes pour installer la version de correctif, 1.11.1-hotfix.1. Pour en savoir plus, consultez la page hybrid 1.11.1-hotfix.1 dans les notes de version d'Apigee.

Ouvrez le fichier de remplacement.
Commencez par mettre à jour votre fichier de remplacement. Suivez les instructions correspondant à l'outil que vous utilisez pour gérer Apigee hybrid, Helm ou apigeectl :
Helm
1. Dans le stanza istiod, remplacez la version du tag d'image (le cas échéant) par la version 1.17.8. Par exemple :
```
istiod:
  image:
    url: "gcr.io/apigee-release/hybrid/apigee-asm-istiod"
    tag: "1.17.8-asm.20-distroless"
```
2. Dans le stanza apigeeIngressGateway, remplacez la version du tag d'image (le cas échéant) par la version 1.17.8. Par exemple :
```
apigeeIngressGateway:
  image:
    url: "gcr.io/apigee-release/hybrid/apigee-asm-ingress"
    tag: "1.17.8-asm.20-distroless"
```
3. Enregistrez le fichier.
apigeectl
1. Dans le stanza istiod, remplacez la version du tag d'image (le cas échéant) par la version 1.17.8. Par exemple :
```
istiod:
  image:
    url: "gcr.io/apigee-release/hybrid/apigee-asm-istiod"
    tag: "1.17.8-asm.20-distroless"
```
2. Selon la manière dont vous avez choisi d'installer Apigee hybrid, vous pouvez avoir un stanza ingressGateway ou ingressGateways. Recherchez le stanza qui s'affiche dans votre fichier de remplacement et remplacez la version du tag d'image (le cas échéant) par la version 1.17.8. Par exemple, si vous disposez d'un stanza ingressGateway:
```
ingressGateway:
  image:
    url: "gcr.io/apigee-release/hybrid/apigee-asm-ingress"
    tag: "1.17.8-asm.20-distroless"
```
  Ou, si vous avez un stanza ingressGateways:
```
ingressGateways:
  - name: gateway1
    image:
      url: "gcr.io/apigee-release/hybrid/apigee-asm-ingress"
      tag: "1.17.8-asm.20-distroless"
    ...
  - name: gateway2
    image:
      url: "gcr.io/apigee-release/hybrid/apigee-asm-ingress"
      tag: "1.17.8-asm.20-distroless"
    ... 
```
3. Enregistrez le fichier.
Ensuite, appliquez les modifications. Suivez les instructions correspondant à l'outil que vous utilisez pour gérer Apigee hybrid, Helm ou apigeectl :
Helm
1. Installez le chart apigee-ingress-manager à l'aide de la commande suivante :
```
helm upgrade ingress-manager apigee-ingress-manager/ \
  --install \
  --namespace "YOUR_APIGEE_NAMESPACE" \
  --atomic \
  -f OVERRIDES_FILE
```
2. Installez le chart apigee-org à l'aide de la commande suivante :
```
helm upgrade ORG_NAME apigee-org/ \
    --install \
    --namespace "YOUR_APIGEE_NAMESPACE" \
    --atomic \
    -f OVERRIDES_FILE
```
3. Vérifiez l'état des pods :
```
kubectl get pods -n YOUR_APIGEE_NAMESPACE
```
apigeectl
1. Exécutez la commande suivante pour initialiser le composant istiod:
```
$APIGEECTL_HOME/apigeectl init -f OVERRIDES_FILE
```
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```
2. Exécutez la commande suivante pour appliquer les modifications aux composants d'entrée Apigee. Si vous avez plusieurs organisations, répétez cette commande pour chacune d'elles:
```
$APIGEECTL_HOME/apigeectl apply --org -f OVERRIDES_FILE
```
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```
3. Vérifiez l'état des pods :
```
kubectl get pods -n YOUR_APIGEE_NAMESPACE
```

Effectuer un rollback de la mise à niveau

Suivez ces étapes ci-dessous pour effectuer le rollback vers une mise à niveau précédente :

Helm

Pour revenir à la version précédente, utilisez les graphiques et le fichier de remplacement de l'installation précédente.

Créez la variable d'environnement suivante :
- PREVIOUS_HELM_CHARTS_HOME : Répertoire dans lequel les graphiques Helm Apigee hybrid précédents sont installés. Il s'agit de la version vers laquelle vous effectuez le rollback.
Effectuer un rollback des hôtes virtuels. Répétez la commande suivante pour chaque groupe d'environnements mentionné dans le fichier de remplacement.
```
helm upgrade ENV_GROUP_RELEASE_NAME $PREVIOUS_HELM_CHARTS_HOME/apigee-virtualhost/ \
  --namespace apigee \
  --atomic \
  --set envgroup=ENV_GROUP_NAME \
  -f PREVIOUS_OVERRIDES_FILE
```
ENV_GROUP_RELEASE_NAME est le nom avec lequel vous avez déjà installé le graphique apigee-virtualhost. Dans la version 1.10 d'Apigee hybrid, il s'agit généralement de apigee-virtualhost-ENV_GROUP_NAME. Dans Apigee hybrid v1.11 et versions ultérieures, il s'agit généralement de ENV_GROUP_NAME.
Effectuer un rollback des environnements Répétez la commande suivante pour chaque environnement mentionné dans le fichier de remplacement.
```
helm upgrade apigee-env-ENV_NAME $PREVIOUS_HELM_CHARTS_HOME/apigee-env/ \
  --install \
  --namespace apigee \
  --atomic \
  --set env=ENV_NAME \
  -f PREVIOUS_OVERRIDES_FILE
```
ENV_RELEASE_NAME est le nom avec lequel vous avez déjà installé le graphique apigee-env. Dans la version 1.10 d'Apigee hybrid, il s'agit généralement de apigee-env-ENV_NAME. Dans Apigee hybrid v1.11 et versions ultérieures, il s'agit généralement de ENV_NAME.

Effectuer un rollback de l'organisation :

helm upgrade ORG_NAME $PREVIOUS_HELM_CHARTS_HOME/apigee-org/ \
  --install \
  --namespace apigee \
  --atomic \
  -f PREVIOUS_OVERRIDES_FILE

Effectuez un rollback du gestionnaire d'entrée :

helm upgrade ingress-manager $PREVIOUS_HELM_CHARTS_HOME/apigee-ingress-manager/ \
  --install \
  --namespace apigee \
  --atomic \
  -f PREVIOUS_OVERRIDES_FILE

Effectuer un rollback de Redis :

helm upgrade redis $PREVIOUS_HELM_CHARTS_HOME/apigee-redis/ \
  --install \
  --namespace apigee \
  --atomic \
  -f PREVIOUS_OVERRIDES_FILE

Effectuer un rollback d'Apigee Telemetry :

helm upgrade telemetry $PREVIOUS_HELM_CHARTS_HOME/apigee-telemetry/ \
  --install \
  --namespace apigee \
  --atomic \
  -f PREVIOUS_OVERRIDES_FILE

Effectuez un rollback d'Apigee Datastore (le composant de base de données Cassandra) :

helm upgrade datastore $PREVIOUS_HELM_CHARTS_HOME/apigee-datastore/ \
  --install \
  --namespace apigee \
  --atomic \
  -f PREVIOUS_OVERRIDES_FILE

Effectuez un rollback du contrôleur Apigee :

helm upgrade operator $PREVIOUS_HELM_CHARTS_HOME/apigee-operator/ \
  --install \
  --namespace apigee-system \
  --atomic \
  -f PREVIOUS_OVERRIDES_FILE

Effectuez un rollback des CRD Apigee hybrid :

  kubectl apply -k  $PREVIOUS_HELM_CHARTS_HOME/apigee-operator/etc/crds/default/ --server-side --force-conflicts --validate=false

`apigeectl`

Nettoyez les tâches terminées pour l'espace de noms d'exécution hybride, où NAMESPACE correspond à l'espace de noms spécifié dans votre fichier de remplacement, si vous avez spécifié un espace de noms. Si ce n'est pas le cas, l'espace de noms par défaut est apigee :
```
kubectl delete job -n NAMESPACE \
  $(kubectl get job -n NAMESPACE \
  -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
```

Nettoyez les tâches terminées pour l'espace de noms apigee-system :

kubectl delete job -n apigee-system \
  $(kubectl get job -n apigee-system \
  -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')

Modifiez la variable APIGEECTL_HOME pour qu'elle pointe en direction du répertoire contenant la version précédente de apigeectl. Par exemple :
```
export APIGEECTL_HOME=PATH_TO_PREVIOUS_APIGEECTL_DIRECTORY
```
Exécutez les commandes suivantes dans le répertoire racine de l'installation vers laquelle vous souhaitez effectuer un rollback. Veillez à utiliser le fichier de remplacement d'origine pour la version vers laquelle vous souhaitez effectuer un rollback :
1. Dans le répertoire hybrid-files, exécutez apigeectl apply :
```
$APIGEECTL_HOME/apigeectl apply -f ORIGINAL_OVERRIDES_FILE
```
  Où ORIGINAL_OVERRIDES_FILE correspond au chemin d'accès relatif et au nom du fichier de remplacement pour l'installation hybride de votre version précédente, par exemple, ./overrides/overrides1.10.yaml.
2. Vérifiez l'état des pods :
```
kubectl -n NAMESPACE get pods
```
  Où NAMESPACE est votre espace de noms Apigee hybrid.
3. Vérifiez l'état de apigeeds :
```
kubectl describe apigeeds -n apigee
```
  Le résultat doit se présenter sous la forme suivante :
```
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
```
  Ne passez à l'étape suivante que lorsque le pod apigeeds est en cours d'exécution.
4. Exécutez la commande suivante pour noter les valeurs de votre nouveau nombre d'instances répliquées pour le processeur de messages après la mise à niveau. Si ces valeurs ne correspondent pas à celles que vous avez définies précédemment, modifiez-les dans votre fichier de remplacement en fonction de votre configuration précédente.
```
apigeectl apply -f ORIGINAL_OVERRIDES_FILE --dry-run=client --print-yaml --env ENV_NAME 2>/dev/null |grep "runtime:" -A 25 -B 1| grep "autoScaler" -A 2
```
  Le résultat doit se présenter sous la forme suivante :
```
      autoScaler:
        minReplicas: 2
        maxReplicas: 10
```
5. Exécutez apigeectl init :
```
$APIGEECTL_HOME/apigeectl init -f ORIGINAL_OVERRIDES_FILE
```

Mettre à niveau Apigee hybrid vers la version 1.11

Présentation de la mise à niveau vers la version 1.11.1

Prérequis

Charts Helm et apigeectl

Migrer vers la version 1.11 avec Helm à partir de la version 1.10 avec apigeectl

Préparer la mise à niveau vers la version 1.11

Sauvegarder votre installation hybride (recommandé)

Helm

Linux

macOS

Windows

Prod

Hors production

apigeectl

Linux

macOS

Windows

Mettre à niveau votre version de Kubernetes

Cliquer pour développer la liste des plates-formes compatibles

Plates-formes

Composants

À propos des clusters associés

Installer l'environnement d'exécution hybride 1.11.1

Helm

Préparer la mise à niveau des charts Helm

Installer les charts Helm Apigee hybrid

apigeectl

Linux

macOS

Windows

Linux

macOS

Windows

Linux

macOS

Windows

Linux

macOS

Windows

Linux

macOS

Windows

Linux

macOS

Windows

Linux

macOS

Windows

Production

Hors production

Installez 1.11.1-hotfix.1.

Helm

apigeectl

Helm

apigeectl

Effectuer un rollback de la mise à niveau

Helm

apigeectl

Charts Helm et `apigeectl`

Migrer vers la version 1.11 avec Helm à partir de la version 1.10 avec `apigeectl`

`apigeectl`

`apigeectl`

Installez `1.11.1-hotfix.1`.

`apigeectl`

`apigeectl`

`apigeectl`