Package Deployer ve Windows PowerShell kullanarak paketleri dağıtma

Microsoft Dynamics CRM Package Deployer, yöneticilerin paketleri bir ortama dağıtmasına olanak tanır.

Not

Package Deployer Dynamics 365 Customer Engagement (on-premises) kuruluşlarıyla da çalışır.

"Paket" aşağıdakilerin herhangi birinden veya tümünden oluşabilir:

• Bir veya daha fazla Dataverse çözüm dosyası.

• Düz dosyalar veya Yapılandırma Geçiş aracından dışa aktarılan veri dosyaları. Yapılandırma Geçişi aracı hakkında Daha fazla bilgi edinmek için bkz. Yapılandırma verilerinizi yönetme.

• Paket bir ortama dağıtılırken veya dağıtıldıktan sonra çalışabilecek özel kod.

• Paket dağıtımı işleminin başlangıcında veya sonunda görüntülenebilecek, pakete özel HTML içeriği. Bu, paket içinde dağıtılan çözümlerin ve dosyaların bir açıklamasını sağlamak için faydalı olabilir.

  Geliştiriciler, Visual Studio'da paket dağıtma şablonunu kullanarak paketler oluşturur. Daha fazla bilgi: Package Deployer için paket oluşturma

  Bir paket oluşturulduktan sonra, CRM Package Deployer çalıştırarak veya araç için Windows PowerShell cmdlet'ler kullanarak dağıtabilirsiniz.

Önemli

Bir üretim kurumunda bir paketi alıp çalıştırmadan önce, üretim kurumunun üretim dışı bir ayna görüntüsünde bunu sınayın.

Bir paketi dağıtmadan önce her zaman üretim kurumunu yedekleyin.

Package Deployer aracını kullanarak paket dağıtma

Paketleri aşağıdaki şekillerde dağıtmak için Package Deployer aracını (packagedeployer.exe) kullanabilirsiniz.

CRM Package Deployer aracını kullanarak paket dağıtma

CRM Package Deployer aracını komut satırında kullanma

Package Deployer aracını kullanarak paket dağıtma

Package Deployer aracı bir seferde yalnızca bir paket işleyebilir. Ancak, kullanıcılara, Package Deployer aracı dizininde kullanılabilecek birden çok paketten dağıtmak üzere bir paket seçme olanağı sağlar. Araçtaki ekranların ve eylemlerin bazıları, paket tanımına bağlı olarak farklılık gösterir. Package Deployer aracını yüklemeniz gerekmez. Yalnızca onu indirin ve çalıştırın.

1. Dağıtılacak paketi edinin. Bir paket, paket projenizi Visual Studio'da oluşturduğunuz zaman, Visual Studio proje klasörünüzde (<Project>\Bin\Debug) oluşturulan bir dosyalar ve klasörler topluluğudur. Proje debug klasörünüzden kopyalanacak:

   • <PackageName> klasörü: Bu klasörde çözümler, içeri aktarma yapılandırması ve paketinizin içeriği bulunmaktadır.

   • <PackageName>.dll: Derlemede paketinizin kodu vardır. Varsayılan olarak, derleme adı Visual Studio proje adıyla aynıdır.

     Visual Studio kullanarak paket oluşturma hakkında ayrıntılı bilgi için bkz. Package Deployer aracı için paket oluşturma.

     Bu konu için, paket klasörünün ve derlemesinin Visual Studio projesi debug klasöründen (<Project>\Bin\Debug) c:\DeployPackage klasörüne kopyalandığını varsayalım.

2. Package Deployer aracını edinin. Package Deployer aracı NuGet paketi olarak sunulur. Package Deployer aracını kullanmak için yerel bilgisayarınıza indirmeniz ve nuget.exe kullanarak açmanız gerekir.
   
   nuget.exe dosyasını https://www.nuget.org/downloads adresinden indirin ve bilgisayarınızda örneğin d:\ konumuna kaydedin. Ardından, komut isteminde paket içeriklerini bilgisayarınızdaki PD adlı bir klasöre ayıklamak için aşağıdaki komutu çalıştırın:
   d:\nuget install Microsoft.CrmSdk.XrmTooling.PackageDeployment.Wpf -Version [VERSION] -O d:\PD
   
   Package Deployer aracını ayıkladıktan sonra PackageDeployer.exe dosyasını bulmak için [ExtractedLocation]\tools klasörüne bakın.

3. Paket klasörünü ve derlemesini c:\DeployPackage konumundan [ExtractedLocation]\tools klasörüne kopyalayın.

4. Dosyalar kopyalandıktan sonra, [ExtractedLocation]\tools klasöründe PackageDeployer.exe dosyasına çift tıklayarak aracı çalıştırın.

5. Aracın ana ekranında Devam öğesine tıklayın.

6. Microsoft Dynamics 365 for Customer Engagement'a bağlan ekranında paketi dağıtmak istediğiniz Dynamics 365 server'a bağlamak için kimlik doğrulama bilgileri sağlayın. Birden çok kuruluşunuz varsa ve paketi dağıtmak istediğiniz kuruluşu seçmek istiyorsanız, Her zaman kullanılabilir kuruluşların listesini görüntüle onay kutusunu seçin. Oturum aç öğesine tıklayın.

7. Dynamics 365 server'da birden çok kuruluşunuz varsa, bağlanmak istediğiniz Dynamics 365 uygulamaları kuruluşunu seçin.

8. Dağıtılmasını istediğiniz paketi seçin ve İleri'ye tıklayın.

   

