Paso 1: Crea un clúster

Estás viendo la versión 1.9 de la documentación de Apigee Hybrid. Para obtener más información, consulta las versiones compatibles.

Version 1.9 (unsupported)

   Supported versions:

• v1.12 (latest)                        
• v1.11                         
• v1.10                                        
• List of supported versions

   Unsupported versions:

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

Actualización: Si estás actualizando a la versión 1.9.4, consulta Actualiza Apigee Hybrid para obtener instrucciones. Si realizas una instalación nueva, continúa con las opciones de configuración que se describen a continuación.

En este paso, se explica cómo crear el clúster en el que ejecutarás Apigee Hybrid. Las instrucciones varían según la plataforma en la que ejecutas Apigee Hybrid.

Clústeres dedicados versus clústeres compartidos

Puedes crear un clúster nuevo y dedicado para Apigee Hybrid, como se explica en este paso, o puedes instalarlo en un clúster que ejecute otras cargas de trabajo.

• Clúster dedicado: (recomendado) Crear un clúster dedicado para Apigee Hybrid agrega aislamiento y simplifica el esfuerzo general necesario para mantener el clúster y sus cargas de trabajo de Apigee Hybrid.
• Clúster compartido: (Poco común) Si instalas Apigee Hybrid en un clúster que ejecuta otras cargas de trabajo, debes actualizar y conservar tu clúster con las versiones y características necesarias en común para Apigee Hybrid y para las otras cargas de trabajo. Te recomendamos desarrollar un plan para migrar una o más cargas de trabajo en caso de que surjan conflictos entre versiones y requisitos compatibles.

Se recomienda usar un clúster dedicado. La configuración del clúster compartido es un caso de uso avanzado y no se analiza con más detalle en los pasos de instalación.

Cree su clúster

Sigue los pasos para tu plataforma seleccionada:

GKE

Crea un clúster en GKE

En estos pasos, se explica cómo configurar y crear un clúster de GKE en tu proyecto de Google Cloud.

Precaución: Apigee no admite GKE Sandbox ni gVisor para instalaciones híbridas en GKE.

Apigee recomienda crear un clúster regional en lugar de un clúster zonal. Si no estás familiarizado con la distinción entre regiones y zonas, consulta Regiones y zonas. Las regiones disponibles se enumeran en Regiones y zonas disponibles. Solo ten en cuenta que, por ejemplo, us-west1 es un nombre de región válido, mientras que us-west1-a es una zona de la región.

1. Asegúrate de usar una versión de GKE compatible con la versión híbrida 1.9.4. Consulta Plataformas y versiones compatibles con Apigee Hybrid.
2. Asegúrate de que los relojes de todos los nodos y los servidores de aplicaciones estén sincronizados con el protocolo NTP, como se explica en los Requisitos previos. La base de datos de Cassandra se basa en la sincronización del protocolo NTP para mantener la coherencia de los datos. Si planeas instalar entornos híbridos en varias regiones, asegúrate de que estén sincronizados con NTP en todas las regiones.
3. (Solo clústeres privados de GKE): Si creas un clúster privado, agrega una regla de firewall para permitir el puerto 9443 a fin de que se comunique entre los nodos principales de GKE y los nodos trabajadores de GKE, y permitir que las instancias principales de GKE accedan a los webhooks de mutación de Apigee. Sigue el procedimiento que aparece en Agrega reglas de firewall para casos de uso específicos en la documentación de Google Kubernetes Engine. Para obtener más información, consulta Clústeres privados en GKE.

   No es necesario que agregues esta regla si creas un clúster público o estándar.

4. Para crear el clúster, sigue las instrucciones en Cómo crear un clúster regional con un grupo de nodos multizonal. Se puede crear el clúster solo con el grupo de nodos predeterminado. Configurarás y crearás los grupos de nodos de Apigee Hybrid necesarios en el siguiente paso.
   Sugerencia: Si no creas el clúster en la red predeterminada, sigue las instrucciones que se indican en Crea un clúster en una subred existente

   Ve al siguiente paso solo después de que la creación del clúster se complete de forma correcta.

