Passaggio 1: creazione di un cluster

Upgrade: se esegui l'upgrade alla versione ibrida di Apigee 1.8.0, consulta l'articolo Eseguire l'upgrade della versione ibrida di Apigee per istruzioni. Se stai eseguendo una nuova installazione, continua con le configurazioni descritte di seguito.

Prima di iniziare:

Questa procedura presuppone che tu abbia creato variabili di ambiente nei passaggi precedenti. Verificali con i seguenti comandi:

echo $PROJECT_ID
echo $CLUSTER_LOCATION
echo $ORG_NAME
echo $ENV_NAME

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

Questi passaggi utilizzano le seguenti variabili di ambiente:

• PROJECT_ID: l'ID del tuo progetto Google Cloud. Consulta la guida rapida ibrida - Passaggio 2: crea un progetto Google Cloud

  export PROJECT_ID=your_project_ID

• CLUSTER_LOCATION: l'area geografica in cui creerai il tuo cluster.

  export CLUSTER_LOCATION=cluster-region

  Nota: Apigee consiglia di utilizzare un nome per l'area geografica e non un nome di zona. Un'area geografica è una località geografica specifica in cui puoi ospitare le tue risorse. Le aree geografiche possono avere più zone. Ad esempio, la regione us-west1 indica una regione sulla costa occidentale degli Stati Uniti che comprende tre zone: us-west1-a, us-west1-b, and us-west1-c. Le aree geografiche disponibili sono indicate nella sezione Aree geografiche e zone disponibili. Tieni presente che, ad esempio, us-west1 è un nome di area geografica valido, mentre us-west1-a è una zona nell'area geografica. Per la maggior parte delle installazioni ibride, utilizza un nome di area geografica per la variabile CLUSTER_LOCATION.
• ORG_NAME: il nome della tua organizzazione. Deve corrispondere al tuo ID progetto Google Cloud. Consulta la guida rapida ibrida - Passaggio 4: crea un'organizzazione

  export ORG_NAME=your_organization_name

• ENV_NAME: il nome del tuo ambiente ibrido. Consulta la guida rapida ibrida - Passaggio 6: crea un gruppo di ambiente

  export ENV_NAME=your_environment_name

Questa procedura spiega come configurare il cluster in cui eseguirai Apigee ibrido. Le istruzioni variano a seconda della piattaforma in cui viene eseguita la soluzione ibrida. Seleziona la tua piattaforma per visualizzare le istruzioni.

GKE

Questo passaggio spiega come configurare il tuo ambiente shell e creare un cluster GKE nel tuo progetto Google Cloud.

Attenzione: Apigee non supporta GKE Sandbox o gVisor per le installazioni ibride su GKE.

Creazione di un cluster

1. Soddisfa i requisiti del cluster per il cluster ibrido Apigee: le configurazioni minime per il cluster sono:

   Configurazione	Pool di nodi stateful	Pool di nodi stateless
   Numero di nodi	3 (per area geografica)	3 (per area geografica)
   CPU	4	4
   RAM	15	15
   Nome etichetta predefinito	Dati Apigee	Tempo di esecuzione Apigee
   Archiviazione	dinamico	Gestiti con il CRD ApigeeDeployment

   Per ulteriori dettagli sulla configurazione minima dei cluster, consulta: Configurazioni minime dei cluster

2. Controlla la versione di GKE supportata da questa versione ibrida 1.8.0:
   • Apigee ibrido: piattaforme supportate
3. Utilizza le istruzioni seguenti per creare un cluster a livello di area geografica con un minimo di 6 nodi:
   • Crea un cluster a livello di area geografica.
     Suggerimento: se utilizzi Google Cloud Console per creare il cluster, aggiungi i pool di nodi prima di fare clic su Crea per creare il cluster.
     Nota: Apigee consiglia di creare un cluster a livello di area geografica. Se preferisci creare un cluster di zona, assicurati di utilizzare la zona in cui le istruzioni richiedono la tua posizione nei passaggi successivi.
     Suggerimento: se non stai creando il cluster nella rete predefinita, segui le istruzioni in Creare un cluster in una subnet esistente
