Teilen über

Einrichten einer Buildpipeline für ein Beispiel zur Finanzintegration

  • Artikel

In diesem Artikel wird erläutert, wie Build- und Release-Pipelines für ein Beispiel zur Steuerintegration aus dem Microsoft Dynamics 365 Commerce Retail Software Development Kit (SDK) eingerichtet werden. Auf diese Weise können Sie das unabhängige Verpackungs- und Erweiterungsmodell verwenden, um die Cloud Skalierungseinheit und selbst bereitstellbare Pakete für den Beispielcode zu generieren und freizugeben.

Notiz

Die in diesem Artikel beschriebenen Schritte funktionieren nicht, wenn Sie die vorherige Version des Retail SDK von der virtuellen Entwicklermaschine (VM) in Microsoft Dynamics Lifecycle Services (LCS) verwenden. Die erforderlichen Schritte zum Bereitstellen eines Beispiels zur Finanzintegration, wenn Sie das Retail SDK von der Entwickler-VM in LCS verwenden, finden Sie in der entsprechenden Dokumentation zum Beispiel zur Finanzintegration.

Richten Sie eine Build-Pipeline ein, um Azure DevOps Cloud Skalierungseinheit-Erweiterungspakete und Retail-Self-Service-Pakete zu generieren.

  1. Melden Sie sich bei Ihrer Azure DevOps Organisation an.

  2. Auswählen Pipeline und dann Auswählen Neue Pipeline.

  3. Auswählen das Quell-Repository (Repo) für Lösungen zur Steuerintegration, Dynamics365Commerce.Solutions.

  4. Auswählen vorhandene Azure Pipelines YAML-Datei.

  5. Auswählen oder holen Sie sich eine entsprechende YAML-Datei aus dem Ordner Pipeline\YAML_Files des Repository Dynamics365Commerce.Solutions . Weitere Informationen zum Suchen einer YAML-Vorlagendatei für das Beispiel finden Sie in der Datei readme.md der Finanzintegrationslösung oder in der öffentlichen Dokumentation für das Finanzintegrationsbeispiel.

  6. Wählen Sie Fortsetzen aus.

    Die YAML-Datei enthält Schritte zur Verwendung eines Zertifikats zum Signieren der Erweiterungsinstallationsprogramme Skalierungseinheit, Modern POS und Hardware Station. Das Skript sucht in Azure Key Vault nach einer Zertifikatsdatei und verwendet das Zertifikat dann zum Signieren. Um das Zertifikat aus Azure Key Vault zu lesen, müssen Sie die Anwendungs-ID, das Geheimnis und den Zertifikatsnamen angeben. Um das Zertifikat mithilfe eines Zeitstempels zu signieren, müssen Sie auch die Details des Zeitstempelservers angeben. Weitere Informationen finden Sie unter Einrichten und Abrufen eines Zertifikats aus Azure Key Vault mithilfe des Azure-Portals.

    Um die Details des Schlüsseltresors und des Zeitstempelservers in der Pipeline anzuzeigen, erstellen Sie die folgenden Variablen auf der Registerkarte Variablen in Ihrer Build-Pipeline und geben Sie Werte für sie an. Um die Variablen zu sichern, können Sie als Variablentyp Auswählen Secret verwenden.

    • Anwendungs-ID
    • AzureKeyVaultURI
    • Zertifikatsname
    • Geheimer Wert
    • Zeitstempel – Als Wert dieser Variable können Sie einen beliebigen Zeitstempelanbieter angeben, beispielsweise http://timestamp.digicert.com.

    Wenn Sie Ihr Zertifikat nicht in Azure speichern, können Sie die Installationsprogramme mit der Option Secure Aufgabe oder anderen von Azure Pipelines unterstützten Optionen signieren.

    Wenn Sie die Installationsprogramme nicht signieren möchten, können Sie die Signatur Schritt aus der YAML-Datei entfernen. Suchen Sie in der YAML-Datei nach PowerShell@2 Aufgabe und entfernen Sie es.

    Skripte in der YAML-Datei erstellen die gesamte Lösung und laden die Ausgabedateien zum Ablageort Veröffentlichte Artefakte für den Build hoch. Die Ausgabedateien sind CloudScaleUnitExtensionPackage.zip und die folgenden Retail-Self-Service-Erweiterungspakete: HardwareStation.*.Installer.exe, ScaleUnit.*.Installer.exe und ModernPOS.*.Installer.exe.

    Notiz

    In den Namen der Retail Self-Service-Erweiterungspakete steht das Sternchen (*) für den Namen der Finanzintegrationslösung.

    Abhängig vom Beispiel der Finanzintegration sind Erweiterungen einiger Commerce-Komponenten möglicherweise nicht erforderlich. Daher können einige der Ausgabedateien weggelassen werden.

  7. Speichern Sie Ihre Änderungen und fügen Sie den Build zur Warteschlange hinzu.

  8. Wenn der Build abgeschlossen ist, können Sie die Pakete von Published Artifacts herunterladen:

    • Cloud Skalierungseinheit-Paket:

      • ScaleUnitPackage_$(BuildNumber).zip

    • Erweiterungspakete für die Selbstbedienung im Einzelhandel:

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

      In diesen Paketnamen stellt das Sternchen (*) den Namen der Finanzintegrationslösung dar.

Richten Sie eine Release-Pipeline für das Cloud-Erweiterungspaket Skalierungseinheit ein.

Um eine Release-Pipeline für das Cloud-Erweiterungspaket Skalierungseinheit für das Beispiel zur Finanzintegration einzurichten, folgen Sie die Schritte in Richten Sie eine Release-Pipeline für das Cloud-Erweiterungspaket Skalierungseinheit ein.

Einrichten einer Releasepipeline für Retail-Self-Service-Pakete

Um eine Release-Pipeline für Retail-Self-Service-Pakete für das Beispiel zur Steuerintegration einzurichten, folgen Sie die Schritte in Eine Release-Pipeline für Commerce-Self-Service-Pakete einrichten.