Actualiza Apigee Hybrid a la versión 1.13

Version 1.13 

   Versiones compatibles:

• v1.13 (la más reciente)                        
• v1.12                         
• v1.11                         
• Lista de versiones compatibles

   Versiones no compatibles

• v1.10                                      
• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

Este procedimiento abarca la actualización de la versión 1.12.x de Apigee Hybrid a la versión 1.13.2 de Apigee Hybrid y de las versiones anteriores de Hybrid 1.13.x a la versión 1.13.2.

Usa los mismos procedimientos para las actualizaciones de versiones secundarias (por ejemplo, de la versión 1.12 a la 1.13) y las actualizaciones de versiones de parches (por ejemplo, de la 1.13.0 a la 1.13.2).

Si actualizas desde Apigee Hybrid 1.11 o desde una versión anterior, primero debes actualizar a la versión 1.12 antes de actualizar a la versión 1.13.2. Consulta las instrucciones para actualizar Apigee híbrido a la versión 1.12.

Cambios de Apigee Hybrid v1.12

Ten en cuenta los siguientes cambios:

• apigee-operator en el espacio de nombres de Apigee: A partir de la versión 1.13, apigee-operator se ejecuta en el mismo espacio de nombres de Kubernetes que los otros componentes de Apigee Hybrid, apigee de forma predeterminada. Puedes proporcionar cualquier nombre para el espacio de nombres. En versiones anteriores, apigee-operator debía ejecutarse en su propio espacio de nombres, apigee-system.
• Anthos (en Bare Metal o VMware) ahora es Google Distributed Cloud (para equipos físicos o VMware): Para obtener más información, consulta las descripciones generales de los productos para Google Distributed Cloud para equipos físicos y Google Distributed Cloud para VMware.

Requisitos previos

Antes de actualizar a la versión Hybrid 1.13, asegúrate de que la instalación cumpla con los siguientes requisitos:

• Si tu instalación híbrida ejecuta una versión anterior a la 1.12, debes actualizar a la versión 1.12 antes de actualizar a la 1.13. Consulta cómo actualizar Apigee híbrido a la versión 1.12.
• Versión de Helm v3.14.2+.
• kubectl: Una versión compatible de kubectl adecuada para la versión de tu plataforma de Kubernetes. Consulta Plataformas y versiones compatibles: kubectl.
• cert-manager: Una versión compatible de cert-manager. Consulta Plataformas y versiones compatibles: cert-manager. Si es necesario, actualizarás cert-manager en la sección Prepárate para actualizar a la versión 1.13 que aparece a continuación.

Descripción general de la actualización a la versión 1.13.2

La actualización a Apigee Hybrid 1.13 puede requerir tiempo de inactividad:

Cuando se actualiza el controlador de Apigee a la versión 1.13.2, todas las implementaciones de Apigee se someten a un reinicio progresivo. Para minimizar el tiempo de inactividad en entornos híbridos de producción durante un reinicio progresivo, asegúrate de ejecutar al menos dos clústeres (en el mismo centro de datos o en uno diferente, o en la misma región o en una diferente). Divide todo el tráfico de producción en un solo clúster, toma el clúster que estás a punto de actualizar sin conexión y, luego, continúa con el proceso de actualización. Repite el proceso para cada clúster.

Apigee recomienda actualizar todos los clústeres lo antes posible para reducir las posibilidades de impacto de producción. No hay límite para que se actualicen todos los clústeres restantes después de que se actualice el primero. Sin embargo, hasta que se actualicen todos los clústeres restantes, la copia de seguridad y el restablecimiento de Cassandra no pueden funcionar con versiones mixtas. Por ejemplo, no se puede usar una copia de seguridad de Hybrid 1.12 para restablecer una instancia de Hybrid 1.13.

Nota: No es necesario suspender los cambios del plano de administración durante una actualización. Cualquier suspensión necesaria para los cambios en el plano de administración se incluyen en las instrucciones de actualización.