4. Crea almeno due pool di nodi per il tuo cluster. I requisiti minimi del pool di nodi sono:

   Nome pool di nodi predefinito	Descrizione	Numero minimo di nodi	CPU minime per pool di nodi	CPU minime per nodo
   apigee-data	Un pool di nodi stateful.	3	4	4/numero di nodi nel pool
   apigee-runtime	Un pool di nodi stateless.	3	4	4/numero di nodi nel pool

   Segui le istruzioni in Aggiungere e gestire i pool di nodi.

   Per ulteriori dettagli sulla configurazione del pool di nodi, consulta Configurare i pool di nodi dedicati

   Suggerimento: dopo aver creato i pool di nodi, puoi verificarli con il comando seguente:

   gcloud container node-pools list \
     --cluster=${CLUSTER_NAME} \
     --region=${CLUSTER_LOCATION}

5. Dopo aver creato il cluster, abilita l'identità del carico di lavoro nel cluster con il comando seguente:

   gcloud container clusters update ${CLUSTER_NAME} \
     --workload-pool=$PROJECT_ID.svc.id.goog \
     --region ${CLUSTER_LOCATION}

   Per scoprire di più, consulta Abilitare Workload Identity in un cluster

   Nota: se hai creato un cluster di zona anziché un cluster a livello di area geografica, utilizza l'argomento --zone anziché --region come nel seguente comando:

   gcloud container clusters update ${CLUSTER_NAME} \
     --workload-pool=$PROJECT_ID.svc.id.goog \
     --zone ${CLUSTER_LOCATION}

6. Recupera le credenziali gcloud del cluster appena creato con il comando seguente:

   gcloud container clusters get-credentials ${CLUSTER_NAME} \
     --region ${CLUSTER_LOCATION} \
     --project ${PROJECT_ID}

   Nota: se hai creato un cluster di zona anziché un cluster a livello di area geografica, recupera le credenziali con il comando seguente:

   gcloud container clusters get-credentials ${CLUSTER_NAME} \
     --zone ${CLUSTER_LOCATION} \
     --project ${PROJECT_ID}

Quando un cluster è installato e in esecuzione, vai al passaggio successivo.

GKE On-Prem

Creazione di un cluster

1. Soddisfa i requisiti del cluster per il cluster ibrido Apigee:
   • Le configurazioni minime per il cluster sono:

     Configurazione	Pool di nodi stateful	Pool di nodi stateless
     Numero di nodi	3 (per area geografica)	3 (per area geografica)
     CPU	4	4
     RAM	15	15
     Nome etichetta predefinito	Dati Apigee	Tempo di esecuzione Apigee
     Archiviazione	dinamico	Gestiti con il CRD ApigeeDeployment

     Per ulteriori dettagli sulla configurazione minima dei cluster, consulta: Configurazioni minime dei cluster

   • Crea almeno due pool di nodi:

     Nome pool di nodi predefinito	Descrizione
     apigee-data	Un pool di nodi stateful.
     apigee-runtime	Un pool di nodi stateless.

     Per ulteriori dettagli sulla configurazione del pool di nodi, consulta Configurare i pool di nodi dedicati

2. Controlla la versione di GKE supportata da questa versione ibrida 1.8.0:
   • Apigee ibrido: piattaforme supportate
3. Segui le istruzioni riportate di seguito per creare un cluster utente:
   • Crea un cluster utente (guida rapida) nella documentazione di GKE On-Prem.

Quando un cluster è installato e in esecuzione, vai al passaggio successivo.

Anthos su Bare Metal

Requisiti e prerequisiti

I cluster Anthos su Bare Metal consentono di eseguire i cluster Kubernetes direttamente sulle risorse della tua macchina.

Esamina i seguenti requisiti e prerequisiti:

• Requisiti hardware: configurazione dell'hardware per cluster Anthos su Bare Metal
• Panoramica dei prerequisiti per l'installazione

Creazione di un cluster

1. Soddisfa i requisiti del cluster per il cluster ibrido Apigee:
   • Le configurazioni minime per il cluster sono:

     Configurazione	Pool di nodi stateful	Pool di nodi stateless
     Numero di nodi	3 (per area geografica)	3 (per area geografica)
     CPU	4	4
     RAM	15	15
     Nome etichetta predefinito	Dati Apigee	Tempo di esecuzione Apigee
     Archiviazione	dinamico	Gestiti con il CRD ApigeeDeployment

     Per ulteriori dettagli sulla configurazione minima dei cluster, consulta: Configurazioni minime dei cluster

   • Crea almeno due pool di nodi:

     Nome pool di nodi predefinito	Descrizione
     apigee-data	Un pool di nodi stateful.
     apigee-runtime	Un pool di nodi stateless.

     Per ulteriori dettagli sulla configurazione del pool di nodi, consulta Configurare i pool di nodi dedicati

