Déploiement de solutions d'intégration dans un environnement de production

Après avoir créé et rempli un fichier BAR avec les ressources de développement, vous pouvez déployer la solution d'intégration sur un serveur d'intégration.

Avant de commencer

Pour ce faire, procédez comme suit :
Remarque :

Le mode de fonctionnement d' IBM® App Connect Enterprise peut avoir une incidence sur le nombre de serveurs d'intégration et de flux de messages que vous pouvez déployer. Pour plus d'informations, voir Modes de fonctionnement.

A propos de cette tâche

Si vous modifiez un fichier BAR et souhaitez propager ces modifications à un ou plusieurs serveurs d'intégration, vous devez supprimer le fichier BAR existant du serveur d'intégration et déployer le nouveau fichier.

Déploiement d'un fichier BAR à l'aide de l'interface utilisateur Web

A propos de cette tâche

Vous pouvez sélectionner un fichier BAR et le déployer sur un serveur d'intégration à l'aide de l'interface utilisateur Web.

Vous pouvez également sélectionner un fichier de substitution, qui définit les propriétés du fichier BAR que vous souhaitez modifier pour un déploiement spécifique. Pour plus d'informations, voir mqsiapplybaroverride command.

Procédure

  1. Démarrez l'interface utilisateur web pour votre nœud d'intégration ou votre serveur d'intégration indépendant, comme décrit dans Accéder à l'interface utilisateur web.
    Pour un noeud d'intégration, l'interface utilisateur Web affiche les serveurs d'intégration du noeud. Pour un serveur d'intégration, l'interface utilisateur Web affiche les flux de messages déployés du serveur et d'autres ressources.
  2. Sélectionnez l'action Déployer .
    Par exemple :
    • Dans l'interface utilisateur Web d'un noeud d'intégration, sélectionnez le serveur d'intégration requis (sur lequel vous souhaitez déployer le fichier BAR ), puis cliquez sur Déployer.
    • Dans l'interface utilisateur Web d'un serveur d'intégration indépendant, cliquez sur Déployer.
  3. Suivez les instructions qui s'affichent.

Résultats

Le contenu du fichier BAR est déployé sur le serveur d'intégrationet les ressources déployées sont affichées.

Déploiement d'un fichier BAR à l'aide de la boîte à outils « IBM App Connect Enterprise »

A propos de cette tâche

Pour déployer un fichier BAR à l'aide de l 'outil « IBM App Connect Enterprise », procédez comme suit. Vous ne pouvez effectuer le déploiement que sur un seul serveur d'intégration à la fois.

Procédure

  1. Facultatif: En règle générale, un déploiement incrémentiel du fichier BAR est effectué. Pour effectuer un déploiement complet du fichier BAR, cliquez avec le bouton droit de la souris sur la cible serveur d'intégration dans le Explorateur d'intégration vue et cliquez sur Supprimer > Tous les flux et ressources.
    Attendez la fin de l'opération avant de continuer.

    Pour ne rafraîchir que certaines ressources avec le contenu du fichier BAR, ne cliquez pas sur Supprimer > Tous les flux et ressources.

  2. Déployez un fichier BAR sur un serveur d'intégration à l'aide de l'une des méthodes suivantes.
    • Faites glisser le fichier BAR sur votre serveur d'intégration cible dans la vue Integration Explorer.
    • Cliquez avec le bouton droit de la souris sur le fichier BAR , puis cliquez sur Déployer et sélectionnez le serveur d'intégrationcible.
    • Cliquez avec le bouton droit de la souris sur le serveur d'intégrationcible, cliquez sur Déployer, sélectionnez BAR from workspace ou BAR from file system, sélectionnez le fichier BAR que vous souhaitez déployer, puis cliquez sur OK.
  3. Si le fichier BAR a été modifié depuis sa dernière édition, vous êtes invité à indiquer si vous souhaitez sauvegarder le fichier avant le déploiement. Si vous cliquez sur Annuler, le fichier BAR n'est pas sauvegardé et le déploiement n'a pas lieu.

Résultats

Le contenu du fichier BAR (par exemple, les flux de messages et les ensembles de messages) est déployé sur le serveur d'intégration. Dans la vue Explorateur d'intégration, les ressources déployées sont ajoutées au serveur d'intégrationapproprié.

Précompilation et déploiement d'un fichier BAR à l'aide de la commande mqsibar

A propos de cette tâche

