Questo passaggio spiega come configurare l'ambiente shell e creare un cluster GKE nel progetto Google Cloud Platform (Google Cloud).
Configura la shell del terminale
Lo strumento gcloud
fornisce l'interfaccia a riga di comando principale per Google Cloud, mentre kubectl
fornisce l'interfaccia a riga di comando principale per l'esecuzione di comandi sui cluster Kubernetes.
Assicurati di avere installato
gcloud
ekubectl
nella shell locale. Lo strumentogcloud
fornisce l'interfaccia a riga di comando principale per Google Cloud, mentrekubectl
fornisce l'interfaccia a riga di comando principale per l'esecuzione di comandi sui cluster Kubernetes.gcloud -h
kubectl -h
- Se non hai installato queste utilità, installale ora:
- Installa Cloud SDK,
che include lo strumento a riga di comando
gcloud
. - Dopo aver installato Cloud SDK, installa lo strumento a riga di comando
kubectl
eseguendo il seguente comando:
gcloud components install kubectl
- Installa Cloud SDK,
che include lo strumento a riga di comando
-
Utilizza lo strumento
gcloud
per configurare due impostazioni predefinite: il progetto e la regione di calcolo predefiniti. La configurazione di queste impostazioni semplifica l'esecuzione dei comandigcloud
, poichégcloud
richiede di specificare il progetto e zona di computing in cui vuoi lavorare.Per elencare le impostazioni correnti:
gcloud config list
Se un progetto e/o una zona di computing non sono elencati, devi aggiungerli con i comandi indicati di seguito. Se dall'output dell'elenco stabilisci che devi modificare le impostazioni attuali per riflettere il progetto e la regione di calcolo (o la zona), puoi anche utilizzare questi comandi:
gcloud config set project project-id
gcloud config set compute/region compute-region
gcloud config set compute/zone compute-zone
dove project-id è il nome del tuo progetto Google Cloud, compute-region è il nome di una regione di calcolo Google Cloud e compute-zone è il nome di una zona di computing Google Cloud. Ad esempio:
compute/region us-central1
. Per un elenco delle regioni e delle zone di calcolo, consulta Regioni e zone disponibili.
Crea un cluster GKE
In questo passaggio, creerai un cluster Kubernetes nel tuo progetto Google Cloud (il progetto impostato con il comando gcloud config
).
Esegui il seguente comando per creare il cluster. Il tipo di macchina, il numero di nodi e altre impostazioni specificate nel comando creano un cluster configurato in modo minimo, adatto per un'installazione di prova di Apigee hybrid.
gcloud container clusters create cluster-name \ --machine-type "n1-standard-4" --num-nodes "3" --enable-autoscaling --min-nodes "3" --max-nodes "6"
dove cluster-name è il nome che scegli per il cluster.
La creazione del cluster può richiedere alcuni minuti. In caso di esito positivo, visualizzerai un output simile al seguente con stato RUNNING
:
NAME LOCATION MASTER_VERSION MASTER_IP MACHINE_TYPE NODE_VERSION NUM_NODES STATUS apigee-hybrid us-central1-a 1.14.10-gke.27 35.222.54.89 n1-standard-4 1.14.10-gke.27 RUNNING
Impostare il contesto corrente
Un contesto è un gruppo di parametri di accesso. Ogni contesto contiene un cluster Kubernetes, un utente e uno spazio dei nomi. Il contesto corrente è il cluster attualmente predefinito per kubectl
: tutti i comandi kubectl
vengono eseguiti su quel cluster.
Assicurati che il contesto gcloud
corrente sia impostato sul cluster che hai appena creato.
- Innanzitutto, elenca i contesti per determinare quale sia quello attuale. Nel
seguente esempio, il contesto corrente è
gke_hybrid-project_us-central1-a_apigee-hybrid
. Il nome include il nome di un progetto Google Cloud (hybrid-project
), di una regione o di una zona (us-central1-a
) e di un 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
- Se necessario, imposta il contesto corrente sul cluster appena creato (il cluster
in cui intendi installare Apigee hybrid). Supponendo l'output
get-contexts
precedente, se il nome del cluster che hai creato fosseapigee-cluster
nella regioneus-west1
, passeresti al contestogke_apigee-project_us-west1-a_apigee-cluster
, come segue:kubectl config use-context gke_apigee-project_us-west1-a_apigee-cluster
dove
gke_apigee-project_us-west1-a_apigee-cluster
è il nome del contesto a cui passare. - Controlla il contesto corrente per assicurarti che sia impostato sul cluster previsto. Ad esempio:
kubectl config current-context gke_apigee-project_us-west1-a_apigee-cluster
Concedi le credenziali del cluster
Le credenziali del cluster ti consentono di accedere ai container in esecuzione nel cluster. Recupera le tue credenziali e concedi a te stesso il ruolo cluster-admin:
- Recupera le credenziali:
gcloud container clusters get-credentials cluster-name
dove cluster-name è il nome del cluster che hai creato (il cluster in cui intendi installare Apigee Hybrid).
- Imposta l'associazione del ruolo del cluster. Esegui questo comando esattamente come mostrato:
kubectl create clusterrolebinding cluster-admin-binding \ --clusterrole cluster-admin --user $(gcloud config get-value account)
Riepilogo
Ora hai un cluster Kubernetes in esecuzione nel tuo progetto Google Cloud. L'ambiente shell è stato configurato e puoi installare il software del piano di runtime Apigee Hybrid sulla tua macchina locale.
1 (AVANTI) Passaggio 2: installa apigeectl 3 4