Partilhar via

Implementar pacotes utilizando o Package Deployer e o Windows PowerShell

  • Artigo

O Package Deployer do Microsoft Dynamics CRM permite que os administradores implementem pacotes para um ambiente.

Nota

O Package deployer também funciona com as organizações do Dynamics 365 Customer Engagement (on-premises).

Um “pacote” pode ser composto por qualquer um ou todos os seguintes:

  • Um ou mais ficheiros de solução do Dataverse.

  • Ficheiros simples ou ficheiros de dados exportados pela Configuration Migration Tool. Para mais informações sobre a Configuration Migration Tool, consulte Gerir dados de configuração.

  • Código personalizado que pode ser executado durante ou após o pacote ser implementado num ambiente.

  • Específico conteúdo do pacote que a apresentar no início e fim do processo de implementação do pacote. Isto pode ser útil fornecer uma descrição de soluções e dos ficheiros que são implementados no pacote.

    Os programadores criar pacotes utilizando o modelo de implementação do pacote em Visual Studio. Mais informações: Criar pacotes para o Package Deployer

    Após o pacote ser criado, pode implementá-lo executando o CRM Package Deployer ou utilizando cmdlets do Windows PowerShell para a ferramenta.

Importante

Antes de importar e executar um pacote numa organização de produção, teste o pacote numa organização de não produção que seja uma imagem exata da organização de produção.

Faça sempre uma cópia de segurança da organização de produção antes de implementar um pacote.


Implementar pacotes com a ferramenta Package Deployer

Poderá utilizar a ferramenta Package Deployer (packagedeployer.exe) para implementar pacotes da seguinte forma.

Usar a ferramenta CRM Package Deployer para implantar pacotes

Usar a ferramenta CRM Package Deployer na linha de comando

Utilizar a ferramenta Package Deployer para implementar pacotes

A ferramenta Package Deployer só consegue processar um pacote de cada vez. Contudo, fornece aos utilizadores a capacidade de selecionar um pacote para implementar a partir dos vários pacotes disponíveis no diretória da ferramenta do Package Deployer. Alguns dos ecrãs e ações a ferramenta diferem com base na definição de pacote. Não necessita de instalar a ferramenta Package Deployer. Apenas transfira-a e execute-.

  1. Transferir o pacote para ser implementado. Um pacote é uma coleção de ficheiros e pastas criada na pasta do projeto do Visual studio (<Project>\Bin\Debug) quando cria o seu projeto de pacote no Visual Studio. Copiar o seguinte da pasta de depuração do projeto:

    • <Pasta> PackageName: Esta pasta contém as soluções, a configuração de importação e o conteúdo do seu pacote.

    • <PackageName.DLL>: O assembly contém o código do seu pacote. Por predefinição, o nome da assemblagem é igual ao nome do projeto do Visual Studio.

      Para obter informações detalhadas sobre como criar um pacote utilizando o Visual Studio, consulteCriar um pacote para a ferramenta Package Deployer.

      Para este tópico, vamos assumir que a pasta e a assemblagem do pacote da pasta de depuração de projetos do Visual Studio (<Project>\Bin\Debug) são copiadas para a pasta c:\DeployPackage.

  2. Obtenha a ferramenta Package Deployer. A ferramenta Package Deployer está disponível como um pacote NuGet. Para utilizar a ferramenta Package Deployer, tem de transferir e extrair o pacote para o seu computador local utilizando o executável nuget.exe.

    Transfira o nuget.exe a partir de https://www.nuget.org/downloads e guarde-o no seu computador, por exemplo, na unidade d:\. Em seguida, execute o seguinte comando na linha de comandos para extrair o conteúdo do pacote para uma pasta (por exemplo, PD) do computador:
    d:\nuget install Microsoft.CrmSdk.XrmTooling.PackageDeployment.Wpf -Version [VERSION] -O d:\PD

    Depois de ter extraído a ferramenta Package Deployer, navegue até à pasta [ExtractedLocation]\tools para localizar o ficheiro PackageDeployer.exe.

  3. Copie a pasta e a assemblagem do pacote a partir de c:\DeployPackage para a pasta [ExtractedLocation]\tools.

  4. Após os ficheiros serem copiados, execute a ferramenta fazendo duplo clique no ficheiro PackageDeployer.exe na pasta [ExtractedLocation]\tools.

  5. Clique em Continuar no ecrã principal da ferramenta.

  6. No ecrã Ligar ao Microsoft Dynamics 365 for Customer Engagement, introduza os dados de autenticação para se ligar ao Dynamics 365 Server onde pretende implementar o pacote. Se tiver várias organizações e quiser selecionar a organização em que pretende implementar o pacote do selecione a caixa de verificação Apresentar sempre a lista de organizações disponíveis. Clique em Iniciar sessão.

  7. Se tiver várias organizações, no Dynamics 365 Server, selecione a organização de aplicações Dynamics 365 à qual pretende ligar.

  8. Selecionar o pacote a implementar e clique em Seguinte.

    Selecione o seu pacote na Ferramenta Package Deployer.

  9. Siga as instruções nos ecrãs subsequentes para concluir a implementação do pacote.

    Os são apresentados por com base na definição do pacote selecionado para a implementação. Para uma implementação de pacotes ponto a ponto que utiliza a ferramenta Package Deployer, consulte o tópico para a implementação de pacotes do Unified Service Desk: Implementar aplicações de amostra do Unified Service Desk no CRM Server utilizando o Package Deployer

