Tutoriel : utiliser des services PaaS avec un cluster Azure Kubernetes Service (AKS)

Avec Kubernetes, vous pouvez utiliser des services PaaS, tels qu’Azure Service Bus, pour développer et exécuter vos applications.

Dans ce tutoriel, la partie cinq sur sept, vous créez un espace de noms et une file d’attente Azure Service Bus pour tester votre application. Vous allez apprendre à effectuer les actions suivantes :

• Créez un espace de noms et une file d’attente Azure Service Bus.
• Mettez à jour le fichier manifeste Kubernetes pour utiliser la file d’attente Azure Service Bus.
• Testez l’application mise à jour en plaçant une commande.

Avant de commencer

Dans les didacticiels précédents, vous avez empaqueté une application dans une image conteneur, chargé l’image dans Azure Container Registry, créé un cluster Kubernetes et déployé une application. Pour effectuer ce didacticiel, vous avez besoin du fichier manifeste Kubernetes aks-store-quickstart.yaml. Ce téléchargement de fichier était inclus avec le code source de l’application dans un didacticiel précédent. Vérifiez que vous avez cloné le référentiel et modifié les répertoires dans le référentiel cloné. Si vous n’avez pas effectué ces étapes et voulez suivre cette procédure, commencez par Tutoriel 1 : préparer une application pour AKS.

Azure CLI

Ce didacticiel nécessite Azure CLI version 2.34.1 ou ultérieure. Exécutez az --version pour trouver la version. Si vous devez installer ou mettre à niveau, voir Installer Azure CLI.

Azure PowerShell

Pour ce didacticiel, Azure PowerShell version 5.9.0 ou ultérieure est nécessaire. Exécutez Get-InstalledModule -Name Az pour trouver la version. Si vous avez besoin de procéder à une installation ou à une mise à niveau, consultez Installer Azure PowerShell.

Créer des variables d’environnement

Azure CLI

• Créez les variables d’environnement suivantes à utiliser pour les commandes de ce didacticiel :

  LOC_NAME=eastus
  RAND=$RANDOM
  RG_NAME=myResourceGroup
  AKS_NAME=myAKSCluster
  SB_NS=sb-store-demo-$RAND
  

Azure PowerShell

• Créez les variables d’environnement suivantes à utiliser pour les commandes de ce didacticiel :

  $LOC_NAME="eastus"
  $rand=New-Object System.Random
  $RAND=$rand.Next()
  $RG_NAME="myResourceGroup"
  $AKS_NAME="myAKSCluster"
  $SB_NS="sb-store-demo-$RAND"
  

Créer un espace de noms et une file d’attente Azure Service Bus

Dans les didacticiels précédents, vous avez utilisé un conteneur RabbitMQ pour stocker les commandes soumises par le order-service. Dans ce tutoriel, vous utilisez un espace de noms Azure Service Bus pour fournir un conteneur d’étendue pour les ressources Service Bus au sein de l’application. Vous utilisez également une file d’attente Azure Service Bus pour envoyer et recevoir des messages entre les composants de l’application. Pour plus d’informations sur Azure Service Bus, consultez Créer un espace de noms et une file d’attente Azure Service Bus.

Azure CLI

1. Créez un espace de noms Azure Service Bus à l’aide de la commande az servicebus namespace create.

   az servicebus namespace create --name $SB_NS --resource-group $RG_NAME --location $LOC_NAME
   

2. Créez une file d’attente Azure Service Bus à l’aide de la commande az servicebus queue create.

   az servicebus queue create --name orders --resource-group $RG_NAME --namespace-name $SB_NS
   

3. Créez une règle d’autorisation Azure Service Bus à l’aide de la commande az servicebus queue authorization-rule create.

   az servicebus queue authorization-rule create \
       --name sender \
       --namespace-name $SB_NS \
       --resource-group $RG_NAME \
       --queue-name orders \
       --rights Send
   