9. Paketinizin dağıtımını tamamlamak için, sonraki ekranlardaki yönergeleri izleyin.

   Ekranlar, dağıtım için seçtiğiniz paket tanımı temel alınarak görüntülenir. Package Deployer aracı kullanılan bir uçtan uca paketi dağıtımı için, Unified Service Desk paketleri dağıtımının konusuna bakın: Örnek Unified Service Desk uygulamalarını Package Deployer kullanarak CRM Sunucusuna dağıtma

Package Deployer aracını komut satırında kullanma

Sistem yöneticileri ve özelleştiricileri, komut satırından packagedeployer.exe dosyasına bölgesel dil kodu gibi parametreleri aktarabilir. Bu parametreler yalnızca komut satırında Package Deployer aracını çalıştırarak yapılandırılabilir.

Not

Bu özellik, önce Dynamics CRM Online 2016 Update 0.1 ile sunulmuştur.

Kullanılabilir parametreler bu tabloda yer alır.

Parametre	Tanım	Varsayılan Değer
RuntimePackageSettings	packagedeployer.exe dosyasından LCID ve SkipChecks gibi komut satırı parametrelerini kabul etmesini ister.	Uygulanamaz
LCID=localeID	Türkçe için 1033 veya paket kimlikleri kullanılabilir yerel ayarlarından Fransızca-Fransa için 1036 gibi yerel ayar kimliği belirtir. Belirtilmezse, varsayılan dil kullanılır.	Varsayılan dili kullan
SkipChecks=true/false	Bu parametreyi yalnızca hedef ortamda başka herhangi bir çözüm veya özelleştirme olmadığında kullanın. Doğru olarak ayarlandığında, çözüm alma işleminin performansını artıran bazı güvenlik denetimlerini atlar.	False

Aşağıdaki örnek, CRM Package Deployer aracına bazı güvenlik denetimlerini atlaması ve alınacak dili Lehçe olarak ayarlaması talimatı verir.

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

Not

packagedeployer.exe dosyasını komut satırında birden çok parametreyle çalıştırdığınızda, parametreleri ayırmak için dikey çizgi | karakterini kullanın.

packagedeployer.exe dosyasına aktarılabilen parametreler ve değerler hakkında Daha fazla bilgi edinmek için bkz. CRM Package Deployer aracı için paket oluşturma.

Paketleri dağıtmak için Windows PowerShell kullanma

Package Deployer aracı, paketleri dağıtmak için Windows PowerShell desteği de sağlar. Daha fazla bilgi: Paket dağıtım modülünü kullanmaya başlayın

Günlük dosyalarını kullanarak paket dağıtımı sorunlarını giderme

Package Deployer aracı, birisi aracı kullanarak ve paketleri dağıtarak Microsoft Dynamics 365 for Customer Engagement örneğinde oturum açtığında oluşabilecek hatalar hakkında ayrıntılı bilgi almak üzere günlük oluşturma desteği sağlar. Araç, varsayılan olarak, aracı çalıştırdığınız bilgisayarda şu konumda üç günlük dosyası oluşturur: c:\Kullanıcılar\<KullanıcıAdı>\AppData\Roaming\Microsoft\Microsoft Dynamics CRM Package Deployer\<Sürüm>. Farklı bir klasör belirtmek için -LogWriteDirectory PowerShell cmdlet parametresini kullanın. Daha fazla bilgi: Paketleri almak için cmdlet kullanma

• Login_ErrorLog.log: Dynamics 365 örneğine oturum açmak için aracı kullandığınızda gerçekleşen sorunlar hakkında bilgi sağlar. Oturum açma sırasında herhangi bir sorun oluşursa, aracın oturum açma ekranında, bu günlük dosyasına bağlantı içeren bir ileti görüntülenir. İletide, oturum açma isteği işlenirken bir hata oluştuğu ve kullanıcının hata günlüğünü görüntüleyebileceği belirtilir. Bu günlük dosyasını görüntülemek için iletideki bağlantıya tıklayabilirsiniz. Günlük dosyası, araçta herhangi bir oturum açma sorunuyla ilk defa karşılaştığınızda oluşturulur. Bundan sonra, günlük dosyası, ne zaman gerçekleşirse, bir oturum açma sorunu hakkında bilgileri günlüğe kaydetmek için kullanılır.

• PackageDeployer.log: Paketlerin dağıtımı sırasında araçta gerçekleştirilen her görev hakkında ayrıntılı bilgi sağlar. Günlük dosyasını araçtan, ekranın alt kısmındaki Günlük Dosyasını Görüntüle bağlantısına tıklayarak görüntüleyebilirsiniz.

• ComplexImportDetail.log: Araç kullanılarak son dağıtımda içe aktarılan veriler hakkında ayrıntılı bilgi sağlar. Bu aracı kullanarak bir paketi her dağıttığınızda, günlük dosyasından varolan ayrıntılar, aynı dizindeki, ComplexImportDetail._old.log adlı bir dosyaya taşınır ve ComplexImportDetail.log dosyası, araç kullanılarak yapılan son içe aktarım hakkında bilgileri görüntüler.

Paketleri dağıtmak için en iyi yöntemler

Paketleri dağıtırken, Dynamics 365 yöneticilerinin aşağıdakileri yapması gerekir:

• Bir derlemeyi kaynağına kadar izleyebilmeleri adına imzalı bir pakette ısrar etmeleri.

• Paketi, bir Üretim sunucusunda çalıştırmadan önce, bir üretim öncesi örnekte (tercihen, üretim örneğinin bir ayna görüntüsü) sınamaları.

• Bir paketi dağıtmadan önce, Üretim kurulumunu yedekleyin.

Ayrıca bkz.

CRM Package Deployer için paket oluşturma