Actualiza Apigee Hybrid a la versión 1.9

Este procedimiento abarca la actualización de la versión 1.8.x de Apigee hybrid a la versión 1.9.4 de Apigee hybrid y de las versiones anteriores de hybrid 1.9.x a la versión 1.9.4.

Usa los mismos procedimientos para las actualizaciones de versiones secundarias (por ejemplo, de la versión 1.8 a la 1.9) y las actualizaciones de versiones de parches (por ejemplo, de 1.9.0 a 1.9.4).

Si actualizas desde Apigee hybrid 1.7 o desde una versión anterior, primero debes actualizar a la versión 1.8 de Hybrid antes de actualizar a la versión 1.9.4. Consulta las instrucciones para actualizar Apigee Hybrid a la versión 1.8.

A partir de la versión 1.9.0, Apigee Hybrid solo admite la puerta de enlace de entrada de Apigee como capa de entrada.

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

La actualización a Apigee Hybrid 1.9 puede requerir tiempo de inactividad.

Cuando se actualiza el controlador de Apigee a la versión 1.9.4, 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, se verán afectadas las siguientes operaciones:

La copia de seguridad y restablecimiento de Cassandra no puede funcionar con versiones mixtas. Por ejemplo, no se puede usar una copia de seguridad de Hybrid 1.8 para restablecer una instancia de Hybrid 1.9.
La transmisión de datos de Cassandra no funcionará entre versiones híbridas. Por lo tanto, los clústeres de Cassandra no pueden escalar de manera horizontal.
La expansión de la región y el retiro de servicio se verán afectados, ya que estas operaciones dependen de la transmisión de datos de Cassandra.

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

Prepárate para la actualización.
Instala la versión 1.9.4 del entorno de ejecución de hybrid.

Requisitos previos

En estas instrucciones de actualización, se supone que tienes instalado la versión 1.8.x de Apigee hybrid y deseas actualizarlo a la versión 1.9.4. Si estás actualizando desde una versión anterior, consulta las instrucciones para actualizar Apigee Hybrid 1.8.
En la versión 1.8 de Apigee Hybrid, presentamos la puerta de enlace de entrada de Apigee como una capa de entrada alternativa a Anthos Service Mesh. A partir de la versión 1.9.0, Apigee Hybrid requiere el uso de una puerta de enlace de entrada de Apigee y ya no admite el uso de Anthos Service Mesh para la entrada. Si la instalación desde la que actualizas usa Anthos Service Mesh, primero debes migrar al uso de la puerta de enlace de entrada de Apigee antes de actualizar a la versión 1.9.4.
La puerta de enlace de entrada de Apigee usa un pequeño subconjunto de características de Anthos Service Mesh para la puerta de enlace de entrada. Apigee Hybrid maneja la administración y actualización de esas funciones de forma automática. Por lo tanto, no necesitas experiencia con Anthos Service Mesh para instalar, actualizar y administrar la puerta de enlace de entrada de Apigee Hybrid.

Consulta Migra a la puerta de enlace de entrada de Apigee en la documentación de la versión 1.8 de hybrid para obtener instrucciones.

Prepárate para actualizar a la versión 1.9

Crea una copia de seguridad de tu instalación híbrida (recomendado)

En estas instrucciones, se usa la variable de entorno APIGEECTL_HOME para el directorio en tu sistema de archivos en el que instalaste apigeectl. Si es necesario, cambia el directorio a tu directorio apigeectl y define la variable con el siguiente comando:
Linux
```
export APIGEECTL_HOME=$PWD
echo $APIGEECTL_HOME
```
macOS
```
export APIGEECTL_HOME=$PWD
echo $APIGEECTL_HOME
```
Windows
```
set APIGEECTL_HOME=%CD%
echo %APIGEECTL_HOME%
```
Realiza una copia de seguridad de tu directorio $APIGEECTL_HOME/ versión 1.8. Por ejemplo:
```
tar -czvf $APIGEECTL_HOME/../apigeectl-v1.8-backup.tar.gz $APIGEECTL_HOME
```
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.

Agrega el rol Agente de Cloud Trace a la cuenta de servicio para el entorno de ejecución de Apigee. (Opcional)

