Paso 1: Crea un clúster

Estás viendo la versión 1.5 de la documentación de Apigee Hybrid. Esta versión está al final del ciclo de vida. Debes actualizarla a una versión más reciente.Para obtener más información, consulta las versiones compatibles.

Version 1.5 (unsupported)

   Versiones compatibles:

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

   Versiones no compatibles

• 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.5.10, 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.

Antes de comenzar:

Para estos pasos, se supone que creaste variables de entorno en los pasos anteriores. Consúltalos con los siguientes comandos:

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

Haz clic para obtener descripciones y comandos que te permitan definir las variables.

En estos pasos, se usan las siguientes variables de entorno:

• PROJECT_ID: El ID del proyecto de Google Cloud. Consulta Guía de inicio rápido de Hybrid: Paso 2: Crea un proyecto de Google Cloud

  export PROJECT_ID=your_project_ID

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

  export CLUSTER_LOCATION=cluster-region

  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.
• ORG_NAME: Es el nombre de tu organización. Debe coincidir con el ID de tu proyecto de Google Cloud. Consulta la Guía de inicio rápido de Hybrid: Paso 4: Crea una organización

  export ORG_NAME=your_organization_name

• ENV_NAME: Es el nombre de tu entorno híbrido. Consulta Guía de inicio rápido de nube híbrida - Paso 6: Crea un grupo de entornos

  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 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. Reúne los requisitos de tu clúster para el clúster de Apigee Hybrid:
   • Opciones de configuración mínimas de los clústeres
   • Configura grupos de nodos dedicados
2. Verifica la versión de GKE compatible con esta versión de Apigee Hybrid 1.5.10:
   • Apigee Hybrid: Plataformas compatibles
3. Usa las siguientes instrucciones para crear un clúster de usuarios:
   • Crea un clúster regional.
     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.

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:
   • Opciones de configuración mínimas de los clústeres
   • Configura grupos de nodos dedicados
2. Verifica la versión de GKE compatible con esta versión de Apigee Hybrid 1.5.10:
   • Apigee Hybrid: Plataformas compatibles
3. Usa las siguientes instrucciones para crear un clúster de usuarios:
   • Descripción general de la instalación de GKE On-Prem 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 los siguientes requisitos y requisitos previos:

• Requisitos de hardware: Configura hardware para clústeres de Anthos alojados en equipos físicos
• 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:
   • Opciones de configuración mínimas de los clústeres
   • Configura grupos de nodos dedicados
2. Verifica la versión de GKE compatible con esta versión de Apigee Hybrid 1.5.10:
   • Apigee Hybrid: Plataformas compatibles
3. Usa las siguientes instrucciones para crear un clúster de usuarios:
   • Crea clústeres de usuario en una configuración de varios clústeres en la documentación de los clústeres de Anthos alojados en el equipo físico.

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:
   • Opciones de configuración mínimas de los clústeres
   • Configura grupos de nodos dedicados
2. Verifica la versión de AKS compatible con esta versión de Apigee Hybrid 1.5.10:
   • 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:
   • Opciones de configuración mínimas de los clústeres
   • Configura grupos de nodos dedicados
2. Verifica la versión de EKS compatible con esta versión de Apigee Hybrid 1.5.10:
   • 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:
   • Opciones de configuración mínimas de los clústeres
   • Configura grupos de nodos dedicados
2. Verifica la versión de GKE compatible con esta versión de Apigee Hybrid 1.5.10:
   • 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
   • Instala GKE 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:
   • Opciones de configuración mínimas de los clústeres
   • Configura grupos de nodos dedicados
2. Verifica la versión de GKE compatible con esta versión de Apigee Hybrid 1.5.10:
   • Apigee Hybrid: Plataformas compatibles
3. Usa las siguientes instrucciones para instalar Apigee en tu clúster de usuario de OpenShift y registrarlo en GKE Hub.
   Si no tienes un clúster de OpenShift listo para usar con Apigee, consulta las instrucciones de la documentación de OpenShift, por ejemplo:Instala un clúster con rapidez en Google Cloud.
   1. Instala y configura la herramienta de la CLI de oc. Consulta Comienza a usar la CLI de OpenShift en la documentación de OpenShift.
   2. Regístrate con GKE Hub
      1. Crea un archivo llamado gke-connect-scc.yaml con el siguiente contenido:

         # Connect Agent SCC
         apiVersion: v1
         kind: SecurityContextConstraints
         metadata:
           name: gke-connect-scc
         allowPrivilegeEscalation: false
         requiredDropCapabilities:
         - ALL
         runAsUser:
           type: MustRunAsNonRoot
         seLinuxContext:
           type: RunAsAny
         supplementalGroups:
           type: MustRunAs
           ranges:
           - min: 1
             max: 65535
         fsGroup:
           type: MustRunAs
           ranges:
           - min: 1
             max: 65535
         volumes:
         - secret
         readOnlyRootFilesystem: true
         seccompProfiles:
         - docker/default
         users:
         groups:
           - system:serviceaccounts:gke-connect
                 

      2. Crea el componente en oc con el siguiente comando:

         oc create -f gke-connect-scc.yaml

      3. Crea las variables de entorno para el contexto con los siguientes comandos:

         export KUBECONFIG=<> # Cluster kubeconfig file path
         export CONTEXT=admin

      4. Regístrate en GKE Hub con el siguiente comando:

         gcloud --project=${PROJECT_ID} container hub memberships register CLUSTER_NAME \
           --kubeconfig=${KUBECONFIG} \
           --context=${CONTEXT} \
           --service-account-key-file=KEY_FILE_PATH

         Aquí:

         • PROJECT_ID es tu ID del proyecto de Google Cloud.
         • CLUSTER_NAME es el nombre del clúster que acabas de crear.
         • KUBECONFIG es la ruta de acceso al archivo kubeconfig del clúster.
         • CONTEXT es el contexto en el que gcloud registra el clúster. CONTEXT debe ser admin para este comando.
         • KEY_FILE_PATH es la ruta al archivo de claves de tu cuenta de servicio, por ejemplo, ./dist/apigee-my-project-ro-sa.json. La cuenta de servicio debe tener las siguientes dos funciones de IAM:
           • Administrador de GKE Hub
           • Agente de GKE Connect

Cuando tengas un clúster instalado y registrado en GKE Hub, ve al siguiente paso.

 

Próximo paso

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