Utilizar a ferramenta Package Deployer na linha de comandos

Os personalizadores e administradores de sistema podem transmitir parâmetros, como códigos de idioma regional, para packagedeployer.exe a partir da linha de comandos. Estes parâmetros só podem ser configuradas ao executar a ferramentqa Package Deployer na linha de comandos.

Nota

Esta caraterística foi inicialmente introduzida no Dynamics CRM Online 2016 Update 0.1.

Os parâmetros disponíveis estão nesta tabela.

Parâmetro Description Valor Predefinido
RuntimePackageSettings Indica à ferramenta packagedeployer.exe para aceitar os parâmetros da linha de comandos, como LCID e SkipChecks. Não aplicável
LCID=localeID Especifica o ID de região, como 1033 para Inglês - Estados Unidos ou 1036 para Francês - França, dos IDs de região disponíveis no pacote. Se não for especificado, será utilizado o idioma predefinido. Utilizar o idioma predefinido
SkipChecks=true/false Use este parâmetro apenas quando o ambiente de destino não contém quaisquer outras soluções ou personalizações. Quando definida como verdadeiro, a importação da solução irá ignorar algumas verificações de segurança que poderão melhorar o desempenho da importação. False

O seguinte exemplo indica ao CRM Package Deployer para ignorar algumas verificações de segurança e define o idioma para importação como polaco.

packagedeployer.exe /Settings:"SkipChecks=true|lcid=1045"

Nota

Utilize o caráter de barra vertical | para separar parâmetros quando executa packagedeployer.exe na linha de comandos com vários parâmetros.

Para mais informações sobre os parâmetros e os valores que podem ser transmitidos para a ferramenta packagedeployer.exe, consulte Criar pacotes para o Package Deployer do CRM.

Utilizar para implementar o Windows PowerShell pacotes

A ferramenta Package Deployer também fornece suporte do Windows PowerShell para implementar pacotes. Mais informações: Começar a utilizar o módulo de implementação do pacote

Resolver problemas de implementação do pacote utilizando ficheiros de registo

A ferramenta Package Deployer fornece suporte de registo para obter informações detalhadas sobre os erros que podem ocorrer ao iniciar sessão na instância do Microsoft Dynamics 365 for Customer Engagement utilizando a ferramenta e implementando pacotes. Por padrão, a ferramenta gera três arquivos de log que estão disponíveis no seguinte local no computador onde você executa a ferramenta: c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft Dynamics CRM Package Deployer\<Version>. Para especificar uma pasta diferente, utilize o parâmetro cmdlet do PowerShell -LogWriteDirectory. Mais informações: Utilizar o cmdlet para obter pacotes

  • Login_ErrorLog.log: Fornece informações sobre os problemas que ocorreram quando você usa a ferramenta para fazer login na instância Dynamics 365. Se existir quaisquer problemas no início de sessão, uma mensagem apresentadas no ecrã de início de sessão de ferramentas com uma hiperligação para o ficheiro de registo. A mensagem indica que um erro ao processar o pedido de início de sessão e o utilizador pode ver o registo de erros. Pode clicar na hiperligação na mensagem para ver o ficheiro de registo. O ficheiro de registo é criado a primeira vez que encontrar problemas de início de sessão na ferramenta. Depois, o ficheiro de registo é utilizado para registar informações sobre problemas de início de sessão sempre que estes ocorrerem.

  • PackageDeployer.log: Fornece informações detalhadas sobre cada tarefa executada na ferramenta durante a implantação dos pacotes. Pode ver o ficheiro de registo a partir da ferramenta clicando na hiperligação Ver Ficheiro de Registo na parte inferior do ecrã.

  • ComplexImportDetail.log: Fornece informações detalhadas sobre os dados importados na última implantação usando a ferramenta. Sempre que implementar um pacote utilizando esta ferramenta, os detalhes existentes no ficheiro de registo são movidos para um ficheiro denominado ComplexImportDetail._old.log no mesmo diretório e o ficheiro ComplexImportDetail.log apresenta informações sobre a importação mais recente efectuada utilizando a ferramenta.

Melhores práticas de pacotes de distribuição

Durante a implementação de pacotes, os administradores do Dynamics 365 têm de:

  • Insista num conjunto deste pacote para que possa monitorizar um conjunto de volta à sua origem.

  • Testar o pacote numa instância de pré-produção (de preferência uma imagem exata da instância de Produção) antes de a executar num servidor de produção.

  • Fazer uma cópia de segurança da instância de Produção antes de implementar o pacote.

Consultar também

Criar pacotes para o CRM Package Deployer