Prima di iniziare:
Questi passaggi presuppongono che tu abbia creato variabili di ambiente nei passaggi precedenti. Verificali con i seguenti comandi:
echo $PROJECT_ID
echo $ANALYTICS_REGION
echo $ORG_NAME
echo $ENV_NAME
Questo passaggio spiega come configurare l'ambiente shell e creare un cluster GKE nel tuo progetto Google Cloud.
Configura la shell del terminale
Lo strumento gcloud
fornisce l'interfaccia a riga di comando principale per Google Cloud, mentre kubectl
offre l'interfaccia a riga di comando principale per eseguire 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
offre l'interfaccia a riga di comando principale per eseguire comandi sui cluster Kubernetes.gcloud -h
kubectl -h
- Se non hai installato queste utilità, installale ora nel seguente modo:
- 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 questo 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 predefinito e la regione di computing. La configurazione di queste impostazioni semplifica l'esecuzione dei comandigcloud
, perchégcloud
richiede di specificare il progetto e la regione di computing in cui vuoi lavorare.Per elencare le impostazioni attuali, esegui questo comando:
gcloud config list
Se un progetto e/o una regione di computing non sono elencati, devi aggiungerli con i comandi mostrati di seguito. Se dall'output dell'elenco viene stabilito che è necessario cambiare le impostazioni attuali per riflettere il progetto e la regione di computing, puoi utilizzare anche questi comandi:
gcloud config set project $PROJECT_ID
gcloud config set compute/region $ANALYTICS_REGION
Dove:
- PROJECT_ID è il nome del tuo progetto Google Cloud.
- ANALYTICS_REGION è il nome di una regione di computing di Google Cloud
Crea un cluster GKE
In questo passaggio creerai un cluster Kubernetes nel tuo progetto Google Cloud (il progetto che hai impostato con il comando gcloud config
rappresentato da PROJECT_ID
).
Crea il cluster
- (Facoltativo) Crea la variabile di ambiente CLUSTER_NAME con il seguente comando:
export CLUSTER_NAME=cluster-name
Dove cluster-name è il nome che scegli per il cluster.
- Esegui questo comando per creare il cluster. Il tipo di macchina, il numero di nodi e altre impostazioni specificate nel comando creano un cluster con configurazione minima, adatto a un'installazione ibrida di prova di Apigee.
gcloud container clusters create $CLUSTER_NAME \ --machine-type "e2-standard-4" --num-nodes "4" --enable-autoscaling --min-nodes "3" --max-nodes "6"
La creazione del cluster può richiedere alcuni minuti. Se l'operazione riesce, viene visualizzato 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 1.15.12-gke.2 35.222.54.89 e2-standard-4 1.15.12-gke.2 RUNNING
Imposta il contesto attuale
Un contesto è un gruppo di parametri di accesso. Ogni contesto contiene un cluster Kubernetes, un utente e uno spazio dei nomi. Il contesto attuale è il cluster attualmente predefinito per kubectl
: tutti i comandi kubectl
vengono eseguiti su quel cluster.
Assicurati che il contesto attuale di gcloud
sia impostato sul cluster che hai appena creato.
- Innanzitutto, elenca i contesti per determinare qual è il contesto attuale. Nell'esempio seguente, il contesto attuale è
gke_hybrid-project_us-central1_apigee-hybrid
. Il nome include il nome di un progetto Google Cloud (hybrid-project
), una regione (us-central1
) e il nome di un cluster (apigee-hybrid
).kubectl config get-contexts
I risultati dovrebbero essere simili all'esempio seguente:
CURRENT NAME CLUSTER AUTHINFO NAMESPACE * gke_hybrid-project_us-central1_apigee-hybrid gke_hybrid-project_us-central1_apigee-hybrid gke_hybrid-project_us-central1_apigee-hybrid gke_apigee-project_us-west1_apigee-cluster gke_apigee-project_us-west1_apigee-cluster gke_apigee-project_us-west1_apigee-cluster
- Se necessario, imposta il contesto attuale sul cluster che hai appena creato (il cluster in cui intendi installare Apigee hybrid). Utilizzando l'output
get-contexts
precedente, puoi passare al contesto corretto, come segue:kubectl config use-context context
Dove context è il nome contesto completo per il cluster come output dal comando
get-contexts
precedente. Ad esempio:gke_apigee-project_us-west1_apigee-cluster
. - Controlla il contesto attuale per assicurarti che sia impostato sul cluster previsto utilizzando il seguente comando:
kubectl config current-context
Ad esempio:
gke_apigee-project_us-west1_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 concediti il ruolo cluster-admin:
- Recupera le credenziali inserendo questo comando:
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).Dovresti vedere un risultato simile al seguente:
Fetching cluster endpoint and auth data. kubeconfig entry generated for example-cluster.
- 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)
Dovresti vedere un risultato simile al seguente:
clusterrolebinding.rbac.authorization.k8s.io/cluster-admin-binding created
Riepilogo
Ora hai un cluster Kubernetes in esecuzione nel tuo progetto Google Cloud. Il tuo ambiente shell è configurato e puoi installare i servizi di gestione certificati e istio richiesti da Apigee hybrid sulla tua macchina locale.
1 (AVANTI) Passaggio 2: installa cert-manager e ASM 3 4 5