Vous pouvez utiliser la commande mqsibar pour déployer un fichier BAR sur un serveur d'intégration, en décompressant le contenu directement dans le répertoire run du serveur d'intégration. Vous pouvez également choisir de précompiler les ressources contenues dans le fichier BAR (telles que le schéma XML, le schéma DFDL et les mappes de données graphiques) afin qu'elles soient prêtes à être exécutées au démarrage du serveur d'intégration.

Vous pouvez utiliser la commande mqsibar dans un script, dans le cadre d'un processus automatisé qui peut inclure des commandes de test, d'optimisation, de déploiement et d'exécution de l'application, comme alternative au déploiement via le kit d'outils ou l'interface utilisateur Web. Cette méthode peut s'avérer particulièrement utile si vous exécutez IBM App Connect Enterprise dans un conteneur cloud.

Déployez un fichier BAR à l'aide de la commande mqsibar en procédant comme suit.

Procédure

  1. Ouvrez une fenêtre de commande configurée pour votre environnement.
    Pour plus d'informations sur la configuration de votre environnement de commande en vue de l'exécution des commandes, voir Mise en place d'un environnement de commande.
  2. Exécutez la commande mqsibar , comme illustré dans l'exemple suivant:
    Sous Windows et Linux®:
    Décompressez le fichier BAR et compilez les ressources dans le répertoire de travail du serveur d'intégration, prêt à être exécuté lorsque le serveur d'intégration démarre:
    mqsibar -a myAppAndShLibs.bar -c -w /sis01Wrk
    où :
    • -a indique le nom du fichier BAR d'entrée à traiter.

      Le fichier BAR doit contenir toutes les ressources référencées. Si une application du fichier BAR fait référence à une bibliothèque contenue dans un autre fichier BAR, une erreur se produit.

    • -c indique que le contenu du fichier BAR est compilé par la commande.

      Les ressources incluses dans le fichier BAR, telles que le schéma DFDL, le schéma XML et les mappes de données graphiques, sont compilées suite à la spécification de ce paramètre.

    • -w indique le répertoire de travail du serveur d'intégration.

      Lorsque vous utilisez -c et -w, toutes les applications et bibliothèques du répertoire de travail sont traitées, et pas seulement celles du fichier BAR. Cette opération permet de s'assurer que toutes les ressources sont valides et prêtes à être exécutées.

      Le répertoire de travail du serveur d'intégration est créé par la commande mqsicreateworkdir , que vous exécutez lorsque vous configurez le serveur d'intégration. Lorsque le répertoire de travail est créé, un sous-répertoire run est également créé et c'est dans ce répertoire que le contenu du fichier BAR est décompressé lors de l'exécution de la commande mqsibar . Pour plus d'informations sur la configuration et le démarrage d'un serveur d'intégration, voir Configurer un serveur d'intégration en modifiant le fichier server.conf.yaml et Démarrer un serveur d'intégration.

    Pour plus d'informations sur l'utilisation de la commande mqsibar, voir commande mqsibar.

  3. Démarrez (ou redémarrez) le serveur d'intégration pour que les modifications prennent effet.

Résultats

La commande signale quand des réponses sont reçues du serveur d'intégration. Si la commande aboutit, elle renvoie 0 (zéro).

Déploiement d'un fichier BAR à l'aide de la commande mqsideploy

A propos de cette tâche

Pour déployer un fichier BAR à l'aide de la commande mqsideploy , procédez comme suit.

Procédure

  1. Ouvrez une fenêtre de commande configurée pour votre environnement.
  2. Entrez la commande appropriée pour votre système d'exploitation et votre configuration, en utilisant les exemples suivants comme guide.
    mqsideploy -i ipAddress -p port -a barfile
    mqsideploy --admin-host ipAddress --admin-port port --bar-file barfile

    La commande effectue un déploiement incrémentiel. Pour effectuer un déploiement complet du fichier BAR , ajoutez le paramètre -m .

    Les paramètres -i (adresse IP) et -p (port) représentent les détails de connexion du serveur d'intégration indépendant ou du noeud d'intégration.

    Si vous déployez sur un noeud d'intégration, vous devez également spécifier le paramètre -e (nom duserveur d'intégration ). Si vous souhaitez exécuter cette commande sur un nœud d'intégration sur le même ordinateur, vous pouvez spécifier le nom du nœud d'intégration au lieu de -i et -p, comme dans l'exemple suivant :

    mqsideploy integrationNodeName -e integrationServerName
    -a barfile

    Si tu as un.broker fichier qui contient les détails de connexion pour un serveur d'intégration indépendant ou un nœud d'intégration, vous pouvez spécifier ce fichier au lieu de -i et -p en utilisant le-n paramètre, comme dans l'exemple suivant :

    mqsideploy -n integrationNodeFileName -e integrationServerName
    -a barfile
    integrationNodeFileName est le chemin et le nom du fichier du.broker déposer.

    Pour plus d'informations sur la commande et sur les noms longs alternatifs pour les paramètres, voir mqsideploy command.

