Étape 1 : Créer un cluster

Vous consultez actuellement la version 1.10 de la documentation d'Apigee hybrid. Pour en savoir plus, consultez la section Versions compatibles.

Version 1.10 

   Versions compatibles :

• v1.13 (la plus récente)
• v1.12
• v1.11                         
• Liste des versions compatibles

   Versions non compatibles :

• v1.10
• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

Mise à niveau : Si vous passez à la version 1.10.5 d'Apigee hybrid, consultez la page Mettre à niveau Apigee hybrid pour obtenir des instructions. Si vous effectuez une nouvelle installation, passez aux configurations décrites ci-dessous.

Cette étape explique comment créer 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. Avant de commencer, veillez à lire les informations suivantes :

• Configurations de base du cluster
• Configurer des pools de nœuds dédiés
• Configurer Cassandra pour la production
• Configurer l'authentification pour Cassandra
• Configuration de StorageClass
• Utilisation des ports sécurisés

Remarque : Vous pouvez créer un cluster dédié pour Apigee hybrid ou l'installer dans un cluster qui exécute d'autres charges de travail. La création d'un cluster dédié Apigee hybrid renforce l'isolation et simplifie l'effort global nécessaire pour gérer le cluster et ses charges de travail Apigee hybrid.

Si vous installez Apigee hybrid dans un cluster exécutant d'autres charges de travail, vous devez mettre à niveau et gérer votre cluster avec les versions et les fonctionnalités requises en commun par Apigee hybrid et vos autres charges de travail. Vous pouvez développer un plan pour migrer une ou plusieurs charges de travail en cas de conflits entre les versions compatibles et les exigences.

Dans la suite des instructions d'installation, nous supposons que vous effectuez l'installation sur un cluster dédié.

Créer votre cluster

Suivez les étapes pour votre plate-forme.

GKE

Créer un cluster sur GKE

Ces étapes expliquent comment configurer et créer un cluster GKE dans votre projet Google Cloud.

Attention : Apigee n'est pas compatible avec GKE Sandbox, ni avec gVisor pour les installations hybrides sur GKE.

Apigee vous recommande de créer un cluster régional plutôt qu'un cluster zonal. Si vous ne connaissez pas la distinction entre les régions et les zones, consultez la page Régions et zones. Les régions disponibles sont répertoriées dans la section Régions et zones disponibles. Sachez simplement que, par exemple, us-west1 est un nom de région valide, tandis que us-west1-a est une zone de la région.

1. Assurez-vous d'utiliser une version de GKE compatible avec la version 1.10.5 d'Apigee hybrid. Consultez Plates-formes et versions compatibles avec Apigee hybrid.
2. Assurez-vous que les horloges de tous les nœuds et serveurs d'applications sont synchronisées avec le protocole NTP (Network Time Protocol), comme expliqué dans la section Prérequis. La base de données Cassandra s'appuie sur la synchronisation NTP (Network Time Protocol) pour maintenir la cohérence des données. Si vous envisagez d'installer Apigee hybrid dans plusieurs régions, assurez-vous qu'elles sont synchronisées avec NTP dans toutes les régions.
3. (Clusters privés GKE uniquement) Si vous créez un cluster privé, ajoutez une règle de pare-feu afin d'autoriser le port 9443 pour la communication entre les nœuds maîtres GKE et les nœuds de calcul GKE et permettre aux maîtres GKE d'accéder aux webhooks de mutation Apigee. Suivez la procédure décrite à la section Ajouter des règles de pare-feu pour des cas d'utilisation spécifiques dans la documentation de Google Kubernetes Engine. Pour en savoir plus, consultez la section Clusters privés dans GKE.

   Vous n'avez pas besoin d'ajouter cette règle si vous créez un cluster standard ou public.

4. Créez un cluster standard en suivant les instructions de la section Créer un cluster régional comportant un pool de nœuds multizone. Vous pouvez créer le cluster avec le pool de nœuds par défaut uniquement. Vous allez configurer et créer les pools de nœuds Apigee hybrid requis à l'étape suivante.
   Important : Créez un cluster standard au lieu d'un cluster Autopilot. Apigee hybrid n'est pas compatible avec les clusters Autopilot, car ceux-ci ne sont pas compatibles avec les pools de nœuds personnalisés. Si vous utilisez l'interface utilisateur de la console Google Cloud, veillez à sélectionner SWITCH TO STANDARD CLUSTER (Passer au cluster standard).
   Conseil : Si vous ne créez pas votre cluster dans le réseau par défaut, suivez les instructions de la section Créer un cluster dans un sous-réseau existant
   .

   Ne passez à l'étape suivante qu'une fois le cluster créé.

