Chia sẻ qua

Triển khai các gói bằng Package Deployer và Windows PowerShell

  • Bài viết

Microsoft Dynamics CRM Package Deployer cho phép quản trị viên triển khai các gói vào một môi trường.

Lưu ý

Package deployer cũng hoạt động với các tổ chức Dynamics 365 Customer Engagement (on-premises).

Một "gói" có thể bao gồm bất kỳ hoặc tất cả những điều sau đây:

  • Một hoặc nhiều Dataverse tệp giải pháp.

  • Tệp mỏng hoặc tệp dữ liệu được xuất từ công cụ Configuration Migration. Để biết thêm thông tin về công cụ Configuration Migration, hãy xem Quản lý dữ liệu cấu hình của bạn.

  • Mã tùy chỉnh có thể chạy trong hoặc sau khi gói được triển khai vào một môi trường.

  • Nội dung HTML cụ thể cho các gói phần mềm mà có thể hiển thị ở đầu và cuối của quá trình triển khai gói. Điều này có thể hữu ích để cung cấp một mô tả về các giải pháp và tệp đã được triển khai trong gói.

    Nhà phát triển tạo ra gói bằng cách sử dụng bản mẫu triển khai gói trong Visual Studio. Thông tin thêm: Tạo gói cho Package Deployer

    Sau khi một gói được tạo, bạn có thể triển khai gói này bằng cách chạy CRM Package Deployer hoặc bằng cách sử dụng các lệnh ghép ngắn của Windows PowerShell cho công cụ.

Quan trọng

Trước khi bạn nhập và chạy một gói trong tổ chức sản xuất, hãy kiểm tra gói trên hình ảnh phản chiếu phi sản xuất của tổ chức sản xuất.

Luôn sao lưu tổ chức sản xuất trước khi bạn triển khai một gói.


Triển khai gói bằng cách sử dụng công cụ Package Deployer

Bạn có thể sử dụng công cụ Package Deployer (packagedeployer.exe) để triển khai các gói trong các cách sau.

Sử dụng công cụ CRM Package Deployer để triển khai các gói

Sử dụng công cụ CRM Package Deployer tại dòng lệnh

Sử dụng công cụ Package Deployer để triển khai các gói

