Étape 1 : Créer un cluster

Vous consultez actuellement la version 1.7 de la documentation d'Apigee hybrid. Cette version est en fin de vie. Vous devez passer à une version plus récente. Pour en savoir plus, consultez la section Versions compatibles.

Version 1.7 (unsupported)

   Supported versions:

• v1.12 (latest)                        
• v1.11                         
• v1.10                                        
• List of supported versions

   Unsupported versions:

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

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

Cliquez ici pour afficher les descriptions et les commandes permettant de définir les variables.

Cette procédure utilise les variables d'environnement suivantes :

• PROJECT_ID : ID de votre projet Google Cloud. Consultez l'étape 2 du guide de démarrage rapide d'Apigee hybrid : Créer un projet Google Cloud.

  export PROJECT_ID=your_project_ID

• CLUSTER_LOCATION : région dans laquelle vous allez créer votre cluster.

  export CLUSTER_LOCATION=cluster-region

  Remarque : Apigee vous recommande d'utiliser un nom de région et non un nom de zone. Une région est un emplacement géographique spécifique où vous pouvez héberger vos ressources. Les régions peuvent comporter plusieurs zones. Par exemple, la région us-west1 est une région de la côte ouest des États-Unis qui comprend les trois zones us-west1-a, us-west1-b et and us-west1-c. 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. Pour la plupart des installations hybrides, utilisez un nom de région pour la variable CLUSTER_LOCATION.
• ORG_NAME : nom de votre organisation. Celui-ci doit correspondre à l'ID de votre projet Google Cloud. Consultez l'étape 4 du guide de démarrage rapide d'Apigee hybrid : Créer une organisation.

  export ORG_NAME=your_organization_name

• ENV_NAME : nom de l'environnement hybride. Consultez l'étape 6 du guide de démarrage rapide d'Apigee hybrid : Créer un groupe d'environnements

  export ENV_NAME=your_environment_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 shell 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.

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
   Mémoire 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.7.6 :
   • Apigee hybrid : plates-formes compatibles
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.
     Conseil: Si vous utilisez Google Cloud Console pour créer votre cluster, ajoutez les pools de nœuds avant de cliquer sur Créer pour créer le cluster.
     Remarque : Apigee recommande de créer un cluster régional. Si vous préférez créer un cluster zonal, veillez à utiliser la zone lorsque les instructions demandent votre emplacement lors des étapes suivantes.
     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
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.

   Conseil:Après avoir créé les pools de nœuds, vous pouvez les vérifier à l'aide de la commande suivante:

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

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.

   Remarque : Si vous avez créé un cluster zonal au lieu d'un cluster régional, utilisez l'argument --zone au lieu de --region, comme dans la commande suivante :

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

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}

   Remarque : Si vous avez créé un cluster zonal au lieu d'un cluster régional, obtenez les identifiants à l'aide de la commande suivante :

   gcloud container clusters get-credentials ${CLUSTER_NAME} \
     --zone ${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
     Mémoire 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.7.6 :
   • Apigee hybrid : plates-formes compatibles
3. Procédez comme suit pour créer un cluster d'utilisateur :
   • Créez un cluster d'utilisateur (guide de démarrage rapide) dans la documentation GKE On-Prem.

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 :

• Configuration matérielle requise : Configurer le matériel pour les clusters Anthos sur solution Bare Metal
• Présentation des conditions préalables à l'installation

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
     Mémoire 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.7.6 :
   • Apigee hybrid : plates-formes compatibles
3. Suivez les instructions ci-dessous dans la documentation d'Anthos clusters on bare metal pour créer un cluster d'utilisateur :
   • Création de clusters : présentation.
   • Guide de démarrage rapide sur Anthos clusters on bare metal dans la documentation d'Anthos clusters on bare metal.

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
     Mémoire 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.7.6 :
   • Apigee hybrid : plates-formes compatibles
3. Servez-vous de l'un des ensembles d'instructions suivants pour créer un cluster :
   • Utilisation de la CLI Azure : Démarrage rapide : déployer un cluster de service Azure Kubernetes à l'aide de l'interface de ligne de commande Azure.
   • Utilisation du portail Azure : Démarrage rapide : déployer un cluster Azure Kubernetes Service (AKS) à l'aide du portail Azure.

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
     Mémoire 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.7.6 :
   • Apigee hybrid : plates-formes compatibles
3. Procédez comme suit pour créer un cluster d'utilisateur :
   • Documentation de présentation d'EKS
   • Créer un cluster Amazon EKS

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
     Mémoire 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.7.6 :
   • Apigee hybrid : plates-formes compatibles
3. Procédez comme suit pour créer un cluster d'utilisateur :
   • Documentation de présentation de GKE sur AWS.
   • Présentation de l'installation d'Anthos clusters on AWS.

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
     Mémoire 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'OpenShift compatible avec cette version de l'environnement hybride 1.7.6 :
   • Apigee hybrid : plates-formes compatibles
3. Créez le cluster OpenShift à déployer sur le plan d'exécution et installez Apigee sur votre cluster d'utilisateur OpenShift.
   Vous trouverez des informations supplémentaires sur la création et la gestion de clusters OpenShift dans GCP dans la documentation OpenShift, par exemple : Installer rapidement un cluster sur GCP.
   Pour obtenir de l'aide sur la configuration de votre cluster OpenShift sur les VM GCP, consultez la page Configurer Apigee hybrid sur OpenShift sur des VM GCP.

   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.

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

 

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