Étape 1 : Créer un cluster

Cette étape explique comment configurer votre environnement shell et créer un cluster Microsoft® Azure Kubernetes Service (AKS) adapté au test Apigee hybrid.

Configurer l'interface système de votre terminal

Vérifiez que la CLI Azure (az) et l'outil kubectl sont installés dans votre interface système locale. L'outil Azure CLI est l'interface de ligne de commande principale utilisée sur Azure, et kubectl fournit l'interface de ligne de commande principale permettant d'exécuter des commandes sur les clusters Kubernetes.

Créer un groupe de ressources

Créez un groupe de ressources en utilisant soit la console Azure, soit la CLI Azure avec la commande suivante : 

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

Créer un réseau virtuel

Créez un réseau virtuel avec une plage CIDR non conflictuelle.

Exemple :

Syntaxe

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

Exemple

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

Où :

  1. my-hybrid-rg est le nom du réseau virtuel.
  2. vnet-address-range est une liste de blocs d'adresses réservés pour ce réseau virtuel au format CIDR.
  3. vnet-subnet-name est le nom du sous-réseau au sein du réseau virtuel.
  4. subnet-address-range est une liste de blocs d'adresses réservés à ce sous-réseau au format CIDR.

Créer un cluster AKS

Lors de cette étape, vous allez créer un cluster AKS.

  1. Ouvrez le portail Microsoft® Azure.
  2. Cliquez sur Kubernetes services (Services Kubernetes).
  3. Créez un cluster avec les paramètres de configuration minimaux suivants.

    Espace de stockage minimal recommandé : examinez les caractéristiques des disques AKS et choisissez une taille de volume de stockage en fonction de vos exigences en termes d'IOPS et de coûts.

    Vous pouvez consulter les consignes de configuration de cluster pour Apigee hybrid figurant sur les pages Configurer Cassandra pour la production et Configuration de StorageClass.

    Tabulation Attribut Value
    Général Abonnement Le nom de votre abonnement
    Groupe de ressources Le groupe de ressources que vous avez créé précédemment
    Région La région que vous avez spécifiée précédemment. Par exemple : (US) Est des États-Unis
    Nom du cluster Kubernetes Le nom du cluster. Par exemple : my-hybrid-aks-cluster
    Version de Kubernetes Choisissez la version 1.16.x ou une version ultérieure.
    Préfixe du nom DNS Le préfixe du nom DNS. Par exemple : my-hybrid-aks-cluster-dns
    Nombre de nœuds 3
    Taille du nœud Standard DS3
    Évoluer Nœuds virtuels Désactivé
    Ensembles de mise à l'échelle de VM Activé
    Authentification Activer RBAC Oui
    Entité principale de service Par défaut
    Mise en réseau Routage des applications HTTP Non
    Équilibreur de charge Standard
    Configuration du réseau Azure CNI
    Réseau virtuel Le nom du réseau virtuel. Vous pouvez sélectionner le réseau virtuel que vous avez créé précédemment ou en créer un en cliquant sur le lien Créer un nouveau réseau. Par exemple : my-hybrid-rg-vnet
    Sous-réseau de cluster Exemple : default (10.240.0.0/16)
    Plage d'adresses de service Kubernetes La plage d'adresses de service. Veillez à utiliser une plage d'adresses non concurrentielles. Par exemple : 10.0.0.0/16
    Adresse IP du service DNS Kubernetes Par exemple : 10.0.0.10
    Adresse de liaison Docker Par exemple : 172.17.0.1/16
    Monitoring Activer la surveillance des conteneurs Oui
    Espace de travail Log Analytics Par exemple : DefaultWorkspace-66f9d75c-2cd9-47dd-ad0f-c43d888e9cef-EUS
    Tags None
  4. Cliquez sur Review and Create (Vérifier et créer).
  5. Une fois la création du cluster terminée, passez à l'étape suivante.

Définir les identifiants du cluster

Si nécessaire, ajoutez les identifiants de cluster Kubernetes pour le cluster que vous venez de créer en utilisant la commande suivante : 

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

Définir le contexte actuel

Un contexte est un groupe de paramètres d'accès. Chaque contexte contient un cluster Kubernetes, un utilisateur et un espace de noms. Le contexte actuel est le cluster par défaut actuel de kubectl : toutes les commandes kubectl s'exécutent sur ce cluster.

À l'aide de la commande suivante, vérifiez que le contexte actuel est bien défini sur le cluster que vous venez de créer :

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

Si le contexte n'est pas défini comme prévu sur votre cluster, procédez comme suit pour le modifier :

  1. Répertoriez tous les contextes pour déterminer lequel est le contexte actuel. Dans l'exemple suivant, le contexte est défini sur 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. Si nécessaire, définissez le contexte actuel sur le cluster que vous venez de créer (dans lequel vous souhaitez installer Apigee hybrid). En supposant la sortie get-contexts précédente, si le nom du cluster que vous avez créé était my-hybrid-aks-cluster, vous basculeriez vers le contexte my-hybrid-aks-cluster, comme suit : 
    kubectl config use-context my-hybrid-aks-cluster

    Où my-hybrid-aks-cluster est le nom du contexte du cluster vers lequel basculer.

Résumé

Vous disposez maintenant d'un cluster Kubernetes s'exécutant dans AKS. Votre environnement shell est configuré, et vous êtes prêt à installer le logiciel d'exécution Apigee hybrid sur votre machine locale.

1 (SUIVANT) Étape 2 : Installer cert-manager et ASM 3 4 5