Opcional: Si planeas usar Cloud Trace y aún no agregaste la función Cloud Trace Agent a la instalación de Hybrid v1.8, asegúrate de que tu cuenta de servicio para los servicios del entorno de ejecución de Apigee tenga el rol Cloud Trace Agent de Google Cloud IAM (roles/cloudtrace.agent).

Para los entornos de producción, la cuenta de servicio del entorno de ejecución es apigee-runtime. En entornos que no son de producción, la cuenta de servicio del entorno de ejecución es apigee-non-prod.

Puedes agregar el rol en la IU de la consola de Cloud > IAM y administración > Cuentas de servicio o con los siguientes comandos:

Obtén la dirección de correo electrónico de tu cuenta de servicio con el siguiente comando:
Producción
```
gcloud iam service-accounts list --filter "apigee-runtime"
```
Si la dirección de correo electrónico coincide con el patrón apigee-runtime@$ORG_NAME.iam.gserviceaccount.com, puedes usar ese patrón en el paso siguiente.
No producción
```
gcloud iam service-accounts list --filter "apigee-non-prod"
```
Si coincide con el patrón apigee-non-prod@$ORG_NAME.iam.gserviceaccount.com, puedes usarlo en el paso siguiente

Asigna el rol Agente de Cloud Trace a la cuenta de servicio:

Producción

gcloud projects add-iam-policy-binding $PROJECT_ID \
    --member="serviceAccount:apigee-runtime@$PROJECT_ID.iam.gserviceaccount.com" \
    --role="roles/cloudtrace.agent"

No producción

gcloud projects add-iam-policy-binding $PROJECT_ID \
    --member="serviceAccount:apigee-non-prod@$PROJECT_ID.iam.gserviceaccount.com" \
    --role="roles/cloudtrace.agent"

Ejemplo

gcloud projects add-iam-policy-binding hybrid-example-project \
    --member="serviceAccount:apigee-runtime@hybrid-example-project.iam.gserviceaccount.com" \
    --role="roles/cloudtrace.agent"

En el ejemplo anterior, $PROJECT_ID es el nombre del proyecto de Google Cloud en el que se instala Apigee Hybrid.

Nota: Si tu instalación usa un nombre personalizado para la cuenta de servicio, sustituye ese nombre por apigee-runtime o apigee-non-prod en el comando.

Instala la puerta de enlace de entrada de Apigee si la instalación usa Anthos Service Mesh

A partir de la versión 1.9, Apigee Hybrid ya no admite el uso de Anthos Service Mesh para la entrada. Si tu instalación híbrida usa Anthos Service Mesh, debes migrar tu instalación actual a la puerta de enlace de entrada de Apigee antes de instalar la versión híbrida 1.9.

Agrega la propiedad ingressGateways a tu archivo de anulaciones.
Sintaxis
```
  ingressGateways:
  - name: INGRESS_NAME
    replicaCountMin: REPLICAS_MIN
    replicaCountMax: REPLICAS_MAX
    resources:
      requests:
        cpu: CPU_COUNT_REQ
        memory: MEMORY_REQ
      limits:
        cpu: CPU_COUNT_LIMIT
        memory: MEMORY_LIMIT
    svcAnnotations:  # optional. See Known issue 243599452.
      SVC_ANNOTATIONS_KEY: SVC_ANNOTATIONS_VALUE
    svcLoadBalancerIP: SVC_LOAD_BALANCER_IP # optional
```
Ejemplo
```
  ingressGateways:
  - name: prod1
    replicaCountMin: 2
    replicaCountMax: 100
    resources:
      requests:
        cpu: 1
        memory: 1Gi
      limits:
        cpu: 2
        memory: 2Gi
    svcAnnotations:  # optional. See Known issue 243599452.
      networking.gke.io/load-balancer-type: "Internal"
    svcLoadBalancerIP: 198.252.0.123 
```
- INGRESS_NAME es el nombre de la implementación de entrada. Puede ser cualquier nombre que cumpla con los siguientes requisitos:
  - Tener una longitud máxima de 17 caracteres
  - Contener solo caracteres alfanuméricos en minúscula “.” o “-”.
  - Comenzar con un carácter alfanumérico
  - Terminar con un carácter alfanumérico
  Consulta ingressGateways[].name en la referencia de la propiedad de configuración.
