Étape 1 : Créer un cluster

Avant de commencer :

Dans cette procédure, nous partons du principe que vous avez créé des variables d'environnement lors des étapes précédentes. Vérifiez-les à l'aide des commandes suivantes :

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

Cette procédure explique comment configurer le cluster dans lequel vous exécuterez Apigee hybrid. Les instructions varient en fonction de la plate-forme sur laquelle vous exécutez Apigee hybrid. Sélectionnez une plate-forme pour afficher les instructions.

GKE

Cette étape explique comment configurer votre environnement de shell et créer un cluster GKE dans votre projet Google Cloud.

Créer un cluster

  1. Rassemblez les exigences de votre cluster Apigee hybrid : Les configurations minimales de votre cluster sont les suivantes :
    Configuration Pool de nœuds avec état Pool de nœuds sans état
    Nombre de nœuds 3 (par région) 3 (par région)
    Processeur 4 4
    RAM 15 15
    Nom de l'étiquette par défaut apigee-data apigee-runtime
    Stockage dynamic Gestion avec le CRD ApigeeDeployment

    Pour en savoir plus sur la configuration minimale du cluster, consultez la section Configurations de base du cluster.

  2. Vérifiez la version de GKE compatible avec cette version de l'environnement hybride 1.6.9 :
  3. Suivez les instructions ci-dessous pour créer un cluster régional comptant au moins six nœuds :
    • Créer un cluster régional.
  4. Créez au moins deux pools de nœuds pour votre cluster. Les exigences minimales pour le pool de nœuds sont les suivantes :
    Nom du pool de nœuds par défaut Description Nombre minimal de nœuds Nombre minimal de processeurs par pool de nœuds Nombre minimal de processeurs par nœud
    apigee-data Un pool de nœuds avec état. 3 4 4/nombre de nœuds du pool
    apigee-runtime Un pool de nœuds sans état. 3 4 4/nombre de nœuds du pool

    Suivez les instructions de la section Ajouter et gérer des pools de nœuds.

    Pour en savoir plus sur la configuration des pools de nœuds, consultez la page Configurer des pools de nœuds dédiés.

  5. Après avoir créé le cluster, activez Workload Identity sur le cluster à l'aide de la commande suivante :
    gcloud container clusters update ${CLUSTER_NAME} \
      --workload-pool=$PROJECT_ID.svc.id.goog \
      --region ${CLUSTER_LOCATION}

    Pour en savoir plus, consultez la page Activer Workload Identity sur un cluster.

  6. Obtenez les identifiants gcloud du cluster que vous venez de créer à l'aide de la commande suivante :
    gcloud container clusters get-credentials ${CLUSTER_NAME} \
      --region ${CLUSTER_LOCATION} \
      --project ${PROJECT_ID}

Une fois le cluster installé et en cours d'exécution, passez à l'étape suivante.

GKE On-Prem

Créer un cluster

  1. Rassemblez les exigences de cluster pour le cluster hybride Apigee :
    • Les configurations de cluster minimales sont les suivantes :
      Configuration Pool de nœuds avec état Pool de nœuds sans état
      Nombre de nœuds 3 (par région) 3 (par région)
      Processeur 4 4
      RAM 15 15
      Nom de l'étiquette par défaut apigee-data apigee-runtime
      Stockage dynamic Gestion avec le CRD ApigeeDeployment

      Pour en savoir plus sur la configuration minimale du cluster, consultez la section Configurations de base du cluster.

    • Créez au moins deux pools de nœuds :
      Nom du pool de nœuds par défaut Description
      apigee-data Un pool de nœuds avec état.
      apigee-runtime Un pool de nœuds sans état.

      Pour en savoir plus sur la configuration des pools de nœuds, consultez la page Configurer des pools de nœuds dédiés.

  2. Vérifiez la version de GKE compatible avec cette version de l'environnement hybride 1.6.9 :
  3. Procédez comme suit pour créer un cluster d'utilisateur :

Une fois le cluster installé et en cours d'exécution, passez à l'étape suivante.

