Hướng dẫn: Tự động triển khai giải pháp bằng cách sử dụng GitHub Actions cho Microsoft Power Platform

Trong hướng dẫn này, bạn sẽ tìm hiểu cách:

• Tạo kho lưu trữ GitHub mới
• Tạo hai dòng GitHub công việc bằng cách sử dụng GitHub Actions cho Microsoft Power Platform

Quy trình làm việc có thể tự động xuất ứng dụng của bạn (dưới dạng giải pháp không được quản lý) từ môi trường phát triển, tạo cấu phần bản dựng (giải pháp được quản lý) và triển khai ứng dụng vào môi trường sản xuất của bạn. Hướng dẫn này sử dụng Giải pháp ALMLab bạn đã xây dựng và các môi trường bạn đã thiết lập trong các hướng dẫn trước.

Hướng dẫn liên quan: Bắt đầu và Xây dựng ứng dụng dựa trên mô hình.

Tạo tài GitHub mới

1. Đi tới https://github.com và chọn Đăng ký hoặc Bắt đầu bản dùng thử miễn phí (hoặc đăng nhập nếu bạn có tài khoản hiện có).

   

2. Sau khi bạn tạo tài khoản của mình, hãy tạo một kho lưu trữ bằng cách chọn Tạo kho lưu trữ hoặcMới.

   

   Bạn có thể thấy màn hình đích thay thế sau:

   

3. Tạo kho lưu trữ mới của bạn và đặt tên cho nó poweractionslab. Đảm bảo bạn chọn Thêm tệp README để khởi tạo kho lưu trữ và chọn Tạo kho lưu trữ.

   

Tạo mã bí mật mới cho Xác thực tên dịch vụ chính

1. Đi tới kho lưu trữ của bạn và chọn Cài đặt. Mở rộng Bí mật, sau đó chọn Hành động.

2. Trên trang Bí mật , đặt tên bí mật PowerPlatformSPN. Nhập bí mật máy khách từ đăng ký ứng dụng bạn đã tạo Microsoft Entra vào trường Giá trị, sau đó chọn Thêm bí mật. Bạn sẽ tham khảo bí mật máy khách trong các tệp YML xác định dòng công việc GitHub sau trong hướng dẫn này.

   

   Mã bí mật máy khách hiện được lưu trữ bảo mật dưới dạng mã bí mật GitHub.

Tạo quy trình làm việc để xuất và giải nén tệp giải pháp vào một nhánh mới

1. Chọn Hành động, rồi chọn tự thiết lập dòng công việc. Hoặc chọn Cấu hình trong hộp Dòng công việc đơn giản bên dưới phần được đề xuất cho kho này .

   

2. Bạn thấy tệp YAML mới với dòng công việc cơ bản để giúp bạn bắt đầu với các GitHub động.

   

3. Xóa nội dung tạo sẵn, rồi dán nội dung từ tệp export-and-branch-solution-with-spn-auth.yml tạo. Đổi tên tệp thành export-and-branch-solution.yml.

   