Résultats

La commande signale quand des réponses sont reçues du noeud d'intégration ou du serveur d'intégration indépendant. Si la commande aboutit, elle renvoie 0 (zéro).

Déploiement d'un fichier BAR à l'aide de l' IBM

A propos de cette tâche

Pour déployer un fichier BAR à l'aide de l' IBM Integration API, utilisez la méthode deploy de la classe ExecutionGroupProxy .

Le code suivant montre comment une application peut effectuer un déploiement incrémentiel:
import
com.ibm.broker.config.proxy.*;
public class DeployBAR {

  public static void main(String[] args) {
    BrokerConnectionParameters bcp =
       new IntegrationNodeConnectionParameters("localhost",
4414);
    try {
      BrokerProxy b = BrokerProxy.getInstance(bcp);
      ExecutionGroupProxy eg = b.getExecutionGroupByName("default");
      DeployResult dr = eg.deploy("MyBAR.bar", true, 30000);
      System.out.println("Result = "+dr.getCompletionCode());
    } catch (Exception e) {
      e.printStackTrace();
    }
  }
}
Par défaut, la méthode deploy effectue un déploiement incrémentiel. Pour effectuer un déploiement complet, utilisez une variante de la méthode qui inclut une valeur false pour le paramètre booléen isIncremental . Par exemple, eg.deploy("MyBAR.bar", false, 30000).

Déployer un BAR fichier à IBM App Connect Enterprise as a Service

Avec App Connect Enterprise as a Service, vous pouvez déployer et gérer des solutions d'intégration développées dans le App Connect Boîte à outils.

Avant de commencer

  • Avant de pouvoir déployer une solution d'intégration pour App Connect Enterprise as a Service, vous devez acheter un abonnement. Pour plus d'informations, voir App Connect as a Service pricing plans dans la App Connect Enterprise as a Service documentation.
  • Pour vérifier si les ressources des fichiers BAR sont prises en charge dans App Connect Enterprise as a Service, voir Ressources prises en charge dans les fichiers BAR importés dans la documentation App Connect Enterprise as a Service.

A propos de cette tâche

App Connect Enterprise as a Service fournit un environnement entièrement géré que vous pouvez utiliser pour déployer des solutions d'intégration dans le cloud sans avoir besoin d'acquérir et de maintenir une infrastructure informatique.

Vous déployez une solution pour App Connect Enterprise as a Service en téléchargeant le BAR fichier vers le cloud. Pour plus d'informations, voir Déploiement des intégrations dans la App Connect Enterprise as a Service documentation.

Déploiement d'un fichier BAR dans IBM App Connect dans des conteneurs

En utilisant IBM Cloud Pak for Integration ou App Connect Enterprise, vous pouvez déployer une intégration IBM App Connect Enterprise Toolkit afin qu'elle s'exécute sur un serveur d'intégration au sein du conteneur.

Avant de commencer

Avant de pouvoir déployer une solution d'intégration dans IBM App Connect dans des conteneurs, vous devez installer IBM App Connect à l'aide de Opérateur IBM App Connectet créer une instance de Tableau de bord App Connect dans laquelle vous souhaitez déployer le fichier BAR.
  • Vérifiez que vous avez accès au tableau de bordApp Connect.

A propos de cette tâche

Vous créez le serveur d'intégration en téléchargeant votre intégration IBM App Connect Enterprise Toolkit sous la forme d'un fichier BAR (Broker Archive) à l'aide du tableau de bord App Connect.

Après avoir téléchargé votre fichier BAR, vous pouvez créer des configurations qui peuvent être appliquées au serveur d'intégration lorsque vous le déployez et configurer les détails du serveur d'intégration.

Le serveur d'intégration s'affiche sous la forme d'une vignette dans la page Serveurs du tableau de bord, avec le statut initial Unavailable, qui devient Started une fois le déploiement terminé.

Pour des instructions détaillées sur le déploiement des fichiers BAR dans IBM App Connect dans des conteneurs, voir la documentation suivante:

Etape suivante

Vous pouvez cliquer sur la vignette du serveur d'intégration pour afficher l'intégration déployée. Dans la page Serveurs , vous pouvez également afficher les intégrations de tous les serveurs d'intégration répertoriés en cliquant sur Intégrations pour ouvrir la page Intégrations .