Paso 1: Crea un clúster

Actualmente, está consultando la versión 1.7 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, consulte las versiones admitidas.

Version 1.7 (unsupported)

   Versiones compatibles:

• v1.15 (última)                        
• v1.14                        
• v1.13                         
• Lista de versiones admitidas

   Versiones no compatibles:

• v1.12                         
• v1.11                         
• v1.10                                      
• v1.9                                         
• v1.8                                         
• v1.7                                         
• Versión 1.6                                         
• v1.5                                         
• Versión 1.4                                         
• Versión 1.3                                         
• v1.2                                         
• v1.1                                         

Si vas a realizar una instalación nueva, continúa con las configuraciones que se describen a continuación.

Antes de empezar:

En estos pasos se presupone que has creado variables de entorno en los pasos anteriores. Puedes comprobarlos con los siguientes comandos:

echo $PROJECT_ID
echo $CLUSTER_LOCATION
echo $ORG_NAME
echo $ENV_NAME

Haz clic para ver las descripciones y los comandos que definen las variables.

En estos pasos se usan las siguientes variables de entorno:

• PROJECT_ID: el ID de tu proyecto de Google Cloud. Consulta Inicio rápido de Hybrid - Paso 2: Crea un proyecto de Google Cloud.

  export PROJECT_ID=your_project_ID

• CLUSTER_LOCATION: la región en la que crearás el clúster.

  export CLUSTER_LOCATION=cluster-region

  Nota: Apigee recomienda usar un nombre de región y no un nombre de zona. Una región es una ubicación geográfica concreta en la que puedes alojar tus recursos. Las regiones pueden tener varias zonas. Por ejemplo, la us-west1 región hace referencia a una región de la costa oeste de Estados Unidos que tiene tres zonas: us-west1-a, us-west1-b y and us-west1-c. Las regiones disponibles se indican en la página Regiones y zonas disponibles. 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, utilice un nombre de región para la variable CLUSTER_LOCATION.
• ORG_NAME: el nombre de tu organización. Debe coincidir con el ID de tu proyecto de Google Cloud. Consulta Inicio rápido de la versión híbrida - Paso 4: Crea una organización.

  export ORG_NAME=your_organization_name

• ENV_NAME: el nombre de tu entorno híbrido. Consulta Guía de inicio rápido (Hybrid) - Paso 6: Crea un grupo de entorno.

  export ENV_NAME=your_environment_name

En este procedimiento se explica cómo configurar el clúster en el que ejecutarás Apigee hybrid. Las instrucciones varían en función de la plataforma en la que ejecutes la versión híbrida. Selecciona tu plataforma para ver las instrucciones.

GKE

En este paso se explica cómo configurar el 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. Reúne los requisitos de tu clúster para el clúster de Apigee hybrid: Las configuraciones mínimas de tu clúster son las siguientes:

   Configuración	Grupo de nodos con estado	Grupo de nodos sin estado
   Número de nodos	3 (por región)	3 (por región)
   CPU	4	4
   RAM	15	15
   Nombre de la etiqueta predeterminada	apigee-data	apigee-runtime
   Almacenamiento	dynamic	Gestionado con el CRD ApigeeDeployment

   Para obtener más información sobre la configuración mínima de los clústeres, consulta el artículo Configuraciones mínimas de clústeres.

2. Comprueba la versión de GKE compatible con esta versión híbrida 1.7.6:
   • Apigee Hybrid: plataformas compatibles
3. Sigue estas instrucciones para crear un clúster regional con un mínimo de 6 nodos:
   • Crear un clúster regional.
     Nota: Si usas la consola de Google Cloud para crear tu clúster, añade los grupos de nodos antes de hacer clic en Crear para 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 se te pida tu ubicación en los pasos posteriores.
     Nota: Si no vas a crear el clúster en la red predeterminada, sigue las instrucciones de Crear un clúster en una subred ya creada
     .
4. Crea un mínimo de dos grupos de nodos para tu clúster. Los requisitos mínimos de los grupos de nodos son los siguientes:

   Nombre predeterminado del grupo de nodos	Descripción	Nodos mínimos	Número mínimo de CPUs por grupo de nodos	Número mínimo de CPUs por nodo
   apigee-data	Un grupo de nodos con estado.	3	4	4/número de nodos del grupo
   apigee-runtime	Un grupo de nodos sin estado.	3	4	4/número de nodos del grupo

   Sigue las instrucciones que se indican en Añadir y gestionar grupos de nodos.

   Para obtener más información sobre la configuración de grupos de nodos, consulta los siguientes artículos: Configurar grupos de nodos dedicados

   Nota: 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}