Công cụ Package Deployer chỉ có thể xử lý một gói tại một thời điểm. Tuy nhiên, nó cung cấp cho người dùng khả năng để chọn một gói để triển khai từ nhiều gói có sẵn trong thư mục công cụ Package Deployer. Một số màn hình và hành động trong các công cụ khác dựa trên định nghĩa gói. Bạn không phải cài đặt công cụ Package Deployer. Chỉ cần tải về và chạy nó.

  1. Nhận được gói để triển khai. Gói là một tập hợp gồm các tệp và thư mục được tạo trong thư mục dự án Visual Studio (<Project>\Bin\Debug) khi bạn tạo dự án gói trong Visual Studio. Sao chép mục sau đây từ thư mục gỡ lỗi dự án của bạn:

    • <PackageName> thư mục: Thư mục này chứa các giải pháp, cấu hình nhập và nội dung cho gói của bạn.

    • <PackageName>.DLL: Phiên bản lắp ráp này chứa mã cho gói của bạn. Theo mặc định, tên của cụm chính là tên dự án Visual Studio của bạn.

      Để có thông tin chi tiết về tao gói bằng cách sử dụng Visual Studio, xem Tạo một gói cho công cụ Package Deployer.

      Để biết về chủ đề này, chúng ta hãy giả định rằng các cụm và thư mục gói từ Visual Studio thư mục gỡ lỗi dự án (<Project>\Bin\Debug) được sao chép vào thư mục c:\DeployPackage.

  2. Lấy công cụ Package Deployer. Công cụ Package Deployer có sẵn dưới dạng gói NuGet. Để sử dụng Package Deployer, bạn phải tải về và trích xuất vào máy tính cục bộ bằng cách dùng nuget.exe.

    Tải nuget.exe xuống từ https://www.nuget.org/downloads rồi lưu vào máy tính, chẳng hạn như d:\. Sau đó chạy lệnh sau ở dấu nhắc lệnh để trích xuất nội dung gói vào một thư mục, chẳng hạn như PD, trên máy tính của bạn:
    d:\nuget install Microsoft.CrmSdk.XrmTooling.PackageDeployment.Wpf -Version [VERSION] -O d:\PD

    Sau khi đã trích xuất công cụ Package Deployer, hãy duyệt tới thư mục [ExtractedLocation]\tools để tìm tệp PackageDeployer.exe.

  3. Sao chép thư mục gói và tập hợp từ c:\DeployPackage đến thư mục [ExtractedLocation]\tools.

  4. Sau khi sao chép tệp, chạy công cụ bằng cách bấm đúp vào tệp PackageDeployer.exe trong thư mục [ExtractedLocation]\tools.

  5. Bấm vào Tiếp tục trên màn hình chính của công cụ.

  6. Trên màn hình Kết nối với Microsoft Dynamics 365 for Customer Engagement, cung cấp thông tin xác thực chi tiết để kết nối với Dynamics 365 Server mà bạn muốn triển khai gói. Nếu bạn có nhiều tổ chức và muốn chọn tổ chức nơi bạn muốn triển khai gói, chọn hộp kiểm Luôn hiển thị danh sách tổ chức có sẵn. Bấm vào đăng nhập.

  7. Nếu bạn có nhiều tổ chức trên Dynamics 365 Server, hãy chọn một tổ chức trong các ứng dụng Dynamics 365 để kết nối.

  8. Chọn gói cần triển khai và bấm vào Tiếp theo.

    Chọn gói của bạn trong Công cụ Package Deployer .

  9. Thực hiện theo các hướng dẫn trên màn hình tiếp theo để hoàn thành việc triển khai các gói của bạn.

    Các màn hình xuất hiện dựa trên định nghĩa của gói bạn đã chọn để triển khai. Nếu triển khai gói đầu cuối bằng công cụ Package Deployer, hãy xem chủ đề về cách triển khai gói Unified Service Desk: Triển khai ứng dụng Unified Service Desk mẫu cho Máy chủ CRM bằng Package Deployer

Sử dụng công cụ Package Deployer tại dòng lệnh

Quản trị viên hệ thống và người tùy chỉnh có thể chuyển các tham số, chẳng hạn như mã ngôn ngữ vùng đến packagedeployer.exe từ dòng lệnh. Các tham số này chỉ có thể được cấu hình bằng cách chạy công cụ Package Deployer tại dòng lệnh.

Lưu ý

Tính năng này được giới thiệu lần đầu tiên trong Dynamics CRM Online 2016 Bản cập nhật 0.1.

Các tham số khả dụng có trong bảng này.

Tham số Description Giá trị Mặc định
Thiết đặt Gói Thời gian chạy Hướng dẫn packagedeployer.exe chấp nhận các tham số dòng lệnh như LCID và SkipChecks. Không áp dụng
LCID=ID ngôn ngữ Chỉ định ID ngôn ngữ, chẳng hạn như 1033 cho tiếng Anh-Mỹ hoặc 1036 cho tiếng Pháp-Pháp, từ ID ngôn ngữ có sẵn trong gói. Nếu không xác định, ngôn ngữ mặc định sẽ được sử dụng. Sử dụng ngôn ngữ mặc định
SkipChecks = đúng/sai Chỉ sử dụng tham số này khi môi trường mục tiêu không chứa bất kỳ giải pháp hay tùy chỉnh nào khác. Khi được đặt thành đúng, nhập giải pháp sẽ bỏ qua một số kiểm tra an toàn, có thể cải thiện hiệu suất nhập. Sai

Sau đây là ví dụ hướng dẫn CRM Package Deployer bỏ qua một số kiểm tra an toàn và đặt ngôn ngữ để nhập là tiếng Ba Lan.

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

