Distribuire pacchetti con Package Deployer e Windows PowerShell

Microsoft Dynamics CRM Package Deployer consente agli amministratori di distribuire i pacchetti a un ambiente.

Nota

Package deployer funziona anche con le organizzazioni Dynamics 365 Customer Engagement (on-premises).

Un "pacchetto" può essere dato da uno o tutti i seguenti elementi:

• Uno o più file di soluzione di Dataverse.

• File flat o file di dati di esportati dallo strumento di migrazione della configurazione. Per ulteriori informazioni sullo strumento di migrazione della configurazione, vedere Gestire i dati di configurazione.

• Codice personalizzato che può essere eseguito durante o dopo la distribuzione del pacchetto in un ambiente.

• Contenuto HTML specifico del pacchetto che può essere visualizzato all'inizio e alla fine del processo di distribuzione del pacchetto. Può essere utile per fornire una descrizione delle soluzioni e dei file distribuiti nel pacchetto.

  Gli sviluppatori possono creare pacchetti utilizzando il modello di distribuzione del pacchetto in Visual Studio. Ulteriori informazioni: Creare pacchetti per Package Deployer

  Dopo essere stato creato, un pacchetto può essere distribuito eseguendo CRM Package Deployer o utilizzando i cmdlet Windows PowerShell dello strumento.

Importante

Prima di importare ed eseguire un pacchetto in un'organizzazione di produzione, esegui il test del pacchetto in un'immagine speculare non di produzione dell'organizzazione di produzione.

Esegui sempre il backup dell'organizzazione di produzione prima di distribuire un pacchetto.

Distribuzione dei pacchetti con lo strumento Package Deployer

Puoi utilizzare lo strumento Package Deployer (packagedeployer.exe) per la distribuzione di pacchetti nei modi seguenti.

Utilizzare lo strumento Package Deployer di CRM per distribuire i pacchetti

Utilizza lo strumento Package Deployer di CRM nella riga di comando

Utilizzare lo strumento Package Deployer di CRM per distribuire i pacchetti

Lo strumento Package Deployer può elaborare un solo pacchetto alla volta. Offre tuttavia agli utenti la possibilità di selezionare un pacchetto da distribuire tra più pacchetti disponibili nella directory dello strumento Package Deployer. Alcune delle schermate e delle azioni dello strumento variano in base alla definizione del pacchetto. Non è necessario installare lo strumento Package Deployer. È sufficiente scaricarlo ed eseguirlo.

1. Ottenere il pacchetto da distribuire. Un pacchetto è una raccolta di file e cartelle che viene creato nella cartella del progetto di Visual Studio (<Project>\Bin\Debug) quando compili il progetto pacchetto in Visual Studio. Copiare la procedura seguente dalla cartella di debug di progetto:

   • Cartella <PackageName>: questa cartella include le soluzioni, la configurazione di importazione e i contenuti per il pacchetto.

   • <PackageName>.dll: l'assembly include il codice del pacchetto. Per impostazione predefinita, il nome dell'assembly è uguale al nome del progetto Visual Studio.

     Per informazioni dettagliate sulla creazione di un pacchetto utilizzando Visual Studio, vedere Creare un pacchetto per lo strumento Package Deployer.

     Per questo argomento, si presuppone che la cartella del pacchetto e l'assembly della cartella di debug del progetto di Visual Studio (<Project>\Bin\Debug) vengano copiati nella cartella c:\DeployPackage.

2. Recuperare lo strumento Package Deployer. Lo strumento Package Deployer è disponibile sotto forma di pacchetto NuGet. Per utilizzare Package Deployer, scarica ed estrai i file nel computer locale utilizzando nuget.exe.
   
   Scarica nuget.exe da https://www.nuget.org/downloads e salvalo nel computer, ad esempio in d:\. Quindi esegui il seguente comando dal prompt dei comandi per estrarre i file del pacchetto in una cartella, ad esempio PD, nel computer:
   d:\nuget install Microsoft.CrmSdk.XrmTooling.PackageDeployment.Wpf -Version [VERSION] -O d:\PD
   
   Dopo aver estratto il file PowerShell per lo strumento Package Deployer, sfoglia la cartella [ExtractedLocation]\tools per trovare il file PackageDeployer.exe.

3. Copia la cartella del pacchetto e l'assembly da c:\DeployPackage alla cartella [ExtractedLocation]\tools.

4. Una volta copiati i file, eseguire lo strumento facendo clic sul file PackageDeployer.exe nella cartella [ExtractedLocation]\tools.

5. Fare clic su Continua nella schermata principale dello strumento.

6. Nella schermata Connessione a Microsoft Dynamics 365 for Customer Engagement, fornisci i dettagli di autenticazione per connetterti a Dynamics 365 Server in cui vuoi distribuire il pacchetto. Se si dispone di più organizzazioni e si desidera selezionare l'organizzazione in cui si desidera distribuire il pacchetto, selezionare la casella di controllo Visualizza sempre l'elenco delle organizzazioni disponibili. Fare clic su Accesso.

7. Se disponi di più organizzazioni in Dynamics 365 Server, seleziona un'organizzazione app Dynamics 365 a cui connetterti.

8. Seleziona pacchetto da distribuire e fai clic su Successivo.

   

