Paso 1: Crea un clúster

Estás viendo la versión 1.8 de la documentación de Apigee Hybrid. This version is end of life. You should upgrade to a newer version. Para obtener más información, consulta las Versiones compatibles.

Version 1.8 (unsupported)

   Versiones compatibles:

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

   Versiones no compatibles

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

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

En este procedimiento, se explica cómo configurar el clúster en el que ejecutarás Apigee Hybrid. Las instrucciones varían según la plataforma en la que ejecutas Apigee Hybrid. Selecciona tu plataforma para ver las instrucciones.

GKE

En este paso, se explica cómo configurar tu entorno de shell 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.

Crear un clúster

1. Crea las siguientes variables de entorno:

   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

   Aquí:

   • CLUSTER_NAME (obligatorio): es el nombre del clúster nuevo.
   • CLUSTER_LOCATION: Es la región en la que crearás el clúster.
     Nota: Apigee recomienda que uses un nombre de región y no un nombre de zona. Una región es una ubicación geográfica específica donde puedes alojar recursos. Las regiones pueden tener varias zonas. Por ejemplo, la región us-west1 denota una región en la costa oeste de Estados Unidos que tiene tres zonas: us-west1-a, us-west1-b, and us-west1-c. 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. En la mayoría de las instalaciones híbridas, usa un nombre de región para la variable CLUSTER_LOCATION.
2. Recopila los requisitos del clúster para el clúster de Apigee Hybrid: Los parámetros de configuración mínimos para el clúster son los siguientes:

   Configuración	Grupo de nodos con estado	Grupo de nodos sin estado
   Cantidad de nodos	3 (por región)	3 (por región)
   CPU	4	4
   RAM	15	15
   Nombre de etiqueta predeterminado	apigee-data	apigee-runtime
   Almacenamiento	dynamic	Administrado con la CRD de ApigeeDeployment

   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.

3. Verifica la versión de GKE compatible con esta versión de hybrid 1.8.8:
   • Apigee Hybrid: Plataformas compatibles
4. Usa las siguientes instrucciones para crear un clúster regional con un mínimo de 6 nodos:
   • Crea un clúster regional.
     Sugerencia: Si usas la consola de Google Cloud para crear tu clúster, agrega los grupos de nodos antes de hacer clic en Crear a fin de crear el clúster.
     Nota: Apigee recomienda crear un clúster regional. Si prefieres crear un clúster zonal, asegúrate de usar la zona en la que las instrucciones solicitan tu ubicación en los pasos posteriores.
     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
5. Crea un mínimo de dos grupos de nodos para el clúster. Los requisitos mínimos del grupo de nodos son los siguientes:

   Nombre predeterminado del grupo de nodos	Descripción	Cantidad mínima de nodos	Cantidad mínima de CPU por grupo de nodos	Cantidad mínima de CPU por nodo
   apigee-data	Un grupo de nodos con estado.	3	4	4/cantidad de nodos en el grupo
   apigee-runtime	Un grupo de nodos sin estado.	3	4	4/cantidad de nodos en el grupo

   Sigue las instrucciones en Agrega y administra grupos de nodos.

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

   Sugerencia: Después de crear los grupos de nodos, puedes verificarlos con el siguiente comando:

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

6. Después de crear el clúster, habilita la identidad de cargas de trabajo en el clúster. Esta operación puede demorar hasta 30 minutos:

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

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

   Nota: Si creaste un clúster zonal en lugar de un clúster regional, usa el argumento --zone en lugar de --region, como en el siguiente comando:

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

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

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

   Nota: Si creaste un clúster zonal en lugar de un clúster regional, obtén las credenciales con el siguiente comando:

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

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

GKE On-Prem

Crear un clúster

1. Reúne los requisitos de tu clúster para el clúster de Apigee Hybrid:
   • Los parámetros de configuración mínimos para tu clúster son los siguientes:

     Configuración	Grupo de nodos con estado	Grupo de nodos sin estado
     Cantidad de nodos	3 (por región)	3 (por región)
     CPU	4	4
     RAM	15	15
     Nombre de etiqueta predeterminado	apigee-data	apigee-runtime
     Almacenamiento	dynamic	Administrado con la CRD de ApigeeDeployment

     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.

   • Crea un mínimo de dos grupos de nodos:

     Nombre predeterminado del grupo de nodos	Descripción
     apigee-data	Un grupo de nodos con estado.
     apigee-runtime	Un grupo de nodos sin estado.

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

2. Verifica la versión de GKE compatible con esta versión de hybrid 1.8.8:
   • Apigee Hybrid: Plataformas compatibles
3. Usa las siguientes instrucciones para crear un clúster de usuarios:
   • Crea un clúster de usuario (guía de inicio rápido) en la documentación de GKE On-Prem.

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

Anthos en Bare Metal

Requisitos y requisitos previos

Los clústeres de Anthos alojados en equipos físicos te permiten ejecutar clústeres de Kubernetes directamente en tus propios recursos de máquina.

Revisa la descripción general de los requisitos previos de instalación.

Crear un clúster

