Actualizar Apigee Hybrid a la versión 1.5

Si vas a actualizar desde la versión 1.3 o una versión anterior de Apigee hybrid, primero debes actualizar a la versión 1.4 antes de actualizar a la versión 1.5.10. Consulta las instrucciones para actualizar Apigee hybrid a la versión 1.4.

Información general sobre la actualización a la versión 1.5.10.

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

  1. Crea una copia de seguridad de tu instalación híbrida.
  2. Comprueba tu versión de Kubernetes y actualízala si es necesario.
  3. Actualiza ASM.
  4. Instala la versión 1.5 del entorno de ejecución híbrido.

Requisitos previos

Actualizar a la versión 1.5

  1. 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, ve al directorio cd y define la variable con el siguiente comando:
    apigeectl

    Linux 

    export APIGEECTL_HOME=$PWD
     
    echo $APIGEECTL_HOME

    macOS 

    export APIGEECTL_HOME=$PWD
     
    echo $APIGEECTL_HOME

    Windows 

    set APIGEECTL_HOME=%CD%
     
    echo %APIGEECTL_HOME%
  2. (Recomendado) Haz una copia de seguridad del directorio $APIGEECTL_HOME/ de la versión 1.4. Por ejemplo: 
    tar -czvf $APIGEECTL_HOME/../apigeectl-v1.4-backup.tar.gz $APIGEECTL_HOME
  3. (Recomendado) Crea una copia de seguridad de tu base de datos de Cassandra siguiendo las instrucciones de Copia de seguridad y recuperación de Cassandra.
  4. Actualiza tu plataforma Kubernetes a las versiones compatibles con Hybrid 1.5. Si necesitas ayuda, consulta la documentación de tu plataforma.
  5. Si usas una versión de cert-manager anterior a la 1.2.0, debes actualizarla a la versión 1.2.0.

    1. Consulta la versión actual de cert-manager con el siguiente comando:

      kubectl -n cert-manager get deployment -o yaml | grep 'image:'

      Se devuelve algo similar a lo siguiente:

      image: quay.io/jetstack/cert-manager-controller:v1.2.0
image: quay.io/jetstack/cert-manager-cainjector:v1.2.0
image: quay.io/jetstack/cert-manager-webhook:v1.2.0
    2. Elimina las implementaciones con el siguiente comando: 
      kubectl delete -n cert-manager deployment cert-manager cert-manager-cainjector cert-manager-webhook
    3. Actualiza cert-manager a la versión 1.2.0 con el siguiente comando: 
      kubectl apply -f https://github.com/jetstack/cert-manager/releases/download/v1.2.0/cert-manager.yaml

Actualizar ASM a la versión 1.26

Realiza la actualización siguiendo la documentación de ASM adecuada para tu plataforma:

Las instrucciones para instalar y configurar ASM varían en función de la plataforma. Las plataformas se dividen en las siguientes categorías:

  • GKE: clústeres de Google Kubernetes Engine que se ejecutan en Google Cloud.
  • Fuera de Google Cloud: clústeres de Anthos que se ejecutan en:
    • Clústeres de Anthos en VMware (GKE On-Prem)
    • Anthos en Bare Metal
    • Clústeres de Anthos en AWS
    • Amazon EKS
  • Otras plataformas de Kubernetes: clústeres conformes creados y ejecutados en:
    • AKS
    • EKS
    • OpenShift

GKE

La secuencia para actualizar a la versión 1.8.x de ASM en tu instalación híbrida es la siguiente:

  1. Prepárate para la actualización.
  2. Instala la nueva versión de ASM.
  3. Elimina las implementaciones, los servicios y los webhooks de la versión anterior de ASM de tu instalación actual.
  4. Actualiza tus pasarelas y configura los nuevos webhooks.

Para actualizar a la versión 1.8.x de ASM para la configuración híbrida en GKE, sigue estos pasos:

.
  • Consulta los requisitos en Actualizar Anthos Service Mesh, pero no realices la actualización todavía.
  • Antes de instalar la nueva versión, determina la revisión actual. Necesitarás esta información para eliminar las implementaciones, los servicios y los webhooks de la versión anterior de ASM de tu instalación actual. Usa el siguiente comando para almacenar la revisión actual de istiod en una variable de entorno: 
    export DELETE_REV=$(kubectl get deploy -n istio-system -l app=istiod -o jsonpath={.items[].metadata.labels.'istio\.io\/rev'}'{"\n"}')