4. Cập nhật <ENVIRONMENTURL> với URL cho môi trường phát triển mà bạn muốn xuất từ đó (ví dụ: https://poweractionsdev.crm.dynamics.com).

5. Cập nhật <APPID> và <TENANT ID> bằng các giá trị của bạn.

   • Nếu bạn sử dụng thông tin xác thực , hãy dán export-and-branch-solution.yml tệp thay vì export-and-branch-solution-with-spn-auth.yml dung tệp. Cập nhật <USERNAME> với tên người dùng bạn sử dụng để kết nối với môi trường.

     

   Tiền bo

   Nếu bạn không quen thuộc với các tài GitHub Actions và muốn tìm hiểu thêm, hãy xem tài liệu chính thức tại https://docs.github.com/en/actions.

6. Bây giờ bạn đã sẵn sàng để cam kết thay đổi của mình. Chọn Bắt đầu cam kết, nhập Tạo yml xuất trong trường tiêu đề, rồi thêm mô tả (tùy chọn). Tiếp theo, chọn Cam kết tệp mới.

   

Xin chúc mừng, bạn đã tạo dòng công việc GitHub đầu tiên của mình bằng cách sử dụng các hành động sau đây:

• Tôi là ai: Đảm bảo rằng bạn có thể kết nối thành công với môi trường mà bạn muốn xuất từ đó.
• Xuất giải pháp: Xuất tệp giải pháp từ môi trường phát triển của bạn.
• Giải pháp giải nén: Tệp giải pháp mà máy chủ xuất là một tệp nén (zip) với các tệp cấu hình hợp nhất. Các tệp ban đầu này không phù hợp cho việc quản lý mã nguồn vì chúng không được cấu trúc để giúp cho hệ thống quản lý mã nguồn có thể thực hiện sự khác biệt đúng cách trên các tệp và ghi lại những thay đổi bạn muốn cam kết kiểm soát nguồn. Bạn cần giải nén các tập tin giải pháp để làm cho chúng thích hợp cho việc lưu trữ và xử lý kiểm soát nguồn.
• Giải pháp nhánh: Tạo một nhánh mới để lưu trữ giải pháp đã xuất.

Kiểm tra quy trình làm việc xuất và giải nén

1. Tiếp theo, kiểm tra xem quy trình làm việc có chạy không. Đi tới Hành động, chọn Chạy dòng công việc, rồi chọn Chạy dòng công việc. Nếu bạn sử dụng tên giải pháp khác với ALMLab, hãy thay đổi giá trị ở đây nhưng vẫn giữ nguyên các giá trị khác.

   

2. Sau 5–10 giây, dòng công việc bắt đầu. Bạn có thể chọn dòng công việc đang chạy để giám sát tiến độ.

   

   

3. Sau khi dòng công việc hoàn tất, hãy kiểm tra xem một nhánh mới có được tạo bằng giải pháp được giải nén vào thư solutions/ALMLab mục không. Đi tới tab Mã ,rồi bung rộng danh sách thả xuống nhánh.

4. Chọn nhánh mà hành động đã tạo.

5. Kiểm tra xem thư solutions/ALMLab mục có được tạo trong nhánh mới không. Sau đó, tạo một yêu cầu kéo để phối các thay đổi vào nhánh chính. Chọn Đóng góp và trong hộp thả xuống , chọn Mở yêu cầu Kéo.

6. Trên màn hình Mở yêu cầu Kéo , thêm tiêu đề và mô tả nếu bạn muốn, rồi chọn Tạo yêu cầu kéo.

7. Màn hình cập nhật để hiển thị yêu cầu kéo mới. Khi bạn tạo yêu cầu kéo, bạn sẽ nhận được xác nhận rằng nhánh của bạn không có xung đột với nhánh chính. Xác nhận này có nghĩa là bạn có thể tự động phối các thay đổi vào nhánh chính. Chọn Phối yêu cầu kéo , rồi chọn Xác nhận phối. Hoặc bạn có thể chọn xóa nhánh để loại bỏ nhánh hiện không còn tồn tại.

   

8. Quay lại nhánh mặc định (chính) và kiểm tra xem giải pháp có sẵn ở đó không.

Tạo quy trình làm việc có thể tái sử dụng để tạo cấu phần bản dựng và nhập vào sản xuất

Trong phần này, tạo dòng công việc bổ sung:

• Tạo giải pháp được quản lý và xuất bản nó dưới dạng cấu phần GitHub
• Nhập cấu phần bản dựng vào môi trường sản xuất

1. Đi tới Hành động và chọn Dòng công việc mới.

   

2. Chọn tự thiết lập dòng công việc.

   

3. Đổi tên tiêu đề dòng công việc thành release-solution-to-prod-with-inputs. Sao chép nội dung từ release-solution-to-prod-with-inputs.yml tệp và dán vào màn hình Chỉnh sửa tệp mới.

   

4. Cam kết thay đổi. Chọn Bắt đầu cam kết và sau đó thêm tiêu đề và mô tả (tùy chọn). Tiếp theo, chọn Cam kết tệp mới.

   

Gọi quy trình làm việc có thể tái sử dụng trong sự kiện phát hành

Trong phần này, bạn gọi dòng công việc có thể dùng lại trên sự kiện phát hành.

1. Đi tới Hành động và chọn Dòng công việc mới.

   

2. Chọn tự thiết lập quy trình làm việc.

   

3. Đổi tên tiêu đề dòng công việc thành release-action-call. Sao chép nội dung từ release-action-call.yml tệp và dán vào màn hình Chỉnh sửa tệp mới.

   

4. Cập nhật các biến sau trong tệp quy trình làm việc mới:

   • Cập <BUILD_ENVIRONMENT> nhật với URL cho môi trường bản dựng bạn đang sử dụng để tạo giải pháp được quản lý. Ví dụ: https://poweractionsbuild.crm.dynamics.com.
   • Cập <PROD_ENVIRONMENT> nhật với URL cho môi trường sản xuất mà bạn đang triển khai đến. Ví dụ: https://poweractionsprod.crm.dynamics.com.
   • Cập <APP_ID> nhật với ID Ứng dụng (Máy khách) mà bạn tìm thấy trong lưỡi App registrations của Microsoft Azure Portal bằng cách chọn đăng ký mà bạn đã tạo trước đó trong hướng dẫn này.
   • Cập <TENANT_ID> nhật với ID Thư mục (đối tượng thuê) mà bạn tìm thấy trong lưỡi App registrations của Microsoft Azure Portal bằng cách chọn đăng ký bạn đã tạo trước đó trong hướng dẫn này.

5. Cam kết thay đổi. Chọn Bắt đầu cam kết và sau đó thêm tiêu đề và mô tả (không bắt buộc). Tiếp theo, chọn Cam kết tệp mới.

   

Kiểm tra bản phát hành cho quy trình làm việc sản xuất

Bây giờ bạn đã sẵn sàng để kiểm tra dòng công việc cuối cùng. Dòng công việc này kích hoạt khi một bản phát hành mới được triển khai để sản xuất.

1. Đi tới Bản phát hành.

   

2. Chọn Tạo nháp bản phát hành mới.

3. Thêm thẻ phát hành, tiêu đề và chọn Xuất bản bản phát hành.

4. Chọn Hành động để xem quy trình làm việc đang chạy.

   

5. Chọn quy trình làm việc đang chạy để xem các hành động khi chúng chạy.

   

6. Chờ đến khi mỗi hành động hoàn thành.

   

7. Sau khi dòng công việc hoàn tất, hãy đăng nhập vào môi trường sản xuất của bạn và xác thực rằng giải pháp được triển khai như một giải pháp được quản lý.

Triển khai bản cập nhật và xem xét các thay đổi trước khi phát hành sản xuất

Kiểm tra quy trình đầu cuối, sau đó xem cách bạn có thể xem và xác thực các thay đổi đối với ứng dụng trước khi triển khai ứng dụng đó vào sản xuất.

1. Đi tới giải pháp ALMLab trong môi trường phát triển của bạn và chọn Chỉnh sửa hoặc chọn tên hiển thị giải pháp.

   

2. Chọn và xem bảng Yêu cầu thời gian rảnh.

   

3. Chọn + Thêm cột và tạo cột mới như minh họa trong hình dưới đây.

   

   Giá trị trường được cập nhật:**

   • Tên hiển thị: Đã phê duyệt
   • Kiểu dữ liệu: Có/Không

4. Chọn Xong.

5. Chọn Lưu bảng.

6. Quay lại tab Hành động GitHub kho lưu trữ của bạn, chọn Chạy dòng công việc và chọn nút Chạy dòng công việc.

   

7. Sau 5–10 giây, dòng công việc bắt đầu. Chọn dòng công việc đang chạy để theo dõi tiến độ của nó.

   

   

8. Sau khi dòng công việc kết thúc, hãy đi đến nhánh mới bằng cách chọn Mã , rồi chọn Nhánh.

   

9. Chọn nhánh mà bạn đã tạo bằng cách mở rộng đóng góp và chọn Mở yêu cầu kéo.

10. Thêm tiêu đề (tùy chọn) rồi chọn Tạo yêu cầu kéo.

11. Sau khi cập nhật nội dung, hãy chọn tab Tệp đã thay đổi.

12. Lưu ý rằng các thay đổi đối với giải pháp được đánh dấu màu xanh lục để cho biết rằng phần này của tệp đã được thêm vào khi so sánh với cùng tệp đó trong nhánh chính.

13. Quay lại tab Hội thoại. Chọn Yêu cầu kéo , rồi chọn yêu cầu kéo mà bạn đã tạo trước đó.

14. Trên trang Yêu cầu kéo , chọn Làm bí mật và phối để phối tệp giải pháp đã cập nhật vào nhánh chính của bạn. Tùy ý xóa mà bây giờ được phối vào chính.

    

15. Làm theo các bước trong phần Kiểm tra bản phát hành cho dòng công việc sản xuất để tạo bản phát hành mới và xác thực rằng giải pháp cập nhật được triển khai cho môi trường sản xuất của bạn.

Xin chúc mừng, bạn đã thiết lập thành công dòng công việc CI/CD mẫu bằng cách sử dụng GitHub động!

Xem thêm

Tự động hóa quy trình làm việc của bạn từ ý tưởng đến sản xuất