Compartir a través de


Configurar una secuencia de compilación para una muestra de integración fiscal

Este artículo explica cómo configurar procesos de compilación y lanzamiento para una muestra de integración fiscal del kit de desarrollo de software (SDK) para minoristas. Microsoft Dynamics 365 Commerce De esta manera, puede utilizar el modelo de extensión y empaquetado independiente para generar y publicar los paquetes implementables de autoservicio y Cloud unidad de escalado para el código de muestra.

Nota

Los pasos que se describen en este artículo no funcionarán si está utilizando la versión anterior del Retail SDK de la máquina virtual (VM) del desarrollador en Lifecycle Services (LCS). Microsoft Dynamics Para conocer los pasos necesarios para implementar una muestra de integración fiscal si utiliza el SDK minorista desde la máquina virtual del desarrollador en LCS, consulte la documentación de muestra de integración fiscal correspondiente.

Configurar una canalización de compilación en Azure DevOps para generar paquetes de extensión Cloud unidad de escalado y paquetes de autoservicio minorista

  1. Inicie sesión en su Azure DevOps organización.

  2. Seleccionar Pipeline, y luego Seleccionar New pipeline.

  3. Seleccionar el repositorio de origen (repo) para soluciones de integración fiscal, Dynamics365Commerce.Solutions.

  4. Seleccionar Archivo YAML de Azure Pipelines existente.

  5. Seleccionar u obtenga un archivo YAML apropiado de la carpeta Pipeline\YAML_Files del repositorio Dynamics365Commerce.Solutions . Para obtener más información sobre cómo encontrar un archivo YAML de plantilla para la muestra, consulte el archivo readme.md de la solución de integración fiscal o la documentación pública de la muestra de integración fiscal.

  6. Seleccione Continuar.

    El archivo YAML tiene pasos para usar un certificado para firmar los instaladores de extensiones unidad de escalado, Modern POS y Hardware Station. El script buscará un archivo de certificado en Azure Key Vault y luego usará el certificado para firmar. Para leer el certificado de Azure Key Vault, debe proporcionar el ID de la aplicación, el secreto y el nombre del certificado. Para firmar el certificado utilizando una marca de tiempo, también debe proporcionar los detalles del servidor de marca de tiempo. Para obtener más información, consulte Establecer y recuperar un certificado de Azure Key Vault mediante el portal de Azure.

    Para ver los detalles del almacén de claves y el servidor de marca de tiempo en el proceso de compilación, cree las siguientes variables en la pestaña Variables en su proceso de compilación y proporcióneles valores. Para ayudar a proteger las variables, puede usar Seleccionar Secret como tipo de variable.

    • Id. de aplicación
    • URI de AzureKeyVault
    • Nombre del certificado
    • Valor secreto
    • Marca de tiempo : como valor de esta variable, puede especificar cualquier proveedor de marca de tiempo, como http://timestamp.digicert.com.

    Si no almacena su certificado en Azure, puede firmar los instaladores mediante la opción Secure tarea u otras opciones que Azure Pipelines admita.

    Si no desea firmar los instaladores, puede eliminar la firma paso del archivo YAML. En el archivo YAML, busque PowerShell@2 tarea y elimínelo.

    Los scripts en el archivo YAML compilan toda la solución y cargan los archivos de salida en la ubicación de entrega Artefactos publicados para la compilación. Los archivos de salida son CloudScaleUnitExtensionPackage.zip y los siguientes paquetes de extensión de autoservicio minorista: HardwareStation.*.Installer.exe, ScaleUnit.*.Installer.exe y ModernPOS.*.Installer.exe.

    Nota

    En los nombres de los paquetes de extensión de autoservicio para Retail, el asterisco (*) representa el nombre de la solución de integración fiscal.

    Dependiendo de la muestra de integración fiscal, es posible que no se necesiten extensiones de algunos componentes de Comercio. Por lo tanto, es posible que se omitan algunos de los archivos de salida.

  7. Guarde los cambios y agregue la compilación a la cola.

  8. Cuando se complete la compilación, puedes descargar los paquetes desde Artefactos publicados:

    • Paquete de nube unidad de escalado:

      • Paquete de unidad de escala_$(BuildNumber).zip
    • Paquetes de ampliación de autoservicio minorista:

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

      En estos nombres de paquetes, el asterisco (*) representa el nombre de la solución de integración fiscal.

Configurar una canalización de lanzamiento para el paquete de extensión Cloud unidad de escalado

Para configurar un canal de lanzamiento para el paquete de extensión Cloud unidad de escalado para el ejemplo de integración fiscal, seguir siga los pasos en Configurar un canal de lanzamiento para el paquete de extensión Cloud unidad de escalado.

Configurar un canal de lanzamiento para paquetes de autoservicio minorista

Para configurar un canal de lanzamiento para paquetes de autoservicio de Retail para el ejemplo de integración fiscal, siga los pasos en Configurar un canal de lanzamiento para paquetes de autoservicio de Commerce.