Los procedimientos para actualizar Apigee Hybrid se organizan en las siguientes secciones:

1. Prepárate para la actualización.
2. Instala la versión 1.13.2 del entorno de ejecución híbrido.

Prepárate para actualizar a la versión 1.13

Haz una copia de seguridad de tu instalación híbrida

1. En estas instrucciones, se usa la variable de entorno APIGEE_HELM_CHARTS_HOME para el directorio en tu sistema de archivos en el que instalaste los charts de Helm. Si es necesario, cambia el directorio a este directorio y define la variable con el siguiente comando:
   Linux macOS Windows
   export APIGEE_HELM_CHARTS_HOME=$PWD
   echo $APIGEE_HELM_CHARTS_HOME

   export APIGEE_HELM_CHARTS_HOME=$PWD
   echo $APIGEE_HELM_CHARTS_HOME

   set APIGEE_HELM_CHARTS_HOME=%CD%
   echo %APIGEE_HELM_CHARTS_HOME%

2. Realiza una copia de seguridad de tu directorio $APIGEE_HELM_CHARTS_HOME/ versión 1.12. Puedes usar cualquier proceso de copia de seguridad. Por ejemplo, puedes crear un archivo tar de todo tu directorio con lo siguiente:

   tar -czvf $APIGEE_HELM_CHARTS_HOME/../apigee-helm-charts-v1.12-backup.tar.gz $APIGEE_HELM_CHARTS_HOME

3. Realiza una copia de seguridad de tu base de datos de Cassandra según las instrucciones que se indican en Copia de seguridad y recuperación de Cassandra.
4. Si usas archivos de certificado de servicio (.json) en tus anulaciones para autenticar cuentas de servicio, asegúrate de que tus archivos de certificado de cuenta de servicio residan en el directorio del chart de Helm correcto. Los charts de Helm no pueden leer archivos fuera de cada directorio del chart.

   Este paso no es necesario si usas Secrets de Kubernetes o Workload Identity para autenticar cuentas de servicio.

   En la siguiente tabla, se muestra el destino de cada archivo de cuenta de servicio, según el tipo de instalación:

   ProducciónNo producción

   Cuenta de servicio	Nombre de archivo predeterminado	Directorio de charts de 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/

   Haz una copia del archivo de la cuenta de servicio apigee-non-prod en cada uno de los siguientes directorios:

   Cuenta de servicio	Nombre de archivo predeterminado	Directorios de charts de 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/

5. Asegúrate de que el certificado TLS y los archivos de claves (.crt, .key o .pem) residan en el directorio $APIGEE_HELM_CHARTS_HOME/apigee-virtualhost/.

Actualiza tu versión de Kubernetes

Verifica tu versión de la plataforma de Kubernetes y, si es necesario, actualiza tu plataforma de Kubernetes a una versión compatible con Hybrid 1.12 y Hybrid 1.13. Si necesitas ayuda, sigue la documentación de la plataforma.

Haz clic para expandir una lista de plataformas compatibles

	1.10 ^(2)	1.11	1.12	1.13
