Esta página se ha traducido con Cloud Translation API.

Actualizar Apigee Hybrid a la versión 1.9

En este procedimiento se explica cómo actualizar de la versión 1.8.x de Apigee hybrid a la versión 1.9.4 de Apigee hybrid y de versiones anteriores de hybrid 1.9.x a la versión 1.9.4.

Sigue los mismos procedimientos para actualizar versiones secundarias (por ejemplo, de la versión 1.8 a la 1.9) y para actualizar versiones de parche (por ejemplo, de la versión 1.9.0 a la 1.9.4).

Si vas a actualizar desde la versión 1.7 o una anterior de Apigee hybrid, primero debes actualizar a la versión 1.8 antes de actualizar a la 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 pasarela de entrada de Apigee como capa de entrada.

Información general sobre la actualización a la versión 1.9.4

Para actualizar a la versión 1.9 de Apigee Hybrid, es posible que se produzca un tiempo de inactividad.

Al actualizar el controlador de Apigee a la versión 1.9.4, todas las implementaciones de Apigee se reinician de forma progresiva. Para minimizar el tiempo de inactividad en entornos híbridos de producción durante un reinicio gradual, asegúrate de que tienes al menos dos clústeres (en la misma región o centro de datos, o en regiones o centros de datos diferentes). Desvía todo el tráfico de producción a un solo clúster y desconecta el clúster que vas a actualizar. A continuación, continúa con el proceso de actualización. Repite el proceso con cada clúster.

Apigee recomienda que actualice todos los clústeres lo antes posible para reducir las probabilidades de que se produzcan problemas en producción. No hay límite de tiempo para actualizar todos los clústeres restantes después de que se haya actualizado 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 la restauración de Cassandra no funcionan con versiones mixtas. Por ejemplo, una copia de seguridad de Hybrid 1.8 no se puede usar para restaurar una instancia de Hybrid 1.9.
La transmisión de datos de Cassandra no funcionará entre versiones híbridas mixtas. Por lo tanto, tus clústeres de Cassandra no se pueden escalar horizontalmente.
La ampliación y la retirada de regiones se verán afectadas, ya que estas operaciones dependen del streaming de datos de Cassandra.

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

Prepárate para cambiar a un plan superior.
Instala la versión 1.9.4 del entorno de ejecución híbrido.

Requisitos previos

En estas instrucciones de actualización se presupone que tienes instalada la versión 1.8.x de Apigee Hybrid y que quieres actualizarla a la versión 1.9.4. Si vas a actualizar desde una versión anterior, consulta las instrucciones para actualizar Apigee hybrid a la versión 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 la 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 vas a actualizar usa Anthos Service Mesh, primero debes migrar a Apigee Ingress Gateway antes de actualizar a la versión 1.9.4.
La pasarela de entrada de Apigee usa un pequeño subconjunto de las funciones de la pasarela de entrada de Anthos Service Mesh. Apigee hybrid gestiona y actualiza esas funciones automáticamente. Por lo tanto, no necesitas tener experiencia con Anthos Service Mesh para instalar, actualizar y gestionar la puerta de enlace de entrada híbrida de Apigee.

Consulta las instrucciones en la sección Migrar a la pasarela de entrada de Apigee de la documentación de Hybrid v1.8.

Prepararse para actualizar a la versión 1.9

Crear 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 del sistema de archivos en el que has instalado apigeectl. Si es necesario, cambia al 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%
```
Crea una copia de seguridad del directorio $APIGEECTL_HOME/ de la versión 1.8. Por ejemplo:
```
tar -czvf $APIGEECTL_HOME/../apigeectl-v1.8-backup.tar.gz $APIGEECTL_HOME
```
Crea una copia de seguridad de tu base de datos de Cassandra siguiendo las instrucciones de Copia de seguridad y recuperación de Cassandra.

Añade el rol Agente de Cloud Trace a la cuenta de servicio del entorno de ejecución de Apigee. (Opcional)

Opcional: Si tienes previsto usar Cloud Trace y aún no has añadido el rol Cloud Trace Agent a tu instalación de hybrid 1.8, asegúrate de que tu cuenta de servicio de los servicios de tiempo de ejecución de Apigee tenga el rol de gestión de identidades y accesos de Google Cloud Agente de Cloud Trace (roles/cloudtrace.agent).

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

Puedes añadir el rol en la interfaz de usuario Consola de Cloud > Gestión de identidades y accesos > Administración > Cuentas de servicio o con los siguientes comandos:

Obtén la dirección de correo 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 coincide con el patrón apigee-runtime@$ORG_NAME.iam.gserviceaccount.com, puedes usar ese patrón en el siguiente paso.
Non-Prod
```
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 siguiente paso.

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"

