Créer un cluster GKE et déployer une charge de travail à l'aide de Terraform
Dans ce guide de démarrage rapide, vous allez apprendre à créer un cluster Google Kubernetes Engine (GKE) Autopilot et à déployer une charge de travail à l'aide de Terraform.
L'Infrastructure as Code (IaC) est une pratique qui consiste à gérer et à provisionner des ressources d'infrastructure logicielle à l'aide de code. Terraform est un outil IaC Open Source populaire compatible avec un large éventail de services cloud, y compris GKE. En tant qu'administrateur de plate-forme GKE, vous pouvez utiliser Terraform pour standardiser la configuration de vos clusters Kubernetes et optimiser vos workflows DevOps. Pour en savoir plus, consultez la section Compatibilité de Terraform avec GKE.
Objectifs
- Créer un réseau cloud privé virtuel (VPC) IPv6
- Créer un cluster GKE Autopilot
- Déployer une charge de travail sur votre cluster
- Exposer la charge de travail à l'aide d'un service
Avant de commencer
Procédez comme suit pour activer l'API Kubernetes Engine :
- Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the GKE API.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the GKE API.
-
Make sure that you have the following role or roles on the project: roles/container.admin, roles/compute.networkAdmin, roles/iam.serviceAccountUser
Check for the roles
-
In the Google Cloud console, go to the IAM page.
Go to IAM - Select the project.
-
In the Principal column, find all rows that identify you or a group that you're included in. To learn which groups you're included in, contact your administrator.
- For all rows that specify or include you, check the Role colunn to see whether the list of roles includes the required roles.
Grant the roles
-
In the Google Cloud console, go to the IAM page.
Accéder à IAM - Sélectionnez le projet.
- Cliquez sur Accorder l'accès.
-
Dans le champ Nouveaux comptes principaux, saisissez votre identifiant utilisateur. Il s'agit généralement de l'adresse e-mail d'un compte Google.
- Dans la liste Sélectionner un rôle, sélectionnez un rôle.
- Pour attribuer des rôles supplémentaires, cliquez sur Ajouter un autre rôle et ajoutez chaque rôle supplémentaire.
- Cliquez sur Enregistrer.
Avant de lire plus en détail ce document, assurez-vous de bien connaître les concepts Terraform dans les ressources suivantes :
-
Préparer l'environnement
Dans ce tutoriel, vous utilisez Cloud Shell pour gérer les ressources hébergées sur Google Cloud. Cloud Shell est préinstallé avec les logiciels dont vous avez besoin dans ce tutoriel, y compris Terraform, kubectl
et Google Cloud CLI.
Lancez une session Cloud Shell depuis la console Google Cloud en cliquant sur l'icône d'activation Cloud Shell Activer Cloud Shell . Une session s'ouvre dans le volet inférieur de la console Google Cloud.
Les identifiants de service associés à cette machine virtuelle sont automatiques. Vous n'avez donc pas besoin de configurer ni de télécharger une clé de compte de service.
Avant d'exécuter des commandes, définissez votre projet par défaut dans gcloud CLI à l'aide de la commande suivante :
gcloud config set project PROJECT_ID
Remplacez
PROJECT_ID
par votre ID de projet.Clonez le dépôt GitHub.
git clone https://github.com/terraform-google-modules/terraform-docs-samples.git --single-branch
Accédez au répertoire de travail :
cd terraform-docs-samples/gke/quickstart/autopilot
Examiner les fichiers Terraform
Le fournisseur Google Cloud est un plug-in qui vous permet de gérer et de provisionner des ressources Google Cloud à l'aide de Terraform, l'outil IaC (Infrastructure as Code) de HashiCorp. Il sert de passerelle entre les configurations Terraform et les API Google Cloud, ce qui vous permet de définir des ressources d'infrastructure, telles que des machines virtuelles et des réseaux, de manière déclarative.
Examinez le fichier
cluster.tf
:cat cluster.tf
Le résultat ressemble à ce qui suit :
Ce fichier décrit les ressources suivantes :
- Un réseau VPC avec l'IPv6 interne activé. Pour exposer votre application sur Internet, remplacez
ipv6_access_type
parEXTERNAL
. Si vous apportez cette modification, vous devez également supprimer l'annotationnetworking.gke.io/load-balancer-type
du fichierapp.tf
à l'étape suivante. - Un sous-réseau à double pile.
- Un cluster Autopilot à double pile situé dans
us-central1
.
- Un réseau VPC avec l'IPv6 interne activé. Pour exposer votre application sur Internet, remplacez
Examinez le fichier
app.tf
:cat app.tf
Le résultat ressemble à ce qui suit :
Ce fichier décrit les ressources suivantes :
- Un déploiement avec un exemple d'image de conteneur.
- Un service de type LoadBalancer. Le service expose le déploiement sur le port 80. Pour exposer votre application sur Internet, configurez un équilibreur de charge externe en supprimant l'annotation
networking.gke.io/load-balancer-type
.
Créer un cluster et déployer une application
Dans Cloud Shell, exécutez la commande suivante pour vérifier que Terraform est disponible :
terraform
La sortie devrait ressembler à ce qui suit :
Usage: terraform [global options] <subcommand> [args] The available commands for execution are listed below. The primary workflow commands are given first, followed by less common or more advanced commands. Main commands: init Prepare your working directory for other commands validate Check whether the configuration is valid plan Show changes required by the current configuration apply Create or update infrastructure destroy Destroy previously-created infrastructure
Initialisez Terraform :
terraform init
Planifiez la configuration Terraform :
terraform plan
Appliquez la configuration Terraform :
terraform apply
Lorsque vous y êtes invité, saisissez
yes
pour confirmer les actions. Cette commande peut prendre plusieurs minutes. Le résultat ressemble à ce qui suit :Apply complete! Resources: 6 added, 0 changed, 0 destroyed.
Vérifier que le cluster fonctionne
Procédez comme suit pour vérifier que votre cluster fonctionne correctement :
Accédez à la page Charges de travail dans la console Google Cloud :
Cliquez sur la charge de travail
example-hello-app-deployment
. La page des détails du pod s'affiche. Cette page affiche des informations sur le pod, telles que les annotations, les conteneurs s'exécutant sur le pod, les services exposant le pod, mais aussi les métriques telles que l'utilisation du processeur, de la mémoire et du disque.Accédez à la page Services et entrées de la console Google Cloud :
Cliquez sur le Service LoadBalancer
example-hello-app-loadbalancer
. La page "Informations sur le service" s'affiche. Cette page affiche des informations sur le service, telles que les pods associés et les ports utilisés par les services.Dans la section Points de terminaison externes, cliquez sur lien IPv4 ou lien IPv6 pour afficher votre service dans le navigateur. Le résultat ressemble à ce qui suit :
Hello, world! Version: 2.0.0 Hostname: example-hello-app-deployment-5df979c4fb-kdwgr
Effectuer un nettoyage
Pour éviter que les ressources utilisées sur cette page soient facturées sur votre compte Google Cloud, procédez comme suit :
Pour éviter que les ressources utilisées sur cette page ne soient facturées sur votre compte Google Cloud, procédez comme suit :
Dans Cloud Shell, exécutez la commande suivante pour supprimer les ressources Terraform :
terraform destroy --auto-approve
Si un message d'erreur semblable à The network resource 'projects/PROJECT_ID/global/networks/example-network' is already being used by 'projects/PROJECT_ID/global/firewalls/example-network-yqjlfql57iydmsuzd4ot6n5v'
apparaît, procédez comme suit :
Supprimez les règles de pare-feu :
gcloud compute firewall-rules list --filter="NETWORK:example-network" --format="table[no-heading](name)" | xargs gcloud --quiet compute firewall-rules delete
Exécutez à nouveau la commande Terraform :
terraform destroy --auto-approve
Étapes suivantes
- Explorez les ressources
google_container_cluster
etgoogle_container_node_pool
dans la documentation du fournisseur Google Cloud. Ces pages répertorient les arguments et les attributs des clusters ainsi que la configuration des pools de nœuds GKE compatibles avec Terraform. - Consultez des exemples de configuration rigoureuses dans le dépôt GitHub du module Terraform GKE.