GKE en Google Cloud	1.24.x 1.25.x 1.26.x 1.27.x^(≥ 1.10.5) 1.28.x^(≥ 1.10.5)	1.25.x 1.26.x 1.27.x 1.28.x^(≥ 1.11.2) 1.29.x^(≥ 1.11.2)	1.26.x 1.27.x 1.28.x 1.29.x^(≥ 1.12.1)	1.27.x 1.28.x 1.29.x 1.30.x
GKE en AWS	1.13.x (K8s v1.24.x) 1.14.x (K8s v1.25.x) 1.26.x^(4) 1.27.x^(≥ 1.10.5) 1.28.x^(≥ 1.10.5)	1.14.x (K8s v1.25.x) 1.26.x^(4) 1.27.x 1.28.x^(≥ 1.11.2) 1.29.x^(≥ 1.11.2)	1.26.x^(4) 1.27.x 1.28.x 1.29.x^(≥ 1.12.1)	1.27.x 1.28.x 1.29.x^(≥ 1.12.1) 1.30.x
GKE en Azure	1.13.x 1.14.x 1.26.x^(4) 1.27.x^(≥ 1.10.5) 1.28.x^(≥ 1.10.5)	1.14.x 1.26.x^(4) 1.27.x 1.28.x^(≥ 1.11.2) 1.29.x^(≥ 1.11.2)	1.26.x^(4) 1.27.x 1.28.x 1.29.x^(≥ 1.12.1)	1.27.x 1.28.x 1.29.x^(≥ 1.12.1) 1.30.x
Google Distributed Cloud (solo software) en VMware ^(5)	1.13.x ^(1) 1.14.x 1.15.x (K8s v1.26.x) 1.16.x (K8s v1.27.x) 1.27.x^(≥ 1.10.5) 1.28.x^(≥ 1.10.5)	1.14.x 1.15.x (K8s v1.26.x) 1.16.x (K8s v1.27.x) 1.28.x^(≥ 1.11.2) 1.29.x^(≥ 1.11.2)	1.15.x (K8s v1.26.x) 1.16.x (K8s v1.27.x) 1.28.x^(4) 1.29.x^(≥ 1.12.1)	1.16.x (K8s v1.27.x) 1.28.x^(4) 1.29.x 1.30.x
Google Distributed Cloud (solo software) en equipos físicos	1.13.x ^(1) 1.14.x (K8s v1.25.x) 1.15.x (K8s v1.26.x) 1.16.x (K8s v1.27.x) 1.27.x^(4)^(≥ 1.10.5) 1.28.x^(≥ 1.10.5)	1.14.x 1.15.x (K8s v1.26.x) 1.16.x (K8s v1.27.x) 1.28.x^(4)^(≥ 1.11.2) 1.29.x^(≥ 1.11.2)	1.15.x (K8s v1.26.x) 1.16.x (K8s v1.27.x) 1.28.x^(4) 1.29.x^(≥ 1.12.1)	1.16.x (K8s v1.27.x) 1.28.x^(4) 1.29.x 1.30.x
EKS	1.24.x 1.25.x 1.26.x 1.27.x^(≥ 1.10.5) 1.28.x^(≥ 1.10.5)	1.25.x 1.26.x 1.27.x 1.28.x^(≥ 1.11.2) 1.29.x^(≥ 1.11.2)	1.26.x 1.27.x 1.28.x 1.29.x^(≥ 1.12.1)	1.26.x 1.27.x 1.28.x 1.29.x
AKS	1.24.x 1.25.x 1.26.x 1.27.x^(≥ 1.10.5) 1.28.x^(≥ 1.10.5)	1.25.x 1.26.x 1.27.x 1.28.x^(≥ 1.11.2) 1.29.x^(≥ 1.11.2)	1.26.x 1.27.x 1.28.x 1.29.x^(≥ 1.12.1)	1.26.x 1.27.x 1.28.x 1.29.x
OpenShift	4.11 4.12 4.14^(≥ 1.10.5) 4.15^(≥ 1.10.5)	4.12 4.13 4.14 4.15^(≥ 1.11.2) 4.16^(≥ 1.11.2)	4.12 4.13 4.14 4.15 4.16^(≥ 1.12.1)	4.12 4.13 4.14 4.15 4.16
Rancher Kubernetes Engine (RKE)	v1.26.2+rke2r1 1.27.x^(≥ 1.10.5) 1.28.x^(≥ 1.10.5)	v1.26.2+rke2r1 v1.27.x 1.28.x^(≥ 1.11.2) 1.29.x^(≥ 1.11.2)	v1.26.2+rke2r1 v1.27.x 1.28.x 1.29.x^(≥ 1.12.1)	v1.26.2+rke2r1 v1.27.x 1.28.x 1.29.x 1.30.x
VMware Tanzu	N/A	N/A	v1.26.x	v1.26.x
Componentes	1.10	1.11	1.12	1.13
Cloud Service Mesh	1.17.x^(3)	1.17.x^(v1.11.0 - v1.11.1)^(3) 1.18.x^(≥ 1.11.2)^(3)	1.18.x^(3)	1.19.x^(3)
JDK	JDK 11	JDK 11	JDK 11	JDK 11
cert-manager	1.10.x 1.11.x 1.12.x	1.11.x 1.12.x 1.13.x	1.11.x 1.12.x 1.13.x	1.13.x 1.14.x 1.15.x
Cassandra	3.11	3.11	4.0	4.0
Kubernetes	1.24.x 1.25.x 1.26.x	1.25.x 1.26.x 1.27.x	1.26.x 1.27.x 1.28.x 1.29.x	1.27.x 1.28.x 1.29.x 1.30.x
kubectl	1.24.x 1.25.x 1.26.x	1.25.x 1.26.x 1.27.x	1.26.x 1.27.x 1.28.x 1.29.x	1.27.x 1.28.x 1.29.x 1.30.x
Helm	3.10+	3.10+	3.14.2+	3.14.2+
Controlador de CSI de Secret Store		1.3.4	1.4.1	1.4.1
Vault		1.13.x	1.15.2	1.15.2
^(1) En la versión 1.13 de Anthos local (Google Distributed Cloud), sigue estas instrucciones para evitar conflictos con cert-manager: Instalación de cert-manager en conflicto ^(2) Se alcanzaron las fechas oficiales de EOL para las versiones 1.10 y posteriores de Apigee hybrid. Los parches mensuales regulares ya no están disponibles. Estas versiones ya no son oficialmente compatibles, excepto para los clientes con excepciones explícitas y oficiales para la asistencia continua. Otros clientes deben actualizar. ^(3) Cloud Service Mesh se instala automáticamente con Apigee Hybrid 1.9 y versiones posteriores. ^(4) Los números de versiones de GKE en AWS ahora reflejan las versiones de Kubernetes. Consulta la compatibilidad con versiones y actualizaciones de GKE Enterprise para obtener detalles de las versiones y parches recomendados. ^(5) Vault no está certificado en Google Distributed Cloud para VMware. ^(6) Compatibilidad disponible con la versión 1.10.5 de Apigee Hybrid y posteriores. ^(7) Compatibilidad disponible con la versión 1.11.2 de Apigee Hybrid y posteriores. ^(8) Compatibilidad disponible con la versión 1.12.1 de Apigee Hybrid y posteriores.

