Configurer un pipeline de build pour un exemple d’intégration fiscale

Cet article explique comment configurer des pipelines de création et de publication pour un exemple d’intégration fiscale à partir du Microsoft Dynamics 365 Commerce kit de développement logiciel (SDK) Retail. De cette façon, vous pouvez utiliser le modèle d’empaquetage et d’extension indépendant pour générer et publier l’unité d’échelle cloud et les packages déployables en libre-service pour l’exemple de code.

Note

Les étapes décrites dans cet article ne fonctionneront pas si vous utilisez la version précédente du SDK Retail à partir de la machine virtuelle (VM) du développeur dans Microsoft Dynamics Lifecycle Services (LCS). Pour connaître les étapes requises pour déployer un exemple d’intégration fiscale si vous utilisez le SDK Retail à partir de la machine virtuelle du développeur dans LCS, consultez la documentation de l’exemple d’intégration fiscale correspondant.

Configurer un pipeline de build dans Azure DevOps pour générer des packages d’extension Cloud Scale Unit et des packages libre-service Retail

1. connectez-vous à votre Azure DevOps organisation.

2. Sélectionnez Pipeline, puis sélectionnez Nouveau pipeline.

3. Sélectionnez le référentiel source (dépôt) pour les solutions d’intégration fiscale, Dynamics365Commerce.Solutions.

4. Sélectionnez le Fichier YAML Azure Pipelines existant.

5. Sélectionnez ou récupérez un fichier YAML approprié dans le dossier Pipeline\YAML_Files du Dynamics365Commerce.Solutions dépôt. Pour plus d’informations sur la recherche d’un modèle de fichier YAML pour l’exemple, consultez le fichier readme.md de la solution d’intégration fiscale ou la documentation publique de l’exemple d’intégration fiscale.

6. Sélectionnez Continuer.

   Le fichier YAML contient des étapes pour utiliser un certificat pour signer les programmes d’installation des extensions Scale Unit, Modern POS et Hardware Station. Le script recherchera un fichier de certificat dans Azure Key Vault, puis utilisera le certificat pour la signature. Pour lire le certificat à partir d’Azure Key Vault, vous devez fournir l’ID de l’application, le secret et le nom du certificat. Pour signer le certificat à l’aide d’un horodatage, vous devez également fournir les détails du serveur d’horodatage. Pour plus d’informations, consultez Définir et récupérer un certificat à partir d’Azure Key Vault à l’aide du portail Azure.

   Pour afficher les détails du coffre de clés et du serveur d’horodatage dans le pipeline, créez les variables suivantes dans l’onglet Variables de votre pipeline de build et fournissez-leur des valeurs. Pour sécuriser les variables, vous pouvez sélectionner Secret comme type de variable.

   • ID d’application
   • AzureKeyVaultURI
   • Nom du certificat
   • Valeur secrète
   • Timestamp – Comme valeur de cette variable, vous pouvez spécifier n’importe quel fournisseur d’horodatage, tel que http://timestamp.digicert.com.

   Si vous ne stockez pas votre certificat dans Azure, vous pouvez signer les programmes d’installation à l’aide de l’option Tâche sécurisée ou d’autres options prises en charge par Azure Pipelines.

   Si vous ne souhaitez pas signer les programmes d’installation, vous pouvez supprimer l’étape de signature du fichier YAML. Dans le fichier YAML, recherchez la tâche PowerShell@2 et supprimez-la.

   Les scripts du fichier YAML créent l’intégralité de la solution et téléchargent les fichiers de sortie vers l’emplacement de dépôt des artefacts publiés pour la génération. Les fichiers de sortie sont CloudScaleUnitExtensionPackage.zip et les packages d’extension libre-service Retail suivants : HardwareStation.*.Installer.exe, ScaleUnit.*.Installer.exe et ModernPOS.*.Installer.exe.

   Note

   Dans les noms des packages d’extension libre-service Retail, l’astérisque (*) représente le nom de la solution d’intégration fiscale.

   Selon l’échantillon d’intégration fiscale, des extensions de certaines composantes du commerce peuvent ne pas être nécessaires. Par conséquent, certains fichiers de sortie peuvent être omis.

7. Enregistrez vos modifications et ajoutez la build à la file d’attente.

8. Une fois la compilation terminée, vous pouvez télécharger les packages à partir de Artefacts publiés :

   • Package d’unités à l’échelle du cloud :

     • ScaleUnitPackage_$(BuildNumber).zip

   • Forfaits d’extension libre-service pour la vente au détail :

     • HardwareStation.*.Installer_$(BuildNumber).exe
     • ScaleUnit.*.Installer_$(BuildNumber).exe
     • ModernPOS.*.Installer_$(BuildNumber).exe

     Dans ces noms de packages, l’astérisque (*) représente le nom de la solution d’intégration fiscale.

Configurer un pipeline de versions pour le package d’extension Cloud Scale Unit

Pour configurer un pipeline de versions pour le package d’extension Cloud Scale Unit pour l’exemple d’intégration fiscale, suivez les étapes décrites dans Configurer un pipeline de versions pour le package d’extension Cloud Scale Unit.

Configurer un pipeline de versions pour les packages libre-service Retail

Pour configurer un pipeline de versions pour les packages libre-service Retail pour l’exemple d’intégration fiscale, suivez les étapes décrites dans Configurer un pipeline de versions pour les packages libre-service Commerce.