Paso 1: Crea un clúster

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

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.

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 de la versión híbrida 1.6.9:
  3. Sigue estas instrucciones para crear un clúster regional con un mínimo de 6 nodos:
  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

  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.

  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}

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 de la versión híbrida 1.6.9:
  3. Sigue estas instrucciones para crear un clúster de usuarios:

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:

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 de la versión híbrida 1.6.9:
  3. Sigue las instrucciones de la documentación de clústeres de Anthos en Bare Metal para crear un clúster de usuario:

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.6.9:
  3. Siga uno de estos conjuntos de instrucciones para crear un clúster:

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.6.9:
  3. Sigue estas instrucciones para crear un clúster de usuarios:

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 de la versión híbrida 1.6.9:
  3. Sigue estas instrucciones para crear un clúster de usuarios:

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 GKE compatible con esta versión de la versión híbrida 1.6.9:
  3. Sigue estas instrucciones para instalar Apigee en tu clúster de usuario de OpenShift y registrarlo en GKE Hub.
    1. 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.
    2. Registrarse en 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 del 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

        Donde:

        • PROJECT_ID es el ID de tu proyecto de Google Cloud.
        • CLUSTER_NAME es el nombre del clúster que acabas de crear.
        • KUBECONFIG es la ruta al archivo kubeconfig de tu 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 clave de tu cuenta de servicio. Por ejemplo, ./dist/apigee-my-project-ro-sa.json. La cuenta de servicio debe tener los dos roles de gestión de identidades y accesos siguientes:
          • Administrador de GKE Hub
          • Agente de GKE Connect

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

 

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