Paso 1: Crea un clúster

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.

Crear un clúster

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
Verifica la versión de GKE compatible con esta versión de Apigee Hybrid 1.5.10:
- Apigee Hybrid: Plataformas compatibles
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

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
Verifica la versión de GKE compatible con esta versión de Apigee Hybrid 1.5.10:
- Apigee Hybrid: Plataformas compatibles
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

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
Verifica la versión de GKE compatible con esta versión de Apigee Hybrid 1.5.10:
- Apigee Hybrid: Plataformas compatibles
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

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
Verifica la versión de AKS compatible con esta versión de Apigee Hybrid 1.5.10:
- Apigee Hybrid: Plataformas compatibles
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

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
Verifica la versión de EKS compatible con esta versión de Apigee Hybrid 1.5.10:
- Apigee Hybrid: Plataformas compatibles
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

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
Verifica la versión de GKE compatible con esta versión de Apigee Hybrid 1.5.10:
- Apigee Hybrid: Plataformas compatibles
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

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
Verifica la versión de GKE compatible con esta versión de Apigee Hybrid 1.5.10:
- Apigee Hybrid: Plataformas compatibles
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.

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