5. Créez deux pools de nœuds en suivant les instructions de la section Ajouter et gérer des pools de nœuds. Veillez à configurer les pools de nœuds avec les exigences minimales répertoriées dans le tableau ci-dessous.

   Ce que vous devez savoir sur les pools de nœuds

   Remarque : Nous vous recommandons d'utiliser les noms apigee-data et apigee-runtime pour les pools de nœuds. Apigee hybrid reconnaît ces noms par défaut. Si vous ne souhaitez pas utiliser les noms par défaut, vous devrez effectuer une configuration supplémentaire lorsque vous configurerez le cluster pour Apigee hybrid. Pour en savoir plus, y compris les instructions concernant la modification des noms de pool de nœuds par défaut en modifiant votre fichier de configuration de cluster, consultez la page Utiliser les sélecteurs de nœuds par défaut.

   Nous vous recommandons de consulter les informations suivantes sur les pools de nœuds et leur configuration avant de continuer :

   • À propos des pools de nœuds
   • Configuration réseau requise pour Cassandra

   Configuration minimale d'un pool de nœuds

   Veillez à respecter ces exigences minimales lors de la création des pools de nœuds. Si vous utilisez la console Cloud, veillez à configurer les sections Détails du pool de nœuds et Nœuds.

   Remarque : Les valeurs de configuration du pool de nœuds décrites dans le tableau suivant représentent des valeurs minimales. Cette configuration minimale convient aux tests. Toutefois, en fonction de vos besoins, vous pouvez redimensionner les nœuds maintenant ou ultérieurement. Pour en savoir plus sur la gestion des nœuds de cluster, consultez la page Ajouter et gérer des pools de nœuds.

   Nom du pool de nœuds	Description	Nombre minimal de nœuds	Type de machine minimal
   apigee-data	Un pool de nœuds avec état utilisé pour la base de données Cassandra.	1 par zone (3 par région)	e2-standard-4 (4 vCPU, 16 Go de mémoire)
   apigee-runtime	Un pool de nœuds sans état utilisé par le processeur de messages d'exécution.	1 par zone (3 par région)	e2-standard-4 (4 vCPU, 16 Go de mémoire)

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

6. (Facultatif) Si vous le souhaitez, vous pouvez supprimer le pool de nœuds default. Consultez la page Supprimer un pool de nœuds.
7. Créez les variables d'environnement suivantes. Ces variables sont utilisées dans les commandes gcloud qui suivent.

   Linux/MacOS

   export CLUSTER_NAME="YOUR_CLUSTER_NAME"
   export CLUSTER_LOCATION="YOUR_CLUSTER_LOCATION"

   Windows

   set CLUSTER_NAME="YOUR_CLUSTER_NAME"
   set CLUSTER_LOCATION=YOUR_CLUSTER_LOCATION
   set PROJECT_ID=YOUR_PROJECT_ID

   Où :

   • CLUSTER_NAME : nom de votre cluster.
   • CLUSTER_LOCATION : région dans laquelle vous avez créé votre cluster.
8. Vérifiez les configurations du pool de nœuds :

   Clusters régionaux

   gcloud container node-pools list \
   --cluster=${CLUSTER_NAME} \
   --region=${CLUSTER_LOCATION} \
   --project=${PROJECT_ID}

   Cluster zonal

   gcloud container node-pools list \
   --cluster=${CLUSTER_NAME} \
   --zone=${CLUSTER_LOCATION} \
   --project=${PROJECT_ID}

9. Assurez-vous que votre cluster est défini comme cluster par défaut pour kubectl en obtenant les
   Identifiants gcloud du cluster que vous venez de créer :

   Clusters régionaux

     gcloud container clusters get-credentials ${CLUSTER_NAME} \
       --region ${CLUSTER_LOCATION} \
       --project ${PROJECT_ID}

   Cluster zonal

     gcloud container clusters get-credentials ${CLUSTER_NAME} \
       --zone ${CLUSTER_LOCATION} \
       --project ${PROJECT_ID}

   Consultez Définir un cluster par défaut pour les commandes kubectl.