5. Crea dos grupos de nodos mediante las instrucciones que se indican en Cómo agregar y administrar grupos de nodos. Asegúrate de configurar los grupos de nodos con los requisitos mínimos que se enumeran en la siguiente tabla.

   Qué necesitas saber sobre los grupos de nodos

   Nota: Te recomendamos usar los nombres apigee-data y apigee-runtime para los grupos de nodos. Apigee Hybrid reconoce estos nombres de forma predeterminada. Si no deseas usar los nombres predeterminados, se requiere una configuración adicional más adelante cuando configures el clúster para Apigee Hybrid. Para obtener más información, incluidas las instrucciones para cambiar los nombres de los grupos de nodos predeterminados mediante la edición de tu archivo de configuración del clúster, consulta Usa los nodeSelectors predeterminados.

   Te recomendamos que revises la siguiente información sobre los grupos de nodos y la configuración de grupos de nodos antes de continuar:

   • Acerca de los grupos de nodos
   • Requisitos de red de Cassandra

   Requisitos mínimos del grupo de nodos

   Asegúrate de cumplir con estos requisitos mínimos cuando crees los grupos de nodos. Si usas la consola de Cloud, asegúrate de configurar las secciones Detalles del grupo de nodos y Nodos.

   Nota: Los valores de configuración del grupo de nodos que se describen en la siguiente tabla representan los valores mínimos. Esta configuración mínima es adecuada para las pruebas. Sin embargo, según tus necesidades, puedes aumentar el tamaño de los nodos ahora o en el futuro. Si quieres obtener información para administrar los nodos del clúster, consulta Cómo agregar y administrar grupos de nodos.

   Nombre del grupo de nodos	Descripción	Cantidad mínima de nodos	Tipo de máquina mínimo
   apigee-data	Un grupo de nodos con estado que se usa para la base de datos de Cassandra.	1 por zona (3 por región)	e2-standard-4 (4 CPU virtuales, 16 GB de memoria)
   apigee-runtime	Un grupo de nodos sin estado que usa el procesador de mensajes del entorno de ejecución.	1 por zona (3 por región)	e2-standard-4 (4 CPU virtuales, 16 GB de memoria)

   Para obtener más detalles sobre la configuración del grupo de nodos, consulta Configura grupos de nodos dedicados.

6. Si quieres, puedes borrar el grupo de nodos default. Consulta Cómo borrar un grupo de nodos.
7. Asegúrate de que tu clúster esté configurado como el predeterminado para kubectl. Consulta Configura un clúster predeterminado para los comandos de kubectl.

8. Configura el almacenamiento en el disco de estado sólido persistente (SSD) para Cassandra. No admitimos el uso de SSD locales. Para obtener más información, consulta Cambia la clase de almacenamiento predeterminada en la documentación de Kubernetes.

   1. Obtén el nombre de la StorageClass predeterminada actual:

      kubectl get sc

      Por ejemplo:

      kubectl get sc
        NAME                    PROVISIONER             RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
        premium-rwo             pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h
        standard                kubernetes.io/gce-pd    Delete          Immediate              true                   15h
        standard-rwo (default)  pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h
      

   2. Describe la StorageClass llamada standard-rwo. Ten en cuenta que su tipo es pd-balanced:

      kubectl describe sc standard-rwo

      Por ejemplo:

      kubectl describe sc standard-rwo

      Name:                  standard-rwo
        IsDefaultClass:        Yes
        Annotations:           components.gke.io/layer=addon,storageclass.kubernetes.io/is-default-class=false
        Provisioner:           pd.csi.storage.gke.io
        Parameters:            type=pd-balanced
        AllowVolumeExpansion:  True
        MountOptions:          <none>
        ReclaimPolicy:         Delete
        VolumeBindingMode:     WaitForFirstConsumer
        Events:                <none>

   3. Crea un archivo nuevo llamado storageclass.yaml de la siguiente manera:
   4. Agrega este código al archivo. Ten en cuenta que el nombre de la clase nueva es apigee-sc. Puedes usar cualquier nombre que desees. Además, ten en cuenta que el tipo de almacenamiento es pd-ssd:

      ---
      kind: StorageClass
      apiVersion: storage.k8s.io/v1
      metadata:
        name: "apigee-sc"
      provisioner: kubernetes.io/gce-pd
      parameters:
        type: pd-ssd
        replication-type: none
      volumeBindingMode: WaitForFirstConsumer
      allowVolumeExpansion: true
      

   5. Aplica la StorageClass nueva a tu clúster de Kubernetes:

      kubectl apply -f storageclass.yaml

   6. Ejecuta los dos comandos siguientes para cambiar la StorageClass predeterminada:

      kubectl patch storageclass standard-rwo \
      -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"false"}}}'

      kubectl patch storageclass apigee-sc \
      -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'

   7. Ejecuta este comando para verificar que la StorageClass predeterminada nueva se llame apigee-sc:

      kubectl get sc

      Por ejemplo:

      kubectl get sc
        NAME                  PROVISIONER             RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
        apigee-sc (default)   kubernetes.io/gce-pd    Delete          WaitForFirstConsumer   true                   14h
        premium-rwo           pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h
        standard              kubernetes.io/gce-pd    Delete          Immediate              true                   15h
        standard-rwo          pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h
      