- REPLICAS_MIN y REPLICAS_MAX son los recuentos de réplicas mínimas y máximas para la puerta de enlace de entrada de Apigee en tu instalación. Para obtener más información y la configuración predeterminada, consulta ingressGateways[].replicaCountMin y ingressGateways[].replicaCountMax en la referencia de la propiedad de configuración.
- CPU_COUNT_REQ y MEMORY_REQ son la solicitud de CPU y memoria para cada réplica de la puerta de enlace de entrada de Apigee en tu instalación.
  Configura estas propiedades si las configuraste antes para la puerta de enlace de entrada de Anthos Service Mesh, por ejemplo, en el archivo overlay.yaml.
  
  Para obtener más información y la configuración predeterminada, consulta ingressGateways[].resources.requests.cpu y ingressGateways[].resources.requests.memory en la referencia de la propiedad de configuración.
- CPU_COUNT_LIMIT y MEMORY_LIMIT son los límites máximos de CPU y memoria para cada réplica de la puerta de enlace de entrada de Apigee en tu instalación.
  Configura estas propiedades si las configuraste antes para la puerta de enlace de entrada de Anthos Service Mesh, por ejemplo, en el archivo overlay.yaml.
  
  Para obtener más información y la configuración predeterminada, consulta ingressGateways[].resources.limits.cpu y ingressGateways[].resources.limits.memory en la referencia de la propiedad de configuración.
- SVC_ANNOTATIONS_KEY SVC_ANNOTATIONS_VALUE (opcional):
  Nota: El campo ingressGateways[].svcAnnotations en overrides.yaml no funciona como se espera. Consulta Problema conocido 243599452
  
  Este es un par clave-valor que proporciona anotaciones para tu servicio de entrada predeterminado. La plataforma en la nube usa las anotaciones para configurar tu instalación híbrida, por ejemplo, si estableces el tipo de balanceador de cargas como interno o externo. Por ejemplo:
```
ingressGateways:
    svcAnnotations:
      networking.gke.io/load-balancer-type: "Internal"
```
  Las anotaciones varían de una plataforma a otra. Consulta la documentación de tu plataforma para ver las anotaciones obligatorias y sugeridas.
  
  Nota: No es necesario que configures Annotations si creas tu propio servicio de Kubernetes para la implementación de entrada como se documenta en Expón la entrada de Apigee.
  Consulta ingressGateways[].svcAnnotations en la referencia de la propiedad de configuración.
- SVC_LOAD_BALANCER_IP (opcional) te permite asignar una dirección IP estática para el balanceador de cargas. En las plataformas que admiten la especificación de la dirección IP del balanceador de cargas, el balanceador de cargas se creará con esta dirección IP. En plataformas que no te permiten especificar la dirección IP del balanceador de cargas, se ignora esta propiedad.
  Si no tienes una dirección IP estática asignada a tu balanceador de cargas, deja esta propiedad fuera de tu archivo de anulaciones.
  
  Precaución: Asegúrate de no especificar la misma dirección IP que la istio-ingressgateway actual. Esto podría causar problemas mientras ese servicio aún está en el clúster.
  
  Nota: No es necesario que configures LoadBalancerIP si creas tu propio servicio de Kubernetes para la implementación de entrada, como se documenta en Expón la puerta de enlace de entrada de Apigee.
  Consulta ingressGateways[].svcLoadBalancerIP en la referencia de la propiedad de configuración.