Non-Prod

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"

Donde $PROJECT_ID es el nombre del proyecto de Google Cloud en el que está instalado 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 pasarela de entrada de Apigee si tu 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 el tráfico de 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 1.9 de híbrida.

Añade la propiedad ingressGateways al 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.
      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 del despliegue de entrada. Puede ser cualquier nombre que cumpla los siguientes requisitos:
  - Tener una longitud máxima de 17 caracteres
  - Contener solo caracteres alfanuméricos en minúscula, guiones ("-") o puntos (".").
  - Empezar 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 el número mínimo y máximo de réplicas de la puerta de enlace de entrada de Apigee en tu instalación. Para obtener más información y conocer los ajustes predeterminados, consulta ingressGateways[].replicaCountMin y ingressGateways[].replicaCountMax en la referencia de la propiedad Configuration.
- CPU_COUNT_REQ y MEMORY_REQ son la solicitud de CPU y memoria de cada réplica de la puerta de enlace de entrada de Apigee en tu instalación.
  Define estas propiedades si ya las has definido para tu pasarela de entrada de Anthos Service Mesh, por ejemplo, en tu archivo overlay.yaml.
  
  Para obtener más información y conocer los ajustes predeterminados, consulta ingressGateways[].resources.requests.cpu y ingressGateways[].resources.requests.memory en la referencia de la propiedad Configuration.
- CPU_COUNT_LIMIT y MEMORY_LIMIT son los límites máximos de CPU y memoria de cada réplica de la puerta de enlace de entrada de Apigee en tu instalación.
  Define estas propiedades si ya las has definido para tu pasarela de entrada de Anthos Service Mesh, por ejemplo, en tu archivo overlay.yaml.
  
  Para obtener más información y conocer los ajustes predeterminados, consulta ingressGateways[].resources.limits.cpu y ingressGateways[].resources.limits.memory en la referencia de la propiedad Configuration.
- SVC_ANNOTATIONS_KEY SVC_ANNOTATIONS_VALUE (opcional):
  Nota: El campo ingressGateways[].svcAnnotations de overrides.yaml no funciona como se espera. Consulta el problema conocido 243599452
  .
  Se trata de un par clave-valor que proporciona anotaciones para tu servicio de entrada predeterminado. Tu plataforma en la nube usa las anotaciones para ayudarte a configurar tu instalación híbrida. Por ejemplo, puedes definir el tipo de balanceador de carga 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 defina Annotations si va a crear su propio servicio de Kubernetes para la implementación de entrada, tal como se describe en el artículo Exponer la pasarela de 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 a tu balanceador de carga. En las plataformas que admiten la especificación de la dirección IP del balanceador de carga, este se creará con esa dirección IP. En las plataformas que no permiten especificar la dirección IP del balanceador de carga, esta propiedad se ignora.
  Si no tienes una dirección IP estática asignada a tu balanceador de carga, no incluyas esta propiedad en tu archivo de anulaciones.
  
  Precaución: No especifiques la misma dirección IP que el istio-ingressgateway actual. Esto podría causar problemas mientras ese servicio siga en el clúster.
  
  Nota: No es necesario que definas LoadBalancerIP si vas a crear tu propio servicio de Kubernetes para la implementación de ingress, tal como se describe en el artículo Exponer la pasarela de ingress 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
