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 (ultima versione)                        
• 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                                         

Se stai eseguendo una nuova installazione, continua con le configurazioni descritte di seguito.

Prima di iniziare:

Questa procedura presuppone che tu abbia creato le 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 descrizioni e 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, la regione us-west1 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 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. Consulta la guida rapida sull'ibrido - 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 hybrid - 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 in cui esegui 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 progetto Google Cloud.

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

Creazione di un cluster

1. Raccogliere i requisiti del cluster 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

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 regionale 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 almeno due pool di nodi per il 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 con stato.	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 riportate in Aggiunta e gestione di node pool.

   Per ulteriori dettagli sulla configurazione dei pool di nodi, consulta: Configurare i 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 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. 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 anziché un cluster a livello di area geografica, recupera le credenziali con il seguente comando:

   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. 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 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 le istruzioni riportate di seguito 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
• Panoramica dei prerequisiti per l'installazione

Creazione di un cluster

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 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. Utilizza le seguenti istruzioni 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.

Quando hai installato e avviato 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 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 AKS supportata da questa versione di hybrid 1.6.9:
   • Apigee hybrid: piattaforme supportate
3. Utilizza uno dei seguenti insiemi di istruzioni per creare un cluster:
   • Utilizzo dell'interfaccia a riga di comando di Azure: Guida rapida: esegui il deployment di un cluster di Azure Kubernetes Service utilizzando l'interfaccia a riga di comando di Azure.
   • Utilizzo del portale di Azure: Guida rapida: esegui il deployment di un cluster Azure Kubernetes Service (AKS) utilizzando il portale di Azure.

EKS

Creazione di un cluster

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 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 EKS 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 di panoramica di 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. 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 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 le istruzioni riportate di seguito per creare un cluster utente:
   • Documentazione di panoramica di GKE su AWS.
   • Panoramica dell'installazione di Anthos clusters on AWS.

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

OpenShift

Creazione di un cluster

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 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 le istruzioni riportate di seguito per installare Apigee nel 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 Google Cloud.
   1. Installa e configura lo strumento CLI oc. Consulta Introduzione all'interfaccia a riga di comando di OpenShift nella documentazione di OpenShift.
   2. Registrati a 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 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

Quando hai 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