Aplica los cambios para instalar la puerta de enlace de entrada de Apigee con los siguientes comandos:
```
$APIGEECTL_HOME/apigeectl apply -f overrides/overrides.yaml
```
Expón la puerta de enlace de entrada de Apigee. Sigue los procedimientos que aparecen en Expón la puerta de enlace de entrada de Apigee.
Prueba la nueva puerta de enlace de entrada mediante una llamada a un proxy. Lo ideal es que pruebes todos los proxies fundamentales que tienes implementados actualmente.
A fin de cambiar el tráfico, actualiza tus registros DNS para que apunten a la dirección IP de tu nueva puerta de enlace de entrada de Apigee. Según tu proveedor de DNS, es posible que puedas transferir el tráfico de manera gradual al extremo nuevo.
Sugerencia: Puedes encontrar la dirección IP externa de la puerta de enlace de entrada de Apigee con el siguiente comando:
```
kubectl get svc -n apigee -l app=apigee-ingressgateway
```
Deberías obtener un resultado similar al siguiente:
```
NAME                                        TYPE           CLUSTER-IP    EXTERNAL-IP     PORT(S)                                      AGE
apigee-ingressgateway-prod-hybrid-37a39bd   LoadBalancer   192.0.2.123   233.252.0.123   15021:32049/TCP,80:31624/TCP,443:30723/TCP   16h
```
Supervisa los paneles para asegurarte de que todo el tráfico del entorno de ejecución funcione. Continúa con el paso siguiente solo si todo funciona como se espera. Asegúrate de que no haya tráfico que pase por la puerta de enlace de entrada anterior (Anthos Service Mesh), ya que la actualización del DNS puede tardar en propagarse debido al almacenamiento en caché del DNS.
Para evitar que Apigee proporcione una configuración a Anthos Service Mesh, sigue los pasos que se indican en Deja de proporcionar la configuración a ASM en la guía sobre cómo administrar la puerta de enlace de entrada de Apigee.
Vuelve a probar y supervisa el tráfico del proxy de API.
Sigue las instrucciones en la documentación de Anthos Service Mesh para desinstalar Anthos Service Mesh del clúster.

Instala el entorno de ejecución de hybrid 1.9.4

Asegúrate de estar en el directorio base híbrido (el superior del directorio en el que se encuentra el archivo ejecutable apigeectl):
```
cd $APIGEECTL_HOME/..
```

Descarga el paquete de lanzamientos para tu sistema operativo con el siguiente comando. Asegúrate de seleccionar tu plataforma en la siguiente tabla:

Linux

Linux de 64 bits

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

macOS

Mac (64 bits)

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

Windows

Windows de 64 bits

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

Cambia el nombre de tu directorio apigeectl/ actual por un nombre de directorio de copia de seguridad. Por ejemplo:

Linux

mv $APIGEECTL_HOME/ $APIGEECTL_HOME-v1.8/

macOS

mv $APIGEECTL_HOME/ $APIGEECTL_HOME-v1.8/

Windows

rename %APIGEECTL_HOME% %APIGEECTL_HOME%-v1.8

Extrae el contenido del archivo gzip descargado en tu directorio base híbrido. El directorio base híbrido es el directorio donde se encuentra el directorio apigeectl-v1.8 al que se le cambió el nombre:
Linux
```
tar xvzf filename.tar.gz -C ./
```
macOS
```
tar xvzf filename.tar.gz -C ./
```
Windows
```
tar xvzf filename.zip -C ./
```
De forma predeterminada, el contenido del archivo tar se expande a un directorio con la versión y la plataforma en su nombre. Por ejemplo: ./apigeectl_1.9.4-xxxxxxx_linux_64. Cambia el nombre de ese directorio a apigeectl con el siguiente comando:
Linux
```
mv apigeectl_1.9.4-xxxxxxx_linux_64 apigeectl
```
macOS
```
mv apigeectl_1.9.4-xxxxxxx_mac_64 apigeectl
```
Windows
```
rename apigeectl_1.9.4-xxxxxxx_windows_64 apigeectl
```
Cambia al directorio apigeectl:
```
cd ./apigeectl
```
Este directorio es el directorio principal de apigeectl. Es donde se encuentra el comando ejecutable apigeectl.
En estas instrucciones, se usa la variable de entorno $APIGEECTL_HOME para el directorio en tu sistema de archivos en el que está instalada la utilidad apigeectl. Si es necesario, cambia el directorio a tu directorio apigeectl y define la variable con el siguiente comando:
Linux
```
export APIGEECTL_HOME=$PWD
```
```
echo $APIGEECTL_HOME
```
macOS
```
export APIGEECTL_HOME=$PWD
```
```
echo $APIGEECTL_HOME
```
Windows
```
set APIGEECTL_HOME=%CD%
```
```
echo %APIGEECTL_HOME%
```
Verifica la versión de apigeectl con el comando version:
```
./apigeectl version
```
```
Version: 1.9.4
```
Ve al directorio hybrid-base-directory/hybrid-files. El directorio hybrid-files es donde se encuentran los archivos de configuración, como el archivo de anulación, los certificados y las cuentas de servicio. Por ejemplo:
```
cd $APIGEECTL_HOME/../hybrid-files
```
Verifica que kubectl esté configurado en el contexto correcto con el siguiente comando. El contexto actual debe configurarse en el clúster en el que actualizas Apigee Hybrid.
```
kubectl config get-contexts | grep \*
```
En el directorio hybrid-files:
1. Actualiza los siguientes vínculos simbólicos a $APIGEECTL_HOME. Estos vínculos te permiten ejecutar el comando apigeectl recién instalado desde el directorio 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. Para verificar que los symlinks se hayan creado correctamente, ejecuta este comando y asegúrate de que las rutas de los vínculos apunten a las ubicaciones correctas:
```
ls -l | grep ^l
```
Realiza una inicialización de prueba de validación para verificar si hay errores:
```
${APIGEECTL_HOME}/apigeectl init -f OVERRIDES_FILE --dry-run=client
```
En el ejemplo anterior, OVERRIDES_FILE es el nombre del archivo de anulación, por ejemplo, ./overrides/overrides.yaml.