echo ${DELETE_REV}
  • Crea un archivo overlay.yaml o comprueba que el que ya tienes contiene lo siguiente:overlay.yaml 
    apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
  revision: asm-1264-1
  components:
    ingressGateways:
      - name: istio-ingressgateway
        enabled: true
        k8s:
          nodeSelector:
            # default node selector, if different or not using node selectors, change accordingly.
            cloud.google.com/gke-nodepool: apigee-runtime
          resources:
            requests:
              cpu: 1000m
          service:
            type: LoadBalancer
            loadBalancerIP: STATIC_IP # If you do not have a reserved static IP, leave this out.
            ports:
              - name: http-status-port
                port: 15021
              - name: http2
                port: 80
                targetPort: 8080
              - name: https
                port: 443
                targetPort: 8443
  meshConfig:
    accessLogFormat:
      '{"start_time":"%START_TIME%","remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%","user_agent":"%REQ(USER-AGENT)%","host":"%REQ(:AUTHORITY)%","request":"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%","request_time":"%DURATION%","status":"%RESPONSE_CODE%","status_details":"%RESPONSE_CODE_DETAILS%","bytes_received":"%BYTES_RECEIVED%","bytes_sent":"%BYTES_SENT%","upstream_address":"%UPSTREAM_HOST%","upstream_response_flags":"%RESPONSE_FLAGS%","upstream_response_time":"%RESPONSE_DURATION%","upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%","upstream_cluster":"%UPSTREAM_CLUSTER%","x_forwarded_for":"%REQ(X-FORWARDED-FOR)%","request_method":"%REQ(:METHOD)%","request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%","request_protocol":"%PROTOCOL%","tls_protocol":"%DOWNSTREAM_TLS_VERSION%","request_id":"%REQ(X-REQUEST-ID)%","sni_host":"%REQUESTED_SERVER_NAME%","apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'
  • Sigue las instrucciones de las siguientes secciones de la documentación de ASM:
    1. Descargar asmcli
    2. Conceder permisos de administrador de clústeres
    3. Validar proyecto y clúster
    4. Actualiza tu plan con funciones opcionales. Detenerse antes de empezar la sección "Actualizar las pasarelas"
  • Elimina el webhook de mutación y el webhook de validación:
    1. cd en el directorio donde hayas instalado asmcli.
    2. Almacena la nueva revisión actual en una variable de entorno para usarla en la secuencia de comandos para eliminar los webhooks: 
      UPGRADE_REV="asm-1264-1"
    3. Crea un shell script que contenga los siguientes comandos: 
      #!/bin/bash

set -ex

PROJECT_ID="YOUR_PROJECT_ID"
CLUSTER_NAME="YOUR_CLUSTER_NAME"
CLUSTER_LOCATION="YOUR_CLUSTER_LOCATION"

kubectl label namespace istio-system istio.io/rev=${UPGRADE_REV} istio-injection- --overwrite
kubectl rollout restart deployment -n istio-system
kubectl apply -n istio-system -f PATH_TO_INGRESSGATEWAYistio-ingressgateway
kubectl apply -n istio-system -f PATH_TO_INGRESSGATEWAY/istio-ingressgateway-connectors

