Compartilhar via

Implantar pacotes usando o Package Deployer e Windows PowerShell do CRM

  • Artigo

 

Publicado: novembro de 2016

Aplicável a: Dynamics CRM 2015

O Microsoft Dynamics CRM Package Deployer permite que os administradores implementem pacotes em um Microsoft Dynamics CRM (local) ou uma instância do Microsoft Dynamics CRM Online. Um "pacote" pode consistir de todos ou qualquer um dos seguintes:

  • Um ou mais arquivos de solução do Dynamics 365.

  • Arquivos de dados simples ou exportados do Ferramenta de Migração de Configuração. Para obter mais informações sobre o Ferramenta de Migração de Configuração, consulte Gerenciar dados de configuração.

  • Um código personalizado que pode ser executado durante ou depois do pacote ser implantado no servidor do Microsoft Dynamics 365.

  • Conteúdo HTML específico para o pacote que pode ser exibido no início e no final do processo de implantação do pacote. Isso pode ser útil para fornecer uma descrição das soluções e dos arquivos que são implantados no pacote.

Desenvolvedores criam pacotes usando o modelo de implantação de pacote no Microsoft Visual Studio.Para obter mais informações:MSDN: Criar um pacote para o Package Deployer do CRM

Depois que um pacote é criado, você pode implantar executando o Implantação de Pacotes do CRM ou usando os cmdlets do Windows PowerShell para a ferramenta.

Neste tópico

Use a ferramenta Package Deployer do CRM para implantar pacotes

Use o Windows PowerShell para implantar pacotes

Solucionar problemas de implantação do pacote usando arquivos de log

Práticas recomendadas para implantar pacotes

Use a ferramenta Package Deployer do CRM para implantar pacotes

O Ferramenta de Implantação de Pacotes pode processar apenas um pacote por vez. Entretanto, oferece aos usuários a capacidade de selecionar um pacote para implantar entre vários pacotes disponíveis no diretório do Ferramenta de Implantação de Pacotes. Algumas das telas e ações na ferramenta são diferentes com base na definição do pacote. Você não precisa instalar o Ferramenta de Implantação de Pacotes. Basta baixar e executar.

  1. Obtenha o pacote a ser implantado. Um pacote é um conjunto de arquivos e pastas criado na pasta de projeto no Visual Studio (<Project>\Bin\Debug) quando você criar seu projeto de pacote no Visual Studio. Copie os dados a seguir da sua pasta de depuração de projeto:

    • Pasta <PackageName>: essa 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 padrão, o nome do assembly será igual ao nome do seu projeto do Visual Studio.

    Para obter informações detalhadas sobre como criar um pacote usando o Visual Studio, consulte MSDN: Criar um pacote para a ferramenta Package Deployer.

    Neste tópico, suponhamos que a pasta do pacote e o assembly da pasta de depuração do projeto do Visual Studio (<Project>\Bin\Debug) foram copiados para a pasta c:\DeployPackage.

  2. Baixe o pacote do SDK do Microsoft Dynamics CRM. Execute o arquivo executável baixado para extrair os conteúdos do pacote.

  3. Procure na pasta SDK\Tools\PackageDeployer e copie a pasta do pacote e o assembly da pasta c:\DeployPackage para a pasta SDK\Tools\PackageDeployer.

  4. Após copiar todos os arquivos, execute a ferramenta clicando duas vezes no arquivo do PackageDeployer.exe na pasta do SDK\Tools\PackageDeployer.

  5. Clique em Continuar na tela principal da ferramenta.

  6. Na tela Conectar-se ao Microsoft Dynamics CRM, forneça os detalhes de autenticação para conectar o seu servidor do Dynamics 365 onde deseja implementar o pacote. Se houver várias organizações no servidor e você deseja selecionar a organização para onde deseja importar o pacote, marque a caixa de seleção Sempre exibir lista de organizações disponíveis. Clique em Logon.

  7. Se houver várias organizações no seu servidor do Dynamics 365 e você marcou a caixa de seleção Sempre exibir a lista de organizações disponíveis, a próxima tela permite selecionar a organização que deseja se conectar. Selecione uma organização do Dynamics 365 para estabelecer conexão.

  8. A tela a seguir solicitará que você selecione um pacote a ser implantado. Selecione seu nome de pacote e clique em Avançar.

    Selecione o pacote na ferramenta de Package Deployer

  9. Siga as instruções nas telas subsequentes para concluir a implantação do seu pacote.

    As telas aparecem baseadas na definição do pacote selecionado para implantação. Para uma implementação do pacote de ponta a ponta que usa o Ferramenta de Implantação de Pacotes, consulte o tópico para a implementação dos pacotes do Unified Service Desk: Implementar a amostra dos aplicativos do Unified Service Desk para o CRM Server usando o Package Deployer

Use o Windows PowerShell para implantar pacotes