10. Configurez le disque SSD persistant pour Cassandra. L'utilisation des disques SSD locaux n'est pas prise en charge. Pour plus d'informations, consultez la section Modifier la classe de stockage par défaut dans la documentation de Kubernetes.

    1. Obtenez le nom de la classe StorageClass actuelle par défaut :

       kubectl get sc

       Exemple :

       kubectl get sc
         NAME                    PROVISIONER             RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
         premium-rwo             pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h
         standard                kubernetes.io/gce-pd    Delete          Immediate              true                   15h
         standard-rwo (default)  pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h

    2. Décrivez la StorageClass nommée standard-rwo. Notez que son type est pd-balanced :

       kubectl describe sc standard-rwo

       Exemple :

       kubectl describe sc standard-rwo

       Name:                  standard-rwo
         IsDefaultClass:        Yes
         Annotations:           components.gke.io/layer=addon,storageclass.kubernetes.io/is-default-class=false
         Provisioner:           pd.csi.storage.gke.io
         Parameters:            type=pd-balanced
         AllowVolumeExpansion:  True
         MountOptions:          <none>
         ReclaimPolicy:         Delete
         VolumeBindingMode:     WaitForFirstConsumer
         Events:                <none>

    3. Créez un fichier appelé storageclass.yaml.
    4. Ajoutez ce code au fichier. Notez que le nom de la nouvelle classe est apigee-sc. Vous pouvez utiliser n'importe quel nom. Notez également que le type de stockage est pd-ssd :

       ---
       kind: StorageClass
       apiVersion: storage.k8s.io/v1
       metadata:
         name: "apigee-sc"
       provisioner: kubernetes.io/gce-pd
       parameters:
         type: pd-ssd
         replication-type: none
       volumeBindingMode: WaitForFirstConsumer
       allowVolumeExpansion: true

    5. Appliquez la nouvelle StorageClass à votre cluster Kubernetes :

       kubectl apply -f storageclass.yaml

    6. Exécutez les deux commandes suivantes pour modifier la StorageClass par défaut :

       kubectl patch storageclass standard-rwo \
       -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"false"}}}'

       kubectl patch storageclass apigee-sc \
       -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'

    7. Exécutez cette commande pour vérifier que la nouvelle StorageClass par défaut est appelée apigee-sc :

       kubectl get sc

       Exemple :

       kubectl get sc
         NAME                  PROVISIONER             RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
         apigee-sc (default)   kubernetes.io/gce-pd    Delete          WaitForFirstConsumer   true                   14h
         premium-rwo           pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h
         standard              kubernetes.io/gce-pd    Delete          Immediate              true                   15h
         standard-rwo          pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h

11. Activer Workload Identity pour le cluster Workload Identity permet aux charges de travail de vos clusters GKE d'emprunter l'identité des comptes de service Identity and Access Management (IAM) pour accéder aux services Google Cloud. Cette opération peut prendre jusqu'à 30 minutes.

    Clusters régionaux

    gcloud container clusters update ${CLUSTER_NAME} \
      --workload-pool=${PROJECT_ID}.svc.id.goog \
      --project ${PROJECT_ID} \
      --region ${CLUSTER_LOCATION}

    Cluster zonal

    gcloud container clusters update ${CLUSTER_NAME} \
      --workload-pool=${PROJECT_ID}.svc.id.goog \
      --zone ${CLUSTER_LOCATION} \
      --project ${PROJECT_ID}

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

12. Vérifiez à l'aide de la commande suivante si Workload Identity a bien été activé :

    Clusters régionaux

    gcloud container clusters describe ${CLUSTER_NAME} \
      --project ${PROJECT_ID} \
      --region ${CLUSTER_LOCATION} | grep -i "workload"

    Cluster zonal

    gcloud container clusters describe ${CLUSTER_NAME} \
      --zone ${CLUSTER_LOCATION} \
      --project ${PROJECT_ID} | grep -i "workload"

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

GKE On-Prem

Créer un cluster sur GKE On-Prem

Ces étapes expliquent comment configurer et créer un cluster GKE On-Prem pour Apigee hybrid.

1. Assurez-vous d'utiliser une version d'Anthos sur site ou d'Anthos sur VMWare compatible avec la version 1.10.5 d'Apigee hybrid. Consultez Plates-formes et versions compatibles avec Apigee hybrid.
2. Assurez-vous que les horloges de tous les nœuds et serveurs d'applications sont synchronisées avec le protocole NTP (Network Time Protocol), comme expliqué dans la section Prérequis. La base de données Cassandra s'appuie sur la synchronisation NTP (Network Time Protocol) pour maintenir la cohérence des données. Si vous prévoyez d'installer Apigee hybrid dans plusieurs régions, assurez-vous qu'elles sont toutes synchronisées à l'aide du protocole NTP.
3. Créez le cluster en suivant les instructions de la section Créer des clusters de base. Vous pouvez créer le cluster avec le pool de nœuds par défaut uniquement. Vous allez configurer et créer les pools de nœuds Apigee hybrid requis à l'étape suivante.

   Ne passez à l'étape suivante qu'une fois le cluster créé.

