Compartilhar via


Configurar um pipeline de criação para um exemplo de integração fiscal

Este artigo explica como configurar pipelines de criação e liberação para um exemplo de integração fiscal do Microsoft Dynamics 365 Commerce kit de desenvolvimento de software (SDK) do Retail. Dessa forma, você pode usar o empacotamento independente e o modelo de extensão para gerar e liberar o Cloud unidade de escala e os pacotes implantáveis de autoatendimento para o código de exemplo.

Observação

As etapas descritas neste artigo não funcionarão se você estiver usando a versão anterior do SDK do Retail da máquina virtual do desenvolvedor (VM) no Microsoft Dynamics Lifecycle Services (LCS). Para obter as etapas necessárias para implantar um exemplo de integração fiscal se você estiver usando o SDK do Retail da VM do desenvolvedor no LCS, consulte a documentação de exemplo de integração fiscal correspondente.

Configurar um pipeline de criação para gerar pacotes de extensão do Azure DevOps Cloud unidade de escala e pacotes de autoatendimento do Retail

  1. Faça logon na sua Azure DevOps organização.

  2. Select Pipeline e, em seguida, Select Novo pipeline.

  3. Select repositório de origem (repositório) para soluções de integração fiscal, Dynamics365Commerce.Solutions.

  4. Select Arquivo YAML do Azure Pipelines existente.

  5. Select ou obtenha um arquivo YAML apropriado do Pasta Pipeline\YAML_Files do repositório Dynamics365Commerce.Solutions . Para obter mais informações sobre como localizar um arquivo YAML de modelo para o exemplo, consulte o arquivo readme.md da solução de integração fiscal ou a documentação pública do exemplo de integração fiscal.

  6. Selecione Continuar.

    O arquivo YAML tem etapas para usar um certificado para assinar os instaladores de extensão do unidade de escala, Modern POS e Hardware Station. O script procurará um arquivo de certificado no Azure Key Vault e usará o certificado para assinatura. Para ler o certificado do Azure Key Vault, você deve fornecer a ID do aplicativo, o segredo e o nome do certificado. Para assinar o certificado usando um carimbo de data/hora, você também deve fornecer os detalhes do servidor de carimbo de data/hora. Para obter mais informações, consulte Definir e recuperar um certificado do Azure Key Vault usando o portal do Azure.

    Para exibir os detalhes do cofre de chaves e do servidor de carimbo de data/hora no pipeline, crie as seguintes variáveis na guia Variáveis no pipeline de compilação e forneça valores para elas. Para ajudar a proteger as variáveis, você pode Select Secret como o tipo de variável.

    • ApplicationId
    • AzureKeyVaultURI
    • Nome do Certificado
    • Valor secreto
    • Carimbo de data/hora – Como o valor dessa variável, você pode especificar qualquer provedor de carimbo de data/hora, como http://timestamp.digicert.com.

    Se você não estiver armazenando seu certificado no Azure, poderá assinar os instaladores usando a opção tarefa Seguro ou outras opções compatíveis com o Azure Pipelines.

    Se você não quiser assinar os instaladores, poderá remover a etapa de assinatura do arquivo YAML. No arquivo YAML, procure o PowerShell@2 tarefa e remova-o.

    Os scripts no arquivo YAML criam a solução inteira e carregam os arquivos de saída para o local de descarte Artefatos Publicados para a compilação. Os arquivos de saída são CloudScaleUnitExtensionPackage.zip e os seguintes pacotes de extensão de autoatendimento do Retail: HardwareStation.*. Installer.exe, ScaleUnit.*. Installer.exe e ModernPDV.*. Installer.exe.

    Observação

    Nos nomes dos pacotes de extensão de autoatendimento do Retail, o asterisco (*) representa o nome da solução de integração fiscal.

    Dependendo do exemplo de integração fiscal, podem não ser necessárias extensões de alguns componentes do Commerce. Portanto, alguns dos arquivos de saída podem ser omitidos.

  7. Salve suas alterações e adicione a compilação à fila.

  8. Quando a compilação for concluída, você poderá baixar os pacotes de Artefatos Publicados:

    • Pacote de unidade de escala nuvem:

      • ScaleUnitPackage_$(BuildNumber).zip
    • Pacotes de extensão de autoatendimento para varejo:

      • HardwareStation.*. Installer_$(BuildNumber).exe
      • ScaleUnit.*. Installer_$(BuildNumber).exe
      • PDV Moderno.*. Installer_$(BuildNumber).exe

      Nesses nomes de pacote, o asterisco (*) representa o nome da solução de integração fiscal.

Configurar um pipeline de versão para o pacote de extensão do Cloud unidade de escala

Para configurar um pipeline de lançamento para o pacote de extensão do Cloud unidade de escala para o exemplo de integração fiscal, siga as etapas em Configurar um pipeline de lançamento para o pacote de extensão do Cloud unidade de escala.

Configurar um pipeline de lançamento para pacotes de autoatendimento do Retail

Para configurar um pipeline de lançamento de pacotes de autoatendimento do Retail para o exemplo de integração fiscal, siga as etapas em Configurar um pipeline de lançamento para pacotes de autoatendimento do Commerce.