1. Reúne los requisitos de tu clúster para el clúster de Apigee Hybrid:
   • Los parámetros de configuración mínimos para tu clúster son los siguientes:

     Configuración	Grupo de nodos con estado	Grupo de nodos sin estado
     Cantidad de nodos	3 (por región)	3 (por región)
     CPU	4	4
     RAM	15	15
     Nombre de etiqueta predeterminado	apigee-data	apigee-runtime
     Almacenamiento	dynamic	Administrado con la CRD de ApigeeDeployment

     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.

   • Crea un mínimo de dos grupos de nodos:

     Nombre predeterminado del grupo de nodos	Descripción
     apigee-data	Un grupo de nodos con estado.
     apigee-runtime	Un grupo de nodos sin estado.

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

2. Verifica la versión de GKE compatible con esta versión de hybrid 1.8.8:
   • Apigee Hybrid: Plataformas compatibles
3. Usa las siguientes instrucciones en la documentación de los clústeres de Anthos en el equipo físico para crear un clúster de usuario:
   • Crear clústeres: descripción general
   • Guía de inicio rápido sobre clústeres de Anthos en equipos físicos en la documentación de clústeres de Anthos en equipos físicos.

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

AKS

Crea un clúster de AKS

1. Reúne los requisitos de tu clúster para el clúster de Apigee Hybrid:
   • Los parámetros de configuración mínimos para tu clúster son los siguientes:

     Configuración	Grupo de nodos con estado	Grupo de nodos sin estado
     Cantidad de nodos	3 (por región)	3 (por región)
     CPU	4	4
     RAM	15	15
     Nombre de etiqueta predeterminado	apigee-data	apigee-runtime
     Almacenamiento	dynamic	Administrado con la CRD de ApigeeDeployment

     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.

   • Crea un mínimo de dos grupos de nodos:

     Nombre predeterminado del grupo de nodos	Descripción
     apigee-data	Un grupo de nodos con estado.
     apigee-runtime	Un grupo de nodos sin estado.

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

2. Verifica la versión de AKS compatible con esta versión de Apigee hybrid 1.8.8:
   • Apigee Hybrid: Plataformas compatibles
3. Usa uno de los siguientes conjuntos de instrucciones para crear un clúster:
   • Mediante la CLI de Azure: Guía de inicio rápido: Implementa un clúster de Azure Kubernetes Service con la CLI de Azure.
   • Mediante le portal de Azure: Guía de inicio rápido: Implementa un clúster de Azure Kubernetes Service (AKS) con el portal de Azure.

EKS

Crear un clúster

1. Reúne los requisitos de tu clúster para el clúster de Apigee Hybrid:
   • Los parámetros de configuración mínimos para tu clúster son los siguientes:

     Configuración	Grupo de nodos con estado	Grupo de nodos sin estado
     Cantidad de nodos	3 (por región)	3 (por región)
     CPU	4	4
     RAM	15	15
     Nombre de etiqueta predeterminado	apigee-data	apigee-runtime
     Almacenamiento	dynamic	Administrado con la CRD de ApigeeDeployment

     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.

   • Crea un mínimo de dos grupos de nodos:

     Nombre predeterminado del grupo de nodos	Descripción
     apigee-data	Un grupo de nodos con estado.
     apigee-runtime	Un grupo de nodos sin estado.

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

2. Verifica la versión de EKS compatible con esta versión de Hybrid 1.8.8:
   • Apigee Hybrid: Plataformas compatibles
3. Usa las siguientes instrucciones para crear un clúster de usuarios:
   • Documentación general de EKS
   • Crea un clúster de Amazon EKS

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

GKE on AWS

Crear un clúster

1. Reúne los requisitos de tu clúster para el clúster de Apigee Hybrid:
   • Los parámetros de configuración mínimos para tu clúster son los siguientes:

     Configuración	Grupo de nodos con estado	Grupo de nodos sin estado
     Cantidad de nodos	3 (por región)	3 (por región)
     CPU	4	4
     RAM	15	15
     Nombre de etiqueta predeterminado	apigee-data	apigee-runtime
     Almacenamiento	dynamic	Administrado con la CRD de ApigeeDeployment

     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.

   • Crea un mínimo de dos grupos de nodos:

     Nombre predeterminado del grupo de nodos	Descripción
     apigee-data	Un grupo de nodos con estado.
     apigee-runtime	Un grupo de nodos sin estado.

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

2. Verifica la versión de GKE compatible con esta versión de hybrid 1.8.8:
   • Apigee Hybrid: Plataformas compatibles
3. Usa las siguientes instrucciones para crear un clúster de usuarios:
   • 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

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

OpenShift

Crear un clúster

1. Reúne los requisitos de tu clúster para el clúster de Apigee Hybrid:
   • Los parámetros de configuración mínimos para tu clúster son los siguientes:

     Configuración	Grupo de nodos con estado	Grupo de nodos sin estado
     Cantidad de nodos	3 (por región)	3 (por región)
     CPU	4	4
     RAM	15	15
     Nombre de etiqueta predeterminado	apigee-data	apigee-runtime
     Almacenamiento	dynamic	Administrado con la CRD de ApigeeDeployment

     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.

   • Crea un mínimo de dos grupos de nodos:

     Nombre predeterminado del grupo de nodos	Descripción
     apigee-data	Un grupo de nodos con estado.
     apigee-runtime	Un grupo de nodos sin estado.

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

2. Verifica la versión de OpenShift compatible con esta versión de Hybrid 1.8.8:
   • Apigee Hybrid: Plataformas compatibles
3. Compila el clúster de OpenShift para implementar en el plano del entorno de ejecución e instala Apigee en el clúster de usuario de OpenShift.
   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.

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

 

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