Configuration du script Ant d'extraction source

HCL Commerce Build tool nécessite que vous fournissiez un fichier de génération Ant d'extraction de source personnalisé. Ce fichier est exécuté dans le cadre du processus de génération.

Le répertoire WCB_installdir/extract comprend des exemples de scripts pour certains SCM :
Gestion de configuration de logiciel (SCM) Exemple de script
CVS wcbd-sample-extract-cvs.*
ClearCase wcbd-sample-extract-clearcase.*
Système de fichiers local wcbd-sample-extract-local.*
Subversion wcbd-sample-extract-svn.*
Git wcbd-sample-extract-git.*

Si aucun exemple de scripts n'est fourni pour votre SCM, vous pouvez développer un script personnalisé. Pour plus d'informations, voir Personnalisation du processus de package.

Avant de commencer

Remarque : Pour le support Git,
  1. Comme condition préalable, installez un client Git et assurez-vous que les commandes Git se trouvent dans le système ou le chemin d'accès utilisateur.
  2. Avant d'exécuter une génération WCB, clonez votre projet Git sur votre ordinateur local et assurez-vous que la commande git pull peut être exécutée avec succès. Utilisez le protocole ssh pour communiquer avec Git. D'autres protocoles, comme https, ne sont pas pris en charge.
  3. Si vous utilisez une configuration Git alternative, vous pouvez l'activer en personnalisant le script Ant extract-git.xml.

Pourquoi et quand exécuter cette tâche

Les étapes suivantes utilisent les conventions suivantes :

  • Les scripts ou fichiers de propriétés spécifiques à l'application se distinguent par le type d'application. Dans les étapes suivantes, apptype signifie le type d'application en cours de construction. Il peut prendre les valeurs ts, crs, search, xc ou data.
  • scm se réfère à la méthode par laquelle le code source est extrait. Le scm peut être local ou n'importe quel type SCM pris en charge, par exemple cvs, svn ou git.

Dans les étapes suivantes, scm fait référence à l'une des valeurs suivantes : cvs, clearcase, local ou svn.

Procédure

  1. Définissez des configurations sensibles à la sécurité qui seront utilisées dans le processus d'extraction.
    1. Si WCB_installdir/extract/wcbd-sample-extract-scm.private.properties existe, copiez le fichier en tant que WCB_installdir/extract-scm-apptype.private.properties.
      Par exemple, 
      extract-svn-ts.private.properties
    2. Ouvrez le fichier avec un éditeur de texte et configurez les propriétés en fonction des commentaires dans le fichier.
  2. Définissez des configurations non sensibles qui seront utilisées dans le processus d'extraction.
    1. Copier WCB_installdir/extract/wcbd-sample-extract-scm.properties comme WCB_installdir/extract-scm-apptype.properties.
      Par exemple, 
      extract-svn-ts.properties
    2. Ouvrez le fichier avec un éditeur de texte et configurez les propriétés en fonction des commentaires dans le fichier.
  3. Copier WCB_installdir/extract/wcbd-sample-extract-scm.xml comme WCB_installdir/extract-scm.xml.
    Par exemple, 
    extract-svn.xml
  4. Ouvrez WCB_installdir/extract-scm.xml avec un éditeur de texte et remplacez l'attribut de nom de l'élément de projet racine de wcbd-sample-extract-scm vers extract-scm.
    Par exemple, si le SCM est svn, alors WCB_installdir/extract-svn.xml devrait avoir la ligne suivante : 
    <project name="wcbd-sample-extract-svn" default="all">
    Modifié en : 
    <project name="extract-svn" default="all">