Configurer un pipeline de construction pour un exemple d’intégration fiscale
Cet article explique comment configurer des pipelines de build et de publication pour un exemple d’intégration fiscale à partir du Microsoft Dynamics 365 Commerce kit de développement logiciel (SDK) de vente au détail. De cette façon, vous pouvez utiliser le modèle d’extension et de packaging indépendant pour générer et publier les packages Cloud unité d’échelle et 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 unité d’échelle et des packages en libre-service Retail
connectez-vous à votre Azure DevOps organisation.
Sélectionner Pipeline, puis Sélectionner Nouveau pipeline.
Sélectionner le référentiel source (repo) pour les solutions d’intégration fiscale, Dynamics365Commerce.Solutions.
Sélectionner Fichier YAML Azure Pipelines existant.
Sélectionner ou obtenez un fichier YAML approprié à partir du dossier Pipeline\YAML_Files du dépôt Dynamics365Commerce.Solutions . Pour plus d’informations sur la façon de trouver un fichier YAML modèle 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.
Sélectionnez Continuer.
Le fichier YAML contient les étapes à suivre pour utiliser un certificat pour signer les programmes d’installation des extensions unité d’échelle, 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 depuis Azure Key Vault, vous devez fournir l’ID d’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 aider à sécuriser les variables, vous pouvez utiliser Sélectionner Secret comme type de variable.
- ID d’application
- AzureKeyVaultURI
- Nom du certificat
- ValeurSecrète
-
Horodatage – 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 Secure tâche ou d’autres options prises en charge par Azure Pipelines.
Si vous ne souhaitez pas signer les programmes d’installation, vous pouvez supprimer la signature étape du fichier YAML. Dans le fichier YAML, recherchez le PowerShell@2 tâche et supprimez-le.
Les scripts du fichier YAML créent la solution entière et téléchargent les fichiers de sortie vers l’emplacement de dépôt des Artefacts publiés pour la création. Les fichiers de sortie sont CloudScaleUnitExtensionPackage.zip et les packages d’extension de libre-service Retail suivants : HardwareStation.*.Installer.exe, ScaleUnit.*.Installer.exe et ModernPOS.*.Installer.exe.
Note
Dans les noms des packages d’extension de libre-service Retail, l’astérisque (*) représente le nom de la solution d’intégration fiscale.
Selon l’échantillon d’intégration fiscale, les extensions de certains composants du Commerce peuvent ne pas être nécessaires. Par conséquent, certains fichiers de sortie peuvent être omis.
Enregistrez vos modifications et ajoutez la build à la file d’attente.
Une fois la construction terminée, vous pouvez télécharger les packages à partir de Artefacts publiés :
Paquet Cloud unité d’échelle :
- ScaleUnitPackage_$(BuildNumber).zip
Packs d’extension du libre-service 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 publication pour le package d’extension Cloud unité d’échelle
Pour configurer un pipeline de publication pour le package d’extension Cloud unité d’échelle pour l’exemple d’intégration fiscale, suivez les étapes décrites dans Configurer un pipeline de publication pour le package d’extension Cloud unité d’échelle.
Configurer un pipeline de publication pour les packages en libre-service Retail
Pour configurer un pipeline de publication pour les packages en libre-service de vente au détail pour l’exemple d’intégration fiscale, suivez les étapes décrites dans Configurer un pipeline de publication pour les packages en libre-service de commerce.