Passaggio 1: creazione di un cluster

Al momento stai visualizzando la versione 1.6 della documentazione di Apigee hybrid. This version is end of life. You should upgrade to a newer version. Per maggiori informazioni, consulta Versioni supportate.

ad ottenere le istruzioni per l'upgrade di

Version 1.6 (unsupported)

Versioni supportate:

• v1.12 (più recente)                        
• Versione 1.11                         
• Versione 1.10                                        
• Elenco delle versioni supportate

Versioni non supportate:

• Versione 1.9                                         
• Versione 1.8                                         
• Versione 1.7                                         
• Versione 1.6                                         
• Versione 1.5                                         
• Versione 1.4                                         
• Versione 1.3                                         
• Versione 1.2                                         
• Versione 1.1                                         

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. Controllali con i seguenti comandi:

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

Fai clic sulle descrizioni e sui 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 per i servizi ibridi - Passaggio 2: crea un progetto Google Cloud

  export PROJECT_ID=your_project_ID

• CLUSTER_LOCATION: la regione in cui creerai il cluster.

  export CLUSTER_LOCATION=cluster-region

  Nota: Apigee consiglia di utilizzare un nome per l'regione e non il nome di una zona. Una regione rappresenta una posizione geografica specifica in cui puoi ospitare le tue risorse. Le regioni possono avere più zone. Ad esempio, us-west1 regione indica una regione sulla costa occidentale degli Stati Uniti che ha tre zone: us-west1-a, us-west1-b, and us-west1-c. Le regioni disponibili sono elencate in Regioni e zone disponibili. Tieni presente che, ad esempio, us-west1 è un nome di regione valido, mentre us-west1-a è una zona nella regione. Per la maggior parte delle installazioni ibride, utilizza un nome di regione per la variabile CLUSTER_LOCATION.
• ORG_NAME: il nome della tua organizzazione. Deve corrispondere all'ID progetto Google Cloud. Consulta la guida rapida per i modelli ibridi - Passaggio 4: crea un'organizzazione

  export ORG_NAME=your_organization_name

• ENV_NAME: il nome del tuo ambiente ibrido. Consulta la guida rapida per i dispositivi ibridi - Passaggio 6: crea un gruppo di ambienti

  export ENV_NAME=your_environment_name

Questa procedura spiega come configurare il cluster in cui eseguirai Apigee hybrid. Le istruzioni variano a seconda della piattaforma su cui esegui il modello ibrido. Seleziona la tua piattaforma per visualizzare le istruzioni.

GKE

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

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

Creazione di un cluster

1. Raccogli i requisiti 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 regione)	3 (per regione)
   CPU	4	4
   RAM	15	15
   Nome etichetta predefinito	apigee-data	Apigee-runtime
   Storage	dinamica	Gestito con il CRD ApigeeDeployment

   Per maggiori dettagli sulla configurazione minima del cluster, consulta: Configurazioni minime del cluster

2. Controlla la versione di GKE supportata da questa versione dell'ibrido 1.6.9:
   • Apigee ibrido: piattaforme supportate
3. Segui le istruzioni riportate di seguito per creare un cluster a livello di regione con almeno 6 nodi:
   • Creazione di un cluster a livello di regione.
     Apigee consiglia di creare un cluster a livello di regione. Se preferisci creare un cluster di zona, assicurati di utilizzare la zona in cui le istruzioni richiedono la posizione nei passaggi successivi.
     Suggerimento: se non stai creando il cluster nella rete predefinita, segui le istruzioni in Creazione di un cluster in una subnet esistente
4. Crea un minimo di due pool di nodi per il cluster. I requisiti minimi per il 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 maggiori dettagli sulla configurazione del pool di nodi, consulta: Configurare pool di nodi dedicati

5. Dopo aver creato il cluster, abilita Workload Identity sul cluster con il seguente comando:

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

   Per maggiori informazioni, consulta Abilitazione di Workload Identity su un cluster

   Nota: se hai creato un cluster di zona anziché un cluster a livello di regione, 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 seguente comando:

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

   Nota: se hai creato un cluster di zona invece di uno a livello di regione, recupera le credenziali con il comando seguente:

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

Una volta installato e in esecuzione un cluster, vai al passaggio successivo.

GKE On-Prem

Creazione di un cluster

1. Rafforza i requisiti 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 regione)	3 (per regione)
     CPU	4	4
     RAM	15	15
     Nome etichetta predefinito	apigee-data	Apigee-runtime
     Storage	dinamica	Gestito con il CRD ApigeeDeployment

     Per maggiori dettagli sulla configurazione minima del cluster, consulta: Configurazioni minime del cluster

   • Crea un minimo di 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 maggiori dettagli sulla configurazione del pool di nodi, consulta: Configurare pool di nodi dedicati

2. Controlla la versione di GKE supportata da questa versione dell'ibrido 1.6.9:
   • Apigee ibrido: piattaforme supportate
3. Utilizza le seguenti istruzioni per creare un cluster utente:
   • Crea un cluster utente (guida rapida) nella documentazione di GKE On-Prem.

Una volta installato e in esecuzione un cluster, vai al passaggio successivo.

Anthos on bare metal

Requisiti e prerequisiti

Anthos clusters on bare metal ti consente di eseguire cluster Kubernetes direttamente sulle tue risorse della macchina.

Esamina i seguenti requisiti e prerequisiti:

• Requisiti hardware: Configurazione di hardware per Anthos clusters on bare metal
• Panoramica dei prerequisiti di installazione

Creazione di un cluster