4. Créez deux pools de nœuds en suivant les instructions de la page Créer et gérer des pools de nœuds. Configurez les pools de nœuds en respectant les exigences minimales répertoriées dans le tableau ci-dessous.

   Ce que vous devez savoir sur les pools de nœuds

   Remarque : Nous vous recommandons d'utiliser les noms apigee-data et apigee-runtime pour les pools de nœuds. Apigee hybrid reconnaît ces noms par défaut. Si vous ne souhaitez pas utiliser les noms par défaut, vous devrez effectuer une configuration supplémentaire lorsque vous configurerez le cluster pour Apigee hybrid. Pour en savoir plus, y compris les instructions concernant la modification des noms de pool de nœuds par défaut en modifiant votre fichier de configuration de cluster, consultez la page Utiliser les sélecteurs de nœuds par défaut.

   Nous vous recommandons de consulter les informations suivantes sur les pools de nœuds et leur configuration avant de continuer :

   • À propos des pools de nœuds
   • Configuration réseau requise pour Cassandra

   Configuration minimale d'un pool de nœuds

   Veillez à respecter ces exigences minimales lors de la création des pools de nœuds.

   Remarque : Les valeurs de configuration du pool de nœuds décrites dans le tableau suivant représentent des valeurs minimales. Cette configuration minimale convient aux tests. Toutefois, en fonction de vos besoins, vous pouvez redimensionner les nœuds maintenant ou ultérieurement. Pour en savoir plus sur la gestion des nœuds de cluster, consultez la page Ajouter et gérer des pools de nœuds.

   Nom du pool de nœuds	Description	Nombre minimal de nœuds	Type de machine minimal
   apigee-data	Un pool de nœuds avec état utilisé pour la base de données Cassandra.	1 par zone (3 par région)	e2-standard-4 (4 vCPU, 16 Go de mémoire)
   apigee-runtime	Un pool de nœuds sans état utilisé par le processeur de messages d'exécution.	1 par zone (3 par région)	e2-standard-4 (4 vCPU, 16 Go de mémoire)

   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. (Facultatif) Si vous le souhaitez, vous pouvez supprimer le pool de nœuds default. Consultez la page Supprimer un pool de nœuds.

6. Configurez le disque SSD persistant pour Cassandra. L'utilisation des disques SSD locaux n'est pas prise en charge. Pour plus d'informations, consultez la section Modifier la classe de stockage par défaut dans la documentation de Kubernetes.

   1. Obtenez le nom de la classe StorageClass actuelle par défaut :

      kubectl get sc

      Exemple :

      kubectl get sc
        NAME                    PROVISIONER             RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
        premium-rwo             pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h
        standard                kubernetes.io/gce-pd    Delete          Immediate              true                   15h
        standard-rwo (default)  pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h

   2. Décrivez la StorageClass nommée standard-rwo. Notez que son type est pd-balanced :

      kubectl describe sc standard-rwo

      Exemple :

      kubectl describe sc standard-rwo

      Name:                  standard-rwo
      IsDefaultClass:        Yes
      Annotations:           components.gke.io/layer=addon,storageclass.kubernetes.io/is-default-class=false
      Provisioner:           pd.csi.storage.gke.io
      Parameters:            type=pd-balanced
      AllowVolumeExpansion:  True
      MountOptions:          <none>
      ReclaimPolicy:         Delete
      VolumeBindingMode:     WaitForFirstConsumer
      Events:                <none>

   3. Créez un fichier appelé storageclass.yaml.
   4. Ajoutez ce code au fichier. Notez que le nom de la nouvelle classe est apigee-sc. Vous pouvez utiliser n'importe quel nom. Notez également que le type de stockage est pd-ssd :

      ---
      kind: StorageClass
      apiVersion: storage.k8s.io/v1
      metadata:
        name: "apigee-sc"
      provisioner: kubernetes.io/gce-pd
      parameters:
        type: pd-ssd
        replication-type: none
      volumeBindingMode: WaitForFirstConsumer
      allowVolumeExpansion: true

   5. Appliquez la nouvelle StorageClass à votre cluster Kubernetes :

      kubectl apply -f storageclass.yaml

   6. Exécutez les deux commandes suivantes pour modifier la StorageClass par défaut :

      kubectl patch storageclass standard-rwo \
        -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"false"}}}'

      kubectl patch storageclass apigee-sc \
        -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'

   7. Exécutez cette commande pour vérifier que la nouvelle StorageClass par défaut est appelée apigee-sc :

      kubectl get sc

      Exemple :

      kubectl get sc
        NAME                  PROVISIONER             RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
        apigee-sc (default)   kubernetes.io/gce-pd    Delete          WaitForFirstConsumer   true                   14h
        premium-rwo           pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h
        standard              kubernetes.io/gce-pd    Delete          Immediate              true                   15h
        standard-rwo          pd.csi.storage.gke.io   Delete          WaitForFirstConsumer   true                   15h

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

