Passaggio 1: creazione di un cluster

Stai visualizzando la versione 1.3 della documentazione di Apigee hybrid. This version is end of life. You should upgrade to a newer version. Per maggiori informazioni, vedi Versioni supportate.

Version 1.3 (unsupported)

Versioni supportate:

• v1.12 (più recente)                        
• v1.11                         
• v1.10                                        
• Elenco delle versioni supportate

Versioni non supportate:

• v1.9                                         
• v1.8                                         
• v1.7                                         
• v1.6                                         
• v1.5                                         
• v1.4                                         
• v1.3                                         
• v1.2                                         
• v1.1                                         

Upgrade: se stai eseguendo l'upgrade ad Apigee hybrid v1.3.6, consulta Upgrade di Apigee hybrid per le istruzioni. Se stai eseguendo una nuova installazione, continua con le configurazioni descritte di seguito.

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

Fai clic per visualizzare le descrizioni e i comandi per definire le variabili.

In questi passaggi vengono utilizzate le seguenti variabili di ambiente:

• PROJECT_ID: l'ID del tuo progetto Google Cloud. Consulta la Guida rapida di tipo ibrido - Passaggio 2: creare un progetto Google Cloud

  export PROJECT_ID=your_project_ID

• ANALYTICS_REGION: la regione in cui è in esecuzione il progetto GKE regione di analisi per la tua organizzazione. Consulta la Guida rapida ibrida - Passaggio 4: creare un'organizzazione

  export ANALYTICS_REGION=your_analytics region

• ORG_NAME: il nome della tua organizzazione. Deve corrispondere all'ID progetto Google Cloud. Consulta la Guida rapida ibrida - Passaggio 4: creare un'organizzazione

  export ORG_NAME=your_organization_name

• ENV_NAME: il nome del tuo ambiente ibrido. Consulta la Guida rapida agli ambienti ibridi - Passaggio 6: crea un gruppo di ambienti

  export ENV_NAME=your_environment_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.

1. Assicurati di avere installato gcloud e kubectl nella shell locale. 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.

   gcloud -h
   kubectl -h

2. Se non hai installato queste utilità, installale ora nel seguente modo:
   1. Installa Cloud SDK, che include lo strumento a riga di comando gcloud.
   2. Dopo aver installato Cloud SDK, installa lo strumento a riga di comando kubectl eseguendo questo comando:

   gcloud components install kubectl

3. 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 comandi gcloud, 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

Attenzione: Apigee non supporta GKE Sandbox o gVisor.

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).

Nota: il comando seguente presuppone che tu abbia impostato la configurazione gcloud per la regione di computing, come spiegato nei passaggi precedenti. Se non hai impostato la configurazione, dovrai aggiungere il parametro --region "compute-region" al comando.

Nota: ti consigliamo di controllare la versione predefinita di Kubernetes e assicurarti che soddisfi i requisiti di versione elencati in Piattaforme supportate. Per determinare quale versione di Kubernetes è quella predefinita, utilizza il seguente comando:

gcloud container get-server-config

Se non vuoi utilizzare l'impostazione predefinita, puoi aggiungere il flag --cluster-version al comando di creazione del cluster. Per maggiori dettagli, consulta gcloud container clusters create.

Crea il cluster

1. (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.

2. 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.
   Nota: la dimensione del cluster che creerai in questo passaggio include una quantità minima di risorse adatte solo per le prove o i test. Per informazioni più dettagliate sui requisiti delle risorse cluster per gli ambienti di produzione e non di produzione, consulta:

   • Requisiti per i cluster di produzione GKE
   • Requisiti per i cluster non di produzione GKE

   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.

1. 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
   

2. 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.

3. 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:

1. 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.

2. 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