O Ferramenta de Implantação de Pacotes também oferece suporte do Windows PowerShell para implantar pacotes.

Execute as etapas a seguir para usar os cmdlets do PowerShell para implantar pacotes:

Pré-requisitos

Registrar o cmdlets

Use o cmdlet do para recuperar pacotes

Use o cmdlet para se conectar ao servidor do CRM

Use o cmdlet para implantar pacotes

Obter ajuda detalhou sobre cmdlets

Pré-requisitos

Aqui estão os pré-requisitos para usar os cmdlets do PowerShell:

  • PowerShell 3.0 ou posterior é necessário para implantar um pacote usando o PowerShell. Para verificar a sua versão do PowerShell, execute uma janela do PowerShell, então execute o seguinte comando:$Host

  • Defina a política de execução para executar os scripts do PowerShell assinados. Para isso, execute uma janela do PowerShell como administrador, então execute o seguinte comando:Set-ExecutionPolicy -ExecutionPolicy AllSigned

Registrar o cmdlets

Você deve registrar os cmdlets do Windows PowerShell para o Ferramenta de Implantação de Pacotes, antes de poder usá-los. Para registrar os cmdlets:

  1. Caso ainda não esteja familiarizado, baixe o pacote de SDK do Dynamics 365 pelo Centro de Download da Microsoft e execute o arquivo do pacote para extrair o conteúdo do pacote. Suponhamos que você tenha extraído o pacote para a pasta do c:\CRM no computador. O Ferramenta de Implantação de Pacotes e outros arquivos necessários serão disponibilizados no seguinte local: c:\CRM\SDK\Tools\PackageDeployer.

  2. Inicie o Windows PowerShell no computador com privilégios elevados (executar como administrador).

  3. No prompt da janela do Windows PowerShell, altere seu diretório para a pasta do Windows PowerShell na pasta do PackageDeployer. Neste caso:

    cd c:\CRM\SDK\Tools\PackageDeployer\PowerShell

  4. Execute o script do RegisterXRMTooling.ps1 para registrar o conjunto do Package Deployer do Windows PowerShell (dll) e instalar o snap-in do Windows PowerShell para o Ferramenta de Implantação de Pacotes. Para fazer isso, para digite o comando a seguir e pressione ENTER:

    .\RegisterXRMTooling.ps1

  5. Adicione o snap-in do Windows PowerShell para a ferramenta XRM. Isso registrará os seguintes cmdlets: Get-CrmConnection e Get-CrmOrganizations.

    Add-PSSnapin Microsoft.Xrm.Tooling.Connector

  6. Adicione o snap-in do Windows PowerShell para o Package Deployer. Isso registrará os seguintes cmdlets: Get-CrmPackages e Import-CrmPackage.

    Add-PSSnapin Microsoft.Xrm.Tooling.PackageDeployment

Você está pronto para usar os cmdlets do Windows PowerShell. Para listar os cmdlets registrados, execute o comando a seguir no prompt da janela do Windows PowerShell:

Get-Help “Crm”

Use o cmdlet do para recuperar pacotes

Antes de usar o cmdlet, verifique se você copiou o pacote para a pasta PackageDeployer (nesse caso, c:\CRM\SDK\Tools\PackageDeployer). Um pacote é um conjunto de arquivos e pastas criado na pasta de projeto no Visual Studio (<Project>\Bin\Debug) ao criar o projeto no Visual Studio. Copie todo o conteúdo da sua pasta de depuração do projeto para a pasta PackageDeployer. Para obter informações detalhadas sobre como criar um pacote usando o Visual Studio, consulte MSDN: Criar um pacote para o Package Deployer do CRM.

  1. Na janela do PowerShell, use o seguinte cmdlet para retornar uma lista de pacotes disponíveis para importar no diretório especificado (nesse caso, c:\CRM\SDK\Tools\PackageDeployer):

    Get-CrmPackages –PackageDirectory c:\CRM\SDK\Tools\PackageDeployer

  2. Se você quiser informações sobre o pacote em um diretório, use o cmdlet Get-CrmPackages junto com o parâmetro –PackageName para especificar o nome do assembly no diretório que contém a definição do pacote.

    Get-CrmPackages –PackageDirectory c:\CRM\SDK\Tools\PackageDeployer –PackageName SampleCRMPackage.dll

