Impostare una pipeline di build per un campione di integrazione fiscale

  • Articolo

Questo articolo spiega come impostare pipeline di compilazione e rilascio per un esempio di integrazione fiscale dal Microsoft Dynamics 365 Commerce kit di sviluppo software (SDK) per la vendita al dettaglio. In questo modo, è possibile utilizzare il modello di estensione e confezionamento indipendente per generare e rilasciare i pacchetti Cloud unità di scala e self-service distribuibili per il codice di esempio.

Nota

I passaggi descritti in questo articolo non funzioneranno se si utilizza la versione precedente del Retail SDK dalla macchina virtuale (VM) dello sviluppatore in Lifecycle Services (LCS). Microsoft Dynamics Per i passaggi necessari per distribuire un esempio di integrazione fiscale se si utilizza Retail SDK dalla VM dello sviluppatore in LCS, consultare la documentazione dell'esempio di integrazione fiscale corrispondente.

Imposta una pipeline di build in Azure DevOps per generare pacchetti di estensione Cloud unità di scala e pacchetti self-service Retail

  1. Accedi alla tua Azure DevOps organizzazione.

  2. Seleziona Pipeline, quindi Seleziona Nuova pipeline.

  3. Seleziona il repository sorgente (repo) per le soluzioni di integrazione fiscale, Dynamics365Commerce.Solutions.

  4. Seleziona File YAML di Azure Pipelines esistente.

  5. Seleziona oppure ottenere un file YAML appropriato dalla cartella Pipeline\YAML_Files del repository Dynamics365Commerce.Solutions . Per ulteriori informazioni su come trovare un file YAML modello per l'esempio, consultare il file readme.md della soluzione di integrazione fiscale o la documentazione pubblica per l'esempio di integrazione fiscale.

  6. Selezionare Continua.

    Il file YAML contiene i passaggi per utilizzare un certificato per firmare i programmi di installazione delle estensioni unità di scala, Modern POS e Hardware Station. Lo script cercherà un file di certificato in Azure Key Vault e quindi utilizzerà il certificato per la firma. Per leggere il certificato da Azure Key Vault, è necessario fornire l'ID applicazione, il segreto e il nome del certificato. Per firmare il certificato utilizzando una marca temporale, è necessario fornire anche i dettagli del server della marca temporale. Per ulteriori informazioni, vedere Impostare e recuperare un certificato da Azure Key Vault tramite il portale di Azure.

    Per visualizzare i dettagli del key vault e del server di timestamp nella pipeline, crea le seguenti variabili nella scheda Variabili nella pipeline di build e specifica i valori per esse. Per proteggere le variabili, puoi usare Seleziona Secret come tipo di variabile.

    • ID applicazione
    • AzureKeyVaultURI
    • Nome del certificato
    • Valore segreto
    • Timestamp – Come valore di questa variabile, puoi specificare qualsiasi fornitore di timestamp, ad esempio http://timestamp.digicert.com.

    Se non si archivia il certificato in Azure, è possibile firmare i programmi di installazione utilizzando l'opzione Secure attività o altre opzioni supportate da Azure Pipelines.

    Se non si desidera firmare i programmi di installazione, è possibile rimuovere la firma passaggio dal file YAML. Nel file YAML, cerca PowerShell@2 attività e rimuovilo.

    Gli script nel file YAML compilano l'intera soluzione e caricano i file di output nella posizione di rilascio Artefatti pubblicati per la compilazione. I file di output sono CloudScaleUnitExtensionPackage.zip e i seguenti pacchetti di estensione self-service per il commercio al dettaglio: HardwareStation.*.Installer.exe, ScaleUnit.*.Installer.exe e ModernPOS.*.Installer.exe.

    Nota

    Nei nomi dei pacchetti di estensione self-service al dettaglio, l'asterisco (*) rappresenta il nome della soluzione di integrazione fiscale.

    A seconda del campione di integrazione fiscale, le estensioni di alcuni componenti del Commercio potrebbero non essere necessarie. Per questo motivo, alcuni file di output potrebbero essere omessi.

  7. Salva le modifiche e aggiungi la build alla coda.

  8. Una volta completata la build, puoi scaricare i pacchetti da Artefatti pubblicati:

    • Pacchetto cloud unità di scala:

      • PacchettoUnitàScale_$(BuildNumber).zip

    • Pacchetti di estensione self-service per la vendita al dettaglio:

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

      In questi nomi di pacchetti, l'asterisco (*) rappresenta il nome della soluzione di integrazione fiscale.

Imposta una pipeline di rilascio per il pacchetto di estensione Cloud unità di scala

Per impostare una pipeline di rilascio per il pacchetto di estensione Cloud unità di scala per l'esempio di integrazione fiscale, seguire seguire i passaggi descritti in Impostare una pipeline di rilascio per il pacchetto di estensione Cloud unità di scala.

Impostare una pipeline di rilascio per i pacchetti self-service al dettaglio

Per impostare una pipeline di rilascio per i pacchetti self-service di vendita al dettaglio per il campione di integrazione fiscale, seguire i passaggi in Impostare una pipeline di rilascio per i pacchetti self-service di commercio.