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

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

  1. 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.

  2. Verifica la versión de GKE compatible con esta versión de Apigee Hybrid 1.6.9:
  3. Usa las siguientes instrucciones para crear un clúster regional con un mínimo de 6 nodos:
    • Crea un clúster regional.
  4. 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.

  5. 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.

  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 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:
    • 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.

  2. Verifica la versión de GKE compatible con esta versión de Apigee Hybrid 1.6.9:
  3. 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.

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:

Crear un clúster

  1. 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.

  2. Verifica la versión de GKE compatible con esta versión de Apigee Hybrid 1.6.9:
  3. 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:

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:
    • 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.

  2. Verifica la versión de AKS compatible con esta versión de Apigee Hybrid 1.6.9:
  3. Usa uno de los siguientes conjuntos de instrucciones para crear un clúster:

EKS

Crear un clúster

  1. 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.

  2. Verifica la versión de EKS compatible con esta versión de Apigee Hybrid 1.6.9:
  3. 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

  1. 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.

  2. Verifica la versión de GKE compatible con esta versión de Apigee Hybrid 1.6.9:
  3. 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

  1. 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.

  2. Verifica la versión de GKE compatible con esta versión de Apigee Hybrid 1.6.9:
  3. Usa las siguientes instrucciones para instalar Apigee en tu clúster de usuario de OpenShift y registrarlo en GKE Hub.
    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