9. Crea las siguientes variables de entorno: Estas variables se usan en los siguientes comandos de gcloud.

   Linux/MacOS

   export CLUSTER_NAME="YOUR_CLUSTER_NAME"
   export CLUSTER_LOCATION="YOUR_CLUSTER_LOCATION"

   Windows

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

   Aquí:

   • CLUSTER_NAME: El nombre de tu clúster.
   • CLUSTER_LOCATION: Es la región en la que creaste el clúster.
10. Verifica la configuración del grupo de nodos:

    Clústeres regionales

    gcloud container node-pools list \
      --cluster=${CLUSTER_NAME} \
      --region=${CLUSTER_LOCATION} \
      --project=${PROJECT_ID}

    Clústeres zonales

    gcloud container node-pools list \
      --cluster=${CLUSTER_NAME} \
      --zone=${CLUSTER_LOCATION} \
      --project=${PROJECT_ID}

11. Habilita Workload Identity en el clúster. Esta operación puede tardar hasta 30 minutos:

    Clústeres regionales

    gcloud container clusters update ${CLUSTER_NAME} \
      --workload-pool=${PROJECT_ID}.svc.id.goog \
      --project ${PROJECT_ID} \
      --region ${CLUSTER_LOCATION}

    Clústeres zonales

    gcloud container clusters update ${CLUSTER_NAME} \
      --workload-pool=${PROJECT_ID}.svc.id.goog \
      --zone ${CLUSTER_LOCATION} \
      --project ${PROJECT_ID}

    Para obtener más información, consulta Habilita Workload Identity.

12. Obtén las credenciales gcloud del clúster que acabas de crear con el siguiente comando:

    Clústeres regionales

    gcloud container clusters get-credentials ${CLUSTER_NAME} \
      --region ${CLUSTER_LOCATION} \
      --project ${PROJECT_ID}

    Clústeres zonales

    gcloud container clusters get-credentials ${CLUSTER_NAME} \
      --zone ${CLUSTER_LOCATION} \
      --project ${PROJECT_ID}

13. Para las instalaciones en GKE, Apigee ofrece la capacidad de usar Workload Identity para conectarse con los servicios de Google Cloud sin usar cuentas de servicio de Google con certificados almacenados de forma local. Puedes obtener más información sobre Workload Identity en Habilita Workload Identity con Apigee Hybrid.

    Opcional: Habilita Workload Identity para cada grupo de nodos con los siguientes comandos. Esta operación puede tomar hasta 30 minutos por grupo de nodos.

    Clústeres regionales

    gcloud container node-pools update apigee-data \
      --cluster=$CLUSTER_NAME \
      --region $CLUSTER_LOCATION \
      --project $PROJECT_ID \
      --workload-metadata=GKE_METADATA

    gcloud container node-pools update apigee-runtime \
      --cluster=$CLUSTER_NAME \
      --region $CLUSTER_LOCATION \
      --project $PROJECT_ID \
      --workload-metadata=GKE_METADATA

    Clústeres zonales

    gcloud container node-pools update apigee-data \
      --cluster=$CLUSTER_NAME \
      --zone $CLUSTER_LOCATION \
      --project $PROJECT_ID \
      --workload-metadata=GKE_METADATA

    gcloud container node-pools update apigee-runtime \
      --cluster=$CLUSTER_NAME \
      --zone $CLUSTER_LOCATION \
      --project $PROJECT_ID \
      --workload-metadata=GKE_METADATA

Cuando tengas un clúster instalado y en ejecución, ve al siguiente paso.

GKE On‑Prem

Crea un clúster en GKE On-Prem

En estos pasos, se explica cómo configurar y crear un clúster de GKE On-Prem para Apigee Hybrid.

1. Asegúrate de usar una versión de VMVMare local de Anthos que sea compatible con la versión híbrida 1.9.4. Consulta Plataformas y versiones compatibles con Apigee Hybrid.
2. Asegúrate de que los relojes de todos los nodos y los servidores de aplicaciones estén sincronizados con el protocolo NTP, como se explica en los Requisitos previos. La base de datos de Cassandra se basa en la sincronización del protocolo NTP para mantener la coherencia de los datos. Si planeas instalar entornos híbridos en varias regiones, asegúrate de que estén sincronizadas con NTP en todas las regiones.
3. Para crear el clúster, sigue las instrucciones en Cómo crear clústeres básicos. Se puede crear el clúster solo con el grupo de nodos predeterminado. Configurarás y crearás los grupos de nodos de Apigee Hybrid necesarios en el siguiente paso.

   Ve al siguiente paso solo después de que la creación del clúster se complete de forma correcta.