```
Exponga la pasarela de entrada de Apigee. Sigue los procedimientos que se indican en Exponer la pasarela de entrada de Apigee.
Prueba tu nueva pasarela de entrada llamando a un proxy. Lo ideal es que pruebes todos los proxies cruciales que tengas implementados.
Para cambiar el tráfico, actualiza tus registros DNS para que apunten a la dirección IP de tu nueva pasarela de entrada de Apigee. En función de tu proveedor de DNS, es posible que puedas transferir el tráfico gradualmente al nuevo endpoint.
Nota: Puedes encontrar la dirección IP externa de la pasarela de entrada de Apigee con el siguiente comando:
```
kubectl get svc -n apigee -l app=apigee-ingressgateway
```
La salida debería tener un aspecto similar a este:
```
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
```
Para comprobar que todo el tráfico de tiempo de ejecución funciona, monitoriza tus paneles de control. Solo debes continuar con el siguiente paso si todo funciona correctamente. Asegúrate de que no haya tráfico que pase por tu antigua puerta de enlace de entrada (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 configuración a Anthos Service Mesh, sigue los pasos que se indican en Dejar de proporcionar configuración a ASM en la guía para gestionar la pasarela de entrada de Apigee.
Vuelve a probar y monitoriza el tráfico del proxy de API.
Sigue las instrucciones de la documentación de Anthos Service Mesh para desinstalar Anthos Service Mesh del clúster.

Instalar el entorno de ejecución híbrido 1.9.4

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

Descarga el paquete de lanzamiento de tu sistema operativo con el siguiente comando. Selecciona 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 de 64 bits:

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

Windows

Windows (64 bits):

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

Cambia el nombre del directorio apigeectl/ actual por el de un 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 el directorio base híbrido. El directorio base híbrido es el directorio en el que se encuentra el directorio apigeectl-v1.8 renombrado:
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 descomprime en un directorio cuyo nombre incluye la versión y la plataforma. 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 apigeectldirectorio principal. Es donde se encuentra el comando ejecutable apigeectl.
En estas instrucciones se usa la variable de entorno $APIGEECTL_HOME para el directorio de tu sistema de archivos en el que está instalada la utilidad apigeectl. Si es necesario, cambia al 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 anulaciones, 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 ser el clúster en el que vas a actualizar Apigee Hybrid.
```
kubectl config get-contexts | grep \*
```
En el directorio hybrid-files:
1. Actualiza los siguientes enlaces simbólicos a $APIGEECTL_HOME. Estos enlaces 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 comprobar que los enlaces simbólicos se han creado correctamente, ejecuta el siguiente comando y asegúrate de que las rutas de los enlaces apuntan a las ubicaciones correctas:
```
ls -l | grep ^l
```
Haz una inicialización de prueba para comprobar si hay errores:
```
${APIGEECTL_HOME}/apigeectl init -f OVERRIDES_FILE --dry-run=client
```
Donde OVERRIDES_FILE es el nombre del archivo de anulaciones. Por ejemplo, ./overrides/overrides.yaml.

Nota: Puedes sustituir OVERRIDES_FILE en el código de ejemplo anterior por el nombre y la ruta de tu archivo de anulaciones. Todas las instancias de esta página se sustituirán.
Si no hay errores, inicializa la versión 1.9.4 híbrida:
```
$APIGEECTL_HOME/apigeectl init -f OVERRIDES_FILE
```
Nota: apigeectl instala y configura la pasarela de entrada de Apigee cuando ejecutas apigeectl init.
Comprueba el estado de inicialización:
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```
Si la operación se realiza correctamente, el resultado será: All containers ready.
```
kubectl describe apigeeds -n apigee
```
En el resultado, busca State: running.
Comprueba si hay errores con una prueba de funcionamiento del comando apply mediante la marca --dry-run:
```
$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --dry-run=client
```
Si no hay errores, aplica las anulaciones. Seleccione y siga las instrucciones para entornos de producción o de no producción, según su instalación.
Producción

En los entornos de producción, actualiza cada componente híbrido por separado y comprueba el estado del componente actualizado antes de pasar al siguiente.
1. Asegúrate de que estás en el directorio hybrid-files.
2. Aplica las anulaciones para actualizar Cassandra:
  $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --datastore
3. Comprobación completada:
  $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
  Nota: Si check-ready falla, puedes obtener más información sobre tus pods con el siguiente comando:
  kubectl -n NAMESPACE get pods
  
  Donde NAMESPACE es el espacio de nombres de Apigee hybrid.
  Continúa con el siguiente paso solo cuando los pods estén listos.
4. Aplica las anulaciones para actualizar los componentes de Telemetría y comprueba que se han completado:
  $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --telemetry
  $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
5. Inicia los componentes de Redis:
  $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --redis