Nota: En este momento, las instalaciones híbridas no son compatibles con los clústeres de Autopilot.

Instala el entorno de ejecución de Hybrid 1.13.2

Precaución: No crees entornos nuevos durante el proceso de actualización.

Prepárate para la actualización de los charts de Helm

En este procedimiento de actualización, se supone que usas el mismo espacio de nombres y las mismas cuentas de servicio para la instalación actualizada. Si realizas algún cambio de configuración, asegúrate de reflejar esos cambios en tu archivo de anulaciones antes de instalar los charts de Helm.

1. Extrae los charts de Helm para Apigee.

   Los gráficos de Apigee Hybrid se alojan en Google Artifact Registry:

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

   Con el comando pull, copia todos los gráficos de Helm de Apigee Hybrid en tu almacenamiento local con el siguiente comando:

   export CHART_REPO=oci://us-docker.pkg.dev/apigee-release/apigee-hybrid-helm-charts
   export CHART_VERSION=1.13.2
   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
   

2. Actualiza cert-manager si es necesario.

   Si necesitas actualizar tu versión de cert-manager, instala la versión nueva con el siguiente comando:

   kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.15.1/cert-manager.yaml
   

   Consulta Plataformas y versiones compatibles: cert-manager para obtener una lista de las versiones compatibles.