Anthos sur solution Bare Metal

Exigences et prérequis

Les clusters Anthos sur solution Bare Metal vous permettent d'exécuter des clusters Kubernetes directement sur vos propres ressources machine.

Examinez les exigences et prérequis suivants :

Créer un cluster

  1. Rassemblez les exigences de cluster pour le cluster hybride Apigee :
    • Les configurations de cluster minimales sont les suivantes :
      Configuration Pool de nœuds avec état Pool de nœuds sans état
      Nombre de nœuds 3 (par région) 3 (par région)
      Processeur 4 4
      RAM 15 15
      Nom de l'étiquette par défaut apigee-data apigee-runtime
      Stockage dynamic Gestion avec le CRD ApigeeDeployment

      Pour en savoir plus sur la configuration minimale du cluster, consultez la section Configurations de base du cluster.

    • Créez au moins deux pools de nœuds :
      Nom du pool de nœuds par défaut Description
      apigee-data Un pool de nœuds avec état.
      apigee-runtime Un pool de nœuds sans état.

      Pour en savoir plus sur la configuration des pools de nœuds, consultez la page Configurer des pools de nœuds dédiés.

  2. Vérifiez la version de GKE compatible avec cette version de l'environnement hybride 1.6.9 :
  3. Suivez les instructions ci-dessous dans la documentation d'Anthos clusters on bare metal pour créer un cluster d'utilisateur :

Une fois le cluster installé et en cours d'exécution, passez à l'étape suivante.

AKS

Créer un cluster AKS

  1. Rassemblez les exigences de cluster pour le cluster hybride Apigee :
    • Les configurations de cluster minimales sont les suivantes :
      Configuration Pool de nœuds avec état Pool de nœuds sans état
      Nombre de nœuds 3 (par région) 3 (par région)
      Processeur 4 4
      RAM 15 15
      Nom de l'étiquette par défaut apigee-data apigee-runtime
      Stockage dynamic Gestion avec le CRD ApigeeDeployment

      Pour en savoir plus sur la configuration minimale du cluster, consultez la section Configurations de base du cluster.

    • Créez au moins deux pools de nœuds :
      Nom du pool de nœuds par défaut Description
      apigee-data Un pool de nœuds avec état.
      apigee-runtime Un pool de nœuds sans état.

      Pour en savoir plus sur la configuration des pools de nœuds, consultez la page Configurer des pools de nœuds dédiés.

  2. Vérifiez la version d'AKS compatible avec cette version de l'environnement hybride 1.6.9 :
  3. Servez-vous de l'un des ensembles d'instructions suivants pour créer un cluster :

EKS

Créer un cluster

  1. Rassemblez les exigences de cluster pour le cluster hybride Apigee :
    • Les configurations de cluster minimales sont les suivantes :
      Configuration Pool de nœuds avec état Pool de nœuds sans état
      Nombre de nœuds 3 (par région) 3 (par région)
      Processeur 4 4
      RAM 15 15
      Nom de l'étiquette par défaut apigee-data apigee-runtime
      Stockage dynamic Gestion avec le CRD ApigeeDeployment

      Pour en savoir plus sur la configuration minimale du cluster, consultez la section Configurations de base du cluster.

    • Créez au moins deux pools de nœuds :
      Nom du pool de nœuds par défaut Description
      apigee-data Un pool de nœuds avec état.
      apigee-runtime Un pool de nœuds sans état.

      Pour en savoir plus sur la configuration des pools de nœuds, consultez la page Configurer des pools de nœuds dédiés.

  2. Vérifiez la version d'EKS compatible avec cette version de l'environnement hybride 1.6.9 :
  3. Procédez comme suit pour créer un cluster d'utilisateur :

Une fois le cluster installé et en cours d'exécution, passez à l'étape suivante.

GKE sur AWS