9. Seguire le istruzioni nelle schermate successive per completare la distribuzione del pacchetto.

   Le schermate verranno visualizzate in base alla definizione del pacchetto selezionato per la distribuzione. Per una distribuzione end-to-end del pacchetto che utilizza lo strumento Package Deployer, vedi l'argomento relativo alla distribuzione di pacchetti di Unified Service Desk: Distribuire le applicazioni Unified Service Desk di esempio al server CRM utilizzando Package Deployer

Utilizza lo strumento Package Deployer dalla riga di comando

Gli amministratori di sistema e i responsabili della personalizzazione possono passare i parametri, ad esempio un codice della lingua regionale a packagedeployer.exe dalla riga di comando. Tali parametri possono essere configurati solo eseguendo lo strumento Package Deployer dalla riga di comando.

Nota

Questa funzionalità è stata introdotta per la prima volta in Dynamics CRM Online 2016 Update 0.1.

In questa tabella sono disponibili i seguenti parametri.

Parametro	Description	Valore predefinito
RuntimePackageSettings	Indica a packagedeployer.exe di accettare i parametri della riga di comando ad esempio LCID e SkipChecks.	Non applicabile
LCID=localeID	Specifica l'ID delle impostazioni locali, ad esempio 1033 per l'inglese degli Stati Uniti o 1036 per il francese della Francia, dagli ID delle impostazioni locali disponibili nel pacchetto. Se non specificato altrimenti, verrà utilizzata la lingua predefinita.	Utilizza la lingua predefinita
SkipChecks=true/false	Usa questo parametro solo solo quando l'ambiente di destinazione non contiene altre soluzioni o personalizzazioni. Quando viene impostata su true, l'importazione della soluzione importerà alcuni controlli di sicurezza, che potranno migliorare le prestazioni dell'importazione.	False

Nell'esempio seguente viene indicato a CRM Package Deployer di ignorare alcuni controlli di sicurezza e viene impostata la lingua su Importa come polacco.

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

Nota

Utilizza il carattere barra verticale | per separare i parametri quando esegui packagedeployer.exe nella riga di comando con più parametri.

Per ulteriori informazioni sui parametri e i valori che puoi passare a packagedeployer.exe, vedere Creare pacchetti per Package Deployer per CRM.

Utilizzare Windows PowerShell per distribuire i pacchetti

Lo strumento Package Deployer fornisce il supporto per Windows PowerShell per la distribuzione dei pacchetti. Maggiori informazioni: Inizia a utilizzare il modulo di distribuzione del pacchetto

Risolvere i problemi di distribuzione del pacchetto utilizzando file di registro

Lo strumento Package Deployer offre supporto di registrazione per ottenere informazioni dettagliate sugli errori che possono verificarsi quando un utente accede all'istanza di Microsoft Dynamics 365 for Customer Engagement utilizzando lo strumento e distribuendo pacchetti. Per impostazione predefinita, lo strumento genera tre file di registro che sono disponibili nel percorso seguente nel computer in cui si esegue lo strumento: c:\Users\<Nomeutente>\AppData\Roaming\Microsoft\Microsoft Dynamics CRM Package Deployer\<Versione>. Per specificare una cartella diversa, utilizza il parametro cmdlet -LogWriteDirectory di PowerShell. Ulteriori informazioni: Utilizzare il cmdlet per recuperare i pacchetti

• Login_ErrorLog.log: fornisce informazioni sui problemi che si verificano quando si utilizza lo strumento per accedere all'istanza di Dynamics 365. Se durante l'accesso si verificano dei problemi, verrà visualizzato un messaggio nella schermata di accesso dello strumento contenente un collegamento a questo file di registro. Il messaggio indica che si è verificato un errore durante l'elaborazione della richiesta di accesso e che l'utente può visualizzare il registro errori. È possibile fare clic sul collegamento nel messaggio per visualizzare il file di registro. Il file di registro viene creato la prima volta che si verifica un problema di accesso nello strumento. Questo file di registro viene quindi utilizzato per registrare le informazioni su un problema di accesso in qualunque momento si verifichi.

• PackageDeployer.log: fornisce informazioni dettagliate su ciascuna attività eseguita nello strumento durante la distribuzione dei pacchetti. È possibile visualizzare il file di registro dallo strumento facendo clic sul collegamento Visualizza file di registro nella parte inferiore dello schermo.

• ComplexImportDetail.log: fornisce informazioni dettagliate sui dati importati durante l'ultima distribuzione utilizzando lo strumento. Ogni volta che si distribuisce un pacchetto utilizzando questo strumento, i dettagli esistenti del file di registro vengono spostati in un file denominato ComplexImportDetail._old.log nella stessa directory, mentre il file ComplexImportDetail.log contiene informazioni sull'ultima importazione eseguita utilizzando lo strumento.

Procedure consigliate per la distribuzione di pacchetti

Durante la distribuzione di pacchetti, gli amministratori di Dynamics 365 devono:

• Insistere su un assembly del pacchetto firmato in modo che possano ricollegare un assembly alla relativa origine.

• Verificare il pacchetto in un'istanza di preproduzione (preferibilmente un'immagine mirror dell'istanza di produzione) prima di eseguirlo in un server di produzione.

• Eseguire il backup dell'istanza di produzione prima di distribuire un pacchetto.

Vedi anche

Creare pacchetti per CRM Package Deployer