4. Crea dos grupos de nodos mediante las instrucciones que se indican en Crea y administra grupos de nodos. Configura los grupos de nodos con los requisitos mínimos que se enumeran en la siguiente tabla.

   Qué necesitas saber sobre los grupos de nodos

   Nota: Te recomendamos usar los nombres apigee-data y apigee-runtime para los grupos de nodos. Apigee Hybrid reconoce estos nombres de forma predeterminada. Si no deseas usar los nombres predeterminados, se requiere una configuración adicional más adelante cuando configures el clúster para Apigee Hybrid. Para obtener más información, incluidas las instrucciones para cambiar los nombres de los grupos de nodos predeterminados mediante la edición de tu archivo de configuración del clúster, consulta Usa los nodeSelectors predeterminados.

   Te recomendamos que revises la siguiente información sobre los grupos de nodos y la configuración de grupos de nodos antes de continuar:

   • Acerca de los grupos de nodos
   • Requisitos de red de Cassandra

   Requisitos mínimos del grupo de nodos

   Asegúrate de cumplir con estos requisitos mínimos cuando crees los grupos de nodos.

   Nota: Los valores de configuración del grupo de nodos que se describen en la siguiente tabla representan los valores mínimos. Esta configuración mínima es adecuada para las pruebas. Sin embargo, según tus necesidades, puedes aumentar el tamaño de los nodos ahora o en el futuro. Si quieres obtener información para administrar los nodos del clúster, consulta Cómo agregar y administrar grupos de nodos.

   Nombre del grupo de nodos	Descripción	Cantidad mínima de nodos	Tipo de máquina mínimo
   apigee-data	Un grupo de nodos con estado que se usa para la base de datos de Cassandra.	1 por zona (3 por región)	e2-standard-4 (4 CPU virtuales, 16 GB de memoria)
   apigee-runtime	Un grupo de nodos sin estado que usa el procesador de mensajes del entorno de ejecución.	1 por zona (3 por región)	e2-standard-4 (4 CPU virtuales, 16 GB de memoria)

   Para obtener más detalles sobre la configuración del grupo de nodos, consulta Configura grupos de nodos dedicados.

5. Si quieres, puedes borrar el grupo de nodos default. Consulta Cómo borrar un grupo de nodos.

6. Configura el almacenamiento en el disco de estado sólido persistente (SSD) para Cassandra. No admitimos el uso de SSD locales. Para obtener más información, consulta Cambia la clase de almacenamiento predeterminada en la documentación de Kubernetes.

   1. Obtén el nombre de la StorageClass predeterminada actual:

      kubectl get sc

      Por ejemplo:

      kubectl get sc
        NAME                    PROVISIONER             RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
        premium-rwo             pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h
        standard                kubernetes.io/gce-pd    Delete          Immediate              true                   15h
        standard-rwo (default)  pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h
      

   2. Describe la StorageClass llamada standard-rwo. Ten en cuenta que su tipo es pd-balanced:

      kubectl describe sc standard-rwo

      Por ejemplo:

      kubectl describe sc standard-rwo

      Name:                  standard-rwo
      IsDefaultClass:        Yes
      Annotations:           components.gke.io/layer=addon,storageclass.kubernetes.io/is-default-class=false
      Provisioner:           pd.csi.storage.gke.io
      Parameters:            type=pd-balanced
      AllowVolumeExpansion:  True
      MountOptions:          <none>
      ReclaimPolicy:         Delete
      VolumeBindingMode:     WaitForFirstConsumer
      Events:                <none>

   3. Crea un archivo nuevo llamado storageclass.yaml de la siguiente manera:
   4. Agrega este código al archivo. Ten en cuenta que el nombre de la clase nueva es apigee-sc. Puedes usar cualquier nombre que desees. Además, ten en cuenta que el tipo de almacenamiento es pd-ssd:

      ---
      kind: StorageClass
      apiVersion: storage.k8s.io/v1
      metadata:
        name: "apigee-sc"
      provisioner: kubernetes.io/gce-pd
      parameters:
        type: pd-ssd
        replication-type: none
      volumeBindingMode: WaitForFirstConsumer
      allowVolumeExpansion: true
      

   5. Aplica la StorageClass nueva a tu clúster de Kubernetes:

      kubectl apply -f storageclass.yaml

   6. Ejecuta los dos comandos siguientes para cambiar la StorageClass predeterminada:

      kubectl patch storageclass standard-rwo \
        -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"false"}}}'

      kubectl patch storageclass apigee-sc \
        -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'

   7. Ejecuta este comando para verificar que la StorageClass predeterminada nueva se llame apigee-sc:

      kubectl get sc

      Por ejemplo:

      kubectl get sc
        NAME                  PROVISIONER             RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
        apigee-sc (default)   kubernetes.io/gce-pd    Delete          WaitForFirstConsumer   true                   14h
        premium-rwo           pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h
        standard              kubernetes.io/gce-pd    Delete          Immediate              true                   15h
        standard-rwo          pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h
      