3. Si tu espacio de nombres de Apigee no es apigee, edita el archivo apigee-operator/etc/crds/default/kustomization.yaml y reemplaza el valor namespace por tu espacio de nombres de Apigee.

   apiVersion: kustomize.config.k8s.io/v1beta1
   kind: Kustomization
   
   namespace: APIGEE_NAMESPACE
   

   Si usas apigee como espacio de nombres, no necesitas editar el archivo.

4. Instala las CRD de Apigee actualizadas:
   Nota: A partir de este paso, todos los comandos se deben ejecutar en el directorio raíz del repositorio del chart.
   Nota: Este es el único método compatible para instalar las CRD de Apigee. No uses kubectl apply sin -k, no omitas --server-side.
   Nota: En este paso, se requieren permisos elevados de clúster.

   1. Usa la función de ejecución de prueba kubectl mediante la ejecución del siguiente comando:

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

   2. Después de validar con el comando de ejecución de prueba, ejecuta el siguiente comando:

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

   3. Valida la instalación con el comando kubectl get crds:

      kubectl get crds | grep apigee

      La respuesta debería ser similar a la siguiente:

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

5. Migra apigee-operator del espacio de nombres apigee-system a APIGEE_NAMESPACE.
   Nota: Este paso solo es obligatorio para las actualizaciones desde la versión 1.12.x. Si actualizas desde una versión anterior a la 1.13, puedes omitir este paso.
   1. Anota clusterIssuer con el nuevo espacio de nombres

      kubectl annotate --overwrite clusterIssuer apigee-ca-issuer meta.helm.sh/release-namespace='APIGEE_NAMESPACE'
      

   2. Si cambias el nombre de la versión de apigee-operator, anota el clusterIssuer con el nuevo nombre de la versión.

      kubectl annotate --overwrite clusterIssuer apigee-ca-issuer meta.helm.sh/release-name='APIGEE_OPERATOR_RELEASE_NAME'
      

   3. Actualiza las réplicas de la implementación existente del operador de Apigee en el espacio de nombres apigee-system a 0 (cero) para evitar que los dos controladores se concilien.

      kubectl scale deployment apigee-controller-manager -n apigee-system --replicas=0
      

   4. Borra la apigee-mutating-webhook-configuration y la apigee-validating-webhook-configuration.

      kubectl delete mutatingwebhookconfiguration apigee-mutating-webhook-configuration
      kubectl delete validatingwebhookconfiguration apigee-validating-webhook-configuration
      

6. Verifica las etiquetas en los nodos del clúster. De forma predeterminada, Apigee programa los Pods de datos en los nodos con la etiqueta cloud.google.com/gke-nodepool=apigee-data y los Pods del entorno de ejecución se programan en nodos con la etiqueta cloud.google.com/gke-nodepool=apigee-runtime. Puedes personalizar las etiquetas de tu grupo de nodos en el archivo overrides.yaml.

   Para obtener más información, consulta Configura grupos de nodos dedicados.

Instala los gráficos de Helm de Apigee Hybrid

Nota: Antes de ejecutar cualquiera de los comandos de actualización o instalación de Helm, usa la función de prueba de validación de Helm; para ello, agrega --dry-run al final del comando. Consulta helm -h para enumerar los comandos, las opciones y el uso compatibles.

1. Si no lo hiciste, navega a tu directorio APIGEE_HELM_CHARTS_HOME. Ejecuta los siguientes comandos desde ese directorio.
2. Actualiza el operador o controlador de Apigee:
   Nota: En este paso, se requieren permisos elevados de clúster. Ejecuta helm -h o helm upgrade -h para obtener más detalles.

   Prueba de validación:

   helm upgrade operator apigee-operator/ \
     --install \
     --namespace APIGEE_NAMESPACE \
     -f OVERRIDES_FILE \
     --dry-run=server
   

   Actualiza el chart:

   helm upgrade operator apigee-operator/ \
     --install \
     --namespace APIGEE_NAMESPACE \
     -f OVERRIDES_FILE
   

   Verifica la instalación del operador de Apigee:

   helm ls -n APIGEE_NAMESPACE
   

   NAME       NAMESPACE       REVISION   UPDATED                                STATUS     CHART                   APP VERSION
   operator   apigee   3          2024-08-21 00:42:44.492009 -0800 PST   deployed   apigee-operator-1.13.2   1.13.2
   

   Para verificar que esté en funcionamiento, comprueba su disponibilidad:

   kubectl -n APIGEE_NAMESPACE get deploy apigee-controller-manager
   

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