Anthos sur bare metal

Créer un cluster sur Anthos sur bare metal

Ces étapes expliquent comment configurer et créer un cluster pour Apigee hybrid sur Anthos sur bare metal. Les clusters Anthos sur bare metal vous permettent d'exécuter des clusters Kubernetes directement sur vos propres ressources machine.

1. Assurez-vous d'utiliser une version d'Anthos sur bare metal compatible avec la version 1.10.5 d'Apigee hybrid. Consultez Plates-formes et versions compatibles avec Apigee hybrid.
2. Assurez-vous que les horloges de tous les nœuds et serveurs d'applications sont synchronisées avec le protocole NTP (Network Time Protocol), comme expliqué dans la section Prérequis. La base de données Cassandra s'appuie sur la synchronisation NTP (Network Time Protocol) pour maintenir la cohérence des données. Si vous prévoyez d'installer Apigee hybrid dans plusieurs régions, assurez-vous qu'elles sont toutes synchronisées à l'aide du protocole NTP.
3. Consultez les pages Présentation des conditions préalables à l'installation et Créer des clusters : présentation.
4. Créez le cluster avec deux pools de nœuds configurés comme décrit ci-dessous :
   • Suivez les instructions de création du cluster du guide de démarrage rapide des clusters Anthos sur bare metal.
   • Créez au moins deux pools de nœuds : Configurez les pools de nœuds en respectant les exigences minimales répertoriées dans le tableau ci-dessous.

     Ce que vous devez savoir sur les pools de nœuds

     Remarque : Nous vous recommandons d'utiliser les noms apigee-data et apigee-runtime pour les pools de nœuds. Apigee hybrid reconnaît ces noms par défaut. Si vous ne souhaitez pas utiliser les noms par défaut, vous devrez effectuer une configuration supplémentaire lorsque vous configurerez le cluster pour Apigee hybrid. Pour en savoir plus, y compris les instructions concernant la modification des noms de pool de nœuds par défaut en modifiant votre fichier de configuration de cluster, consultez la page Utiliser les sélecteurs de nœuds par défaut.

     Nous vous recommandons de consulter les informations suivantes sur les pools de nœuds et leur configuration avant de continuer :

     • Configurer des pools de nœuds dédiés
     • À propos des pools de nœuds
     • Configuration réseau requise pour Cassandra

     Les configurations de cluster minimales sont les suivantes :

     Remarque : Les valeurs de configuration du pool de nœuds décrites dans le tableau suivant représentent des valeurs minimales. Cette configuration minimale convient aux tests. Toutefois, en fonction de vos besoins, vous pouvez redimensionner les nœuds maintenant ou ultérieurement.

     Configuration	Pool de nœuds avec état	Pool de nœuds sans état
     Objectif	Un pool de nœuds avec état utilisé pour la base de données Cassandra.	Un pool de nœuds sans état utilisé par le processeur de messages d'exécution.
     Nom du libellé	apigee-data	apigee-runtime
     Nombre de nœuds	1 par zone (3 par région)	1 par zone (3 par région)
     Processeur	4	4
     RAM	15	15
     Stockage	dynamic	Gestion avec le CRD ApigeeDeployment
     IOPS du disque minimales	2 000 IOPS avec stockage SAN ou associé directement NFS n'est pas recommandé, même s'il peut accepter les IOPS requises.	2 000 IOPS avec stockage SAN ou associé directement NFS n'est pas recommandé, même s'il peut accepter les IOPS requises.
     Bande passante réseau pour chaque type d'instance de machine	1 Gbit/s	1 Gbit/s

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

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

AKS

Créer un cluster sur AKS

Ces étapes expliquent comment configurer et créer un cluster pour Apigee hybrid sur AKS.