Cuando tengas un clúster instalado y en ejecución, ve al siguiente paso.

Anthos en Bare Metal

Crea un clúster en Anthos alojado en Bare Metal

En estos pasos, se explica cómo configurar y crear un clúster para Apigee Hybrid en Anthos alojado en Bare Metal. Anthos alojado en Bare Metal te permite ejecutar clústeres de Kubernetes directamente en tus propios recursos de máquina.

1. Asegúrate de usar una versión de Anthos alojado en Bare Metal que sea compatible con la versión híbrida 1.9.4. Consulta Plataformas y versiones compatibles con Apigee Hybrid.
2. Asegúrate de que los relojes de todos los nodos y los servidores de aplicaciones estén sincronizados con el protocolo NTP, como se explica en los Requisitos previos. La base de datos de Cassandra se basa en la sincronización del protocolo NTP para mantener la coherencia de los datos. Si planeas instalar entornos híbridos en varias regiones, asegúrate de que estén sincronizadas con NTP en todas las regiones.
3. Revisa la descripción general de los requisitos previos de instalación y Crea clústeres: descripción general.
4. Crea el clúster con dos grupos de nodos configurados como se describe a continuación:
   • Sigue las instrucciones de creación de clústeres en la Guía de inicio rápido para clústeres de Anthos alojados en Bare Metal.
   • Crea un mínimo de dos grupos de nodos. Configura los grupos de nodos con los requisitos mínimos que se enumeran en la siguiente tabla.

     Qué necesitas saber sobre los grupos de nodos

     Nota: Te recomendamos usar los nombres apigee-data y apigee-runtime para los grupos de nodos. Apigee Hybrid reconoce estos nombres de forma predeterminada. Si no deseas usar los nombres predeterminados, se requiere una configuración adicional más adelante cuando configures el clúster para Apigee Hybrid. Para obtener más información, incluidas las instrucciones para cambiar los nombres de los grupos de nodos predeterminados mediante la edición de tu archivo de configuración del clúster, consulta Usa los nodeSelectors predeterminados.

     Te recomendamos que revises la siguiente información sobre los grupos de nodos y la configuración de grupos de nodos antes de continuar:

     • Configura grupos de nodos dedicados
     • Acerca de los grupos de nodos
     • Requisitos de red de Cassandra

     Los parámetros de configuración mínimos para tu clúster son los siguientes:

     Nota: Los valores de configuración del grupo de nodos que se describen en la siguiente tabla representan los valores mínimos. Esta configuración mínima es adecuada para las pruebas. Sin embargo, según tus necesidades, puedes aumentar el tamaño de los nodos ahora o en el futuro.

     Configuración	Grupo de nodos con estado	Grupo de nodos sin estado
     Purpose	Un grupo de nodos con estado que se usa para la base de datos de Cassandra.	Un grupo de nodos sin estado que usa el procesador de mensajes del entorno de ejecución.
     Nombre de la etiqueta	apigee-data	apigee-runtime
     Cantidad de nodos	1 por zona (3 por región)	1 por zona (3 por región)
     CPU	4	4
     RAM	15	15
     Almacenamiento	dynamic	Administrado con la CRD de ApigeeDeployment
     IOPS mínimas del disco	2,000 IOPS con SAN o almacenamiento conectado de forma directa. No se recomienda NFS, incluso si es compatible con las IOPS necesarias.	2,000 IOPS con SAN o almacenamiento conectado de forma directa. No se recomienda NFS, incluso si es compatible con las IOPS necesarias.

     Para obtener más detalles sobre la configuración mínima de los clústeres, consulta Opciones de configuración mínima de los clústeres.

Cuando tengas un clúster instalado y en ejecución, ve al siguiente paso.

AKS

Crea un clúster en AKS

En estos pasos, se explica cómo configurar y crear un clúster para Apigee Hybrid en AKS.

