Passaggio 1: creazione di un cluster

Questo passaggio spiega come configurare l'ambiente shell e creare un cluster Microsoft® Azure Kubernetes Service (AKS) adatto per testare Apigee hybrid.

Configura la shell del terminale

Assicurati di aver installato gli strumenti Azure CLI (az) e kubectl nella shell locale. Lo strumento Azure CLI fornisce l'interfaccia a riga di comando principale per Azure, mentre kubectl fornisce l'interfaccia a riga di comando principale per l'esecuzione di comandi sui cluster Kubernetes.

Creare un gruppo di risorse

Crea un gruppo di risorse utilizzando la console Azure o Azure CLI con il seguente comando: 

az group create --name my-hybrid-rg --location eastus

Crea una rete virtuale

Crea una rete virtuale con un intervallo CIDR non in conflitto.

Ad esempio:

Sintassi

az network vnet create \
 --name vnet-name \
 --resource-group my-hybrid-rg \
 --address-prefixes vnet-address-range \
 --subnet-name vnet-subnet-name \
 --subnet-prefix subnet-address-range

Esempio

az network vnet create \
 --name my-hybrid-rg-vnet \
 --resource-group my-hybrid-rg \
 --address-prefixes 120.38.1.0/14 \
 --subnet-name my-hybrid-rg-vnet-subnet \
 --subnet-prefix 120.38.1.0/16

Dove:

  1. my-hybrid-rg è il nome della rete virtuale.
  2. vnet-address-range è un elenco di blocchi di indirizzi riservati a questa rete virtuale in notazione CIDR.
  3. vnet-subnet-name è il nome della subnet all'interno della rete virtuale.
  4. subnet-address-range è un elenco di blocchi di indirizzi riservati a questa subnet in notazione CIDR.

Crea un cluster AKS

In questo passaggio creerai un cluster AKS.

  1. Apri il portale Microsoft® Azure.
  2. Fai clic su Servizi Kubernetes.
  3. Crea un cluster con le seguenti impostazioni di configurazione minime.

    Spazio di archiviazione minimo consigliato: esamina le specifiche del disco AKS e scegli una dimensione del volume di archiviazione in base ai requisiti di IOPS e costi.

    Puoi visualizzare le linee guida per la configurazione del cluster per Apigee hybrid in Configurazione di Cassandra per la produzione e Configurazione di StorageClass.

    Tab Attributo Valore
    Informazioni di base Abbonamento Il nome dell'abbonamento
    Gruppo di risorse Il gruppo di risorse che hai creato in precedenza
    Regione La regione che hai specificato in precedenza. Ad esempio: (US) East US
    Nome del cluster Kubernetes Il nome del cluster. Ad esempio: my-hybrid-aks-cluster
    Versione di Kubernetes Scegli la versione 1.16.x o una versione successiva
    Prefisso del nome DNS Il prefisso del nome DNS. Ad esempio: my-hybrid-aks-cluster-dns
    Conteggio nodi 3
    Dimensione nodo DS3 Standard
    Scala Nodi virtuali Disabilitato
    Set di scalabilità di macchine virtuali Abilitato
    Autenticazione Abilita RBAC Sì
    Entità servizio Predefinito
    Networking Routing delle applicazioni HTTP No
    Bilanciatore del carico Standard
    Configurazione di rete CNI di Azure
    Rete virtuale Il nome della rete virtuale. Puoi selezionare la rete virtuale che hai creato in precedenza o crearne una nuova facendo clic sul link Crea nuova. Ad esempio: my-hybrid-rg-vnet
    Subnet cluster Esempio: default (10.240.0.0/16)
    Intervallo di indirizzi dei servizi Kubernetes L'intervallo di indirizzi dei servizi. Assicurati di utilizzare un intervallo di indirizzi non in conflitto. Ad esempio: 10.0.0.0/16
    Indirizzo IP del servizio DNS di Kubernetes Ad esempio: 10.0.0.10
    Indirizzo bridge Docker Ad esempio: 172.17.0.1/16
    Monitoraggio Abilita il monitoraggio dei container Sì
    Spazio di lavoro Log Analytics Ad esempio: DefaultWorkspace-66f9d75c-2cd9-47dd-ad0f-c43d888e9cef-EUS
    Tag Nessuno
  4. Fai clic su Rivedi e crea.
  5. Al termine della creazione del cluster, vai al passaggio successivo.

Imposta le credenziali del cluster

Aggiungi le credenziali del cluster Kubernetes per il cluster appena creato utilizzando il seguente comando se non sono già state aggiunte: 

az aks get-credentials --resource-group my-hybrid-rg --name my-hybrid-aks-cluster

Imposta il contesto corrente

Un contesto è un gruppo di parametri di accesso. Ogni contesto contiene un cluster Kubernetes, un utente e uno spazio dei nomi. Il contesto attuale è il cluster attualmente predefinito per kubectl: tutti i comandi kubectl vengono eseguiti su quel cluster.

Assicurati che il contesto attuale sia impostato sul cluster appena creato utilizzando questo comando:

kubectl config current-context
 my-hybrid-aks-cluster-context

Se il contesto non è impostato sul tuo cluster come previsto, segui questi passaggi per modificarlo:

  1. Elenca tutti i contesti per determinare qual è quello attuale. Nell'esempio seguente, il contesto è impostato su my-hybrid-aks-ext01: 
    kubectl config get-contexts
CURRENT   NAME                            CLUSTER                                 AUTHINFO
          my-hybrid-aks-cluster    my-hybrid-aks-cluster          clusterUser_my-hybrid-rg2_myhybrid-aks-cluster
*         my-hybrid-aks-ext01      my-hybrid-aks-ext01            clusterUser_my-hybrid-rg_my-hybrid-aks-ext01
  2. Se necessario, imposta il contesto corrente sul cluster che hai appena creato (il cluster in cui intendi installare Apigee hybrid). Supponendo l'output get-contexts precedente, se il nome del cluster creato fosse my-hybrid-aks-cluster, passeresti al contesto my-hybrid-aks-cluster, come segue: 
    kubectl config use-context my-hybrid-aks-cluster

    dove my-hybrid-aks-cluster è il nome del contesto del cluster a cui passare.

Riepilogo

Ora hai un cluster Kubernetes in esecuzione in AKS. L'ambiente shell è configurato e puoi installare il software Apigee hybrid runtime sulla tua macchina locale.

1 (NEXT) Step 2: Install cert-manager and ASM 3 4 5