1. Assurez-vous d'utiliser une version d'AKS compatible avec la version 1.10.5 d'Apigee hybrid. Consultez Plates-formes et versions compatibles avec Apigee hybrid.
2. Assurez-vous que les horloges de tous les nœuds et serveurs d'applications sont synchronisées avec le protocole NTP (Network Time Protocol), comme expliqué dans la section Prérequis. La base de données Cassandra s'appuie sur la synchronisation NTP (Network Time Protocol) pour maintenir la cohérence des données. Si vous prévoyez d'installer Apigee hybrid dans plusieurs régions, assurez-vous qu'elles sont toutes synchronisées à l'aide du protocole NTP.
3. Créez le cluster à l'aide de la CLI Azure ou du portail Azure, puis créez deux pools de nœuds comme décrit ci-dessous.

   Ce que vous devez savoir sur les pools de nœuds

   Remarque : Nous vous recommandons d'utiliser les noms apigee-data et apigee-runtime pour les pools de nœuds. Apigee hybrid reconnaît ces noms par défaut. Si vous ne souhaitez pas utiliser les noms par défaut, vous devrez effectuer une configuration supplémentaire lorsque vous configurerez le cluster pour Apigee hybrid. Pour en savoir plus, y compris les instructions concernant la modification des noms de pool de nœuds par défaut en modifiant votre fichier de configuration de cluster, consultez la page Utiliser les sélecteurs de nœuds par défaut.

   Nous vous recommandons de consulter les informations suivantes sur les pools de nœuds et leur configuration avant de continuer :

   • Configurer des pools de nœuds dédiés
   • À propos des pools de nœuds
   • Configuration réseau requise pour Cassandra

   Les configurations de cluster minimales sont les suivantes :

   Remarque : Les valeurs de configuration du pool de nœuds décrites dans le tableau suivant représentent des valeurs minimales. Cette configuration minimale convient aux tests. Toutefois, en fonction de vos besoins, vous pouvez redimensionner les nœuds maintenant ou ultérieurement. Pour en savoir plus sur la gestion des nœuds de cluster, consultez la page Ajouter et gérer des pools de nœuds AKS.

   Configuration	Pool de nœuds avec état	Pool de nœuds sans état
   Objectif	Un pool de nœuds avec état utilisé pour la base de données Cassandra.	Un pool de nœuds sans état utilisé par le processeur de messages d'exécution.
   Nom du libellé	apigee-data	apigee-runtime
   Nombre de nœuds	1 par zone (3 par région)	1 par zone (3 par région)
   Processeur	4	4
   RAM	15	15
   Stockage	dynamic	Gestion avec le CRD ApigeeDeployment
   IOPS du disque minimales	2 000 IOPS avec stockage SAN ou associé directement NFS n'est pas recommandé, même s'il peut accepter les IOPS requises.	2 000 IOPS avec stockage SAN ou associé directement NFS n'est pas recommandé, même s'il peut accepter les IOPS requises.
   Bande passante réseau pour chaque type d'instance de machine	1 Gbit/s	1 Gbit/s

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

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

EKS

Créer un cluster sur EKS

Ces étapes expliquent comment configurer et créer un cluster pour Apigee hybrid sur EKS.

