Partilhar via

Configurar um pipeline de construção para uma amostra de integração fiscal

  • Artigo

Isto artigo explica como configurar pipelines de compilação e lançamento para uma amostra de integração fiscal a partir do kit de desenvolvimento de software (SDK) Microsoft Dynamics 365 Commerce Retail. Desta forma, pode utilizar o modelo de extensão e empacotamento independente para gerar e lançar o Cloud unidade de escala e pacotes implementáveis de self-service para o código de exemplo.

Nota

Os passos descritos neste artigo não funcionarão se estiver a utilizar a versão anterior do Retail SDK a partir da máquina virtual (VM) do programador em Microsoft Dynamics Lifecycle Services (LCS). Para obter as etapas necessárias para implantar uma amostra de integração fiscal se estiver usando o Retail SDK da VM de desenvolvedor no LCS, consulte a documentação de amostra de integração fiscal correspondente.

Configurar um pipeline de compilação em Azure DevOps para gerar pacotes de extensão Cloud unidade de escala e pacotes de auto-atendimento Retail

  1. Inicie sessão na sua organização Azure DevOps .

  2. Selecione Pipeline, e depois selecione New pipeline.

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

  4. Selecione Ficheiro YAML do Azure Pipelines existente.

  5. Selecione ou obtenha um ficheiro YAML adequado a partir da pasta Pipeline\YAML_Files do repositório Dynamics365Commerce.Solutions . Para mais informações sobre como encontrar um ficheiro YAML modelo para a amostra, consulte o ficheiro readme.md da solução de integração fiscal ou a documentação pública da amostra de integração fiscal.

  6. Selecione Continuar.

    O ficheiro YAML tem etapas para usar um certificado para assinar os instaladores de extensão unidade de escala, Modern POS e Hardware Station. O script procurará um ficheiro de certificado no Azure Key Vault e, em seguida, utilizará o certificado para assinatura. Para ler o certificado do Azure Key Vault, tem de fornecer o ID da aplicação, o segredo e o nome do certificado. Para assinar o certificado utilizando um carimbo de data/hora, também é necessário fornecer os detalhes do servidor de carimbo de data/hora. Para mais informações, consulte Definir e recuperar um certificado do Azure Key Vault utilizando 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 Variables no pipeline de compilação e forneça valores para elas. Para ajudar a proteger as variáveis, pode selecionar Secret como o tipo de variável.

    • ApplicationId
    • AzureKeyVaultURI
    • CertificateName
    • ValorSecreto
    • Carimbo de data/hora - Como valor desta variável, pode especificar qualquer fornecedor de carimbo de data/hora, como http://timestamp.digicert.com.

    Se não estiver a armazenar o seu certificado no Azure, pode assinar os instaladores utilizando a opção Secure task ou outras opções suportadas pelo Azure Pipelines.

    Se não quiser assinar os instaladores, pode remover a assinatura passo do ficheiro YAML. No ficheiro YAML, procure a tarefa PowerShell@2 e remova-a.

    Os scripts no ficheiro YAML constroem toda a solução e carregam os ficheiros de saída para a localização Published Artifacts para a construção. Os ficheiros 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 ModernPOS.*.Installer.exe.

    Nota

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

    Dependendo da amostra de integração fiscal, as extensões de algumas componentes do comércio podem não ser necessárias. Por conseguinte, alguns dos ficheiros de saída podem ser omitidos.

  7. Guarde as alterações e adicione a compilação à fila de espera.

  8. Quando a compilação estiver concluída, pode transferir os pacotes a partir de Artefactos publicados:

    • Pacote Cloud unidade de escala:

      • ScaleUnitPackage_$(BuildNumber).zip

    • Pacotes de extensão de autosserviço para o retalho:

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

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

Configurar um pipeline de lançamento para o pacote de extensão Cloud unidade de escala

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

Configurar um pipeline de lançamento para pacotes de auto-atendimento do Retail

Para configurar um pipeline de liberação para pacotes de auto-atendimento do Retail para a amostra de integração fiscal, siga as etapas em Configurar um pipeline de liberação para pacotes de auto-atendimento do Commerce.