6. Aplica las anulaciones para actualizar los componentes a nivel de organización (MART, Watcher y Apigee Connect) y comprueba si se han completado:
  $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --org
  $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
7. Aplica las anulaciones para actualizar tus entornos. Tienes dos opciones:
  - Entorno por entorno: aplica las anulaciones a un entorno cada vez y comprueba que se completan. Repite este paso para cada entorno:
    $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --env ENV_NAME
    
    $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
    
    Donde ENV_NAME es el nombre del entorno que vas a actualizar.
  - Todos los entornos a la vez: aplica las anulaciones a todos los entornos a la vez y comprueba si se han completado:
    $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --all-envs
    
    $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
8. Aplica las anulaciones para actualizar los componentes virtualhosts y comprueba si se han completado:
  $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 que no son de producción, de demostración o experimentales, puedes aplicar las anulaciones a todos los componentes a la vez. Si tu entorno de no producción es grande y complejo o se parece mucho a un entorno de producción, te recomendamos que sigas 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. Comprueba el estado:
  $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE

Instalar `1.9.4-hotfix.1`

Sigue estos pasos para instalar la versión de la revisión, 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 tienes la versión 1.9.4 o una posterior, actualiza a la 1.9.4 antes de continuar.
Abre el archivo overrides.yaml.
En la estrofa istiod, cambie 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"
```

En función de cómo hayas elegido instalar Apigee hybrid, puede que tengas una sección ingressGateway o ingressGateways. Busca la estrofa que aparece en el 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, si tienes una sección 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 de ellas:
```
$APIGEECTL_HOME/apigeectl apply --org -f OVERRIDES_FILE
```
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```

Verifica el estado de tus pods:

kubectl get pods -n YOUR_APIGEE_NAMESPACE

Actualizar la versión de Kubernetes

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

Haz clic para desplegar la 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 (on-premises - 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)⁽⁷⁾	N/A	N/A	N/A	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 o versiones posteriores: Conflicto con `cert-manager` al actualizar a la versión 1.8.2 o una posterior. Anthos 1.9: Conflicto con `cert-manager` al actualizar a la versión 1.9.0 o 1.9.1. Anthos 1.10 o versiones posteriores: Instalación en conflicto de `cert-manager`. ⁽²⁾ La asistencia está disponible con Apigee hybrid versión 1.7.2 y posteriores. ⁽³⁾ Se han alcanzado las fechas oficiales de finalización del ciclo de vida de las versiones 1.8 y anteriores de Apigee hybrid. Los parches mensuales periódicos ya no están disponibles. Estas versiones ya no se admiten oficialmente, excepto para los clientes que tengan excepciones explícitas y oficiales para seguir recibiendo asistencia. Otros clientes deben actualizarse. ⁽⁴⁾Las versiones 1.12 y anteriores de Anthos en Bare Metal y VMware ya no tienen asistencia. Consulta la política de asistencia de versiones de Anthos en Bare Metal y las versiones de clústeres de Anthos en VMware. ⁽⁵⁾Anthos en Bare Metal y VMware requiere ASM 1.14 o una versión posterior. Te recomendamos que actualices a la versión 1.8 de Hybrid y que cambies a la puerta de enlace de entrada de Apigee, que ya no requiere que instales ASM en tu clúster híbrido. ⁽⁶⁾ La asistencia está disponible en Apigee hybrid versión 1.8.4 y posteriores. ⁽⁷⁾ Los clústeres adjuntos no son necesarios para Apigee hybrid v1.8 y versiones posteriores que usen Apigee ingressgateway.. ⁽⁸⁾ No se admite en Apigee hybrid versión 1.8.4 y posteriores. ⁽⁹⁾ La asistencia está disponible en Apigee hybrid versión 1.7.6 y posteriores. ⁽¹⁰⁾ No se admite en Apigee Hybrid versión 1.8.5 y posteriores. ⁽¹¹⁾ ASM se instala automáticamente con Apigee hybrid 1.9 y versiones posteriores. ⁽¹²⁾ La asistencia está disponible con Apigee Hybrid versión 1.9.2 y posteriores. ⁽¹³⁾ Los números de versión de los clústeres de Anthos en AWS (multinube) ahora reflejan las versiones de Kubernetes. Consulta la compatibilidad con versiones y actualizaciones de Anthos para obtener información sobre las versiones y los parches recomendados.

