Crea un cluster ed esegui il deployment di un workload utilizzando Terraform
Un cluster Kubernetes fornisce risorse di calcolo, archiviazione, networking e altri servizi per le applicazioni, come un data center virtuale. Le app e i relativi servizi in esecuzione in Kubernetes sono chiamati carichi di lavoro.
Questo tutorial ti consente di visualizzare rapidamente un cluster Google Kubernetes Engine in esecuzione e un carico di lavoro di esempio, il tutto configurato utilizzando Terraform. Puoi quindi esplorare il workload nella console Google Cloud prima di passare al nostro percorso di apprendimento più approfondito o iniziare a pianificare e creare il tuo cluster pronto per la produzione. Questo tutorial presuppone che tu abbia già familiarità con Terraform.
Se preferisci configurare il cluster e il workload di esempio nella console Google Cloud , consulta Creare un cluster nella console Google Cloud .
Prima di iniziare
Per abilitare l'API Kubernetes Engine, segui questi passaggi:
- Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud project.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the GKE API:
gcloud services enable container.googleapis.com
-
Install the Google Cloud CLI.
-
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud project.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the GKE API:
gcloud services enable container.googleapis.com
-
Grant roles to your user account. Run the following command once for each of the following IAM roles:
roles/container.admin, roles/compute.networkAdmin, roles/iam.serviceAccountUser
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
- Replace
PROJECT_ID
with your project ID. -
Replace
USER_IDENTIFIER
with the identifier for your user account. For example,user:myemail@example.com
. - Replace
ROLE
with each individual role.
- Replace
Prepara l'ambiente
In questo tutorial utilizzerai Cloud Shell per gestire le risorse ospitate su
Google Cloud. Cloud Shell è preinstallato con il
software necessario per questo tutorial, tra cui Terraform,
kubectl
e
Google Cloud CLI.
Avvia una sessione di Cloud Shell dalla console Google Cloud facendo clic sull'icona di attivazione di Cloud Shell Attiva Cloud Shell
. Viene avviata una sessione nel riquadro inferiore della console Google Cloud .
Le credenziali di servizio associate a questa macchina virtuale sono automatiche, quindi non devi configurare o scaricare una chiave delaccount di serviziot.
Prima di eseguire i comandi, imposta il progetto predefinito in gcloud CLI utilizzando questo comando:
gcloud config set project PROJECT_ID
Sostituisci
PROJECT_ID
con l'ID progetto.Clona il repository GitHub:
git clone https://github.com/terraform-google-modules/terraform-docs-samples.git --single-branch
Passa alla directory di lavoro:
cd terraform-docs-samples/gke/quickstart/autopilot
Esamina i file Terraform
Il Google Cloud provider è un plug-in che consente di gestire ed eseguire il provisioning delle risorse Google Cloud utilizzando Terraform. Funge da ponte tra le configurazioni Terraform e le API Google Cloud , consentendoti di definire in modo dichiarativo le risorse dell'infrastruttura, come macchine virtuali e reti.
Il cluster e l'app di esempio per questo tutorial sono specificati in due file Terraform che utilizzano i provider Google Cloud e Kubernetes.
Esamina il file
cluster.tf
:cat cluster.tf
L'output è simile al seguente:
Questo file descrive le seguenti risorse:
google_compute_network
: una rete VPC con IPv6 interno abilitato.google_compute_subnetwork
: una subnet a doppio stack.google_container_cluster
: un cluster in modalità Autopilot dual-stack situato inus-central1
. L'impostazionedeletion_protection
controlla se puoi utilizzare Terraform per eliminare questo cluster. Se imposti il valore nel campodeletion_protection
sufalse
, Terraform può eliminare il cluster. Per maggiori dettagli, consulta il riferimentogoogle_container_cluster
.
Esamina il file
app.tf
:cat app.tf
L'output è simile al seguente:
Questo file descrive le seguenti risorse:
- Un deployment con un'immagine container di esempio.
- Un servizio di tipo LoadBalancer. Il servizio espone il deployment sulla porta 80.
(Facoltativo) Esporre l'applicazione su internet
I file Terraform per l'esempio descrivono un'applicazione con un indirizzo IP interno, a cui è possibile accedere solo dallo stesso Virtual Private Cloud (VPC) dell'app di esempio. Se vuoi accedere all'interfaccia web dell'app demo in esecuzione da internet (ad esempio dal tuo laptop), modifica i file Terraform per creare un indirizzo IP pubblico prima di creare il cluster. Puoi farlo utilizzando un editor di testo direttamente in Cloud Shell o utilizzando l'editor di Cloud Shell.
Per esporre l'applicazione demo su internet:
In
cluster.tf
, modificaipv6_access_type
daINTERNAL
aEXTERNAL
.ipv6_access_type = "EXTERNAL"
In
app.tf
, configura un bilanciatore del carico esterno rimuovendo l'annotazionenetworking.gke.io/load-balancer-type
.annotations = { "networking.gke.io/load-balancer-type" = "Internal" # Remove this line }
Crea un cluster ed esegui il deployment di un'applicazione
In Cloud Shell, esegui questo comando per verificare che Terraform sia disponibile:
terraform
L'output dovrebbe essere simile al seguente:
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
Inizializza Terraform:
terraform init
Pianifica la configurazione Terraform:
terraform plan
Applica la configurazione Terraform
terraform apply
Quando richiesto, inserisci
yes
per confermare le azioni. Il completamento di questo comando potrebbe richiedere diversi minuti. L'output è simile al seguente:Apply complete! Resources: 6 added, 0 changed, 0 destroyed.
Verificare il funzionamento del cluster
Per verificare che il cluster sia in esecuzione correttamente:
Vai alla pagina Workload nella console Google Cloud :
Fai clic sul carico di lavoro
example-hello-app-deployment
. Viene visualizzata la pagina Dettagli pod. Questa pagina mostra informazioni sul pod, ad esempio annotazioni, container in esecuzione sul pod, servizi che espongono il pod e metriche tra cui utilizzo di CPU, memoria e disco.Vai alla pagina Servizi e Ingress nella console Google Cloud :
Fai clic sul servizio
example-hello-app-loadbalancer
LoadBalancer. Viene visualizzata la pagina dei dettagli del servizio. Questa pagina mostra informazioni sul servizio, ad esempio i pod associati al servizio e le porte utilizzate dai servizi.Nella sezione Endpoint esterni, fai clic sul link IPv4 o sul link IPv6 per visualizzare il servizio nel browser. L'output è simile al seguente:
Hello, world! Version: 2.0.0 Hostname: example-hello-app-deployment-5df979c4fb-kdwgr
Esegui la pulizia
Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, elimina il progetto Google Cloud con le risorse.
Se prevedi di seguire altri tutorial o di esplorare ulteriormente il campione, esegui questo passaggio di pulizia solo al termine.
In Cloud Shell, esegui questo comando per eliminare le risorse Terraform:
terraform destroy --auto-approve
Risolvere i problemi relativi agli errori di pulizia
Se viene visualizzato un messaggio di errore simile a The network resource 'projects/PROJECT_ID/global/networks/example-network' is already being used by 'projects/PROJECT_ID/global/firewalls/example-network-yqjlfql57iydmsuzd4ot6n5v'
,
fai quanto segue:
Elimina le regole firewall:
gcloud compute firewall-rules list --filter="NETWORK:example-network" --format="table[no-heading](name)" | xargs gcloud --quiet compute firewall-rules delete
Esegui di nuovo il comando Terraform:
terraform destroy --auto-approve
Passaggi successivi
Esplora il cluster e il workload nella console Google Cloud per scoprire alcune delle impostazioni e delle risorse chiave del workload di cui hai eseguito il deployment.
Scopri di più su come configurare e utilizzare Terraform con GKE in Supporto di Terraform per GKE.
Prova il nostro percorso di apprendimento più approfondito: app scalabili.
Scopri come iniziare a utilizzare l'amministrazione del cluster nella vita reale nella nostra panoramica dell'amministrazione del cluster.