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.
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 -hkubectl -h
Si vous n'avez pas installé ces utilitaires, installez-les maintenant :
Après avoir installé le SDK Cloud, installez l'outil de ligne de commande kubectl en exécutant la commande suivante :
gcloud components install kubectl
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-idgcloud config set compute/region compute-regiongcloud config set compute/zone compute-zone
Où 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 :
Où 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.
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
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 :
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 :
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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/09/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/09/04 (UTC)."],[[["\u003cp\u003eThis guide provides instructions for setting up a shell environment and creating a Google Kubernetes Engine (GKE) cluster in a Google Cloud Platform (GCP) project, which is required for a trial Apigee hybrid installation.\u003c/p\u003e\n"],["\u003cp\u003eUsers must ensure they have both the \u003ccode\u003egcloud\u003c/code\u003e and \u003ccode\u003ekubectl\u003c/code\u003e command-line tools installed and configured, including setting the default project and compute region or zone using the \u003ccode\u003egcloud config\u003c/code\u003e command.\u003c/p\u003e\n"],["\u003cp\u003eA GKE cluster is created using the \u003ccode\u003egcloud container clusters create\u003c/code\u003e command, and the guide provides settings to create a minimally configured cluster suitable for a trial installation, while also warning that Apigee does not support GKE Sandbox or gVisor.\u003c/p\u003e\n"],["\u003cp\u003eAfter cluster creation, the current context for \u003ccode\u003ekubectl\u003c/code\u003e commands must be set to the newly created cluster to ensure that all subsequent commands are executed against it, using \u003ccode\u003ekubectl config use-context\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eFinally, the guide explains how to fetch cluster credentials using \u003ccode\u003egcloud container clusters get-credentials\u003c/code\u003e and how to grant the cluster-admin role to the user with \u003ccode\u003ekubectl create clusterrolebinding\u003c/code\u003e, in order to have the adequate access to the cluster.\u003c/p\u003e\n"]]],[],null,["# Step 1: Create a GKE cluster\n\n| You are currently viewing version 1.1 of the Apigee hybrid documentation. **This version is end of life.** You should upgrade to a newer version. For more information, see [Supported versions](/apigee/docs/hybrid/supported-platforms#supported-versions).\n\n\nThis step explains how to set up your shell environment and create a GKE cluster\nin your Google Cloud Platform (GCP) project.\n\nSet up your terminal shell\n--------------------------\n\nThe `gcloud` tool provides the primary command-line interface\nfor GCP, and `kubectl` provides the primary command-line interface for\nrunning commands against Kubernetes clusters.\n\n1. Be sure you have `gcloud` and `kubectl` installed in your\n local shell. The `gcloud` tool provides the primary command-line interface\n for GCP, and `kubectl` provides the primary command-line interface for\n running commands against Kubernetes clusters.\n\n gcloud -h\n kubectl -h\n\n2. If you do not have these utilities installed, install them now:\n 1. [Install the Cloud SDK](https://cloud.google.com/sdk/install), which includes the `gcloud` command-line tool.\n 2. After installing Cloud SDK, install the `kubectl` command-line tool by running the following command: \n\n ```\n gcloud components install kubectl\n ```\n3. Use the `gcloud` tool to configure two default settings: your default [project](https://cloud.google.com/resource-manager/docs/creating-managing-projects) and [compute region](https://cloud.google.com/compute/docs/regions-zones/#available). Configuring these settings makes it easier to run `gcloud` commands, because `gcloud` requires that you specify the project and compute zone in which you want to work.\n\n\n To list the current settings: \n\n ```\n gcloud config list\n ```\n\n\n If a project and/or compute zone is not listed, then you need to add them with the\n commands shown below. If, from the list output, you determine that you need to switch the current settings\n to reflect your project and compute region (or zone), you can also use these commands: \n\n gcloud config set project \u003cvar translate=\"no\"\u003eproject-id\u003c/var\u003e\n gcloud config set compute/region \u003cvar translate=\"no\"\u003ecompute-region\u003c/var\u003e\n gcloud config set compute/zone \u003cvar translate=\"no\"\u003ecompute-zone\u003c/var\u003e\n\n\n Where \u003cvar translate=\"no\"\u003eproject-id\u003c/var\u003e is the name of your GCP project, \u003cvar translate=\"no\"\u003ecompute-region\u003c/var\u003e is\n the name of a GCP compute region, and \u003cvar translate=\"no\"\u003ecompute-zone\u003c/var\u003e is\n the name of a GCP compute zone. For example: `compute/region us-central1`. For a list of\n compute regions and zones, see [Available regions and zones](https://cloud.google.com/compute/docs/regions-zones/#available).\n\nCreate a GKE cluster\n--------------------\n\n| **Note:** Apigee does not support [GKE Sandbox](https://cloud.google.com/kubernetes-engine/sandbox) or [gVisor](https://github.com/google/gvisor).\n\n\nIn this step, you will create a Kubernetes cluster in your GCP project (the project you set\nwith the `gcloud config` command).\n| **NOTE:** The following command assumes you set the `gcloud` configuration for the compute region and/or zone, as explained in the previous steps. If you did not set the configuration, then you will need to add the `--region \"`\u003cvar translate=\"no\"\u003ecompute-region\u003c/var\u003e`\"` and/or `--zone \"`\u003cvar translate=\"no\"\u003ecompute-zone\u003c/var\u003e`\"` parameter to the command.\n\n\nExecute the following command to create the cluster. The machine type, number of nodes, and\nother settings specified in the command create a minimally configured cluster suitable for\na trial Apigee hybrid installation: \n\n```\ngcloud container clusters create cluster-name \\\n--machine-type \"n1-standard-4\" --num-nodes \"3\" --enable-autoscaling --min-nodes \"3\" --max-nodes \"6\"\n```\n\n\nWhere \u003cvar translate=\"no\"\u003ecluster-name\u003c/var\u003e is the name you choose for the cluster.\n\n\nCluster creation can take a few minutes. Upon success, you will see output similar to\nthe following with a status of `RUNNING`: \n\n```\nNAME LOCATION MASTER_VERSION MASTER_IP MACHINE_TYPE NODE_VERSION NUM_NODES STATUS\napigee-hybrid us-central1-a 1.13.11-gke.9 35.222.54.89 n1-standard-4 1.13.11-gke.9 3 RUNNING\n```\n\nSet the current context\n-----------------------\n\n\nA *context* is a group of access parameters. Each context contains a Kubernetes cluster,\na user and a namespace. The current context is the cluster that is currently the default for\n`kubectl`: all `kubectl` commands run against that cluster.\n\n\nMake sure the current `gcloud` context is set to the cluster you just created.\n\n1. First, list the contexts to determine which is the *current* context. In the following example, the current context is `gke_hybrid-project_us-central1-a_apigee-hybrid`. The name includes the name of a GCP project (`hybrid-project`), a region or zone (`us-central1-a`), and a cluster name (`apigee-hybrid`): \n\n ```\n kubectl config get-contexts\n CURRENT NAME CLUSTER AUTHINFO NAMESPACE\n * gke_hybrid-project_us-central1-a_apigee-hybrid gke_hybrid-project_us-central1-a_apigee-hybrid gke_hybrid-project_us-central1-a_apigee-hybrid\n gke_apigee-project_us-west1-a_apigee-cluster gke_apigee-project_us-west1-a_apigee-cluster gke_apigee-project_us-west1-a_apigee-cluster\n\n ```\n2. If necessary, set the current context to the cluster you just created (the cluster into which you intend to install Apigee hybrid). Assuming the previous `get-contexts` output, if the cluster name you created were `apigee-cluster` in the region `us-west1`, you would switch to the `gke_apigee-project_us-west1-a_apigee-cluster` context, as follows: \n\n ```\n kubectl config use-context gke_apigee-project_us-west1-a_apigee-cluster\n ```\n\n Where `gke_apigee-project_us-west1-a_apigee-cluster` is the name of the context to switch to.\n3. Check the current context to be sure it is set to the intended cluster. For example: \n\n ```\n kubectl config current-context\n gke_apigee-project_us-west1-a_apigee-cluster\n ```\n\nGrant cluster credentials\n-------------------------\n\n\n[Cluster credentials](https://cloud.google.com/sdk/gcloud/reference/container/clusters/get-credentials) give you access to the containers running in the cluster. Fetch your\ncredentials and grant yourself the **cluster-admin** role:\n\n1. Fetch the credentials: \n\n ```\n gcloud container clusters get-credentials cluster-name\n ```\n\n Where \u003cvar translate=\"no\"\u003ecluster-name\u003c/var\u003e is the name is the name of the cluster you created (the\n cluster into which you intend to install Apigee hybrid).\n2. Set the cluster role binding. Execute this command exactly as shown: \n\n ```\n kubectl create clusterrolebinding cluster-admin-binding \\\n --clusterrole cluster-admin --user $(gcloud config get-value account)\n ```\n\nSummary\n-------\n\n\nYou now have a Kubernetes cluster running in your GCP project. Your shell environment is\nset up, and you are ready to install the Apigee hybrid runtime plane software\non your local machine.\n[1](/apigee/docs/hybrid/v1.1/install-create-cluster) [(NEXT) Step 2: Install apigeectl](/apigee/docs/hybrid/v1.1/install-download-install) [3](/apigee/docs/hybrid/v1.1/install-copy-overrides) [4](/apigee/docs/hybrid/v1.1/install-apply-hybrid)\n\n\u003cbr /\u003e"]]