Sugerencia: Puedes reemplazar OVERRIDES_FILE en la muestra de código anterior por el nombre y la ruta de acceso al archivo de anulación, y se reemplazará cada instancia en esta página.
Si no hay errores, inicializa hybrid 1.9.4:
```
$APIGEECTL_HOME/apigeectl init -f OVERRIDES_FILE
```
Nota:apigeectl Instala y configura la puerta de enlace de entrada de Apigee cuando ejecutas apigeectl init.
Comprueba el estado de inicialización:
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```
Si se realiza de forma correcta, el resultado indica lo siguiente: All containers ready.
```
kubectl describe apigeeds -n apigee
```
En el resultado, busca State: running.
Verifica si hay errores con una prueba de validación del comando apply mediante la marca --dry-run:
```
$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --dry-run=client
```
Si no hay errores, aplica tus anulaciones. Selecciona y sigue las instrucciones para los entornos de producción o que no sean de producción, según tu instalación.
Producción

En los entornos de producción, actualiza cada componente Hybrid de forma individual y verificar el estado del componente actualizado antes de continuar con el siguiente.
1. Asegúrate de que estés en el directorio hybrid-files.
2. Aplica tus anulaciones para actualizar Cassandra:
```
$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --datastore
```
3. Verifica la finalización:
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```
  Sugerencia: Si check-ready falla, puedes obtener más información sobre los Pods con el siguiente comando:
  kubectl -n NAMESPACE get pods
  
  En el ejemplo anterior, NAMESPACE es el espacio de nombres híbrido de Apigee.
  Continúa con el siguiente paso solo cuando los Pods estén listos.
4. Aplica tus anulaciones para actualizar los componentes de telemetría y verificar la finalización:
```
$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --telemetry
```
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```
5. Abre los componentes de Redis:
```
$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --redis
```
6. Aplica tus anulaciones para actualizar los componentes a nivel de la organización (MART, Watcher y Apigee Connect) y verifica la finalización:
```
$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --org
```
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```
7. Aplica tus anulaciones para actualizar tus entornos. Tienes dos opciones:
  - Entorno por entorno: Aplica tus anulaciones a un entorno a la vez y verifica la finalización. Repite este paso para cada entorno:
    $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --env ENV_NAME
    
    $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
    
    En el comando anterior, ENV_NAME es el nombre del entorno que estás actualizando.
  - Todos los entornos a la vez: Aplica las anulaciones a todos los entornos a la vez y verifica la finalización:
    $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --all-envs
    
    $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
8. Aplica tus anulaciones para actualizar los componentes virtualhosts y verificar la finalización:
```
$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --settings virtualhosts
```
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```
No producción

En la mayoría de los entornos experimentales, de producción o de no producción, puedes aplicar las anulaciones a todos los componentes a la vez. Si tu entorno de no producción es grande y complejo, o imita a un entorno de producción, te recomendamos seguir las instrucciones para actualizar entornos de producción.
1. Asegúrate de que estés en el directorio hybrid-files.
2. ```
$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE
```
3. Verifica el estado:
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```

