Passaggio 1: creazione di un cluster

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

   Supported versions:

• v1.15 (latest)                        
• v1.14                        
• v1.13                         
• List of supported versions

   Unsupported versions:

• v1.12                         
• v1.11                         
• 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:

Questi passaggi presuppongono 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 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 Guida rapida ibrida - Passaggio 2: crea un progetto Google Cloud

  export PROJECT_ID=your_project_ID

• CLUSTER_LOCATION: la regione in cui verrà creato il cluster.

  export CLUSTER_LOCATION=cluster-region

  Nota: Apigee consiglia di utilizzare un nome di regione e non un nome di zona. Una regione è una località geografica specifica in cui puoi ospitare le tue risorse. Le regioni possono avere più zone. Ad esempio, la 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 della regione. Per la maggior parte delle installazioni ibride, utilizza il nome di una regione per la variabile CLUSTER_LOCATION.
• ORG_NAME: il nome della tua organizzazione. Deve corrispondere all'ID progetto Google Cloud. Consulta Guida rapida ibrida - Passaggio 4: crea un'organizzazione

  export ORG_NAME=your_organization_name

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

  export ENV_NAME=your_environment_name

Questa procedura spiega come configurare il cluster in cui verrà eseguito 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 tuo 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 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 regione)	3 (per regione)
   CPU	4	4
   RAM	15	15
   Nome etichetta predefinito	apigee-data	apigee-runtime
   Archiviazione	dinamica	Gestito con la CRD ApigeeDeployment

   Per maggiori dettagli sulla configurazione minima del cluster, vedi: 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 queste istruzioni per creare un cluster regionale con un minimo di 6 nodi:
   • Creazione di un cluster regionale.
     Apigee consiglia di creare un cluster regionale. Se preferisci creare un cluster zonale, assicurati di utilizzare la zona in cui le istruzioni richiedono la tua posizione nei passaggi successivi.
     Suggerimento: se non crei il cluster nella rete predefinita, segui le istruzioni riportate in Creazione di un cluster in una subnet esistente
4. Crea almeno due node pool per il cluster. I requisiti minimi del pool di nodi sono:

   Nome predefinito del pool di nodi	Descrizione	Numero minimo di nodi	Numero minimo di CPU per pool di nodi	Numero minimo di CPU 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 riportate in Aggiunta e gestione dei node pool.

   Per ulteriori dettagli sulla configurazione del node pool, consulta: Configura 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 maggiori informazioni, vedi Abilitare 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 regionale, recupera le credenziali con il seguente comando:

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

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

GKE On-Prem

Creazione di un cluster

1. Raccogli i requisiti del cluster per il cluster Apigee hybrid:
   • 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
     Archiviazione	dinamica	Gestito con la CRD ApigeeDeployment

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

   • Crea un minimo di due node pool:

     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 node pool, consulta: Configura 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. Per creare un cluster utente, segui queste istruzioni:
   • Crea un cluster utente (guida rapida) nella documentazione di GKE On-Prem.

Quando hai un cluster installato e in esecuzione, 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 macchina.

Esamina i seguenti requisiti e prerequisiti:

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

Creazione di un cluster

1. Raccogli i requisiti del cluster per il cluster Apigee hybrid:
   • 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
     Archiviazione	dinamica	Gestito con la CRD ApigeeDeployment

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

   • Crea un minimo di due node pool:

     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 node pool, consulta: Configura 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. Per creare un cluster utente, segui le istruzioni riportate nella documentazione di Anthos clusters on bare metal:
   • Creazione di cluster: panoramica.
   • Guida rapida di Anthos clusters on bare metal nella documentazione di Anthos clusters on bare metal.

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

AKS

Crea un cluster AKS

1. Raccogli i requisiti del cluster per il cluster Apigee hybrid:
   • 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
     Archiviazione	dinamica	Gestito con la CRD ApigeeDeployment

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

   • Crea un minimo di due node pool:

     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 node pool, consulta: Configura 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 set di istruzioni per creare un cluster:
   • Utilizzo dell'interfaccia a riga di comando di Azure: Guida rapida: esegui il deployment di un cluster Azure Kubernetes Service utilizzando l'interfaccia a riga di comando di Azure.
   • Utilizzo del portale Azure: Guida introduttiva: distribuire un cluster Azure Kubernetes Service (AKS) usando il portale Azure.

EKS

Creazione di un cluster

1. Raccogli i requisiti del cluster per il cluster Apigee hybrid:
   • 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
     Archiviazione	dinamica	Gestito con la CRD ApigeeDeployment

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

   • Crea un minimo di due node pool:

     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 node pool, consulta: Configura 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. Per creare un cluster utente, segui queste istruzioni:
   • Documentazione sulla panoramica di EKS.
   • Creazione di un cluster Amazon EKS.

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

GKE su AWS

Creazione di un cluster

1. Raccogli i requisiti del cluster per il cluster Apigee hybrid:
   • 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
     Archiviazione	dinamica	Gestito con la CRD ApigeeDeployment

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

   • Crea un minimo di due node pool:

     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 node pool, consulta: Configura 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. Per creare un cluster utente, segui queste istruzioni:
   • Documentazione di panoramica di GKE su AWS.
   • Panoramica dell'installazione di Anthos clusters on AWS.

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

OpenShift

Creazione di un cluster

1. Raccogli i requisiti del cluster per il cluster Apigee hybrid:
   • 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
     Archiviazione	dinamica	Gestito con la CRD ApigeeDeployment

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

   • Crea un minimo di due node pool:

     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 node pool, consulta: Configura 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 è l'ID del tuo progetto Google Cloud.
         • CLUSTER_NAME è il nome del cluster che hai appena creato.
         • KUBECONFIG è il percorso del file kubeconfig del 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 chiave del account di servizio, ad esempio ./dist/apigee-my-project-ro-sa.json. Il account di servizio deve avere i seguenti due ruoli IAM:
           • Amministratore GKE Hub
           • GKE Connect Agent

Quando hai installato e registrato un cluster in GKE Hub, vai al passaggio successivo.

 

1 (NEXT) Step 2: Install cert-manager 3 4 5 6 7 8 9