1. Assurez-vous d'utiliser une version d'EKS compatible avec la version 1.10.5 d'Apigee hybrid. Consultez Plates-formes et versions compatibles avec Apigee hybrid.
2. Assurez-vous que les horloges de tous les nœuds et serveurs d'applications sont synchronisées avec le protocole NTP (Network Time Protocol), comme expliqué dans la section Prérequis. La base de données Cassandra s'appuie sur la synchronisation NTP (Network Time Protocol) pour maintenir la cohérence des données. Si vous prévoyez d'installer Apigee hybrid dans plusieurs régions, assurez-vous qu'elles sont toutes synchronisées à l'aide du protocole NTP.
3. Si vous utilisez Kubernetes 1.24 ou une version ultérieure, assurez-vous d'avoir installé le pilote CSI Kubernetes pour Amazon EBS.
4. Suivez les instructions pour créer un cluster d'utilisateur et deux pools de nœuds, comme décrit ci-dessous.
   • Documentation de présentation d'EKS
   • Créer un cluster Amazon EKS

   Ce que vous devez savoir sur les pools de nœuds

   Remarque : Nous vous recommandons d'utiliser les noms apigee-data et apigee-runtime pour les pools de nœuds. Apigee hybrid reconnaît ces noms par défaut. Si vous ne souhaitez pas utiliser les noms par défaut, vous devrez effectuer une configuration supplémentaire lorsque vous configurerez le cluster pour Apigee hybrid. Pour en savoir plus, y compris les instructions concernant la modification des noms de pool de nœuds par défaut en modifiant votre fichier de configuration de cluster, consultez la page Utiliser les sélecteurs de nœuds par défaut.

   Nous vous recommandons de consulter les informations suivantes sur les pools de nœuds et leur configuration avant de continuer :

   • Configurer des pools de nœuds dédiés
   • À propos des pools de nœuds
   • Configuration réseau requise pour Cassandra

   Les configurations de cluster minimales sont les suivantes :

   Remarque : Les valeurs de configuration du pool de nœuds décrites dans le tableau suivant représentent des valeurs minimales. Cette configuration minimale convient aux tests. Toutefois, en fonction de vos besoins, vous pouvez redimensionner les nœuds maintenant ou ultérieurement. Pour en savoir plus sur la gestion des nœuds de cluster, consultez la page Ajouter et gérer des pools de nœuds.

   Configuration	Pool de nœuds avec état	Pool de nœuds sans état
   Objectif	Un pool de nœuds avec état utilisé pour la base de données Cassandra.	Un pool de nœuds sans état utilisé par le processeur de messages d'exécution.
   Nom du libellé	apigee-data	apigee-runtime
   Nombre de nœuds	1 par zone (3 par région)	1 par zone (3 par région)
   Processeur	4	4
   RAM	15	15
   Stockage	dynamic	Gestion avec le CRD ApigeeDeployment
   IOPS du disque minimales	2 000 IOPS avec stockage SAN ou associé directement NFS n'est pas recommandé, même s'il peut accepter les IOPS requises.	2 000 IOPS avec stockage SAN ou associé directement NFS n'est pas recommandé, même s'il peut accepter les IOPS requises.
   Bande passante réseau pour chaque type d'instance de machine	1 Gbit/s	1 Gbit/s

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

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

GKE sur AWS

Créer un cluster sur GKE sur AWS

Ces étapes expliquent comment configurer et créer un cluster pour Apigee hybrid sur GKE sur AWS.

1. Assurez-vous d'utiliser une version de GKE compatible avec la version 1.10.5 d'Apigee hybrid. Consultez Plates-formes et versions compatibles avec Apigee hybrid.
2. Assurez-vous que les horloges de tous les nœuds et serveurs d'applications sont synchronisées avec le protocole NTP (Network Time Protocol), comme expliqué dans la section Prérequis. La base de données Cassandra s'appuie sur la synchronisation NTP (Network Time Protocol) pour maintenir la cohérence des données. Si vous prévoyez d'installer Apigee hybrid dans plusieurs régions, assurez-vous qu'elles sont toutes synchronisées à l'aide du protocole NTP.
3. Suivez les instructions pour créer un cluster d'utilisateur et deux pools de nœuds, comme décrit ci-dessous.
   • Documentation de présentation de GKE sur AWS.
   • Déployez une application sur GKE sur AWS.

   Ce que vous devez savoir sur les pools de nœuds

   Remarque : Nous vous recommandons d'utiliser les noms apigee-data et apigee-runtime pour les pools de nœuds. Apigee hybrid reconnaît ces noms par défaut. Si vous ne souhaitez pas utiliser les noms par défaut, vous devrez effectuer une configuration supplémentaire lorsque vous configurerez le cluster pour Apigee hybrid. Pour en savoir plus, y compris les instructions concernant la modification des noms de pool de nœuds par défaut en modifiant votre fichier de configuration de cluster, consultez la page Utiliser les sélecteurs de nœuds par défaut.

   Nous vous recommandons de consulter les informations suivantes sur les pools de nœuds et leur configuration avant de continuer :

   • Configurer des pools de nœuds dédiés
   • À propos des pools de nœuds
   • Configuration réseau requise pour Cassandra

   Les configurations de cluster minimales sont les suivantes :

   Remarque : Les valeurs de configuration du pool de nœuds décrites dans le tableau suivant représentent des valeurs minimales. Cette configuration minimale convient aux tests. Toutefois, en fonction de vos besoins, vous pouvez redimensionner les nœuds maintenant ou ultérieurement. Pour en savoir plus sur la gestion des nœuds de cluster, consultez la page Ajouter et gérer des pools de nœuds.

   Configuration	Pool de nœuds avec état	Pool de nœuds sans état
   Objectif	Un pool de nœuds avec état utilisé pour la base de données Cassandra.	Un pool de nœuds sans état utilisé par le processeur de messages d'exécution.
   Nom du libellé	apigee-data	apigee-runtime
   Nombre de nœuds	1 par zone (3 par région)	1 par zone (3 par région)
   Processeur	4	4
   RAM	15	15
   Stockage	dynamic	Gestion avec le CRD ApigeeDeployment
   IOPS du disque minimales	2 000 IOPS avec stockage SAN ou associé directement NFS n'est pas recommandé, même s'il peut accepter les IOPS requises.	2 000 IOPS avec stockage SAN ou associé directement NFS n'est pas recommandé, même s'il peut accepter les IOPS requises.
   Bande passante réseau pour chaque type d'instance de machine	1 Gbit/s	1 Gbit/s

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

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

