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 ulteriori informazioni, consulta Versioni supportate.

Version 1.6 (unsupported)

   Versioni supportate:

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

Versioni non supportate:

• v1.10                                      
• 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 versione 1.6.9, vedi 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. Controllali con i seguenti comandi:

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

Fai clic per visualizzare 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 sull'integrazione ibrida - 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 il nome di una regione e non il nome di una zona. Una regione rappresenta una località geografica specifica in cui puoi ospitare le tue risorse. Le regioni possono avere più zone. Ad esempio, us-west1 region indica una regione sulla costa occidentale degli Stati Uniti con tre zone: us-west1-a, us-west1-b, and us-west1-c. Le regioni disponibili sono elencate in Regioni e aree geografiche disponibili zone. Tieni presente che, ad esempio, us-west1 è un nome di regione valido, mentre us-west1-a è una zona della 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. Vedi Ibrido Guida rapida - Passaggio 4: crea un'organizzazione

  export ORG_NAME=your_organization_name

• ENV_NAME: il nome del tuo ambiente ibrido. Consulta la guida rapida sull'ambiente ibrido - 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. La istruzioni variano a seconda della piattaforma su cui è in esecuzione l'ibrido. Seleziona la tua piattaforma per visualizzare le istruzioni.

GKE

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

Attenzione: Apigee non supporta la sandbox GKE 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 tuo cluster sono:

   Configurazione	Pool di nodi con stato	Pool di nodi senza stato
   Numero di nodi	3 (per regione)	3 (per regione)
   CPU	4	4
   RAM	15	15
   Nome dell'etichetta predefinita	apigee-data	apigee-runtime
   Archiviazione	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 della versione ibrida 1.6.9:
   • Apigee hybrid: piattaforme supportate
3. Segui queste istruzioni per creare un cluster a livello di regione con un minimo di 6 nodi:
   • Creazione di un cluster a livello di area geografica.
     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 ti chiedono la tua posizione nei passaggi successivi.
     Suggerimento: se non crei il cluster nella rete predefinita, segui le istruzioni riportate in Creare un cluster in una subnet esistente
4. Crea un minimo di 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 senza stato.	3	4	4/numero di nodi nel pool

   Segui le istruzioni in Aggiungere e per la gestione dei pool di nodi.

   Per ulteriori dettagli sulla configurazione del pool di nodi, consulta: Configura pool di nodi dedicati

5. Dopo aver creato il cluster, abilita Workload Identity nel cluster con quanto segue :

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

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

   Nota: se hai creato un cluster zonale anziché un cluster regionale, 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. Ottieni le credenziali gcloud del cluster appena creato con quanto segue :

   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 regione, Recupera le credenziali con il comando seguente:

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

Quando hai installato e avviato un cluster, vai al passaggio successivo.

GKE On-Prem

Creazione di un cluster

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

     Configurazione	Pool di nodi con stato	Pool di nodi senza stato
     Numero di nodi	3 (per regione)	3 (per regione)
     CPU	4	4
     RAM	15	15
     Nome dell'etichetta predefinita	apigee-data	apigee-runtime
     Archiviazione	dinamica	Gestito con il CRD ApigeeDeployment

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

   • Crea almeno due pool di nodi:

     Nome pool di nodi predefinito	Descrizione
     apigee-data	Un pool di nodi con stato.
     apigee-runtime	Un pool di nodi senza stato.

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

2. Controlla la versione di GKE supportata da questa versione di hybrid 1.6.9:
   • Apigee hybrid: piattaforme supportate
3. Segui queste istruzioni per creare un cluster utente:
   • Crea un cluster utente (avvio rapido) nella documentazione di GKE on-prem.

Quando hai installato e avviato 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 risorse della tua macchina.

Esamina i seguenti requisiti e prerequisiti:

• Requisiti hardware: Configurazione dell'hardware per Anthos clusters on bare metal
• Installazione panoramica sui prerequisiti

Creazione di un cluster

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

     Configurazione	Pool di nodi con stato	Pool di nodi senza stato
     Numero di nodi	3 (per regione)	3 (per regione)
     CPU	4	4
     RAM	15	15
     Nome dell'etichetta predefinita	apigee-data	apigee-runtime
     Archiviazione	dinamica	Gestito con 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 con stato.
     apigee-runtime	Un pool di nodi senza stato.

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

2. Controlla la versione di GKE supportata da questa versione di hybrid 1.6.9:
   • Apigee hybrid: piattaforme supportate