1. Asegúrate de usar una versión de AKS compatible con la versión híbrida 1.9.4. Consulta Plataformas y versiones compatibles con Apigee Hybrid.
2. Asegúrate de que los relojes de todos los nodos y los servidores de aplicaciones estén sincronizados con el protocolo NTP, como se explica en los Requisitos previos. La base de datos de Cassandra se basa en la sincronización del protocolo NTP para mantener la coherencia de los datos. Si planeas instalar entornos híbridos en varias regiones, asegúrate de que estén sincronizadas con NTP en todas las regiones.
3. Crea el clúster con la CLI de Azure o el Portal de Azure y crea dos grupos de nodos como se describe a continuación.

   Qué necesitas saber sobre los grupos de nodos

   Nota: Te recomendamos usar los nombres apigee-data y apigee-runtime para los grupos de nodos. Apigee Hybrid reconoce estos nombres de forma predeterminada. Si no deseas usar los nombres predeterminados, se requiere una configuración adicional más adelante cuando configures el clúster para Apigee Hybrid. Para obtener más información, incluidas las instrucciones para cambiar los nombres de los grupos de nodos predeterminados mediante la edición de tu archivo de configuración del clúster, consulta Usa los nodeSelectors predeterminados.

   Te recomendamos que revises la siguiente información sobre los grupos de nodos y la configuración de grupos de nodos antes de continuar:

   • Configura grupos de nodos dedicados
   • Acerca de los grupos de nodos
   • Requisitos de red de Cassandra

   Los parámetros de configuración mínimos para tu clúster son los siguientes:

   Nota: Los valores de configuración del grupo de nodos que se describen en la siguiente tabla representan los valores mínimos. Esta configuración mínima es adecuada para las pruebas. Sin embargo, según tus necesidades, puedes aumentar el tamaño de los nodos ahora o en el futuro. Si quieres obtener información para administrar los nodos del clúster, consulta Cómo agregar y administrar grupos de nodos.

   Configuración	Grupo de nodos con estado	Grupo de nodos sin estado
   Purpose	Un grupo de nodos con estado que se usa para la base de datos de Cassandra.	Un grupo de nodos sin estado que usa el procesador de mensajes del entorno de ejecución.
   Nombre de la etiqueta	apigee-data	apigee-runtime
   Cantidad de nodos	1 por zona (3 por región)	1 por zona (3 por región)
   CPU	4	4
   RAM	15	15
   Almacenamiento	dynamic	Administrado con la CRD de ApigeeDeployment
   IOPS mínimas del disco	2,000 IOPS con SAN o almacenamiento conectado de forma directa. No se recomienda NFS, incluso si es compatible con las IOPS necesarias.	2,000 IOPS con SAN o almacenamiento conectado de forma directa. No se recomienda NFS, incluso si es compatible con las IOPS necesarias.

   Para obtener más detalles sobre la configuración mínima de los clústeres, consulta Opciones de configuración mínima de los clústeres.

Cuando tengas un clúster instalado y en ejecución, ve al siguiente paso.

EKS

Crea un clúster en EKS

En estos pasos, se explica cómo configurar y crear un clúster para Apigee Hybrid en EKS.