5. Después de crear el clúster, habilita Workload Identity en él con el siguiente comando:

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

   Para obtener más información, consulta Habilitar Workload Identity en un clúster.

   Nota: Si has creado un clúster zonal en lugar de uno 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}

6. 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 has creado un clúster de zona 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 funcionamiento, ve al siguiente paso.

GKE On-Prem

Crear un clúster

1. Reúne los requisitos de tu clúster de Apigee Hybrid:
   • Las configuraciones mínimas de tu clúster son las siguientes:

     Configuración	Grupo de nodos con estado	Grupo de nodos sin estado
     Número de nodos	3 (por región)	3 (por región)
     CPU	4	4
     RAM	15	15
     Nombre de la etiqueta predeterminada	apigee-data	apigee-runtime
     Almacenamiento	dynamic	Gestionado con el CRD ApigeeDeployment

     Para obtener más información sobre la configuración mínima de los clústeres, consulta el artículo Configuraciones mínimas de clústeres.

   • Crea al menos 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 información sobre la configuración de grupos de nodos, consulta los siguientes artículos: Configurar grupos de nodos dedicados

2. Comprueba la versión de GKE compatible con esta versión híbrida 1.7.6:
   • Apigee Hybrid: plataformas compatibles
3. Sigue estas instrucciones para crear un clúster de usuarios:
   • Crea un clúster de usuarios (guía de inicio rápido) en la documentación de GKE On-prem.

Cuando tengas un clúster instalado y en funcionamiento, ve al siguiente paso.

Anthos en Bare Metal

Requisitos

Los clústeres de Anthos en Bare Metal te permiten ejecutar clústeres de Kubernetes directamente en tus propios recursos de máquina.

Revisa los siguientes requisitos:

• Requisitos de hardware: Configurar el hardware para clústeres de Anthos en Bare Metal
• Descripción general de los requisitos previos de instalación

Crear un clúster

1. Reúne los requisitos de tu clúster de Apigee Hybrid:
   • Las configuraciones mínimas de tu clúster son las siguientes:

     Configuración	Grupo de nodos con estado	Grupo de nodos sin estado
     Número de nodos	3 (por región)	3 (por región)
     CPU	4	4
     RAM	15	15
     Nombre de la etiqueta predeterminada	apigee-data	apigee-runtime
     Almacenamiento	dynamic	Gestionado con el CRD ApigeeDeployment

     Para obtener más información sobre la configuración mínima de los clústeres, consulta el artículo Configuraciones mínimas de clústeres.

   • Crea al menos 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 información sobre la configuración de grupos de nodos, consulta los siguientes artículos: Configurar grupos de nodos dedicados

2. Comprueba la versión de GKE compatible con esta versión híbrida 1.7.6:
   • Apigee Hybrid: plataformas compatibles
3. Sigue las instrucciones de la documentación de clústeres de Anthos en Bare Metal para crear un clúster de usuario:
   • Información general sobre cómo crear clústeres
   • Guía de inicio rápido sobre clústeres de Anthos en Bare Metal en la documentación de clústeres de Anthos en Bare Metal.

Cuando tengas un clúster instalado y en funcionamiento, ve al siguiente paso.

AKS

Crear un clúster de AKS

1. Reúne los requisitos de tu clúster de Apigee Hybrid:
   • Las configuraciones mínimas de tu clúster son las siguientes:

     Configuración	Grupo de nodos con estado	Grupo de nodos sin estado
     Número de nodos	3 (por región)	3 (por región)
     CPU	4	4
     RAM	15	15
     Nombre de la etiqueta predeterminada	apigee-data	apigee-runtime
     Almacenamiento	dynamic	Gestionado con el CRD ApigeeDeployment

     Para obtener más información sobre la configuración mínima de los clústeres, consulta el artículo Configuraciones mínimas de clústeres.

   • Crea al menos 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 información sobre la configuración de grupos de nodos, consulta los siguientes artículos: Configurar grupos de nodos dedicados

2. Comprueba la versión de AKS compatible con esta versión híbrida 1.7.6:
   • Apigee Hybrid: plataformas compatibles