OpenShift

Créer un cluster sur OpenShift

Ces étapes expliquent comment configurer et créer un cluster pour Apigee hybrid sur OpenShift.

1. Assurez-vous d'utiliser une version d'OpenShift compatible avec la version 1.10.5 d'Apigee hybrid. Consultez Plates-formes et versions compatibles avec Apigee hybrid.
2. Assurez-vous que les horloges de tous les nœuds et serveurs d'applications sont synchronisées avec le protocole NTP (Network Time Protocol), comme expliqué dans la section Prérequis. La base de données Cassandra s'appuie sur la synchronisation NTP (Network Time Protocol) pour maintenir la cohérence des données. Si vous prévoyez d'installer Apigee hybrid dans plusieurs régions, assurez-vous qu'elles sont toutes synchronisées à l'aide du protocole NTP.
3. Créez le cluster OpenShift à déployer sur le plan d'exécution, installez Apigee sur votre cluster d'utilisateur OpenShift et créez deux pools de nœuds.
   Vous trouverez des informations supplémentaires sur la création et la gestion de clusters OpenShift dans Google Cloud dans la documentation OpenShift, par exemple : Installer rapidement un cluster sur Google Cloud.
   Pour obtenir de l'aide sur la configuration de votre cluster OpenShift sur les VM Google Cloud, consultez la page Configurer Apigee hybrid sur OpenShift sur des VM Google Cloud.

   Dans le cadre de l'installation d'OpenShift, installez et configurez l'outil CLI oc. Consultez la section Premiers pas avec la CLI OpenShift dans la documentation OpenShift.

   Ce que vous devez savoir sur les pools de nœuds

   Remarque : Nous vous recommandons d'utiliser les noms apigee-data et apigee-runtime pour les pools de nœuds. Apigee hybrid reconnaît ces noms par défaut. Si vous ne souhaitez pas utiliser les noms par défaut, vous devrez effectuer une configuration supplémentaire lorsque vous configurerez le cluster pour Apigee hybrid. Pour en savoir plus, y compris les instructions concernant la modification des noms de pool de nœuds par défaut en modifiant votre fichier de configuration de cluster, consultez la page Utiliser les sélecteurs de nœuds par défaut.

   Nous vous recommandons de consulter les informations suivantes sur les pools de nœuds et leur configuration avant de continuer :

   • Configurer des pools de nœuds dédiés
   • À propos des pools de nœuds
   • Configuration réseau requise pour Cassandra

   Les configurations de cluster minimales sont les suivantes :

   Remarque : Les valeurs de configuration du pool de nœuds décrites dans le tableau suivant représentent des valeurs minimales. Cette configuration minimale convient aux tests. Toutefois, en fonction de vos besoins, vous pouvez redimensionner les nœuds maintenant ou ultérieurement. Pour en savoir plus sur la gestion des nœuds de cluster, consultez la page Ajouter et gérer des pools de nœuds.

   Configuration	Pool de nœuds avec état	Pool de nœuds sans état
   Objectif	Un pool de nœuds avec état utilisé pour la base de données Cassandra.	Un pool de nœuds sans état utilisé par le processeur de messages d'exécution.
   Nom du libellé	apigee-data	apigee-runtime
   Nombre de nœuds	1 par zone (3 par région)	1 par zone (3 par région)
   Processeur	4	4
   RAM	15	15
   Stockage	dynamic	Gestion avec le CRD ApigeeDeployment
   IOPS du disque minimales	2 000 IOPS avec stockage SAN ou associé directement NFS n'est pas recommandé, même s'il peut accepter les IOPS requises.	2 000 IOPS avec stockage SAN ou associé directement NFS n'est pas recommandé, même s'il peut accepter les IOPS requises.
   Bande passante réseau pour chaque type d'instance de machine	1 Gbit/s	1 Gbit/s

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

Une fois le cluster installé, passez à l'étape suivante.

 

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