Configuration de votre pipeline pour créer un package de personnalisation

Une fois que les développeurs ont vérifié le code dans votre référentiel de code source, vous devez créer un package de personnalisation pour inclure le nouveau code.

Assurez-vous que votre pipeline peut accéder à une machine Windows sur laquelle est installé. inclut un utilitaire WCB que vous pouvez utiliser pour créer votre package de personnalisation. L'utilitaire WCB crée un package ZIP dans la structure de fichiers spécifique, nécessaire pour créer de nouvelles images Docker. Vous pouvez créer un package de personnalisation ciblé pour une application spécifique (search-app, xc-app ou ts-app). L'arborescence suivante résume la structure d'un package ZIP.

    + Code
         |--search-app
                |----search-config.jar   /*These JAR files will be copied to lib folder in search-ear*/
                |----*.jar
         |--xc-app
         |--ts-app 
                  |-- lib
                       |---- xxx.jar  /*Any JAR files under this path will be copied into ts.ear under relative paths*/
                  |-- ejb
                       |---- xxx.jar  /*Will invoke wsadmin scripts to update ejb model for WebsphereCommerceExtentionData.jar)
                  |-- xxx.jar         /*Any JAR files under this path will be copied into ts.ear under relative paths)
                  |-- xxx.war         /*Will copy and replace file under xxx.war folder)
         |--crs-app
               |----wc-web.war        /*will unzip crs.ear, replace wc-web.war file, and then repackage as crs.ear)
    + Config
         | --search-app
                | -- search-runtime
         | -- xc-app
         | -- ts-app                  /*Will copy folders under this path to /SETUP/app/customization)
                 |---config
                 |---member
    + Certs                           /*This is an additional folder. If you have certificates that you want to bundle, you
                                           need to implement WCB logic to package in the ZIP*/                 
         |--------xxx.json( with privatekey/issue-ca/certification)
    + DeployScripts                   /*This is an additional folder. If you have custom deployment scripts,
                                           you need to implement WCB logic to package in the ZIP*/ 

Chaque package d'applications n'inclura que les dossiers connexes. Par exemple, si vous exécutez l'utilitaire WCB pour l'application ts-app, le package résultant inclura les dossiers ts-app et les dossiers supplémentaires que vous avez ajoutés tels que Certs et DeployScripts.

La procédure suivante fournit des lignes directrices pour la mise en œuvre de la procédure de génération dans votre pipeline. Vous pouvez utiliser un outil d'orchestration comme Jenkins ou IBM Urban Code Deploy pour orchestrer votre pipeline.

Procédure

  1. Assurez-vous que l'utilitaire WCB est configuré pour l'extraction à partir de votre référentiel de code source.

    Pour plus d'informations, voir Configuration du script Ant d'extraction source.

  2. Assurez-vous d'avoir configuré les paramètres de génération pour déterminer l'application par défaut à créer.

    Pour plus d'informations, voir Configuration des paramètres d'emballage.

  3. Créez un script qui peut être utilisé par votre pipeline pour exécuter l'utilitaire WCB et transmettre le package créé vers votre référentiel d'artefacts.
    Pour plus d'informations sur l'exécution de l'utilitaire WCB, voir Génération de packages.

    Une fois l'utilitaire WCB exécuté, un package ZIP est créé et enregistré dans WCDE_installdir/wcbd/dist/server/wcbd-deploy-server-build-label.zip. Téléchargez ce package dans votre référentiel d'artefacts.