4. Obtenez les informations d’identification Azure Service Bus pour une utilisation ultérieure à l’aide des commandes az servicebus namespace show et az servicebus queue authorization-rule keys list.

   az servicebus namespace show --name $SB_NS --resource-group $RG_NAME --query name -o tsv
   az servicebus queue authorization-rule keys list --namespace-name $SB_NS --resource-group $RG_NAME --queue-name orders --name sender --query primaryKey -o tsv
   

Azure PowerShell

1. Créer un espace de noms Azure Service Bus à l’aide du cmdlet New-AzServiceBusNamespace.

   New-AzServiceBusNamespace -Name $SB_NS -ResourceGroupName $RG_NAME -Location $LOC_NAME
   

2. Créez une file d’attente Azure Service Bus à l’aide du cmdlet New-AzServiceBusQueue.

   New-AzServiceBusQueue -Name orders -ResourceGroupName $RG_NAME -NamespaceName $SB_NS
   

3. Créez une règle d’autorisation Azure Service Bus à l’aide du cmdlet New-AzServiceBusAuthorizationRule.

   New-AzServiceBusAuthorizationRule `
       -Name sender `
       -NamespaceName $SB_NS `
       -ResourceGroupName $RG_NAME `
       -QueueName orders `
       -Rights Send
   

4. Obtenez les informations d’identification Azure Service Bus pour une utilisation ultérieure à l’aide des cmdlet Get-AzServiceBusNamespace et Get-AzServiceBusKey.

   (Get-AzServiceBusNamespace -Name $SB_NS -ResourceGroupName $RG_NAME).Name 
   (Get-AzServiceBusKey -NamespaceName $SB_NS -ResourceGroupName $RG_NAME -Name sender -QueueName orders).PrimaryKey
   

Mise à jour du fichier manifeste Kubernetes

Azure CLI

1. Configurez kubectl pour qu’il se connecte à votre cluster à l’aide de la commande az aks get-credentials.

   az aks get-credentials --resource-group myResourceGroup --name myAKSCluster
   

2. Ouvrez le fichier aks-store-quickstart.yaml dans un éditeur de texte.

3. Supprimez les sections StatefulSet, ConfigMap et Service rabbitmq existantes et remplacez la section Deployment order-service existante par le contenu suivant :

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: order-service
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: order-service
     template:
       metadata:
         labels:
           app: order-service
       spec:
         nodeSelector:
           "kubernetes.io/os": linux
         containers:
         - name: order-service
           image: <REPLACE_WITH_YOUR_ACR_NAME>.azurecr.io/aks-store-demo/order-service:latest
           ports:
           - containerPort: 3000
           env:
           - name: ORDER_QUEUE_HOSTNAME
             value: "<REPLACE_WITH_YOUR_SB_NS_HOSTNAME>" # Example: sb-store-demo-123456.servicebus.windows.net
           - name: ORDER_QUEUE_PORT
             value: "5671"
           - name: ORDER_QUEUE_TRANSPORT
             value: "tls"
           - name: ORDER_QUEUE_USERNAME
             value: "sender"
           - name: ORDER_QUEUE_PASSWORD
             value: "<REPLACE_WITH_YOUR_SB_SENDER_PASSWORD>"
           - name: ORDER_QUEUE_NAME
             value: "orders"
           - name: FASTIFY_ADDRESS
             value: "0.0.0.0"
           resources:
             requests:
               cpu: 1m
               memory: 50Mi
             limits:
               cpu: 75m
               memory: 128Mi
   

   Remarque

   L’ajout direct d’informations sensibles, telles que des clés API, à vos fichiers manifestes Kubernetes n’est pas sécurisé et peut être accidentellement validée dans des référentiels de code. Nous les avons ajoutées ici pour plus de simplicité. Pour les charges de travail de production, utilisez l’identité managée pour vous authentifier auprès d’Azure Service Bus, ou stockez vos secrets dans Azure Key Vault.

4. Enregistrez et fermez le fichier mis à jour aks-store-quickstart.yaml.

Azure PowerShell

1. Configurez kubectl pour qu’il se connecte à votre cluster à l’aide du cmdlet Import-AzAksCredential.

   Import-AzAksCredential -ResourceGroupName myResourceGroup -Name myAKSCluster
   

2. Ouvrez le fichier aks-store-quickstart.yaml dans un éditeur de texte.

3. Supprimez les sections Déploiement, ConfigMap et Service rabbitmq existantes et remplacez la section Déploiement order-service existante par le contenu suivant :

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: order-service
   spec:
     replicas: 1
     selector:
       matchLabels:
         app: order-service
     template:
       metadata:
         labels:
           app: order-service
       spec:
         nodeSelector:
           "kubernetes.io/os": linux
         containers:
         - name: order-service
           image: <REPLACE_WITH_YOUR_ACR_NAME>.azurecr.io/aks-store-demo/order-service:latest
           ports:
           - containerPort: 3000
           env:
           - name: ORDER_QUEUE_HOSTNAME
             value: "<REPLACE_WITH_YOUR_SB_NS_HOSTNAME>" # Example: sb-store-demo-123456.servicebus.windows.net
           - name: ORDER_QUEUE_PORT
             value: "5671"
           - name: ORDER_QUEUE_TRANSPORT
             value: "tls"
           - name: ORDER_QUEUE_USERNAME
             value: "sender"
           - name: ORDER_QUEUE_PASSWORD
             value: "<REPLACE_WITH_YOUR_SB_SENDER_PASSWORD>"
           - name: ORDER_QUEUE_NAME
             value: "orders"
           - name: FASTIFY_ADDRESS
             value: "0.0.0.0"
           resources:
             requests:
               cpu: 1m
               memory: 50Mi
             limits:
               cpu: 75m
               memory: 128Mi
   

   Remarque

   L’ajout direct d’informations sensibles, telles que des clés API, à vos fichiers manifestes Kubernetes n’est pas sécurisé et peut être accidentellement validée dans des référentiels de code. Nous les avons ajoutées ici pour plus de simplicité. Pour les charges de travail de production, utilisez l’identité managée pour vous authentifier auprès d’Azure Service Bus, ou stockez vos secrets dans Azure Key Vault.

4. Enregistrez et fermez le fichier mis à jour aks-store-quickstart.yaml.

Déployer l’application mise à jour

• Déployez l’application mise à jour à l’aide de la commande kubectl apply.

  kubectl apply -f aks-store-quickstart.yaml
  

  L’exemple de sortie suivant montre les ressources mises à jour avec succès :

  deployment.apps/order-service configured
  service/order-service unchanged
  deployment.apps/product-service unchanged
  service/product-service unchanged
  deployment.apps/store-front configured
  service/store-front unchanged
  

Test de l’application

Passer un exemple de commande

1. Obtenez l’adresse IP externe du service store-front à l’aide de la commande kubectl get service.

   kubectl get service store-front
   

2. Accédez à l’adresse IP externe du service store-front dans votre navigateur à l’aide de http://<external-ip>.

3. Passez une commande en choisissant un produit et en sélectionnant Ajouter au panier.

4. Sélectionnez Panier pour afficher votre commande, puis sélectionnez Finaliser la commande.

Afficher la commande dans la file d’attente Azure Service Bus

1. Accédez au portail Microsoft Azure et ouvrez l’espace de noms Azure Service Bus que vous avez créé précédemment.
2. Sous Entités, sélectionnez Files d’attente, puis sélectionnez la file d’attente des commandes.
3. Dans la file d’attente des commandes, sélectionnez Service Bus Explorer.
4. Sélectionnez Aperçu depuis le début pour afficher la commande que vous avez envoyée.

Étapes suivantes

Dans ce tutoriel, vous avez utilisé Azure Service Bus pour mettre à jour et tester l’exemple d’application. Vous avez appris à :

• Créez un espace de noms et une file d’attente Azure Service Bus.
• Mettez à jour le fichier manifeste Kubernetes pour utiliser la file d’attente Azure Service Bus.
• Testez l’application mise à jour en plaçant une commande.

Dans le tutoriel suivant, vous allez apprendre à mettre à l’échelle une application dans AKS.

Mettre à l’échelle des applications dans AKS