1. Asegúrate de usar una versión de EKS compatible con la versión híbrida 1.9.4. Consulta Plataformas y versiones compatibles con Apigee Hybrid.
2. Asegúrate de que los relojes de todos los nodos y los servidores de aplicaciones estén sincronizados con el protocolo NTP, como se explica en los Requisitos previos. La base de datos de Cassandra se basa en la sincronización del protocolo NTP para mantener la coherencia de los datos. Si planeas instalar entornos híbridos en varias regiones, asegúrate de que estén sincronizadas con NTP en todas las regiones.
3. Si usas la versión 1.24 de Kubernetes o una más reciente, asegúrate de haber instalado el controlador CSI de Kubernetes para Amazon EBS.
4. Usa las siguientes instrucciones para crear un clúster de usuario y dos grupos de nodos como se describe a continuación.
   • Documentación general de EKS
   • Crea un clúster de Amazon EKS

   Qué necesitas saber sobre los grupos de nodos

   Nota: Te recomendamos usar los nombres apigee-data y apigee-runtime para los grupos de nodos. Apigee Hybrid reconoce estos nombres de forma predeterminada. Si no deseas usar los nombres predeterminados, se requiere una configuración adicional más adelante cuando configures el clúster para Apigee Hybrid. Para obtener más información, incluidas las instrucciones para cambiar los nombres de los grupos de nodos predeterminados mediante la edición de tu archivo de configuración del clúster, consulta Usa los nodeSelectors predeterminados.

   Te recomendamos que revises la siguiente información sobre los grupos de nodos y la configuración de grupos de nodos antes de continuar:

   • Configura grupos de nodos dedicados
   • Acerca de los grupos de nodos
   • Requisitos de red de Cassandra

   Los parámetros de configuración mínimos para tu clúster son los siguientes:

   Nota: Los valores de configuración del grupo de nodos que se describen en la siguiente tabla representan los valores mínimos. Esta configuración mínima es adecuada para las pruebas. Sin embargo, según tus necesidades, puedes aumentar el tamaño de los nodos ahora o en el futuro. Si quieres obtener información para administrar los nodos del clúster, consulta Cómo agregar y administrar grupos de nodos.

   Configuración	Grupo de nodos con estado	Grupo de nodos sin estado
   Purpose	Un grupo de nodos con estado que se usa para la base de datos de Cassandra.	Un grupo de nodos sin estado que usa el procesador de mensajes del entorno de ejecución.
   Nombre de la etiqueta	apigee-data	apigee-runtime
   Cantidad de nodos	1 por zona (3 por región)	1 por zona (3 por región)
   CPU	4	4
   RAM	15	15
   Almacenamiento	dynamic	Administrado con la CRD de ApigeeDeployment
   IOPS mínimas del disco	2,000 IOPS con SAN o almacenamiento conectado de forma directa. No se recomienda NFS, incluso si es compatible con las IOPS necesarias.	2,000 IOPS con SAN o almacenamiento conectado de forma directa. No se recomienda NFS, incluso si es compatible con las IOPS necesarias.

   Para obtener más detalles sobre la configuración mínima de los clústeres, consulta Opciones de configuración mínima de los clústeres.

Cuando tengas un clúster instalado y en ejecución, ve al siguiente paso.

GKE en AWS

Crea un clúster en GKE en AWS

En estos pasos, se explica cómo configurar y crear un clúster para Apigee Hybrid en GKE en AWS.

1. Asegúrate de usar una versión de GKE compatible con la versión híbrida 1.9.4. Consulta Plataformas y versiones compatibles con Apigee Hybrid.
2. Asegúrate de que los relojes de todos los nodos y los servidores de aplicaciones estén sincronizados con el protocolo NTP, como se explica en los Requisitos previos. La base de datos de Cassandra se basa en la sincronización del protocolo NTP para mantener la coherencia de los datos. Si planeas instalar entornos híbridos en varias regiones, asegúrate de que estén sincronizadas con NTP en todas las regiones.
3. Usa las siguientes instrucciones para crear un clúster de usuario y dos grupos de nodos como se describe a continuación.
   • Documentación de la descripción general de GKE on AWS
   • Descripción general de la instalación de clústeres de Anthos en AWS

   Qué necesitas saber sobre los grupos de nodos

   Nota: Te recomendamos usar los nombres apigee-data y apigee-runtime para los grupos de nodos. Apigee Hybrid reconoce estos nombres de forma predeterminada. Si no deseas usar los nombres predeterminados, se requiere una configuración adicional más adelante cuando configures el clúster para Apigee Hybrid. Para obtener más información, incluidas las instrucciones para cambiar los nombres de los grupos de nodos predeterminados mediante la edición de tu archivo de configuración del clúster, consulta Usa los nodeSelectors predeterminados.

   Te recomendamos que revises la siguiente información sobre los grupos de nodos y la configuración de grupos de nodos antes de continuar:

   • Configura grupos de nodos dedicados
   • Acerca de los grupos de nodos
   • Requisitos de red de Cassandra

   Los parámetros de configuración mínimos para tu clúster son los siguientes:

   Nota: Los valores de configuración del grupo de nodos que se describen en la siguiente tabla representan los valores mínimos. Esta configuración mínima es adecuada para las pruebas. Sin embargo, según tus necesidades, puedes aumentar el tamaño de los nodos ahora o en el futuro. Si quieres obtener información para administrar los nodos del clúster, consulta Cómo agregar y administrar grupos de nodos.

   Configuración	Grupo de nodos con estado	Grupo de nodos sin estado
   Purpose	Un grupo de nodos con estado que se usa para la base de datos de Cassandra.	Un grupo de nodos sin estado que usa el procesador de mensajes del entorno de ejecución.
   Nombre de la etiqueta	apigee-data	apigee-runtime
   Cantidad de nodos	1 por zona (3 por región)	1 por zona (3 por región)
   CPU	4	4
   RAM	15	15
   Almacenamiento	dynamic	Administrado con la CRD de ApigeeDeployment
   IOPS mínimas del disco	2,000 IOPS con SAN o almacenamiento conectado de forma directa. No se recomienda NFS, incluso si es compatible con las IOPS necesarias.	2,000 IOPS con SAN o almacenamiento conectado de forma directa. No se recomienda NFS, incluso si es compatible con las IOPS necesarias.

   Para obtener más detalles sobre la configuración mínima de los clústeres, consulta Opciones de configuración mínima de los clústeres.

