Démarrer
Aperçu
Cette section présente comment exécuter rapidement le conteneur WorkflowGen avec une architecture minimale sur Kubernetes.
Il existe des limitations connues lors de l'utilisation de l'isolation Hyper-V avec le conteneur WorkflowGen dans les versions 7.19.x et antérieures de WorkflowGen. Il est recommandé d'utiliser exclusivement l'isolation de processus. Cette limitation ne s'applique plus à partir de la version 7.20.0 de WorkflowGen.
Kubernetes avec AKS
Cet exemple est conçu pour Azure Kubernetes Service (AKS). Pour commencer avec AKS, consultez l'article Microsoft Créer un conteneur Windows Server sur un cluster Azure Kubernetes Service (AKS) à l’aide d’Azure CLI.
Aperçu de l'architecture
À la fin de cette section, vous aurez cette configuration de cluster :
Chaque conteneur du cluster aura accès à la configuration et aux secrets à l'intérieur de leurs espaces de noms. Plusieurs services Azure seront déployés par Azure Kubernetes Service. Cela ne nécessite aucune étape manuelle autre que l'interaction avec Kubernetes lui-même. L'équilibreur de charge que le service créera répartira les demandes entre les répliques de serveur WorkflowGen.
Prérequis
Vous devez avoir un cluster Kubernetes fonctionnel avec des nœuds Windows Server 2019. Voir la vue des ressources Azure ci-dessus pour une configuration AKS de base. Consultez l'article Microsoft Déployer un conteneur Windows Server sur un cluster Azure Kubernetes Service (AKS) à l’aide d’Azure CLI pour commencer à créer un cluster AKS avec le support des nœuds Windows.
Vous devez avoir installé l'outil de ligne de commande kubectl et il doit être connecté au cluster. Consultez la section Se connecter au cluster de l'article Microsoft Déployer un conteneur Windows Server sur un cluster Azure Kubernetes Service (AKS) à l’aide d’Azure CLI pour obtenir des instructions sur la connexion de kubectl à AKS.
Notez également que vous ne devez pas créer d'autres ressources dans Azure en dehors du cluster et ses nœuds. Toutes les ressources requises pour les conteneurs seront créées automatiquement par Kubernetes. AKS est une plateforme entièrement gérée.
Ajoutez un PersistentVolumeClaim pour le stockage partagé
Maintenant, vous devez ajouter une revendication qui représente le volume de données WorkflowGen qui sera utilisé par votre déploiement. Pour ce faire, appliquez le YAML suivant à votre cluster :
Ensuite, appliquez-le au cluster à l'aide de la commande suivante :
Ajoutez votre fichier de licence WorkflowGen au cluster
Kubernetes vous permet de gérer les secrets et les configurations sous forme de fichiers à l'intérieur du cluster et de les injecter dans des pods. Dans ce cas, vous ajouterez votre fichier de licence en tant que secret et l'injecterez plus tard au module WorkflowGen. Pour ajouter votre licence au cluster, exécutez la commande suivante :
Ajoutez des ConfigMap pour les services
Comme mentionné précédemment, il existe un mécanisme dans Kubernetes qui vous permet de gérer les configurations de vos conteneurs. Ici, vous allez en créer un pour WorkflowGen et un autre pour la base de données :
La valeur WFGEN_APP_SETTING_ApplicationUrl
sera remplacée par l'adresse IP de l'équilibreur de charge après la création des services WorkflowGen. Par conséquent, peu importe pour l'instant ce qui y est mis car il sera modifié plus tard dans cet exemple.
N'oubliez pas d'appliquer cette configuration :
Ajoutez des secrets pour les services
Kubernetes gère également des secrets pour vous. Ils sont stockés en toute sécurité et ne sont remis aux conteneurs que sous forme de fichiers.
Vous avez besoin d'une clé de cryptage pour mettre comme secret :
Avant de créer les secrets, vous devez les encoder en base64 :
Remplacez <YOUR_WFG_LIC_KEY>
par votre clé de licence WorkflowGen et remplacez <YOUR_NEW_GUID>
par le GUID que vous avez généré.
Ces valeurs encodées iront dans la déclaration des secrets. Pour créer les secrets requis pour les services, appliquez le code YAML suivant :
Remplacez YOUR_WFG_LIC_KEY_BASE64>
par la valeur générée à l'étape précédente pour la clé de licence WorkflowGen et remplacez <YOUR_NEW_GUID_BASE64>
par la valeur générée à l'étape précédente pour le nouveau GUID.
N'oubliez pas d'appliquer ceci :
Déployez les conteneurs
Vous êtes maintenant prêt à déployer les services. Vous allez créer deux objets Deployment et un objet ReplicaSet. Le déploiement créera des ReplicaSet pour tous les services avec différentes configurations. Ces déploiements peuvent ensuite être configurés pour évoluer automatiquement avec l'utilisation des pods. Le ReplicaSet fournira les services nécessaires au conteneur de base de données afin de fonctionner correctement et d'éviter les pertes de données. N'oubliez pas qu'il ne doit y avoir qu'une seule instance de chaque service Windows WorkflowGen en cours d'exécution à tout moment. Ce modèle de conteneur est appelé Singleton.
Base de données
Cette configuration déploiera la base de données StatefulSet avec un service en mode sans affichage (« headless service »). Cet objet créera également une revendication de volume persistante basée sur le modèle fourni dans la déclaration.
Appliquez d'abord la base de données :
Applications Web WorkflowGen
Appliquez ce contrôleur de réplication :
Déploiement des services Windows
Appliquez les services Windows :
Ajoutez un équilibreur de charge
Maintenant, vous devez ajouter un équilibreur de charge public pour envoyer des demandes à vos pods. Pour ce faire, exécutez la commande suivante :
Vous devez maintenant attendre que l'IP soit approvisionné. Exécutez périodiquement la commande suivante jusqu'à obtenir l'adresse IP publique de l'équilibreur de charge :
Une fois que la valeur de EXTERNAL-IP
est provisionnée, copiez-la et modifiez la configuration de WorkflowGen pour modifier la valeur WFGEN_APP_SETTING_ApplicationUrl
:
Remplacez <EXTERNAL_IP>
par la valeur de EXTERNAL-IP
que vous avez.
Appliquez-le :
Ensuite, redémarrez tous les pods du déploiement WorkflowGen pour leur appliquer les modifications. Vous devez également le faire pour les services Windows. Pour ce faire, exécutez les commandes suivantes :
Vous devriez maintenant avoir un WorkflowGen fonctionnel avec un équilibreur de charge et une base de données.
Kubernetes avec AKS utilisant Helm
Helm est un outil de type gestionnaire de packages pour Kubernetes. Il gère le partage, le déploiement, les mises à jour et les restaurations des logiciels développés pour Kubernetes. En fonction des valeurs fournies, Helm génère des fichiers de définition pour le cluster avec le moteur de modèle à partir du langage de programmation Go. Pour chaque version, WorkflowGen produit désormais une carte que vous pouvez utiliser avec votre cluster. Pour obtenir les dernières corrections de bogues et fonctionnalités de la carte, assurez-vous de toujours choisir la carte publiée avec la dernière mise à jour de WorkflowGen.
Aperçu de l'architecture
À la fin de cette section, vous aurez cette configuration de cluster :
Chaque conteneur du cluster aura accès à la configuration et aux secrets à l'intérieur de leurs espaces de noms. Plusieurs services Azure seront déployés par Azure Kubernetes Service. Cela ne nécessite aucune étape manuelle autre que l'interaction avec Kubernetes lui-même. L'équilibreur de charge que le service créera répartira les demandes entre les répliques de serveur WorkflowGen.
Prérequis
Vous devez avoir un cluster Kubernetes fonctionnel avec des nœuds Windows Server 2019. Voir la vue des ressources Azure ci-dessus pour une configuration AKS de base. Consultez l'article Microsoft Déployer un conteneur Windows Server sur un cluster Azure Kubernetes Service (AKS) à l’aide d’Azure CLI pour commencer à créer un cluster AKS avec le support des nœuds Windows.
Vous devez avoir installé l'outil de ligne de commande kubectl et il doit être connecté au cluster. Consultez la section Se connecter au cluster de l'article Microsoft Déployer un conteneur Windows Server sur un cluster Azure Kubernetes Service (AKS) à l’aide d’Azure CLI pour obtenir des instructions sur la connexion de kubectl à AKS.
Vous devez avoir installé l'outil de ligne de commande Helm. Consultez la section Installing Helm (disponible en anglais uniquement) sur le site Web de Helm pour savoir comment l'installer. Seules les versions Helm 3.0 et ultérieures sont supportées.
Notez également que vous ne devez pas créer d'autres ressources dans Azure en dehors du cluster et ses nœuds. Toutes les ressources requises pour les conteneurs seront créées automatiquement par Kubernetes. AKS est une plateforme entièrement gérée.
Créez la clé de chiffrement symétrique
Cette valeur doit être générée par vous. Un GUID simple suffira car il a une entropie suffisante pour ne pas être deviné :
Ajoutez votre fichier de licence WorkflowGen au cluster
Kubernetes vous permet de gérer les secrets et les configurations sous forme de fichiers à l'intérieur du cluster et de les injecter dans des pods. Dans ce cas, vous ajouterez votre fichier de licence en tant que secret et l'injecterez plus tard au module WorkflowGen. Pour ajouter votre licence au cluster, exécutez la commande suivante :
Créez un fichier avec vos valeurs pour la carte
Afin de générer les modèles adaptés à vos attentes de configuration, vous devez fournir certaines valeurs à la commande helm lorsque vous installez ou mettez à jour une version. Vous pouvez spécifier ces valeurs à l'aide de l'interface de ligne de commande ou avec un fichier. Dans le cas d'une nouvelle installation, ce sera plus facile avec un fichier. Voici les valeurs dont vous aurez besoin :
Remplacez <YOUR_WFG_LIC_KEY>
par votre clé de licence WorkflowGen et remplacez <YOUR_NEW_GUID>
par le GUID que vous avez généré.
Vous pouvez enregistrer ce fichier sous values.yaml
. Le nom n'est pas important.
Installez la carte WorkflowGen
Vous devez maintenant installer la carte avec ces valeurs. Pour ce faire, exécutez la commande suivante :
Helm va générer des fichiers de déploiement Kubernetes pour vous et les installer sur le cluster.
Mettez à jour l'URL de l'application
Cette configuration créera un équilibreur de charge devant les conteneurs WorkflowGen. Vous devrez l'attendre pour obtenir une adresse IP publique. Exécutez périodiquement la commande suivante jusqu'à obtenir l'adresse IP publique de l'équilibreur de charge :
Une fois la valeur de EXTERNAL-IP
approvisionnée, copiez-la et modifiez la configuration de WorkflowGen pour modifier la valeur WFGEN_APP_SETTING_ApplicationUrl
. Pour ce faire, vous devez d'abord obtenir le nom du ConfigMap associé au déploiement de WorkflowGen. La commande suivante vous donnera tous les objets ConfigMap dans l'espace de noms par défaut :
Copiez le nom de WorkflowGen ConfigMap et remplacez <WFG_CONFIG_MAP>
par la valeur dans la commande suivante :
Cela fera apparaître un éditeur afin que vous puissiez remplacer la valeur WFGEN_APP_SETTING_ApplicationUrl
par l'adresse IP correcte du service d'équilibrage de charge. Enregistrez le fichier et quittez l'éditeur. Pour appliquer les modifications apportées à l'objet ConfigMap, redémarrez tous les pods du déploiement WorkflowGen. Vous devez également le faire pour les services Windows. Obtenez le nom des déploiements avec la commande suivante :
Remplacez <WEB_APPS_DEPLOYMENT_NAME>
et <WIN_SERVICES_DEPLOYMENT_NAME>
dans le script suivant par les noms de déploiement corrects pour redémarrer tous les conteneurs :
Vous devriez maintenant avoir un WorkflowGen fonctionnel avec un équilibreur de charge et une base de données.
Dernière mise à jour