Use o cmdlet para se conectar ao servidor do CRM

  1. Forneça suas credenciais para se conectar à instância do Microsoft Dynamics CRM Online ou Microsoft Dynamics CRM (local). Executar o seguinte comando solicitará que você digite seu nome de usuário e senha para se conectar à instância do Dynamics 365 e iremos armazenar na variável do $Cred e usá-lo posteriormente para conectar ao seu servidor do CRM.

    $Cred = Get-Credential

  2. Use o seguinte comando para obter uma conexão para sua instância do Microsoft Dynamics CRM Online ou Microsoft Dynamics CRM (local). Iremos armazenar informações de conexão na variável $CRMConn:

    • Se estiver se conectando a uma instância do Microsoft Dynamics CRM (local):

      $CRMConn = Get-CrmConnection -ServerUrl http://<your_CRM_Server> -OrganizationName <your_Org_Name> -Credential $Cred

    • Se estiver se conectando a um servidor do Microsoft Dynamics CRM Online:

      $CRMConn = Get-CrmConnection -DeploymentRegion NorthAmerica –OnlineType Office365 –OrganizationName <your_Org_Name> -Credential $Cred

      Observação

      Para o parâmetro DeploymentRegion, os valores válidos são NorthAmerica, EMEA e APAC. Para o parâmetro OnlineType, os valores válidos são Office365 e LiveID.

  3. Suas credenciais fornecidas são validadas ao executar o comando na etapa 2.

Use o cmdlet para implantar pacotes

Em seguida, use as informações de conexão do CRM armazenadas na variável $CRMConn para implantar pacotes da instância do Dynamics 365. Execute o seguinte comando para implantar seu pacote:

Import-CrmPackage –CrmConnection $CRMConn –PackageDirectory c:\CRM\SDK\Tools\PackageDeployer –PackageName SampleCRMPackage.dll –UnpackFilesDirectory c:\UnpackedFiles -Verbose

Observação

  • Os parâmetros CrmConnection, PackageDirectory e PackageName são obrigatórios.

  • Para o parâmetro PackageName, é necessário especificar o nome do assembly que contém a definição do pacote.

  • Não é necessário especificar o parâmetro UnpackFilesDirectory se seu pacote não desempacotar arquivos durante a implantação do pacote. Ao definir um pacote no Visual Studio, você especifica se deve descompactar arquivos usando o parâmetro agentdesktopzipfile no arquivo ImportConfig.xml .exe.Para obter mais informações:MSDN: Criar um pacote para o Package Deployer do CRM

  • O parâmetro Verbose é opcional e é usado para exibir um log detalhado de atividades executadas durante o processo de implantação do pacote.

Obter ajuda detalhou sobre cmdlets

Na janela PowerShell, use o cmdlet Get-Help com um nome de cmdlet para exibir a ajuda detalhada do cmdlet. Por exemplo, para obter ajuda detalhada para o cmdlet Import-CrmPackage:

Get-Help Import-CrmPackage -full

Para visualizar a ajuda online para cmdlets, consulte Referência do PowerShell do CRM.

Solucionar problemas de implantação do pacote usando arquivos de log

O Ferramenta de Implantação de Pacotes oferece suporte de registro para obter informações detalhadas sobre os erros que podem ocorrer quando alguém efetua login na instância do Microsoft Dynamics CRM usando a ferramenta e implantando pacotes. 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\PackageDeployer\<Version>.

  • Login_ErrorLog.log: fornece informações sobre os problemas que ocorreram ao usar a ferramenta para efetuar login na instância do Dynamics 365. Se houver problemas durante a entrada, uma mensagem aparece na tela de logon da ferramenta com um link para este arquivo de log. A mensagem indica que um erro ocorreu ao processar a solicitação de logon e o usuário pode exibir o log de erros. Você pode clicar no link na mensagem para exibir este arquivo de log. O arquivo de log é criado na primeira vez que você encontra qualquer problemas de login na ferramenta. Depois disso, o arquivo de log é usado para registrar as informações sobre problemas de login, sempre que ocorrerem.

  • PackageDeployer.log: fornece informações detalhadas sobre cada tarefa executada na ferramenta durante a implementação dos pacotes. Você pode exibir o arquivo de log da ferramenta clicando no link Exibir Arquivo de Log na parte inferior da tela.

  • ComplexImportDetail.log: fornece informações detalhadas sobre os dados importados na última implementação usando a ferramenta. Cada vez que implementar um pacote usando esta ferramenta, os detalhes existentes do arquivo de registro são movidos para um arquivo chamado ComplexImportDetail._old.log no mesmo diretório, e o arquivo do ComplexImportDetail.log exibe as informações sobre a última importação feita usando a ferramenta.

Práticas recomendadas para implantar pacotes

Para implantar pacotes, os administradores do Dynamics 365 devem:

  • Insista em um assembly de pacote assinado para que possa rastrear um assembly de volta para sua origem.

  • Teste o pacote em uma instância pré-produção (preferivelmente uma imagem espelhada da instância de produção) antes de executar em um servidor de produção.

  • Faça o backup da instância de produção antes de implantar um pacote.

Confira Também

MSDN: Criar um pacote para o Package Deployer do CRM
Administrando o CRM 2015

© 2016 Microsoft Corporation. Todos os direitos reservados. Direitos autorais