Exemple de structure de fichier .sra pour l'automatisation CI/CD
Lorsque vous générez vos personnalisations, il est utile de les regrouper dans une structure d'archivage cohérente. Pour procéder avec HCL Commerce Search, un fichier appelé Archive de ressources de recherche (.sra) est proposé.
Conception d'une structure de référentiel
Lorsque vos personnalisations sont terminées, vous pouvez regrouper les ressources dans un format de fichier compressé standard tel que .zip ou .tar. Cette archive peut être récupérée par des processus dans les étapes suivantes du pipeline CI/CD. Il est logique si la structure de fichier de l'archive suit celle du référentiel de travail que vous avez utilisé pour développer le code, dans la mesure du possible. La structure utile pour la génération et les tests n'est toutefois pas nécessairement utile pour le regroupement et la transmission des modifications. Par exemple, pour archiver un nouveau connecteur de sorte que le code modifié puisse être systématiquement récupéré et utilisé par la séquence de génération/déploiement CI/CD, vous pouvez utiliser une structure de fichier de référentiel telle que la suivante :
pipes
│
├───new
│ auth.xfields.json
│
└───updates
1_auth.xfields
2_auth.xfields
et l'archiver d'une manière similaire, mais spécialisée. Par exemple, vous pouvez inclure un répertoire distinct pour un manifeste de l'archive.Ingest-pipeline.sra
├───META-INF
├───pipes
├───new
│ auth.xfield.json
└───updates
1_auth.xfield.json
2_auth.xfield.json
La structure logique de l'archive est conçue pour favoriser la portabilité. L'archive contient toutes les ressources qui peuvent être nécessaires pour déployer le code. Elle peut refléter directement la structure de référentiel d'origine ou avoir une hiérarchie entièrement différente en fonction de vos besoins de développement et de déploiement. L'objectif est de regrouper toutes vos modifications de manière à ce qu'elles soient automatiquement trouvées, intégrées, générées et déployées par les scripts CI/CD.Une approche utile consiste à modifier l'extension d'archive de sorte que (en particulier sous Windows) les scripts récupèrent ces fichiers pour traitement, et pas d'autres par erreur. Remplacez votre fichier .tar ou .zip par un fichier .sra, par exemple, où SRA signifie Archive de ressources de recherche.