Instale `1.9.4-hotfix.1`

Sigue estos pasos para instalar la versión de parche rápido, 1.9.4-hotfix.1:

Antes de seguir estos pasos, debes tener la versión 1.9.4 o una posterior de Apigee Hybrid. Si no usas la versión 1.9.4 o una posterior, realiza una actualización a la versión 1.9.4 antes de continuar.
Abre el archivo overrides.yaml.
En la estrofa istiod, cambia la versión de la etiqueta de imagen (si está presente) a la versión 1.17.7. Por ejemplo:
```
istiod:
  image:
    url: "gcr.io/apigee-release/hybrid/apigee-asm-istiod"
    tag: "1.17.7-asm.0-distroless"
```

Según cómo elijas instalar Apigee Hybrid, es posible que tengas una estrofa ingressGateway o ingressGateways. Ubica la estrofa que aparece en tu archivo de anulaciones y cambia la versión de la etiqueta de imagen (si está presente) a la versión 1.17.7. Por ejemplo, si tienes una estrofa ingressGateway:

ingressGateway:
  image:
    url: "gcr.io/apigee-release/hybrid/apigee-asm-ingress"
    tag: "1.17.7-asm.0-distroless"

O bien, si tienes una estrofa ingressGateways:

ingressGateways:
  - name: gateway1
    image:
      url: "gcr.io/apigee-release/hybrid/apigee-asm-ingress"
      tag: "1.17.7-asm.0-distroless"
    ...
  - name: gateway2
    image:
      url: "gcr.io/apigee-release/hybrid/apigee-asm-ingress"
      tag: "1.17.7-asm.0-distroless"
    ...

Guarda el archivo.

Ejecuta el siguiente comando para inicializar el componente istiod:

$APIGEECTL_HOME/apigeectl init -f OVERRIDES_FILE

$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE

