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
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
- 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.
- Verifica la versión de GKE compatible con esta versión de Apigee Hybrid 1.6.9:
- Usa las siguientes instrucciones para crear un clúster regional con un mínimo de 6 nodos:
- 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.
- Después de crear el clúster, habilita la identidad de carga de trabajo en el clúster 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 Habilita Workload Identity en un clúster.
- 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}
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:
- 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.
- Los parámetros de configuración mínimos para tu clúster son los siguientes:
- Verifica la versión de GKE compatible con esta versión de Apigee Hybrid 1.6.9:
- 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 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:
- 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.
- Los parámetros de configuración mínimos para tu clúster son los siguientes:
- Verifica la versión de GKE compatible con esta versión de Apigee Hybrid 1.6.9:
- 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
- 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.
- Los parámetros de configuración mínimos para tu clúster son los siguientes:
- Verifica la versión de AKS compatible con esta versión de Apigee Hybrid 1.6.9:
- 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:
- 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.
- Los parámetros de configuración mínimos para tu clúster son los siguientes:
- Verifica la versión de EKS compatible con esta versión de Apigee Hybrid 1.6.9:
- Usa las siguientes instrucciones para crear un clúster de usuarios:
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:
- 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.
- Los parámetros de configuración mínimos para tu clúster son los siguientes:
- Verifica la versión de GKE compatible con esta versión de Apigee Hybrid 1.6.9:
- Usa las siguientes instrucciones para crear un clúster de usuarios:
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:
- 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.
- Los parámetros de configuración mínimos para tu clúster son los siguientes:
- Verifica la versión de GKE compatible con esta versión de Apigee Hybrid 1.6.9:
- Usa las siguientes instrucciones para instalar Apigee en tu clúster de usuario de OpenShift y registrarlo en GKE Hub.
- Instala y configura la herramienta de la CLI de
oc
. Consulta Comienza a usar la CLI de OpenShift en la documentación de OpenShift. - Regístrate con GKE Hub
- 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
- Crea el componente en
oc
con el siguiente comando:oc create -f gke-connect-scc.yaml
- Crea las variables de entorno para el contexto con los siguientes comandos:
export KUBECONFIG=<> # Cluster kubeconfig file path
export CONTEXT=admin
- 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 seradmin
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
- Crea un archivo llamado
- Instala y configura la herramienta de la CLI de
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