3. Actualiza el almacén de datos de Apigee:

   Ejecución de prueba:

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

   Actualiza el chart:

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

   Para verificar que apigeedatastore esté en funcionamiento, comprueba su estado:

   kubectl -n APIGEE_NAMESPACE get apigeedatastore default
   

   NAME      STATE       AGE
   default   running    2d

4. Actualiza la telemetría de Apigee:

   Ejecución de prueba:

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

   Actualiza el chart:

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

   Para verificar que esté en funcionamiento, comprueba su estado:

   kubectl -n APIGEE_NAMESPACE get apigeetelemetry apigee-telemetry
   

   NAME               STATE     AGE
   apigee-telemetry   running   2d

5. Actualiza Apigee Redis:

   Ejecución de prueba:

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

   Actualiza el chart:

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

   Para verificar que esté en funcionamiento, comprueba su estado:

   kubectl -n APIGEE_NAMESPACE get apigeeredis default
   

   NAME      STATE     AGE
   default   running   2d

6. Actualiza el administrador de entrada de Apigee:

   Ejecución de prueba:

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

   Actualiza el chart:

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

   Para verificar que esté en funcionamiento, comprueba su disponibilidad:

   kubectl -n APIGEE_NAMESPACE get deployment apigee-ingressgateway-manager
   

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

7. Actualiza la organización de Apigee:

   Ejecución de prueba:

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

   Actualiza el chart:

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

   Para verificar que esté en funcionamiento, comprueba el estado de la organización correspondiente:

   kubectl -n APIGEE_NAMESPACE get apigeeorg
   

   NAME                      STATE     AGE
   apigee-org1-xxxxx          running   2d

   Nota: Si el comando de actualización falla con el error Forbidden: state: releasing, los componentes existentes aún están en estado de lanzamiento. Puedes esperar a que se complete la actualización actual y volver a intentarlo. Verifica el estado de la versión con el siguiente comando:

   kubectl get org -n APIGEE_NAMESPACE

8. Actualiza el entorno.

   Debes instalar un entorno a la vez. Especifica el entorno con --set env=ENV_NAME.

   Prueba de validación:

   helm upgrade ENV_RELEASE_NAME apigee-env/ \
     --install \
     --namespace APIGEE_NAMESPACE \
     --set env=ENV_NAME \
     -f OVERRIDES_FILE \
     --dry-run=server
   

   • ENV_RELEASE_NAME es el nombre con el que se instaló el chart apigee-env. En la versión híbrida 1.10, por lo general, es apigee-env-ENV_NAME. En la versión híbrida 1.11 y posteriores, suele ser ENV_NAME.
   • ENV_NAME es el nombre del entorno que estás actualizando.
   • OVERRIDES_FILE es tu nuevo archivo de anulaciones para v.1.13.2.

   Actualiza el chart:

   helm upgrade ENV_RELEASE_NAME apigee-env/ \
     --install \
     --namespace APIGEE_NAMESPACE \
     --set env=ENV_NAME \
     -f OVERRIDES_FILE
   

   Para verificar que esté en funcionamiento, comprueba el estado del entorno correspondiente:

   kubectl -n APIGEE_NAMESPACE get apigeeenv
   

   NAME                          STATE       AGE   GATEWAYTYPE
   apigee-org1-dev-xxx            running     2d