3. Utilizza le seguenti istruzioni nella documentazione di Anthos clusters on bare metal per creare un cluster utente:
   • Creazione in corso cluster: panoramica.
   • Cluster Anthos su Bare Metal Guida rapida nella documentazione di Anthos clusters on bare metal.

Dopo aver installato e in esecuzione un cluster, vai al passaggio successivo.

AKS

Crea un cluster AKS

1. Raccogliere i requisiti del cluster per il cluster Apigee hybrid:
   • Le configurazioni minime per il cluster sono:

     Configurazione	Pool di nodi con stato	Pool di nodi senza stato
     Numero di nodi	3 (per regione)	3 (per regione)
     CPU	4	4
     RAM	15	15
     Nome dell'etichetta predefinita	apigee-data	apigee-runtime
     Archiviazione	dinamica	Gestito con CRD ApigeeDeployment

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

   • Crea almeno due pool di nodi:

     Nome pool di nodi predefinito	Descrizione
     apigee-data	Un pool di nodi con stato.
     apigee-runtime	Un pool di nodi senza stato.

     Per ulteriori dettagli sulla configurazione del pool di nodi, consulta: Configura pool di nodi dedicati

2. Controlla la versione di AKS supportata da questa versione della versione ibrida 1.6.9:
   • Apigee hybrid: piattaforme supportate
3. Utilizza uno dei seguenti insiemi di istruzioni per creare un cluster:
   • Utilizzo di Azure CLI: Guida rapida: esegui il deployment di un cluster di Azure Kubernetes Service utilizzando Azure CLI.
   • Utilizzando il portale Azure: Guida rapida: esegui il deployment di un cluster Azure Kubernetes Service (AKS) utilizzando il portale Azure.

EKS

Creazione di un cluster

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

     Configurazione	Pool di nodi con stato	Pool di nodi senza stato
     Numero di nodi	3 (per regione)	3 (per regione)
     CPU	4	4
     RAM	15	15
     Nome dell'etichetta predefinita	apigee-data	apigee-runtime
     Archiviazione	dinamica	Gestito con CRD ApigeeDeployment

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

   • Crea almeno due pool di nodi:

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

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

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

Quando hai installato e avviato un cluster, vai al passaggio successivo.

GKE su AWS

Creazione di un cluster

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

     Configurazione	Pool di nodi con stato	Pool di nodi senza stato
     Numero di nodi	3 (per regione)	3 (per regione)
     CPU	4	4
     RAM	15	15
     Nome dell'etichetta predefinita	apigee-data	apigee-runtime
     Archiviazione	dinamica	Gestito con il CRD ApigeeDeployment

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

   • Crea almeno due pool di nodi:

     Nome pool di nodi predefinito	Descrizione
     apigee-data	Un pool di nodi con stato.
     apigee-runtime	Un pool di nodi senza stato.

     Per ulteriori dettagli sulla configurazione del pool di nodi, consulta: Configura pool di nodi dedicati

2. Controlla la versione di GKE supportata da questa versione di hybrid 1.6.9:
   • Apigee hybrid: 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 clusters on AWS.

Dopo aver installato e in esecuzione un cluster, vai al passaggio successivo.

OpenShift

Creazione di un cluster

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

     Configurazione	Pool di nodi con stato	Pool di nodi senza stato
     Numero di nodi	3 (per regione)	3 (per regione)
     CPU	4	4
     RAM	15	15
     Nome dell'etichetta predefinita	apigee-data	apigee-runtime
     Archiviazione	dinamica	Gestito con CRD ApigeeDeployment

     Per ulteriori 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 con stato.
     apigee-runtime	Un pool di nodi senza stato.

     Per ulteriori dettagli sulla configurazione del pool di nodi, consulta: Configura pool di nodi dedicati

2. Controlla la versione di GKE supportata da questa versione di hybrid 1.6.9:
   • Apigee hybrid: piattaforme supportate
3. Usa le istruzioni seguenti per installare Apigee sul tuo cluster utente OpenShift ed eseguire la registrazione 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 Google Cloud.
   1. Installa e configura lo strumento CLI oc. Consulta: Recupero avviato con l'interfaccia a riga di comando OpenShift nella documentazione di OpenShift.
   2. Registrati a 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 questo 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 a GKE Hub con il seguente comando:

         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 file kubeconfig del cluster.
         • CONTEXT è il contesto in cui gcloud registra il cluster. Per questo comando, CONTEXT deve essere admin.
         • 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
           • GKE Connect Agent

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

 

1 (AVANTI) Passaggio 2: installa cert-manager 3 4 5 6 7 8 9