Créer un cluster

  1. Rassemblez les exigences de cluster pour le cluster hybride Apigee :
    • Les configurations de cluster minimales sont les suivantes :
      Configuration Pool de nœuds avec état Pool de nœuds sans état
      Nombre de nœuds 3 (par région) 3 (par région)
      Processeur 4 4
      RAM 15 15
      Nom de l'étiquette par défaut apigee-data apigee-runtime
      Stockage dynamic Gestion avec le CRD ApigeeDeployment

      Pour en savoir plus sur la configuration minimale du cluster, consultez la section Configurations de base du cluster.

    • Créez au moins deux pools de nœuds :
      Nom du pool de nœuds par défaut Description
      apigee-data Un pool de nœuds avec état.
      apigee-runtime Un pool de nœuds sans état.

      Pour en savoir plus sur la configuration des pools de nœuds, consultez la page Configurer des pools de nœuds dédiés.

  2. Vérifiez la version de GKE compatible avec cette version de l'environnement hybride 1.6.9 :
  3. Procédez comme suit pour créer un cluster d'utilisateur :

Une fois le cluster installé et en cours d'exécution, passez à l'étape suivante.

OpenShift

Créer un cluster

  1. Rassemblez les exigences de cluster pour le cluster hybride Apigee :
    • Les configurations de cluster minimales sont les suivantes :
      Configuration Pool de nœuds avec état Pool de nœuds sans état
      Nombre de nœuds 3 (par région) 3 (par région)
      Processeur 4 4
      RAM 15 15
      Nom de l'étiquette par défaut apigee-data apigee-runtime
      Stockage dynamic Gestion avec le CRD ApigeeDeployment

      Pour en savoir plus sur la configuration minimale du cluster, consultez la section Configurations de base du cluster.

    • Créez au moins deux pools de nœuds :
      Nom du pool de nœuds par défaut Description
      apigee-data Un pool de nœuds avec état.
      apigee-runtime Un pool de nœuds sans état.

      Pour en savoir plus sur la configuration des pools de nœuds, consultez la page Configurer des pools de nœuds dédiés.

  2. Vérifiez la version de GKE compatible avec cette version de l'environnement hybride 1.6.9 :
  3. Suivez les instructions ci-dessous pour installer Apigee sur votre cluster d'utilisateur OpenShift et l'enregistrer auprès de GKE Hub.
    1. Installez et configurez l'outil CLI oc. Consultez la section Premiers pas avec la CLI OpenShift dans la documentation OpenShift.
    2. Enregistrez-vous auprès de GKE Hub
      1. Créez un fichier nommé gke-connect-scc.yaml avec le contenu suivant :
        # 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. Créez le composant dans oc à l'aide de la commande suivante :
        oc create -f gke-connect-scc.yaml
      3. Créez les variables d'environnement pour le contexte à l'aide des commandes suivantes :
        export KUBECONFIG=<> # Cluster kubeconfig file path
        export CONTEXT=admin
      4. Enregistrez-vous auprès de GKE Hub à l'aide de la commande suivante :
        gcloud --project=${PROJECT_ID} container hub memberships register ${CLUSTER_NAME} \
          --kubeconfig=${KUBECONFIG} \
          --context=${CONTEXT} \
          --service-account-key-file=KEY_FILE_PATH

        Où :

        • PROJECT_ID correspond à votre ID de projet Google Cloud.
        • CLUSTER_NAME est le nom du cluster que vous venez de créer.
        • KUBECONFIG est le chemin d'accès au fichier kubeconfig de votre cluster.
        • CONTEXT est le contexte dans lequel gcloud enregistre le cluster. CONTEXT doit être défini sur admin pour cette commande.
        • KEY_FILE_PATH est le chemin d'accès au fichier de clé de votre compte de service, par exemple ./dist/apigee-my-project-ro-sa.json. Le compte de service doit disposer des deux rôles IAM suivants :
          • Administrateur de GKE Hub
          • Agent GKE Connect

Une fois qu'un cluster est installé et enregistré auprès de GKE Hub, passez à l'étape suivante.

 

1 (SUITE) Étape 2 : Installer cert-manager 3 4 5 6 7 8 9