Lưu ý

Sử dụng dấu gạch dọc | để phân tách các tham số khi bạn chạy packagedeployer.exe tại dòng lệnh có nhiều tham số.

Để biết thêm thông tin về tham số và giá trị có thể được chuyển đến packagedeployer.exe, hãy xem Tạo gói cho CRM Package Deployer.

Sử dụng Windows PowerShell để triển khai gói

Công cụ Package Deployer cũng hỗ trợ Windows PowerShell để triển khai gói. Thông tin thêm: Bắt đầu sử dụng mô-đun triển khai gói

Khắc phục sự cố các vấn đề triển khai gói bằng cách sử dụng tệp nhật ký

Công cụ Package Deployer cung cấp trợ giúp đăng nhập để có thông tin chi tiết về lỗi có thể xảy ra khi ai đó đăng nhập vào phiên bản Microsoft Dynamics 365 for Customer Engagement bằng cách sử dụng công cụ và triển khai các gói. Theo mặc định, công cụ này tạo ra ba tệp nhật ký có sẵn tại vị trí sau trên máy tính nơi bạn chạy công cụ: c:\Users\<UserName>\AppData\Roaming\Microsoft\Microsoft Dynamics CRM Package Deployer\<Version>. Để chỉ định một thư mục khác, hãy sử dụng tham số -LogWriteDirectory trong lệnh ghép ngắn của PowerShell. Thông tin thêm: Sử dụng lệnh ghép ngắn để truy xuất gói

  • Login_ErrorLog.log: Cung cấp thông tin về các sự cố xảy ra khi bạn sử dụng công cụ để đăng nhập vào phiên bản Dynamics 365. Nếu có bất kỳ vấn đề trong quá trình đăng nhập, một thông báo xuất hiện trên màn hình đăng nhập của công cụ với một liên kết đến tệp nhật ký này. Thông báo cho biết rằng một lỗi đã xảy ra trong khi thực hiện yêu cầu đăng nhập và người dùng có thể xem nhật ký lỗi. Bạn có thể bấm vào liên kết trong thông báo để xem tệp nhật ký này. Tệp nhật ký được tạo ra lần đầu tiên gặp bất kỳ sự cố đăng nhập nào vào công cụ. Sau đó, tệp nhật ký được sử dụng để ghi các thông tin về sự cố đăng nhập bất cứ khi nào nó xảy ra.

  • PackageDeployer.log: Cung cấp thông tin chi tiết về từng tác vụ được thực hiện trong công cụ trong quá trình triển khai các gói. Bạn có thể xem các tệp nhật ký từ công cụ bằng cách bấm vào liên kết Xem tệp nhật ký ở dưới cùng của màn hình.

  • ComplexImportDetail.log: Cung cấp thông tin chi tiết về dữ liệu được nhập trong lần triển khai cuối cùng bằng cách sử dụng công cụ. Mỗi khi bạn triển khai một gói bằng cách sử dụng công cụ này, các chi tiết sẵn có từ các tệp nhật ký được chuyển đến một tệp gọi là ComplexImportDetail._old.log trong cùng một thư mục, và tệp ComplexImportDetail.log hiển thị các thông tin về việc nhập gần đây nhất được thực hiện bằng cách sử dụng công cụ.

Các thực tiễn tốt nhất cho việc triển khai gói

Trong khi triển khai gói, quản trị viên Dynamics 365 phải:

  • Nhấn mạnh vào một tổ hợp gói đã ký để họ có thể theo dõi một tổ hợp về nguồn của nó.

  • Kiểm tra các gói trên một phiên bản tiền sản xuất (tốt hơn là một hình ảnh phản chiếu của phiên bản Sản xuất) trước khi sử dụng nó trên một máy chủ sản xuất.

  • Sao lưu phiên bản Sản xuất trước khi triển khai một gói.

Xem thêm

Tạo các gói cho CRM Package Deployer