2. Controlla la versione di GKE supportata da questa versione ibrida 1.8.0:
   • Apigee ibrido: piattaforme supportate
3. Utilizza le seguenti istruzioni nella documentazione dei cluster Anthos su Bare Metal per creare un cluster utente:
   • Creazione di cluster: panoramica.
   • Guida rapida ai cluster Anthos su Bare Metal nella documentazione dei cluster Anthos su Bare Metal.

Quando un cluster è installato e in esecuzione, vai al passaggio successivo.

alias

Crea un cluster AKS

1. Soddisfa i requisiti del cluster per il cluster ibrido Apigee:
   • Le configurazioni minime per il cluster sono:

     Configurazione	Pool di nodi stateful	Pool di nodi stateless
     Numero di nodi	3 (per area geografica)	3 (per area geografica)
     CPU	4	4
     RAM	15	15
     Nome etichetta predefinito	Dati Apigee	Tempo di esecuzione Apigee
     Archiviazione	dinamico	Gestiti con il CRD ApigeeDeployment

     Per ulteriori dettagli sulla configurazione minima dei cluster, consulta: Configurazioni minime dei cluster

   • Crea almeno due pool di nodi:

     Nome pool di nodi predefinito	Descrizione
     apigee-data	Un pool di nodi stateful.
     apigee-runtime	Un pool di nodi stateless.

     Per ulteriori dettagli sulla configurazione del pool di nodi, consulta Configurare i pool di nodi dedicati

2. Controlla la versione di AKS supportata da questa versione di versione ibrida 1.8.0:
   • Apigee ibrido: piattaforme supportate
3. Utilizza uno dei seguenti set di istruzioni per creare un cluster:
   • Utilizzo dell'interfaccia a riga di comando di Azure: Quickstart: Esegui il deployment di un cluster di servizio Kubernetes Kubernetes utilizzando l'interfaccia a riga di comando di Azure.
   • Utilizzando il portale di Azure: Quickstart: esegui il deployment di un cluster Azure Kubernetes Service (AKS) utilizzando il portale di Azure.

periodo

Creazione di un cluster

1. Soddisfa i requisiti del cluster per il cluster ibrido Apigee:
   • Le configurazioni minime per il cluster sono:

     Configurazione	Pool di nodi stateful	Pool di nodi stateless
     Numero di nodi	3 (per area geografica)	3 (per area geografica)
     CPU	4	4
     RAM	15	15
     Nome etichetta predefinito	Dati Apigee	Tempo di esecuzione Apigee
     Archiviazione	dinamico	Gestiti con il CRD ApigeeDeployment

     Per ulteriori dettagli sulla configurazione minima dei cluster, consulta: Configurazioni minime dei cluster

   • Crea almeno due pool di nodi:

     Nome pool di nodi predefinito	Descrizione
     apigee-data	Un pool di nodi stateful.
     apigee-runtime	Un pool di nodi stateless.

     Per ulteriori dettagli sulla configurazione del pool di nodi, consulta Configurare i pool di nodi dedicati

2. Controlla la versione di EKS supportata da questa versione di versione ibrida 1.8.0:
   • Apigee ibrido: piattaforme supportate
3. Segui le istruzioni riportate di seguito per creare un cluster utente:
   • Documentazione panoramica di EKS.
   • Creazione di un cluster Amazon EKS.

Quando un cluster è installato e in esecuzione, vai al passaggio successivo.

GKE su AWS

Creazione di un cluster

1. Soddisfa i requisiti del cluster per il cluster ibrido Apigee:
   • Le configurazioni minime per il cluster sono:

     Configurazione	Pool di nodi stateful	Pool di nodi stateless
     Numero di nodi	3 (per area geografica)	3 (per area geografica)
     CPU	4	4
     RAM	15	15
     Nome etichetta predefinito	Dati Apigee	Tempo di esecuzione Apigee
     Archiviazione	dinamico	Gestiti con il CRD ApigeeDeployment

     Per ulteriori dettagli sulla configurazione minima dei cluster, consulta: Configurazioni minime dei cluster

   • Crea almeno due pool di nodi:

     Nome pool di nodi predefinito	Descrizione
     apigee-data	Un pool di nodi stateful.
     apigee-runtime	Un pool di nodi stateless.

     Per ulteriori dettagli sulla configurazione del pool di nodi, consulta Configurare i pool di nodi dedicati

