Gérer Openflow

Cette rubrique décrit les étapes de la gestion des composants Openflow.

Supprimer un déploiement

À partir de la console AWS :

  1. Naviguez jusqu’aux instances EC2

  2. Sélectionnez l’instance openflow-agent-{deployment-key} avec votre clé de déploiement.

  3. En haut de la page, cliquez sur Connect.

  4. Passez de EC2 Instance Connect à Connect using EC2 Instance Connect Endpoint. Laissez le point de terminaison par défaut de EC2 Instance Connect.

  5. Cliquez sur Connect. Un nouvel onglet ou une nouvelle fenêtre du navigateur apparaît avec une interface de ligne de commande.

  6. Exécutez ./destroy.sh depuis l’interface système.

    • Cette opération peut prendre 20 à 30 minutes. Si votre connexion est interrompue, le processus continue son exécution en arrière-plan.

    • Vous pouvez vous reconnecter et voir son état avec la commande : journalctl -u docker -f -n 250

    • Le processus destroy est terminé lorsque vous voyez la sortie de delete successful.

  7. Naviguez sur CloudFormation dans la console AWS pour votre région.

  8. Supprimez la pile CloudFormation pour votre déploiement.

À partir de Snowsight :

  1. Naviguez vers Openflow.

  2. Sélectionnez l’onglet Deployments.

  3. Dans la ligne du déploiement que vous souhaitez supprimer, sélectionnez l’icône Plus d’options.

  4. Sélectionnez Delete.

  5. Dans la boîte de dialogue de confirmation, saisissez delete pour confirmer la suppression.

  6. Cliquez sur Delete deployment.

Mise à niveau d’un déploiement

Dans le cadre du déploiement d’Openflow, plusieurs composants peuvent nécessiter une mise à jour. Actuellement, cette opération est exécutée par le biais d’un script de l’agent de déploiement Openflow. Les composants comprennent l’agent, le service de déploiement, l’UI de déploiement, la passerelle d’exécution et l’opérateur d’exécution. Tous les composants seront mis à niveau selon les procédures suivantes.

Connexion à l’agent de déploiement

  1. Naviguez vers Openflow.

  2. Sélectionnez l’onglet Deployments.

  3. Voyez les détails de votre déploiement et notez la clé de déploiement.

  4. Dans votre compte AWS, affichez les instances EC2 et filtrez-les à l’aide de la clé de déploiement.

  5. Localisez l’instance de l’agent de déploiement EC2 nommée openflow-agent-{deployment-key}.

  6. Connectez-vous à l’aide du point de terminaison de connexion à l’instance EC2 et en acceptant toutes les valeurs par défaut.

  7. Exécutez les commandes restantes à partir du nouvel onglet du navigateur ou de la nouvelle fenêtre qui apparaît avec une interface de ligne de commande.

Vérifiez si des mises à niveau sont disponibles

cat ~/.upgrade
Copy

Le script affichera la dernière version disponible des différents composants de déploiement.

Si aucune mise à niveau n’est disponible, vous verrez une sortie similaire à ceci :

AGENT_IMAGE_VERSION_UPGRADE=
OPERATOR_CHART_VERSION_UPGRADE=
GATEWAY_IMAGE_VERSION_UPGRADE=
DPS_CHART_VERSION_UPGRADE=
DPUI_CHART_VERSION_UPGRADE=

Sinon, vous verrez la version que les composants mis à niveau utiliseront, comme :

AGENT_IMAGE_VERSION_UPGRADE=0.17.0
OPERATOR_CHART_VERSION_UPGRADE=0.31.0
GATEWAY_IMAGE_VERSION_UPGRADE=
DPS_CHART_VERSION_UPGRADE=
DPUI_CHART_VERSION_UPGRADE=

Lancer la mise à niveau

Si la sortie indique que des mises à niveau sont disponibles, exécutez le script suivant pour lancer la mise à niveau. Les déploiements Openflow plus anciens peuvent utiliser le script upgrade-data-plane.sh à la place.

./upgrade.sh
Copy

Vous verrez une sortie similaire à celle-ci :

openflow-data-plane-agent-aws is set to version 0.16.0
   Upgrade set to version 0.17.0
openflow-dataplane-service-chart is set to version 0.47.0
   No upgrade is available
openflow-dataplane-ui-chart is set to version 0.5.0
   No upgrade is available
openflow-runtime-gateway is set to version 2025.6.8.2
   No upgrade is available
runtime-operator-chart is set to version 0.30.0
   Upgrade set to version 0.31.0

Ensuite, vous avez deux options :

  • Attendez une mise à niveau automatique : le système lancera automatiquement le processus de mise à niveau dans un délai d’environ 10 minutes.

  • Mise à niveau manuelle : pour démarrer la mise à niveau immédiatement, exécutez la commande suivante :

./create.sh
Copy

Contrôler le processus de mise à niveau

Pour suivre la progression de la mise à niveau, utilisez la commande journalctl:

journalctl -u openflow-apply-infrastructure -f -n 250
Copy