Nota: Si el comando de actualización falla con el error Forbidden: state: releasing, los componentes existentes aún están en estado de lanzamiento. Puedes esperar a que se complete la actualización actual y volver a intentarlo. Verifica el estado de la versión con el siguiente comando:

kubectl get env -n APIGEE_NAMESPACE

9. Actualiza los grupos de entornos (virtualhosts).
   1. Debes actualizar un grupo de entornos (virtualhost) a la vez. Especifica el grupo de entornos con --set envgroup=ENV_GROUP_NAME. Repite los siguientes comandos para cada grupo de entornos mencionado en el archivo overrides.yaml:

      Prueba de validación:

      helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
        --install \
        --namespace APIGEE_NAMESPACE \
        --set envgroup=ENV_GROUP_NAME \
        -f OVERRIDES_FILE \
        --dry-run=server
      

      ENV_GROUP_RELEASE_NAME es el nombre con el que se instaló el chart apigee-virtualhost. En la versión híbrida 1.10, por lo general, es apigee-virtualhost-ENV_GROUP_NAME. En la versión híbrida 1.11 y posteriores, suele ser ENV_GROUP_NAME.

      Actualiza el chart:

      helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
        --install \
        --namespace APIGEE_NAMESPACE \
        --set envgroup=ENV_GROUP_NAME \
        -f OVERRIDES_FILE
      

      Nota: ENV_GROUP_RELEASE_NAME debe ser único en el espacio de nombres apigee.

      Por ejemplo, si tienes un entorno llamado prod y un grupo de entornos llamado prod, establece el valor de ENV_GROUP_RELEASE_NAME en algo único, como prod-envgroup.

   2. Verifica el estado de ApigeeRouter (AR).

      La instalación de virtualhosts crea ApigeeRouteConfig (ARC), que crea de forma interna ApigeeRoute (AR) una vez que Apigee Watcher extrae detalles relacionados del grupo de entornos desde el plano de control. Por lo tanto, verifica que el estado de AR correspondiente esté en ejecución:

      kubectl -n APIGEE_NAMESPACE get arc
      

      NAME                                STATE   AGE
      apigee-org1-dev-egroup                       2d

      kubectl -n APIGEE_NAMESPACE get ar
      

      NAME                                        STATE     AGE
      apigee-org1-dev-egroup-xxxxxx                running   2d

10. Después de verificar que todas las instalaciones se actualizaron correctamente, borra la versión anterior de apigee-operator del espacio de nombres apigee-system.
    Nota: Este paso solo es obligatorio para las actualizaciones desde la versión 1.12.x. Si actualizas desde una versión anterior a la 1.13, puedes omitir este paso.
    1. Desinstala la versión anterior de operator:

       helm delete operator -n apigee-system
       

    2. Borra el espacio de nombres apigee-system:

       kubectl delete namespace apigee-system
       

11. Actualiza operator nuevamente en tu espacio de nombres de Apigee para volver a instalar los recursos con permisos de clúster que se borraron:
    Nota: Este paso solo es obligatorio para las actualizaciones desde la versión 1.12.x. Si actualizas desde una versión anterior a la 1.13, puedes omitir este paso.

    helm upgrade operator apigee-operator/ \
      --install \
      --namespace APIGEE_NAMESPACE \
      --atomic \
      -f overrides.yaml
    

¡Felicitaciones! Actualizaste a la versión 1.13.2 de Apigee Hybrid. Para probar la actualización, llama a un proxy con la instalación nueva. Para ver un ejemplo, consulta el Paso 10: Implementar un proxy de API en la guía de instalación de Apigee Hybrid 1.13.

Revierte a una versión anterior

Para revertir a la versión anterior, usa la versión anterior del gráfico para revertir el proceso de actualización en orden inverso. Comienza con apigee-virtualhost y vuelve a apigee-operator. Luego, revierte los CRD.

Debido al cambio en el espacio de nombres de apigee-operator, debes realizar pasos adicionales para borrar los hooks de admisión de validación y mutación. De esta manera, cuando vuelvas a instalar apigee-operator en el espacio de nombres apigee-system, se volverán a crear para apuntar al extremo correcto de Apigee Operator.