1. Rafforza i requisiti 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 regione)	3 (per regione)
     CPU	4	4
     RAM	15	15
     Nome etichetta predefinito	apigee-data	Apigee-runtime
     Storage	dinamica	Gestito con il CRD ApigeeDeployment

     Per maggiori dettagli sulla configurazione minima del cluster, consulta: Configurazioni minime del cluster

   • Crea un minimo di 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 maggiori dettagli sulla configurazione del pool di nodi, consulta: Configurare pool di nodi dedicati

2. Controlla la versione di GKE supportata da questa versione dell'ibrido 1.6.9:
   • Apigee ibrido: piattaforme supportate
3. Segui le istruzioni riportate nella documentazione di Anthos clusters on bare metal per creare un cluster utente:
   • Creazione di cluster: panoramica.
   • Guida rapida di Anthos clusters on bare metal nella documentazione di Anthos clusters on bare metal.

Una volta installato e in esecuzione un cluster, vai al passaggio successivo.

AKS

Crea un cluster AKS

1. Rafforza i requisiti 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 regione)	3 (per regione)
     CPU	4	4
     RAM	15	15
     Nome etichetta predefinito	apigee-data	Apigee-runtime
     Storage	dinamica	Gestito con il CRD ApigeeDeployment

     Per maggiori dettagli sulla configurazione minima del cluster, consulta: Configurazioni minime del cluster

   • Crea un minimo di 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 maggiori dettagli sulla configurazione del pool di nodi, consulta: Configurare pool di nodi dedicati

2. Controlla la versione di AKS supportata da questa versione della versione ibrida 1.6.9:
   • Apigee ibrido: piattaforme supportate
3. Utilizza uno dei seguenti insiemi di istruzioni per creare un cluster:
   • Utilizzando l'interfaccia a riga di comando di Azure: Guida rapida: deployment di un cluster di servizio Azure Kubernetes utilizzando l'interfaccia a riga di comando di Azure.
   • Utilizzo del portale Azure: Guida rapida: deployment di un cluster Azure Kubernetes Service (AKS) utilizzando il portale Azure.

EKS

Creazione di un cluster

1. Rafforza i requisiti 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 regione)	3 (per regione)
     CPU	4	4
     RAM	15	15
     Nome etichetta predefinito	apigee-data	Apigee-runtime
     Storage	dinamica	Gestito con il CRD ApigeeDeployment

     Per maggiori dettagli sulla configurazione minima del cluster, consulta: Configurazioni minime del cluster

   • Crea un minimo di 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 maggiori dettagli sulla configurazione del pool di nodi, consulta: Configurare pool di nodi dedicati

2. Controlla la versione di EKS supportata da questa versione della versione ibrida 1.6.9:
   • Apigee ibrido: piattaforme supportate
3. Utilizza le seguenti istruzioni per creare un cluster utente:
   • Documentazione di panoramica di EKS.
   • Creazione di un cluster Amazon EKS.

Una volta installato e in esecuzione un cluster, vai al passaggio successivo.

GKE su AWS

Creazione di un cluster

1. Rafforza i requisiti 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 regione)	3 (per regione)
     CPU	4	4
     RAM	15	15
     Nome etichetta predefinito	apigee-data	Apigee-runtime
     Storage	dinamica	Gestito con il CRD ApigeeDeployment

     Per maggiori dettagli sulla configurazione minima del cluster, consulta: Configurazioni minime del cluster

   • Crea un minimo di 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 maggiori dettagli sulla configurazione del pool di nodi, consulta: Configurare pool di nodi dedicati

2. Controlla la versione di GKE supportata da questa versione dell'ibrido 1.6.9:
   • Apigee ibrido: piattaforme supportate
3. Utilizza le seguenti istruzioni per creare un cluster utente:
   • Documentazione panoramica di GKE su AWS.
   • Panoramica dell'installazione dei cluster Anthos su AWS.

Una volta installato e in esecuzione un cluster, vai al passaggio successivo.

OpenShift

Creazione di un cluster

1. Rafforza i requisiti 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 regione)	3 (per regione)
     CPU	4	4
     RAM	15	15
     Nome etichetta predefinito	apigee-data	Apigee-runtime
     Storage	dinamica	Gestito con il CRD ApigeeDeployment

     Per maggiori dettagli sulla configurazione minima del cluster, consulta: Configurazioni minime del cluster

   • Crea un minimo di 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 maggiori dettagli sulla configurazione del pool di nodi, consulta: Configurare pool di nodi dedicati

2. Controlla la versione di GKE supportata da questa versione dell'ibrido 1.6.9:
   • Apigee ibrido: piattaforme supportate
3. Segui le istruzioni riportate di seguito per installare Apigee sul tuo cluster utente OpenShift e registrarlo con GKE Hub.
   Se non disponi di un cluster openshift pronto per l'uso con Apigee, consulta le istruzioni nella documentazione di OpenShift, ad esempio: Installazione rapida di un cluster su Google Cloud.
   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. Registrazione con GKE Hub
      1. Crea un file denominato gke-connect-scc.yaml con i seguenti contenuti:

         # 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 seguenti comandi:

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

      4. Registrati con 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 è l'ID del tuo progetto Google Cloud.
         • CLUSTER_NAME è il nome del cluster che hai appena creato.
         • KUBECONFIG è il percorso del file kubeconfig del tuo cluster.
         • CONTEXT è il contesto in cui gcloud registra il cluster. CONTEXT deve essere admin per questo comando.
         • KEY_FILE_PATH è il percorso del file di chiavi 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.

 

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