Cuando tengas un clúster instalado y en ejecución, ve al siguiente paso.

OpenShift

Crea un clúster en OpenShift

En estos pasos, se explica cómo configurar y crear un clúster para Apigee Hybrid en OpenShift.

1. Asegúrate de usar una versión de OpenShift compatible con la versión híbrida 1.9.4. Consulta Plataformas y versiones compatibles con Apigee Hybrid.
2. Asegúrate de que los relojes de todos los nodos y los servidores de aplicaciones estén sincronizados con el protocolo NTP, como se explica en los Requisitos previos. La base de datos de Cassandra se basa en la sincronización del protocolo NTP para mantener la coherencia de los datos. Si planeas instalar entornos híbridos en varias regiones, asegúrate de que estén sincronizadas con NTP en todas las regiones.
3. Compila el clúster de OpenShift para implementar en el plano del entorno de ejecución, instala Apigee en tu clúster de usuario de OpenShift y crea dos grupos de nodos.
   Puedes encontrar información adicional sobre la creación y la administración de clústeres de OpenShift en Google Cloud en la documentación de OpenShift, por ejemplo: Instala un clúster en Google Cloud con rapidez.
   Para obtener ayuda sobre cómo configurar tu clúster de OpenShift en las VMs de Google Cloud, consulta Cómo configurar Apigee Hybrid en OpenShift en VMs de GCP.

   Como parte de la instalación de OpenShift, instala y configura la herramienta de la CLI de oc. Consulta Comienza a usar la CLI de OpenShift en la documentación de OpenShift.

   Qué necesitas saber sobre los grupos de nodos

   Nota: Te recomendamos usar los nombres apigee-data y apigee-runtime para los grupos de nodos. Apigee Hybrid reconoce estos nombres de forma predeterminada. Si no deseas usar los nombres predeterminados, se requiere una configuración adicional más adelante cuando configures el clúster para Apigee Hybrid. Para obtener más información, incluidas las instrucciones para cambiar los nombres de los grupos de nodos predeterminados mediante la edición de tu archivo de configuración del clúster, consulta Usa los nodeSelectors predeterminados.

   Te recomendamos que revises la siguiente información sobre los grupos de nodos y la configuración de grupos de nodos antes de continuar:

   • Configura grupos de nodos dedicados
   • Acerca de los grupos de nodos
   • Requisitos de red de Cassandra

   Los parámetros de configuración mínimos para tu clúster son los siguientes:

   Nota: Los valores de configuración del grupo de nodos que se describen en la siguiente tabla representan los valores mínimos. Esta configuración mínima es adecuada para las pruebas. Sin embargo, según tus necesidades, puedes aumentar el tamaño de los nodos ahora o en el futuro. Si quieres obtener información para administrar los nodos del clúster, consulta Cómo agregar y administrar grupos de nodos.

   Configuración	Grupo de nodos con estado	Grupo de nodos sin estado
   Purpose	Un grupo de nodos con estado que se usa para la base de datos de Cassandra.	Un grupo de nodos sin estado que usa el procesador de mensajes del entorno de ejecución.
   Nombre de la etiqueta	apigee-data	apigee-runtime
   Cantidad de nodos	1 por zona (3 por región)	1 por zona (3 por región)
   CPU	4	4
   RAM	15	15
   Almacenamiento	dynamic	Administrado con la CRD de ApigeeDeployment
   IOPS mínimas del disco	2,000 IOPS con SAN o almacenamiento conectado de forma directa. No se recomienda NFS, incluso si es compatible con las IOPS necesarias.	2,000 IOPS con SAN o almacenamiento conectado de forma directa. No se recomienda NFS, incluso si es compatible con las IOPS necesarias.

   Para obtener más detalles sobre la configuración mínima de los clústeres, consulta Opciones de configuración mínima de los clústeres.

Cuando hayas instalado un clúster, ve al siguiente paso.

 

Próximo paso

1 (SIGUIENTE) Paso 2: Instala cert-manager 3 4 5 6 7 8 9 10