Sugerencia: Si conoces la última versión de lanzamiento, puedes usar el comando helm rollback en lugar del comando helm upgrade que se describe a continuación.

1. Actualiza las réplicas de la implementación existente del operador de Apigee en Apigee a 0 (cero) para evitar que los dos controladores concilien los recursos personalizados y evitar conflictos cuando se revierta en el espacio de nombres apigee-system.

   kubectl scale deployment apigee-controller-manager -n APIGEE_NAMESPACE --replicas=0
   
   kubectl delete mutatingwebhookconfiguration \
     apigee-mutating-webhook-configuration-APIGEE_NAMESPACE
   
   kubectl delete validatingwebhookconfiguration \
     apigee-validating-webhook-configuration-APIGEE_NAMESPACE
   

2. Revierte todos los gráficos de apigee-virtualhost a apigee-datastore. En los siguientes comandos, se supone que usas los gráficos de la versión anterior (v1.12.x).

   Ejecuta el siguiente comando para cada grupo de entorno:

   helm upgrade ENV_GROUP_RELEASE_NAME apigee-virtualhost/ \
     --install \
     --namespace apigee \
     --atomic \
     --set envgroup=ENV_GROUP_NAME \
     -f 1.12_OVERRIDES_FILE
   

   Ejecuta el siguiente comando para cada entorno:

   helm upgrade ENV_RELEASE_NAME apigee-env/ \
     --install \
     --namespace apigee \
     --atomic \
     --set env=ENV_NAME \
     -f 1.12_OVERRIDES_FILE
   

   Revierte los gráficos restantes, excepto apigee-operator.

   helm upgrade ORG_NAME apigee-org/ \
     --install \
     --namespace apigee \
     --atomic \
     -f 1.12_OVERRIDES_FILE
   

   helm upgrade ingress-manager apigee-ingress-manager/ \
     --install \
     --namespace apigee \
     --atomic \
     -f 1.12_OVERRIDES_FILE
   

   helm upgrade redis apigee-redis/ \
     --install \
     --namespace apigee \
     --atomic \
     -f 1.12_OVERRIDES_FILE
   

   helm upgrade telemetry apigee-telemetry/ \
     --install \
     --namespace apigee \
     --atomic \
     -f 1.12_OVERRIDES_FILE
   

   helm upgrade datastore apigee-datastore/ \
     --install \
     --namespace apigee \
     --atomic \
     -f 1.12_OVERRIDES_FILE
   

3. Crea el espacio de nombres apigee-system.

   kubectl create namespace apigee-system
   

4. Vuelve a aplicar la anotación de recursos al espacio de nombres apigee-system.

   kubectl annotate --overwrite clusterIssuer apigee-ca-issuer meta.helm.sh/release-namespace='apigee-system'
   

5. Si también cambiaste el nombre de la versión, actualiza la anotación con el nombre de la versión operator.

   kubectl annotate --overwrite cluseterIssuer apigee-ca-issuer meta.helm.sh/release-name='operator'
   

6. Vuelve a instalar apigee-operator en el espacio de nombres apigee-system.

   helm upgrade operator apigee-operator/ \
     --install \
     --namespace apigee-system \
     --atomic \
     -f 1.12_OVERRIDES_FILE
   

7. Para revertir las CRD, vuelve a instalar las CRD anteriores.

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

8. Limpia la versión apigee-operator del espacio de nombres APIGEE_NAMESPACE para completar el proceso de reversión.

   helm uninstall operator -n APIGEE_NAMESPACE
   

9. Algunos recursos de alcance de clúster, como clusterIssuer, se borran cuando se desinstala operator. Vuelve a instalarlos con el siguiente comando:

   helm upgrade operator apigee-operator/ \
     --install \
     --namespace apigee-system \
     --atomic \
     -f 1.12_OVERRIDES_FILE