if [[ "${DELETE_REV}" != "${UPGRADE_REV}" ]]; then
  kubectl apply -f out/asm/istio/istiod-service.yaml
  kubectl delete deploy -l app=istio-ingressgateway,istio.io/rev=${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete deploy -l app=istio-ingressgateway-connectors,istio.io/rev=${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete ValidatingWebhookConfiguration -l app=istiod,istio.io/rev=${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete MutatingWebhookConfiguration -l app=sidecar-injector,istio.io/rev=${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete Service,Deployment,HorizontalPodAutoscaler,PodDisruptionBudget istiod-${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete IstioOperator installed-state-${DELETE_REV} -n istio-system --ignore-not-found=true
fi
    4. Ejecuta la secuencia de comandos para eliminar los webhooks actuales.
  • Sigue los pasos que se indican en Actualizar pasarelas para crear los nuevos webhooks y cambiar el tráfico a las nuevas pasarelas.

    • Fuera de Google Cloud

    Estas instrucciones explican cómo actualizar ASM en los siguientes sistemas:

    • Clústeres de Anthos en VMware (GKE On-Prem)
    • Anthos en Bare Metal
    • Clústeres de Anthos en AWS
    • Amazon EKS
    .
  • Consulta los requisitos en Actualizar Anthos Service Mesh, pero no realices la actualización todavía.
  • Antes de instalar la nueva versión, determina la revisión actual. Necesitarás esta información para eliminar el webhook de validación y el webhook de mutación de tu instalación actual de ASM. Usa el siguiente comando para almacenar la revisión de istiod actual en una variable de entorno: 
    export DELETE_REV=$(kubectl get deploy -n istio-system -l app=istiod -o jsonpath={.items[].metadata.labels.'istio\.io\/rev'}'{"\n"}')
echo ${DELETE_REV}
  • Crea un archivo overlay.yaml o comprueba que el que ya tienes contiene lo siguiente:overlay.yaml 
    apiVersion: install.istio.io/v1alpha1
kind: IstioOperator
spec:
  revision: asm-1264-1
  components:
    ingressGateways:
      - name: istio-ingressgateway
        enabled: true
        k8s:
          nodeSelector:
            # default node selector, if different or not using node selectors, change accordingly.
            cloud.google.com/gke-nodepool: apigee-runtime
          resources:
            requests:
              cpu: 1000m
          service:
            type: LoadBalancer
            loadBalancerIP: STATIC_IP # If you do not have a reserved static IP, leave this out.
            ports:
              - name: http-status-port
                port: 15021
              - name: http2
                port: 80
                targetPort: 8080
              - name: https
                port: 443
                targetPort: 8443
  values:
    gateways:
      istio-ingressgateway:
        runAsRoot: true

  meshConfig:
    accessLogFormat:
      '{"start_time":"%START_TIME%","remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%","user_agent":"%REQ(USER-AGENT)%","host":"%REQ(:AUTHORITY)%","request":"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%","request_time":"%DURATION%","status":"%RESPONSE_CODE%","status_details":"%RESPONSE_CODE_DETAILS%","bytes_received":"%BYTES_RECEIVED%","bytes_sent":"%BYTES_SENT%","upstream_address":"%UPSTREAM_HOST%","upstream_response_flags":"%RESPONSE_FLAGS%","upstream_response_time":"%RESPONSE_DURATION%","upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%","upstream_cluster":"%UPSTREAM_CLUSTER%","x_forwarded_for":"%REQ(X-FORWARDED-FOR)%","request_method":"%REQ(:METHOD)%","request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%","request_protocol":"%PROTOCOL%","tls_protocol":"%DOWNSTREAM_TLS_VERSION%","request_id":"%REQ(X-REQUEST-ID)%","sni_host":"%REQUESTED_SERVER_NAME%","apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'
  • Sigue las instrucciones de las siguientes secciones de la documentación de ASM:
    1. Descargar asmcli
    2. Conceder permisos de administrador de clústeres
    3. Validar proyecto y clúster
    4. Actualiza tu plan con funciones opcionales. Detenerse antes de empezar la sección "Actualizar las pasarelas"
  • Elimina el webhook de mutación y el webhook de validación:
    1. cd en el directorio donde hayas instalado asmcli.
    2. Almacena la nueva revisión actual en una variable de entorno para usarla en la secuencia de comandos para eliminar los webhooks: 
      UPGRADE_REV="asm-1264-1"
    3. Crea un shell script que contenga los siguientes comandos: 
      #!/bin/bash

set -ex

PROJECT_ID="YOUR_PROJECT_ID"
CLUSTER_NAME="YOUR_CLUSTER_NAME"
CLUSTER_LOCATION="YOUR_CLUSTER_LOCATION"


gcloud config configurations activate ${PROJECT_ID}
gcloud container clusters get-credentials ${CLUSTER_NAME} --region ${CLUSTER_LOCATION} --project ${PROJECT_ID}


kubectl label namespace istio-system istio.io/rev=${UPGRADE_REV} istio-injection- --overwrite
kubectl rollout restart deployment -n istio-system
kubectl apply -n istio-system -f PATH_TO_INGRESSGATEWAYistio-ingressgateway
kubectl apply -n istio-system -f PATH_TO_INGRESSGATEWAY/istio-ingressgateway-connectors

if [[ "${DELETE_REV}" != "${UPGRADE_REV}" ]]; then
  kubectl apply -f out/asm/istio/istiod-service.yaml
  kubectl delete deploy -l app=istio-ingressgateway,istio.io/rev=${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete deploy -l app=istio-ingressgateway-connectors,istio.io/rev=${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete ValidatingWebhookConfiguration -l app=istiod,istio.io/rev=${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete MutatingWebhookConfiguration -l app=sidecar-injector,istio.io/rev=${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete Service,Deployment,HorizontalPodAutoscaler,PodDisruptionBudget istiod-${DELETE_REV} -n istio-system --ignore-not-found=true
  kubectl delete IstioOperator installed-state-${DELETE_REV} -n istio-system --ignore-not-found=true
fi
    4. Ejecuta la secuencia de comandos para eliminar los webhooks actuales.
  • Sigue los pasos que se indican en Actualizar pasarelas para crear los nuevos webhooks y cambiar el tráfico a las nuevas pasarelas.

    • AKS/EKS

    En estas instrucciones, el proceso de actualización de la versión istio-1.26.4-asm.1 de Anthos Service Mesh (ASM) en clústeres vinculados de Anthos es el mismo que el de una instalación nueva.

    Prepararse para instalar Anthos Service Mesh

      Linux

    1. Descarga el archivo de instalación de Anthos Service Mesh en tu directorio de trabajo actual: 
      curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.4-asm.1-linux-amd64.tar.gz
    2. Descarga el archivo de firma y usa openssl para verificar la firma: 
      curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.4-asm.1-linux-amd64.tar.gz.1.sig
       
      openssl dgst -verify /dev/stdin -signature istio-1.26.4-asm.1-linux-amd64.tar.gz.1.sig istio-1.26.4-asm.1.tar.gz <<'EOF'
-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ
wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==
-----END PUBLIC KEY-----
EOF
    3. Extrae el contenido del archivo a cualquier ubicación de tu sistema de archivos. Por ejemplo, para extraer el contenido al directorio de trabajo actual, haz lo siguiente: 
      tar xzf istio-1.26.4-asm.1-linux-amd64.tar.gz

      El comando crea un directorio de instalación en tu directorio de trabajo actual llamado istio-1.26.4-asm.1 que contiene lo siguiente:

      • Aplicaciones de ejemplo en el directorio samples.
      • La herramienta de línea de comandos istioctl que usas para instalar Anthos Service Mesh se encuentra en el directorio bin.
      • Los perfiles de configuración de Anthos Service Mesh se encuentran en el directorio manifests/profiles.
    4. Asegúrate de que te encuentras en el directorio raíz de la instalación de Anthos Service Mesh: 
      cd istio-1.26.4-asm.1
    5. Para mayor comodidad, añade las herramientas del directorio /bin a tu PATH: 
      export PATH=$PWD/bin:$PATH

      6. macOS

    6. Descarga el archivo de instalación de Anthos Service Mesh en tu directorio de trabajo actual: 
      curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.4-asm.1-osx.tar.gz
    7. Descarga el archivo de firma y usa openssl para verificar la firma: 
      curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.4-asm.1-osx.tar.gz.1.sig
       
      openssl dgst -sha256 -verify /dev/stdin -signature istio-1.26.4-asm.1-osx.tar.gz.1.sig istio-1.26.4-asm.1.tar.gz <<'EOF'
-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ
wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==
-----END PUBLIC KEY-----
EOF
    8. Extrae el contenido del archivo a cualquier ubicación de tu sistema de archivos. Por ejemplo, para extraer el contenido al directorio de trabajo actual, haz lo siguiente: 
      tar xzf istio-1.26.4-asm.1-osx.tar.gz

      El comando crea un directorio de instalación en tu directorio de trabajo actual llamado istio-1.26.4-asm.1 que contiene lo siguiente:

      • Aplicaciones de ejemplo en el directorio samples.
      • La herramienta de línea de comandos istioctl que usas para instalar Anthos Service Mesh se encuentra en el directorio bin.
      • Los perfiles de configuración de Anthos Service Mesh se encuentran en el directorio manifests/profiles.
    9. Asegúrate de que te encuentras en el directorio raíz de la instalación de Anthos Service Mesh: 
      cd istio-1.26.4-asm.1
    10. Para mayor comodidad, añade las herramientas del directorio /bin a tu PATH: 
      export PATH=$PWD/bin:$PATH

      11. Windows

    11. Descarga el archivo de instalación de Anthos Service Mesh en tu directorio de trabajo actual: 
      curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.4-asm.1-win.zip
    12. Descarga el archivo de firma y usa openssl para verificar la firma: 
      curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.4-asm.1-win.zip.1.sig
       
      openssl dgst -verify - -signature istio-1.26.4-asm.1-win.zip.1.sig istio-1.26.4-asm.1.win.zip <<'EOF'
-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ
wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==
-----END PUBLIC KEY-----
EOF
    13. Extrae el contenido del archivo a cualquier ubicación de tu sistema de archivos. Por ejemplo, para extraer el contenido al directorio de trabajo actual, haz lo siguiente: 
      tar xzf istio-1.26.4-asm.1-win.zip

      El comando crea un directorio de instalación en tu directorio de trabajo actual llamado istio-1.26.4-asm.1 que contiene lo siguiente:

      • Aplicaciones de ejemplo en el directorio samples.
      • La herramienta de línea de comandos istioctl que usas para instalar Anthos Service Mesh se encuentra en el directorio bin.
      • Los perfiles de configuración de Anthos Service Mesh se encuentran en el directorio manifests\profiles.
    14. Asegúrate de que te encuentras en el directorio raíz de la instalación de Anthos Service Mesh: 
      cd istio-1.26.4-asm.1
    15. Para mayor comodidad, añade las herramientas del directorio \bin a tu PATH: 
      set PATH=%CD%\bin:%PATH%
      16.
    16. Ahora que ASM Istio está instalado, comprueba la versión de istioctl: 
      istioctl version
    17. Crea un espacio de nombres llamado istio-system para los componentes del plano de control: 
      kubectl create namespace istio-system

    Configurar el webhook de validación

    Cuando instalas Anthos Service Mesh, asignas una etiqueta de revisión a istiod. Debes definir la misma revisión en el webhook de validación.

    1. Crea un archivo llamado istiod-service.yaml con el siguiente contenido: 
      apiVersion: v1
kind: Service
metadata:
  name: istiod
  namespace: istio-system
  labels:
    istio.io/rev: asm-1264-1
    app: istiod
    istio: pilot
    release: istio
spec:
  ports:
    - port: 15010
      name: grpc-xds # plaintext
      protocol: TCP
    - port: 15012
      name: https-dns # mTLS with k8s-signed cert
      protocol: TCP
    - port: 443
      name: https-webhook # validation and injection
      targetPort: 15017
      protocol: TCP
    - port: 15014
      name: http-monitoring # prometheus stats
      protocol: TCP
  selector:
    app: istiod
    istio.io/rev: asm-1264-1
  meshConfig:
    accessLogFormat:
      '{"start_time":"%START_TIME%","remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%","user_agent":"%REQ(USER-AGENT)%","host":"%REQ(:AUTHORITY)%","request":"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%","request_time":"%DURATION%","status":"%RESPONSE_CODE%","status_details":"%RESPONSE_CODE_DETAILS%","bytes_received":"%BYTES_RECEIVED%","bytes_sent":"%BYTES_SENT%","upstream_address":"%UPSTREAM_HOST%","upstream_response_flags":"%RESPONSE_FLAGS%","upstream_response_time":"%RESPONSE_DURATION%","upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%","upstream_cluster":"%UPSTREAM_CLUSTER%","x_forwarded_for":"%REQ(X-FORWARDED-FOR)%","request_method":"%REQ(:METHOD)%","request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%","request_protocol":"%PROTOCOL%","tls_protocol":"%DOWNSTREAM_TLS_VERSION%","request_id":"%REQ(X-REQUEST-ID)%","sni_host":"%REQUESTED_SERVER_NAME%","apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'
    2. Usa kubectl para aplicar la configuración del webhook de validación: 
      kubectl apply -f istiod-service.yaml
    3. Verifica que se ha aplicado la configuración: 
      kubectl get svc -n istio-system

      La respuesta debería ser similar a esta: 

      NAME     TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)                                 AGE
istiod   ClusterIP   172.200.18.133   <none>        15010/TCP,15012/TCP,443/TCP,15014/TCP   22s

    Instalar Anthos Service Mesh

    1. Instala Anthos Service Mesh con istioctl mediante el perfil asm-multicloud: 
      istioctl install \
    --set profile=asm-multicloud \
    --set revision="asm-1264-1"

      La salida debería tener un aspecto similar a este: 

      kubectl get pods -n istio-system
NAME                                   READY   STATUS    RESTARTS   AGE
istio-ingressgateway-88b6fd976-flgp2   1/1     Running   0          3m13s
istio-ingressgateway-88b6fd976-p5dl9   1/1     Running   0          2m57s
istiod-asm-1264-1-798ffb964-2ls88       1/1     Running   0          3m21s
istiod-asm-1264-1-798ffb964-fnj8c       1/1     Running   1          3m21s

      El argumento --set revision añade una etiqueta de revisión con el formato istio.io/rev=asm-1264-1 a istiod. El webhook del inyector automático de sidecars usa la etiqueta de revisión para asociar los sidecars inyectados con una revisión de istiod concreta. Para habilitar la inyección automática de sidecar en un espacio de nombres, debe etiquetarlo con una revisión que coincida con la etiqueta de istiod.

    2. Comprueba que la instalación se ha completado: 
      kubectl get svc -n istio-system

      La salida debería tener un aspecto similar a este: 

      NAME                   TYPE           CLUSTER-IP       EXTERNAL-IP     PORT(S)                                                                      AGE
istio-ingressgateway   LoadBalancer   172.200.48.52    34.74.177.168   15021:30479/TCP,80:30030/TCP,443:32200/TCP,15012:32297/TCP,15443:30244/TCP   3m35s
istiod                 ClusterIP      172.200.18.133   <none>          15010/TCP,15012/TCP,443/TCP,15014/TCP                                        4m46s
istiod-asm-1264-1       ClusterIP      172.200.63.220   <none>          15010/TCP,15012/TCP,443/TCP,15014/TCP                                        3m43s

    OpenShift

    En estas instrucciones, el proceso de actualización de la versión istio-1.26.4-asm.1 de Anthos Service Mesh (ASM) en clústeres vinculados de Anthos es el mismo que el de una instalación nueva.

    Prepararse para instalar Anthos Service Mesh

      Linux

    1. Asigna la restricción de contexto de seguridad (SCC) anyuid a istio-system con el siguiente comando de la CLI de OpenShift (oc): 
      oc adm policy add-scc-to-group anyuid system:serviceaccounts:istio-system
    2. Descarga el archivo de instalación de Anthos Service Mesh en tu directorio de trabajo actual: 
      curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.4-asm.1-linux-amd64.tar.gz
    3. Descarga el archivo de firma y usa openssl para verificar la firma: 
      curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.4-asm.1-linux-amd64.tar.gz.1.sig
       
      openssl dgst -verify /dev/stdin -signature istio-1.26.4-asm.1-linux-amd64.tar.gz.1.sig istio-1.26.4-asm.1.tar.gz <<'EOF'
-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ
wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==
-----END PUBLIC KEY-----
EOF
    4. Extrae el contenido del archivo a cualquier ubicación de tu sistema de archivos. Por ejemplo, para extraer el contenido al directorio de trabajo actual, haz lo siguiente: 
      tar xzf istio-1.26.4-asm.1-linux-amd64.tar.gz

      El comando crea un directorio de instalación en tu directorio de trabajo actual llamado istio-1.26.4-asm.1 que contiene lo siguiente:

      • Aplicaciones de ejemplo en el directorio samples.
      • La herramienta de línea de comandos istioctl que usas para instalar Anthos Service Mesh se encuentra en el directorio bin.
      • Los perfiles de configuración de Anthos Service Mesh se encuentran en el directorio manifests/profiles.
    5. Asegúrate de que te encuentras en el directorio raíz de la instalación de Anthos Service Mesh: 
      cd istio-1.26.4-asm.1
    6. Para mayor comodidad, añade las herramientas del directorio /bin a tu PATH: 
      export PATH=$PWD/bin:$PATH

      7. macOS

    7. Asigna la restricción de contexto de seguridad (SCC) anyuid a istio-system con el siguiente comando de la CLI de OpenShift (oc): 
      oc adm policy add-scc-to-group anyuid system:serviceaccounts:istio-system
    8. Descarga el archivo de instalación de Anthos Service Mesh en tu directorio de trabajo actual: 
      curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.4-asm.1-osx.tar.gz
    9. Descarga el archivo de firma y usa openssl para verificar la firma: 
      curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.4-asm.1-osx.tar.gz.1.sig
       
      openssl dgst -sha256 -verify /dev/stdin -signature istio-1.26.4-asm.1-osx.tar.gz.1.sig istio-1.26.4-asm.1.tar.gz <<'EOF'
-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ
wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==
-----END PUBLIC KEY-----
EOF
    10. Extrae el contenido del archivo a cualquier ubicación de tu sistema de archivos. Por ejemplo, para extraer el contenido al directorio de trabajo actual, haz lo siguiente: 
      tar xzf istio-1.26.4-asm.1-osx.tar.gz

      El comando crea un directorio de instalación en tu directorio de trabajo actual llamado istio-1.26.4-asm.1 que contiene lo siguiente:

      • Aplicaciones de ejemplo en el directorio samples.
      • La herramienta de línea de comandos istioctl que usas para instalar Anthos Service Mesh se encuentra en el directorio bin.
      • Los perfiles de configuración de Anthos Service Mesh se encuentran en el directorio manifests/profiles.
    11. Asegúrate de que te encuentras en el directorio raíz de la instalación de Anthos Service Mesh: 
      cd istio-1.26.4-asm.1
    12. Para mayor comodidad, añade las herramientas del directorio /bin a tu PATH: 
      export PATH=$PWD/bin:$PATH

      13. Windows

    13. Asigna la restricción de contexto de seguridad (SCC) anyuid a istio-system con el siguiente comando de la CLI de OpenShift (oc): 
      oc adm policy add-scc-to-group anyuid system:serviceaccounts:istio-system
    14. Descarga el archivo de instalación de Anthos Service Mesh en tu directorio de trabajo actual: 
      curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.4-asm.1-win.zip
    15. Descarga el archivo de firma y usa openssl para verificar la firma: 
      curl -LO https://storage.googleapis.com/gke-release/asm/istio-1.26.4-asm.1-win.zip.1.sig
       
      openssl dgst -verify - -signature istio-1.26.4-asm.1-win.zip.1.sig istio-1.26.4-asm.1.win.zip <<'EOF'
-----BEGIN PUBLIC KEY-----
MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEWZrGCUaJJr1H8a36sG4UUoXvlXvZ
wQfk16sxprI2gOJ2vFFggdq3ixF2h4qNBt0kI7ciDhgpwS8t+/960IsIgw==
-----END PUBLIC KEY-----
EOF
    16. Extrae el contenido del archivo a cualquier ubicación de tu sistema de archivos. Por ejemplo, para extraer el contenido al directorio de trabajo actual, haz lo siguiente: 
      tar xzf istio-1.26.4-asm.1-win.zip

      El comando crea un directorio de instalación en tu directorio de trabajo actual llamado istio-1.26.4-asm.1 que contiene lo siguiente:

      • Aplicaciones de ejemplo en el directorio samples.
      • La herramienta de línea de comandos istioctl que usas para instalar Anthos Service Mesh se encuentra en el directorio bin.
      • Los perfiles de configuración de Anthos Service Mesh se encuentran en el directorio manifests\profiles.
    17. Asegúrate de que te encuentras en el directorio raíz de la instalación de Anthos Service Mesh: 
      cd istio-1.26.4-asm.1
    18. Para mayor comodidad, añade las herramientas del directorio \bin a tu PATH: 
      set PATH=%CD%\bin:%PATH%
      19.
    19. Ahora que ASM Istio está instalado, comprueba la versión de istioctl: 
      istioctl version
    20. Crea un espacio de nombres llamado istio-system para los componentes del plano de control: 
      kubectl create namespace istio-system

    Configurar el webhook de validación

    Cuando instalas Anthos Service Mesh, asignas una etiqueta de revisión a istiod. Debes definir la misma revisión en el webhook de validación.

    1. Crea un archivo llamado istiod-service.yaml con el siguiente contenido: 
      apiVersion: v1
kind: Service
metadata:
  name: istiod
  namespace: istio-system
  labels:
    istio.io/rev: asm-1264-1
    app: istiod
    istio: pilot
    release: istio
spec:
  ports:
    - port: 15010
      name: grpc-xds # plaintext
      protocol: TCP
    - port: 15012
      name: https-dns # mTLS with k8s-signed cert
      protocol: TCP
    - port: 443
      name: https-webhook # validation and injection
      targetPort: 15017
      protocol: TCP
    - port: 15014
      name: http-monitoring # prometheus stats
      protocol: TCP
  selector:
    app: istiod
    istio.io/rev: asm-1264-1
  meshConfig:
    accessLogFormat:
      '{"start_time":"%START_TIME%","remote_address":"%DOWNSTREAM_DIRECT_REMOTE_ADDRESS%","user_agent":"%REQ(USER-AGENT)%","host":"%REQ(:AUTHORITY)%","request":"%REQ(:METHOD)% %REQ(X-ENVOY-ORIGINAL-PATH?:PATH)% %PROTOCOL%","request_time":"%DURATION%","status":"%RESPONSE_CODE%","status_details":"%RESPONSE_CODE_DETAILS%","bytes_received":"%BYTES_RECEIVED%","bytes_sent":"%BYTES_SENT%","upstream_address":"%UPSTREAM_HOST%","upstream_response_flags":"%RESPONSE_FLAGS%","upstream_response_time":"%RESPONSE_DURATION%","upstream_service_time":"%RESP(X-ENVOY-UPSTREAM-SERVICE-TIME)%","upstream_cluster":"%UPSTREAM_CLUSTER%","x_forwarded_for":"%REQ(X-FORWARDED-FOR)%","request_method":"%REQ(:METHOD)%","request_path":"%REQ(X-ENVOY-ORIGINAL-PATH?:PATH)%","request_protocol":"%PROTOCOL%","tls_protocol":"%DOWNSTREAM_TLS_VERSION%","request_id":"%REQ(X-REQUEST-ID)%","sni_host":"%REQUESTED_SERVER_NAME%","apigee_dynamic_data":"%DYNAMIC_METADATA(envoy.lua)%"}'
    2. Usa kubectl para aplicar la configuración del webhook de validación: 
      kubectl apply -f istiod-service.yaml
    3. Verifica que se ha aplicado la configuración: 
      kubectl get svc -n istio-system

      La respuesta debería ser similar a esta: 

      NAME     TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)                                 AGE
istiod   ClusterIP   172.200.18.133   <none>        15010/TCP,15012/TCP,443/TCP,15014/TCP   22s

    Instalar Anthos Service Mesh

    1. Instala Anthos Service Mesh con istioctl mediante el perfil asm-multicloud: 
      istioctl install \
    --set profile=asm-multicloud \
    --set revision=istio-1.26.4-asm.1

      La salida debería tener un aspecto similar a este: 

      kubectl get pods -n istio-system
NAME                                   READY   STATUS    RESTARTS   AGE
istio-ingressgateway-88b6fd976-flgp2   1/1     Running   0          3m13s
istio-ingressgateway-88b6fd976-p5dl9   1/1     Running   0          2m57s
istiod-asm-1264-1-798ffb964-2ls88       1/1     Running   0          3m21s
istiod-asm-1264-1-798ffb964-fnj8c       1/1     Running   1          3m21s

      El argumento --set revision añade una etiqueta de revisión con el formato istio.io/rev=1.8.6-asm.1 a istiod. El webhook del inyector automático de sidecars usa la etiqueta de revisión para asociar los sidecars inyectados con una revisión de istiod concreta. Para habilitar la inyección automática de sidecar en un espacio de nombres, debe etiquetarlo con una revisión que coincida con la etiqueta de istiod.

    2. Comprueba que la instalación se ha completado: 
      kubectl get svc -n istio-system

      La salida debería tener un aspecto similar a este: 

      NAME                   TYPE           CLUSTER-IP       EXTERNAL-IP     PORT(S)                                                                      AGE
istio-ingressgateway   LoadBalancer   172.200.48.52    34.74.177.168   15021:30479/TCP,80:30030/TCP,443:32200/TCP,15012:32297/TCP,15443:30244/TCP   3m35s
istiod                 ClusterIP      172.200.18.133   <none>          15010/TCP,15012/TCP,443/TCP,15014/TCP                                        4m46s
istiod-asm-1264-1       ClusterIP      172.200.63.220   <none>          15010/TCP,15012/TCP,443/TCP,15014/TCP                                        3m43s

    Instalar el entorno de ejecución híbrido 1.5.10

    1. Descarga el paquete de lanzamiento para tu sistema operativo:

      Mac de 64 bits:

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

      Linux de 64 bits:

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

      Mac de 32 bits:

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

      Linux de 32 bits:

      curl -LO \
    https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.5.10/apigeectl_linux_32.tar.gz
    2. Cambia el nombre del directorio apigeectl/ actual por el de un directorio de copia de seguridad. Por ejemplo: 
      mv $APIGEECTL_HOME/ $APIGEECTL_HOME-v1.2/

    3. Extrae el contenido del archivo gzip descargado en el directorio base híbrido. Por ejemplo: 

      tar xvzf FILENAME.tar.gz -C HYBRID_BASE_DIRECTORY
    4. cd al directorio base.

    5. De forma predeterminada, el contenido de tar se expande en un directorio con la versión y la plataforma en su nombre. Por ejemplo: ./apigeectl_1.5.0-d591b23_linux_64. Cambia el nombre de ese directorio a apigeectl:

      mv apigeectl_1.5.0-d591b23_linux_64 apigeectl
    6. En el directorio new apigeectl/, ejecuta apigeectl init, apigeectl apply y apigeectl check-ready:
      1. Inicializar la versión híbrida 1.5.10: 
        apigeectl init -f OVERRIDES.yaml

        Donde OVERRIDES.yaml es el archivo overrides.yaml editado.

      2. Comprueba que se ha inicializado correctamente con los siguientes comandos: 
        apigeectl check-ready -f OVERRIDES.yaml
         
        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
      3. La sintaxis de la marca apigeectl --dry-run depende de la versión de kubectl que estés usando. Comprueba la versión de kubectl: 
        gcloud version
      4. Comprueba si hay errores con una prueba de funcionamiento con el comando adecuado para tu versión de kubectl:

        kubectl versión 1.17 y anteriores: 

        apigeectl apply -f OVERRIDES.yaml --dry-run=true

        kubectl versión 1.18 y posteriores: 

        apigeectl apply -f OVERRIDES.yaml --dry-run=client
      5. Aplica las anulaciones. Selecciona las instrucciones para entornos de producción o de demostración/experimentales, según tu instalación, y síguelas.

        Producción

        En los entornos de producción, debes actualizar cada componente híbrido por separado y comprobar el estado del componente actualizado antes de pasar al siguiente.

        1. Aplica las anulaciones para actualizar Cassandra: 
          apigeectl apply -f OVERRIDES.yaml --datastore
        2. Comprobación completada: 
          apigeectl check-ready -f OVERRIDES.yaml

          Continúa con el siguiente paso solo cuando los pods estén listos.

        3. Aplica las anulaciones para actualizar los componentes de Telemetría y comprueba que se han completado: 
          apigeectl apply -f OVERRIDES.yaml --telemetry
           
          apigeectl check-ready -f OVERRIDES.yaml
        4. Inicia los componentes de Redis: 
          apigeectl apply -f OVERRIDES.yaml --redis
        5. Aplica las anulaciones para actualizar los componentes a nivel de organización (MART, Watcher y Apigee Connect) y comprueba si se han completado: 
          apigeectl apply -f OVERRIDES.yaml --org
           
          apigeectl check-ready -f OVERRIDES.yaml
        6. 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 apply -f OVERRIDES.yaml --env ENV_NAME
             
            apigeectl check-ready -f OVERRIDES.yaml

            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 apply -f OVERRIDES.yaml --all-envs
             
            apigeectl check-ready -f OVERRIDES.yaml

        Demo o experimental

        En la mayoría de los entornos de demostración o experimentales, puedes aplicar las anulaciones a todos los componentes a la vez. Si tu entorno de demostración o experimental es grande y complejo, o bien se parece mucho a un entorno de producción, te recomendamos que sigas las instrucciones para actualizar entornos de producción. 

        1. apigeectl apply -f OVERRIDES.yaml
        2. Comprueba el estado: 
          apigeectl check-ready -f OVERRIDES.yaml

    Restaurar una versión anterior de una actualización

    Sigue estos pasos para revertir una actualización anterior:

    1. 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}')
    2. 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}')
    3. 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
    4. En el directorio raíz de la instalación a la que quieras volver, ejecuta apigeectl apply, comprueba el estado de tus pods, elimina el componente Redis (novedad de la versión híbrida 1.5.0) 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:
      • Ejecuta apigeectl apply: 
        $APIGEECTL_HOME/apigeectl apply -f overrides/ORIGINAL_OVERRIDES.yaml
      • Verifica el estado de tus pods: 
        kubectl -n NAMESPACE get pods

        Donde NAMESPACE es el espacio de nombres de Apigee hybrid.

        Continúa con el siguiente paso solo cuando el apigeedspod esté en ejecución.

      • Como Redis es un componente nuevo en la versión 1.5 híbrida, ejecuta el siguiente comando para eliminarlo:

        apigeectl_1.5.0 delete --redis -f ORIGINAL_OVERRIDES.yaml
      • Ejecuta apigeectl init: 
        $APIGEECTL_HOME/apigeectl init -f overrides/ORIGINAL_OVERRIDES.yaml