2. Controlla la versione di GKE supportata da questa versione ibrida 1.8.0:
   • Apigee ibrido: piattaforme supportate
3. Segui le istruzioni riportate di seguito per creare un cluster utente:
   • Documentazione panoramica di GKE su AWS.
   • Panoramica dell'installazione di Anthos Anthos su AWS.

Quando un cluster è installato e in esecuzione, vai al passaggio successivo.

Maiusc.

Creazione di un cluster

1. Soddisfa i requisiti del cluster per il cluster ibrido Apigee:
   • Le configurazioni minime per il cluster sono:

     Configurazione	Pool di nodi stateful	Pool di nodi stateless
     Numero di nodi	3 (per area geografica)	3 (per area geografica)
     CPU	4	4
     RAM	15	15
     Nome etichetta predefinito	Dati Apigee	Tempo di esecuzione Apigee
     Archiviazione	dinamico	Gestiti con il CRD ApigeeDeployment

     Per ulteriori dettagli sulla configurazione minima dei cluster, consulta: Configurazioni minime dei cluster

   • Crea almeno due pool di nodi:

     Nome pool di nodi predefinito	Descrizione
     apigee-data	Un pool di nodi stateful.
     apigee-runtime	Un pool di nodi stateless.

     Per ulteriori dettagli sulla configurazione del pool di nodi, consulta Configurare i pool di nodi dedicati

2. Controlla la versione di GKE supportata da questa versione ibrida 1.8.0:
   • Apigee ibrido: piattaforme supportate
3. Utilizza le istruzioni seguenti per installare Apigee sul cluster utente OpenShift e registrarlo con GKE Hub.
   Se non hai un cluster openshift pronto per l'uso con Apigee, consulta le istruzioni nella documentazione di OpenShift, ad esempio: Installazione rapida di un cluster su GCP.
   1. Installa e configura lo strumento dell'interfaccia a riga di comando oc. Consulta la Guida introduttiva all'interfaccia a riga di comando di OpenShift nella documentazione di OpenShift.
   2. Registrati con GKE Hub
      1. Crea un file denominato gke-connect-scc.yaml con il seguente contenuto:

         # Connect Agent SCC
         apiVersion: v1
         kind: SecurityContextConstraints
         metadata:
           name: gke-connect-scc
         allowPrivilegeEscalation: false
         requiredDropCapabilities:
         - ALL
         runAsUser:
           type: MustRunAsNonRoot
         seLinuxContext:
           type: RunAsAny
         supplementalGroups:
           type: MustRunAs
           ranges:
           - min: 1
             max: 65535
         fsGroup:
           type: MustRunAs
           ranges:
           - min: 1
             max: 65535
         volumes:
         - secret
         readOnlyRootFilesystem: true
         seccompProfiles:
         - docker/default
         users:
         groups:
           - system:serviceaccounts:gke-connect
                 

      2. Crea il componente in oc con il seguente comando:

         oc create -f gke-connect-scc.yaml

      3. Crea le variabili di ambiente per il contesto con i comandi seguenti:

         export KUBECONFIG=<> # Cluster kubeconfig file path
         export CONTEXT=admin

      4. Registrati su GKE Hub con il comando seguente:

         gcloud --project=${PROJECT_ID} container hub memberships register ${CLUSTER_NAME} \
           --kubeconfig=${KUBECONFIG} \
           --context=${CONTEXT} \
           --service-account-key-file=KEY_FILE_PATH

         Dove:

         • PROJECT_ID è il tuo ID progetto Google Cloud.
         • CLUSTER_NAME è il nome del cluster appena creato.
         • KUBECONFIG è il percorso del tuo file kubeconfig del cluster.
         • CONTEXT è il contesto in cui gcloud registra il cluster. CONTEXT per admin per questo comando.
         • KEY_FILE_PATH è il percorso del file della chiave dell'account di servizio, ad esempio ./dist/apigee-my-project-ro-sa.json. L'account di servizio deve avere i seguenti due ruoli IAM:
           • Amministratore GKE Hub
           • Agente GKE Connect

Dopo aver installato e registrato un cluster con GKE Hub, vai al passaggio successivo.

 

Passaggio successivo

1 (AVANTI) Passaggio 2: installa cert-manager 3 4 5