3. Siga uno de estos conjuntos de instrucciones para crear un clúster:
   • Con la CLI de Azure: Guía de inicio rápido: Implementar un clúster de Azure Kubernetes Service con la CLI de Azure.
   • Con Azure Portal: Inicio rápido: implementar un clúster de Azure Kubernetes Service (AKS) mediante Azure Portal

EKS

Crear un clúster

1. Reúne los requisitos de tu clúster de Apigee Hybrid:
   • Las configuraciones mínimas de tu clúster son las siguientes:

     Configuración	Grupo de nodos con estado	Grupo de nodos sin estado
     Número de nodos	3 (por región)	3 (por región)
     CPU	4	4
     RAM	15	15
     Nombre de la etiqueta predeterminada	apigee-data	apigee-runtime
     Almacenamiento	dynamic	Gestionado con el CRD ApigeeDeployment

     Para obtener más información sobre la configuración mínima de los clústeres, consulta el artículo Configuraciones mínimas de clústeres.

   • Crea al menos 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 información sobre la configuración de grupos de nodos, consulta los siguientes artículos: Configurar grupos de nodos dedicados

2. Comprueba la versión de EKS compatible con esta versión híbrida 1.7.6:
   • Apigee Hybrid: plataformas compatibles
3. Sigue estas instrucciones para crear un clúster de usuarios:
   • Documentación general de EKS
   • Crear un clúster de Amazon EKS.

Cuando tengas un clúster instalado y en funcionamiento, ve al siguiente paso.

GKE en AWS

Crear un clúster

1. Reúne los requisitos de tu clúster de Apigee Hybrid:
   • Las configuraciones mínimas de tu clúster son las siguientes:

     Configuración	Grupo de nodos con estado	Grupo de nodos sin estado
     Número de nodos	3 (por región)	3 (por región)
     CPU	4	4
     RAM	15	15
     Nombre de la etiqueta predeterminada	apigee-data	apigee-runtime
     Almacenamiento	dynamic	Gestionado con el CRD ApigeeDeployment

     Para obtener más información sobre la configuración mínima de los clústeres, consulta el artículo Configuraciones mínimas de clústeres.

   • Crea al menos 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 información sobre la configuración de grupos de nodos, consulta los siguientes artículos: Configurar grupos de nodos dedicados

2. Comprueba la versión de GKE compatible con esta versión híbrida 1.7.6:
   • Apigee Hybrid: plataformas compatibles
3. Sigue estas instrucciones para crear un clúster de usuarios:
   • Documentación general de GKE on AWS
   • Información general sobre la instalación de clústeres de Anthos en AWS

Cuando tengas un clúster instalado y en funcionamiento, ve al siguiente paso.

OpenShift

Crear un clúster

1. Reúne los requisitos de tu clúster de Apigee Hybrid:
   • Las configuraciones mínimas de tu clúster son las siguientes:

     Configuración	Grupo de nodos con estado	Grupo de nodos sin estado
     Número de nodos	3 (por región)	3 (por región)
     CPU	4	4
     RAM	15	15
     Nombre de la etiqueta predeterminada	apigee-data	apigee-runtime
     Almacenamiento	dynamic	Gestionado con el CRD ApigeeDeployment

     Para obtener más información sobre la configuración mínima de los clústeres, consulta el artículo Configuraciones mínimas de clústeres.

   • Crea al menos 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 información sobre la configuración de grupos de nodos, consulta los siguientes artículos: Configurar grupos de nodos dedicados

2. Comprueba la versión de OpenShift compatible con esta versión híbrida 1.7.6:
   • Apigee Hybrid: plataformas compatibles
3. Crea el clúster de OpenShift para implementarlo en el plano de tiempo de ejecución e instala Apigee en tu clúster de usuarios de OpenShift.
   Puedes consultar más información sobre cómo crear y gestionar clústeres de OpenShift en GCP en la documentación de OpenShift, por ejemplo, en el artículo Instalar un clúster rápidamente en GCP
   .
   Para obtener ayuda sobre cómo configurar tu clúster de OpenShift en máquinas virtuales de GCP, consulta el artículo Cómo configurar Apigee hybrid en OpenShift en máquinas virtuales de GCP.

   Como parte de la instalación de OpenShift, instala y configura la herramienta de línea de comandos oc. Consulta la sección Primeros pasos con la CLI de OpenShift en la documentación de OpenShift.

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

 

1 Paso 2: Instala cert-manager 3 4 5 6 7 8 9