Acerca de los clústeres vinculados

En las versiones híbridas de Apigee 1.7.x y anteriores, debes usar clústeres adjuntos de Anthos si quieres ejecutar Apigee hybrid en un contexto multicloud en Elastic Kubernetes Service (EKS), Azure Kubernetes Service (AKS) u otro proveedor de servicios de Kubernetes de terceros compatible. La asociación de clústeres permite a Google medir el uso de Anthos Service Mesh (ASM). Registrar el clúster de terceros es opcional. Regístrate solo si quieres ver el clúster adjunto en la Google Cloud console. Para obtener más información, consulta el artículo sobre cómo asociar clústeres de Kubernetes de terceros a Google Cloud.

En la versión híbrida 1.8.x de Apigee, se necesitan clústeres adjuntos de Anthos si usas Anthos Service Mesh para tu pasarela de entrada. Si usas la pasarela de entrada de Apigee, los clústeres adjuntos de Anthos son opcionales.

Restaurar una versión anterior de una actualización

Sigue estos pasos para revertir una actualización anterior:

Limpia las tareas completadas del espacio de nombres del tiempo de ejecución híbrido, donde NAMESPACE es el espacio de nombres especificado en el archivo de anulaciones (si has especificado alguno). Si no es así, el espacio de nombres predeterminado es apigee:
```
kubectl delete job -n NAMESPACE \
  $(kubectl get job -n NAMESPACE \
  -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
```

Limpia las tareas completadas 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 anterior de apigeectl. Por ejemplo:
```
export APIGEECTL_HOME=PATH_TO_PREVIOUS_APIGEECTL_DIRECTORY
```
En el directorio raíz de la instalación a la que quieras volver, ejecuta apigeectl apply, comprueba el estado de tus pods y, a continuación, ejecuta apigeectl init. Asegúrate de usar el archivo de anulaciones original de la versión a la que quieras volver:
1. En el directorio hybrid-files, ejecuta apigeectl apply:
```
$APIGEECTL_HOME/apigeectl apply -f ORIGINAL_OVERRIDES_FILE
```
  Donde ORIGINAL_OVERRIDES_FILE es la ruta relativa y el nombre de archivo de las anulaciones del archivo de tu instalación híbrida anterior. Por ejemplo, ./overrides/overrides1.8.yaml.
2. Verifica el estado de tus pods:
```
kubectl -n NAMESPACE get pods
```
  Donde NAMESPACE es el espacio de nombres de Apigee hybrid.
3. Comprueba el estado de apigeeds:
```
kubectl describe apigeeds -n apigee
```
  La salida debería tener un aspecto similar a este:
```
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 anotar los nuevos valores del recuento de réplicas del procesador de mensajes después de la actualización. Si estos valores no coinciden con los que ha definido anteriormente, cambie los valores del archivo de anulaciones para que coincidan con la 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
```
  La salida debería tener un aspecto similar a este:
```
      autoScaler:
        minReplicas: 2
        maxReplicas: 10
```
5. Ejecuta apigeectl init:
```
$APIGEECTL_HOME/apigeectl init -f ORIGINAL_OVERRIDES_FILE
```

Actualizar Apigee Hybrid a la versión 1.9 Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Información general sobre la actualización a la versión 1.9.4

Requisitos previos

Prepararse para actualizar a la versión 1.9

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

Linux

macOS

Windows

Añade el rol Agente de Cloud Trace a la cuenta de servicio del entorno de ejecución de Apigee. (Opcional)

Producción

Non-Prod

Producción

Non-Prod

Ejemplo

Instala la pasarela de entrada de Apigee si tu instalación usa Anthos Service Mesh

Sintaxis

Ejemplo

Instalar el entorno de ejecución híbrido 1.9.4

Linux

macOS

Windows

Linux

macOS

Windows

Linux

macOS

Windows

Linux

macOS

Windows

Linux

macOS

Windows

Producción

No producción

Instalar 1.9.4-hotfix.1

Actualizar la versión de Kubernetes

Haz clic para desplegar la lista de plataformas compatibles.

Plataformas

Componentes

Acerca de los clústeres vinculados

Restaurar una versión anterior de una actualización

Actualizar Apigee Hybrid a la versión 1.9

Instalar `1.9.4-hotfix.1`