Ejecuta el siguiente comando para aplicar los cambios a los componentes de entrada de Apigee. Si tienes más de una organización, repite este comando para cada una:
```
$APIGEECTL_HOME/apigeectl apply --org -f OVERRIDES_FILE
```
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```

Verifica el estado de los Pods:

kubectl get pods -n YOUR_APIGEE_NAMESPACE

Actualiza tu versión de Kubernetes

Actualiza tu plataforma de Kubernetes a las versiones compatibles con la versión 1.9 de Hybrid. Si necesitas ayuda, sigue la documentación de la plataforma.

Haz clic para expandir una lista de plataformas compatibles.

	Versiones de Apigee Hybrid
Plataformas	1.6 ⁽³⁾	1.7 ⁽³⁾	1.8 ⁽³⁾	1.9	1.10
Anthos (Google Cloud - GKE)	1.19.x 1.20.x 1.21.x	1.20.x 1.21.x 1.22.x ^{(≥ 1.7.2)} 1.23.x ^{(≥ 1.7.2)}	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
Anthos (AWS)	1.7.x 1.8.x 1.9.3+ 1.10.x	1.9.x 1.10.x 1.12.x ^{(≥ 1.7.2)}	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⁽¹³⁾
Anthos (Azure)	1.8.x	1.9.x 1.10.x 1.12.x ^{(≥ 1.7.2)}	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
Anthos (local - VMware)⁽¹⁾	1.7.x 1.8.x 1.9.3+ 1.10.x	1.9.x ⁽⁴⁾ 1.10.x ⁽⁴⁾ 1.11.x ⁽⁴⁾ ^{(≥ 1.7.2)} 1.12.x ⁽⁴⁾ ^{(≥ 1.7.2)}	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
Anthos (Bare Metal)⁽¹⁾	1.7.x 1.8.2+ 1.9.3+ 1.10.x	1.9.x ⁽⁴⁾ 1.10.x ⁽⁴⁾ 1.11.x ⁽⁴⁾ ^{(≥ 1.7.2)} 1.12.x ⁽⁴⁾ ^{(≥ 1.7.2)}	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
EKS⁽⁷⁾	1.19.x 1.20.x 1.21.x	1.21.x 1.22.x ^{(≥ 1.7.2)} 1.23.x ^{(≥ 1.7.2)}	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
AKS⁽⁷⁾	1.19.x 1.20.x 1.21.x	1.21.x 1.22.x ^{(≥ 1.7.2)} 1.23.x ^{(≥ 1.7.2)}	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
OpenShift⁽⁷⁾	4.6 4.7 4.8	4.7 4.8	4.8 4.9 4.10	4.10 4.11	4.11 4.12
Rancher Kubernetes Engine (RKE)⁽⁷⁾	No disponible	N/A	No disponible	1.3.8	v1.26.2+rke2r1
Componentes	1.6 ⁽³⁾	1.7 ⁽³⁾	1.8	1.9	1.10
Anthos Service Mesh (ASM)	1.9.x 1.10.x 1.12.x 1.13.x	1.10.x 1.11.x 1.12.x 1.13.x ^{(≥ 1.7.2)} 1.14.x 1.15.x ^{(≥ 1.7.6)}	1.11.x 1.12.x 1.13.x 1.14.x 1.15.x	1.17.x⁽¹¹⁾	1.17.x⁽¹¹⁾
JDK	JDK 11	JDK 11	JDK 11	JDK 11	JDK 11
cert-manager	1.5.4	1.7.x	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
Cassandra	3.11.10	3.11.10	3.11.10	3.11.10	3.11.10
⁽¹⁾ En las versiones 1.8, 1.9 y 1.10 de Anthos, sigue las instrucciones de estos documentos para evitar conflictos con `cert-manager`: Anthos 1.8.2+: Conflicto con `cert-manager` cuando se actualiza a la versión 1.8.2 o superior. Anthos 1.9: Conflicto con `cert-manager` cuando se actualiza a la versión 1.9.0 o 1.9.1. Anthos 1.10+: Instalación de `cert-manager` en conflicto. ⁽²⁾ Compatibilidad disponible con la versión 1.7.2 de Apigee Hybrid y posteriores.. ⁽³⁾ Se alcanzaron las fechas oficiales de EOL para las versiones 1.8 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. ⁽⁴⁾ Las versiones 1.12 y anteriores de Anthos alojado en Bare Metal y VMWare no son compatibles. Consulta la política de asistencia Anthos alojado en Bare Metal y las versiones de clústeres de Anthos alojados en VMware. ⁽⁵⁾Anthos alojado en Bare Metal y VMWare requiere ASM 1.14 o posterior. Te recomendamos que actualices a la versión híbrida 1.8 y cambies a la puerta de enlace de entrada de Apigee, que ya no requiere que instales ASM en tu clúster híbrido. ⁽⁶⁾ Compatibilidad disponible con la versión 1.8.4 de Apigee Hybrid y posteriores.. ⁽⁷⁾ No se requieren clústeres adjuntos para Apigee Hybrid v1.8 y versiones posteriores con Apigee ingressgateway. ⁽⁸⁾ No es compatible con la versión híbrida 1.8.4 de Apigee y las versiones posteriores. ⁽⁹⁾ Compatibilidad disponible con la versión 1.7.6 de Apigee Hybrid y posteriores.. ⁽¹⁰⁾ No es compatible con la versión híbrida 1.8.5 de Apigee y las versiones posteriores. ⁽¹¹⁾ ASM se instala automáticamente con Apigee Hybrid 1.9 y versiones posteriores. ⁽¹²⁾ Compatibilidad disponible con la versión 1.9.2 de Apigee Hybrid y versiones posteriores.. ⁽¹³⁾ Los números de versiones de clústeres de Anthos en AWS (múltiples nubes) ahora reflejan las versiones de Kubernetes. Consulta la compatibilidad de las versiones y las actualizaciones de Anthos para obtener detalles de las versiones y parches recomendados.

Acerca de los clústeres adjuntos

Para las versiones de Apigee Hybrid 1.7.x y anteriores, debes usar clústeres adjuntos de Anthos si deseas ejecutar Apigee Hybrid en un contexto de múltiples nubes en Elastic Kubernetes Service (EKS, Azure Kubernetes Service (AKS) o algún otro proveedor de servicios de Kubernetes compatible de terceros. El adjunto de clúster permite que Google mida el uso de Anthos Service Mesh (ASM). Registrar el clúster de terceros es opcional. Regístrate solo si deseas ver el clúster adjunto en la consola de Google Cloud. Para obtener más información, consulta Conecta clústeres de Kubernetes de terceros a Google Cloud.

En la versión 1.8.x de Apigee Hybrid, se requieren clústeres adjuntos de Anthos si usas Anthos Service Mesh para la puerta de enlace de entrada. Si usas la puerta de enlace de entrada de Apigee, los clústeres adjuntos de Anthos son opcionales.

Revierte una actualización

Sigue estos pasos para revertir una actualización anterior:

Limpia los trabajos completados del espacio de nombres del entorno de ejecución híbrido, en el que NAMESPACE es el espacio de nombres especificado en el archivo de anulaciones, si especificaste un espacio de nombres. De lo contrario, el espacio de nombres predeterminado será apigee:
```
kubectl delete job -n NAMESPACE \
  $(kubectl get job -n NAMESPACE \
  -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
```

Limpia los trabajos completados del espacio de nombres apigee-system:

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

Cambia la variable APIGEECTL_HOME para que apunte al directorio que contiene la versión previa de apigeectl. Por ejemplo:
```
export APIGEECTL_HOME=PATH_TO_PREVIOUS_APIGEECTL_DIRECTORY
```
En el directorio raíz de la instalación a la que deseas revertir, ejecuta apigeectl apply, verifica el estado de los Pods y, luego, ejecuta apigeectl init. Asegúrate de usar el archivo de anulaciones original para la versión a la que deseas revertir:
1. En el directorio archivos híbridos, ejecuta apigeectl apply:
```
$APIGEECTL_HOME/apigeectl apply -f ORIGINAL_OVERRIDES_FILE
```
  En el ejemplo anterior, ORIGINAL_OVERRIDES_FILE es la ruta relativa y el nombre de archivo del archivo de anulación de la instalación híbrida de la versión anterior, por ejemplo, ./overrides/overrides1.8.yaml.
2. Verifica el estado de los pods:
```
kubectl -n NAMESPACE get pods
```
  En el ejemplo anterior, NAMESPACE es el espacio de nombres híbrido de Apigee.
3. Verifica el estado de apigeeds:
```
kubectl describe apigeeds -n apigee
```
  Deberías obtener un resultado similar al siguiente:
```
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
```
  Continúa con el siguiente paso solo cuando el Pod apigeeds esté en ejecución.
4. Ejecuta el siguiente comando para tomar nota de los valores nuevos de cantidad de réplicas del procesador de mensajes después de la actualización. Si estos valores no coinciden con lo que configuraste antes, cambia los valores en el archivo de anulación para que coincidan con tu configuración anterior.
```
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
```
  Deberías obtener un resultado similar al siguiente:
```
      autoScaler:
        minReplicas: 2
        maxReplicas: 10
```
5. Ejecuta apigeectl init:
```
$APIGEECTL_HOME/apigeectl init -f ORIGINAL_OVERRIDES_FILE
```

Actualiza Apigee Hybrid a la versión 1.9

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

Requisitos previos

Prepárate para actualizar a la versión 1.9

Crea una copia de seguridad de tu instalación híbrida (recomendado)

Linux

macOS

Windows

Agrega el rol Agente de Cloud Trace a la cuenta de servicio para el entorno de ejecución de Apigee. (Opcional)

Producción

No producción

Producción

No producción

Ejemplo

Instala la puerta de enlace de entrada de Apigee si la instalación usa Anthos Service Mesh

Sintaxis

Ejemplo

Instala el entorno de ejecución de hybrid 1.9.4

Linux

macOS

Windows

Linux

macOS

Windows

Linux

macOS

Windows

Linux

macOS

Windows

Linux

macOS

Windows

Producción

No producción

Instale 1.9.4-hotfix.1

Actualiza tu versión de Kubernetes

Haz clic para expandir una lista de plataformas compatibles.

Plataformas

Componentes

Acerca de los clústeres adjuntos

Revierte una actualización

Instale `1.9.4-hotfix.1`