Vérifier la réussite de la mise à niveau

Une mise à niveau réussie présente généralement une sortie similaire à celle-ci :

All resources applied successfully and log uploaded to s3
openflow-apply-infrastructure.service: Deactivated successfully

Mise à niveau d’un environnement d’exécution

Les mises à jour seront rendues disponibles par Snowflake, à la fois lors de l’introduction de nouveaux processeurs Openflow ou de nouvelles versions de processeurs existants, ainsi que lors de l’introduction de nouvelles fonctionnalités de l’environnement d’exécution d’Openflow. Lorsque des mises à jour sont disponibles pour les runtimes Openflow, vous verrez une icône Upgrade à côté de votre environnement d’exécution dans l’UI Openflow.

Pour mettre à niveau un environnement d’exécution, procédez comme suit :

  1. Naviguez vers Openflow.

  2. Sélectionnez l’onglet Runtimes.

  3. Un indicateur à côté du nom de l’environnement d’exécution indique si une mise à niveau est disponible.

  4. Dans la ligne de l’environnement d’exécution que vous souhaitez mettre à niveau, sélectionnez l’icône Plus d’options.

  5. Sélectionnez Upgrade.

Mettre à niveau un connecteur

Les mises à jour des connecteurs sont mises à disposition par Snowflake lorsque des fonctionnalités sont ajoutées, que la logique de traitement est améliorée ou que de nouvelles versions de processeurs sont utilisées.

Par exemple, pour ajouter la prise en charge d’une nouvelle version de l’API source.

Lorsque les mises à jour des connecteurs sont disponibles, vous voyez une icône Upgrade dans votre groupe de processus sur la zone de préparation.

Note

Vous ne pouvez mettre à niveau les connecteurs qu’après avoir mis à niveau leur environnement d’exécution.

Pour mettre à niveau un connecteur, procédez comme suit :

  1. Naviguez vers Openflow.

  2. Sélectionnez l’onglet Runtimes.

  3. Cliquez sur le nom de l’environnement d’exécution ou sélectionnez « Afficher le canevas » dans le menu Plus d’options pour naviguer jusqu’au canevas.

  4. Localisez le(s) groupe(s) de processeur(s) qui affiche une flèche de mise à niveau rouge à côté de son nom.

  5. Faites un clic droit sur le groupe de processus et sélectionnez Version » Change Version.

  6. Sélectionnez la dernière version disponible et sélectionnez Change.

  7. Confirmez que votre connecteur a été mis à niveau vers la dernière version qui doit maintenant afficher une coche verte. Vous pouvez également valider la version en passant votre souris sur la bulle de dialogue en bas à droite du groupe de processus.

Configurer le registre de flux de Snowflake Connector

Important

Les premières prévisualisations préliminaires d’Openflow ne configuraient pas les environnements d’exécution pour les mises à niveau des connecteurs. Si vous ne voyez pas l’option Version lorsque vous cliquez avec le bouton droit sur un groupe de processus, vous devez configurer le registre de flux de Snowflake Connector et activer manuellement le contrôle de version pour les connecteurs existants.

Pour configurer le registre de flux de Snowflake Connector, procédez comme suit :

  1. Accédez au canevas.

  2. Cliquez sur le menu dans le coin supérieur droit et sélectionnez Controller Settings.

  3. Passez à l’onglet Registry Clients.

  4. Cliquez sur l’icône + pour ajouter un nouveau client de registre.

  5. Sélectionnez le ConnectorFlowRegistryClient et sélectionnez Add.

  6. Cliquez sur More Options pour la ligne ConnectorFlowRegistryClient et sélectionnez Edit.

  7. Entrez /nifi/configuration_resources/connector_flow_registry comme valeur pour Storage Location et sélectionnez Apply.

Après avoir configuré le registre de flux de Snowflake Connector, vous pouvez maintenant activer le contrôle de version pour vos connecteurs existants.

Pour activer le contrôle de version pour les connecteurs existants, procédez comme suit :

  1. Accédez à la zone de préparation et localisez le groupe de processus auquel vous souhaitez ajouter le contrôle de version.

  2. Faites un clic droit sur le groupe de processus et sélectionnez Version » Set Version.

  3. Dans la boîte de dialogue Set Version, choisissez le flux qui correspond à votre groupe de processus.

    Par exemple, choisissez sqlserver si vous utilisez le connecteur de serveur SQL.

    Notez que les noms des flux ne correspondent pas exactement au nom des connecteurs.

  4. Sélectionnez la dernière version, puis Set version pour activer le contrôle de version.

  5. Dans le canevas, faites à nouveau un clic droit sur le groupe de processus et sélectionnez Version » Revert Local Changes pour appliquer la dernière version du connecteur.

  6. Examinez la liste des modifications et sélectionnez Revert.

  7. Confirmez que votre connecteur a été mis à niveau vers la dernière version qui doit maintenant afficher une coche verte. Vous pouvez également valider la version en passant votre souris sur la bulle de dialogue en bas à droite du groupe de processus.

Langage: Français