Étape 1 : Créer un cluster GKE

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

Configurer l'interface système de votre terminal

L'outil gcloud est l'interface de ligne de commande principale utilisée sur GCP, et kubectl fournit l'interface de ligne de commande principale permettant d'exécuter des commandes sur les clusters Kubernetes.

  1. Assurez-vous que gcloud et kubectl sont installés dans votre interface système locale. L'outil gcloud est l'interface de ligne de commande principale utilisée sur GCP, et kubectl fournit l'interface de ligne de commande principale permettant d'exécuter des commandes sur les clusters Kubernetes.

    gcloud -h
    kubectl -h
  2. Si vous n'avez pas installé ces utilitaires, installez-les maintenant :
    1. Installez le SDK Cloud, qui inclut l'outil de ligne de commande gcloud.
    2. Après avoir installé le SDK Cloud, installez l'outil de ligne de commande kubectl en exécutant la commande suivante :
    3. gcloud components install kubectl
  3. Utilisez l'outil gcloud pour configurer deux paramètres par défaut : votre projet par défaut et votre région de calcul. La configuration de ces paramètres facilite l'exécution des commandes gcloud, car gcloud vous demanderait sinon de spécifier à chaque fois le projet et la zone de calcul dans lesquels vous souhaitez travailler.

    Pour répertorier les paramètres actuels :

    gcloud config list

    Si un projet et/ou une zone de calcul ne sont pas répertoriés, vous devez les ajouter avec les commandes présentées ci-dessous. Si, dans les résultats, vous décidez que vous devez changer les paramètres actuels pour refléter votre projet et votre région (ou zone) de calcul, vous pouvez également exécuter les commandes suivantes :

    gcloud config set project project-id
    gcloud config set compute/region compute-region
    gcloud config set compute/zone compute-zone
    

    project-id est le nom de votre projet GCP, compute-region le nom d'une région de calcul GCP et compute-zone le nom d'une zone de calcul GCP. Exemple : compute/region us-central1 Pour obtenir la liste des zones et des régions de calcul, consultez la section Régions et zones disponibles.

Créer un cluster GKE

Au cours de cette étape, vous allez créer un cluster Kubernetes dans votre projet GCP (le projet que vous avez défini à l'aide de la commande gcloud config).

Exécutez la commande suivante pour créer le cluster. Le type de machine, le nombre de nœuds et les autres paramètres spécifiés dans la commande permettent de créer un cluster configuré de manière minimale et adapté à une installation d'essai d'Apigee hybrid :

gcloud container clusters create cluster-name \
--machine-type "n1-standard-4" --num-nodes "3" --enable-autoscaling --min-nodes "3" --max-nodes "6"

cluster-name est le nom que vous avez choisi pour le cluster.

La création du cluster peut prendre quelques minutes. Si l'opération réussit, un résultat semblable au suivant doit s'afficher, avec l'état RUNNING :

NAME           LOCATION       MASTER_VERSION  MASTER_IP     MACHINE_TYPE   NODE_VERSION   NUM_NODES  STATUS
apigee-hybrid  us-central1-a  1.13.11-gke.9   35.222.54.89  n1-standard-4  1.13.11-gke.9  3          RUNNING

Définir le contexte actuel

Un contexte est un groupe de paramètres d'accès. Chaque contexte contient un cluster Kubernetes, un utilisateur et un espace de noms. Le contexte actuel est le cluster par défaut actuel de kubectl : toutes les commandes kubectl s'exécutent sur ce cluster.

Vérifiez que le contexte gcloud actuel est défini sur le cluster que vous venez de créer.

  1. D'abord, répertoriez les contextes pour déterminer lequel est le contexte actuel. Dans l'exemple suivant, le contexte actuel est gke_hybrid-project_us-central1-a_apigee-hybrid. Le nom comprend le nom d'un projet GCP (hybrid-project), une région ou une zone (us-central1-a) et un nom de cluster (apigee-hybrid) :
    kubectl config get-contexts
    CURRENT   NAME                                             CLUSTER                                          AUTHINFO                                           NAMESPACE
    *         gke_hybrid-project_us-central1-a_apigee-hybrid   gke_hybrid-project_us-central1-a_apigee-hybrid   gke_hybrid-project_us-central1-a_apigee-hybrid
              gke_apigee-project_us-west1-a_apigee-cluster     gke_apigee-project_us-west1-a_apigee-cluster     gke_apigee-project_us-west1-a_apigee-cluster
    
    
  2. Si nécessaire, définissez le contexte actuel sur le cluster que vous venez de créer (dans lequel vous souhaitez installer Apigee hybrid). En supposant la sortie get-contexts précédente, si le nom du cluster que vous avez créé était apigee-cluster dans la région us-west1, vous basculez vers le contexte gke_apigee-project_us-west1-a_apigee-cluster comme suit :
    kubectl config use-context gke_apigee-project_us-west1-a_apigee-cluster

    gke_apigee-project_us-west1-a_apigee-cluster est le nom du contexte vers lequel basculer.

  3. Vérifiez le contexte actuel pour vous assurer qu'il est défini sur le cluster prévu. Exemple :
    kubectl config current-context
     gke_apigee-project_us-west1-a_apigee-cluster

Attribuez des identifiants au cluster

Les identifiants de cluster vous permettent d'accéder aux conteneurs s'exécutant dans le cluster. Extrayez vos identifiants et attribuez-vous le rôle cluster-admin :

  1. Extrayez les identifiants :
    gcloud container clusters get-credentials cluster-name

    cluster-name correspond au nom du cluster que vous avez créé (le cluster dans lequel vous souhaitez installer Apigee hybride).

  2. Définissez la liaison de rôle du cluster. Exécutez la commande suivante exactement comme indiqué ci-dessous :
    kubectl create clusterrolebinding cluster-admin-binding \
    --clusterrole cluster-admin --user $(gcloud config get-value account)

Résumé

Vous disposez maintenant d'un cluster Kubernetes s'exécutant dans votre projet GCP. Votre environnement shell est configuré et vous êtes prêt à installer le logiciel de plan d'exécution Apigee hybrid sur votre ordinateur local.

1 (SUIVANT) Étape 2 : Installer apigeectl 3 4