Hành động GitHub có sẵn cho phát triển Microsoft Power Platform
Các hành động của GitHub dành cho Microsoft Power Platform được mô tả trong các phần sau. Ngoài ra, các mẫu quy trình làm việc GitHub cũng được hiển thị. Để biết thêm thông tin về Hành động GitHub và cách tải chúng xuống, hãy truy cập vào Hành động GitHub cho Microsoft Power Platform.
Đặt cấu hình thông tin xác thực để sử dụng với Hành động GitHub với Microsoft Power Platform
Nhiều hành động yêu cầu bạn kết nối với môi trường Microsoft Dataverse. Bạn có thể thêm thông tin xác thực chính của dịch vụ hoặc người dùng làm bí mật trong kho lưu trữ GitHub của mình và sau đó sử dụng chúng trong quy trình làm việc của bạn.
Để biết chi tiết về cách thiết lập bí mật trong GitHub, hãy xem Bí mật được mã hóa
Để biết chi tiết cách thiết lập xác thực chính dịch vụ cho Microsoft Power Platform, xem Công cụ tạo DevOps
Sau khi được đặt cấu hình, bạn có thể gọi Dịch vụ chính từ bên trong các tập lệnh Hành động của mình.
Các thông số cần xác định trong Tập lệnh hành động GitHub của bạn là Các biến môi trường:
- ID ứng dụng chẳng hạn như:
WF_APPLICATION_ID:<your application id> - ID đối tượng thuê chẳng hạn như:
WF_TENANT_ID:<your tenant id>
Bí mật ứng dụng khách phải được thêm và lưu trữ dưới dạng Bí mật GitHub và sẽ được tham chiếu từ trong quy trình làm việc bằng cách sử dụng tham số như: client secret: ${{secrets.CLIENT_SECRET_GITHUB_ACTIONS}}
Nhiệm vụ trình trợ giúp
Nhiệm vụ trợ giúp có sẵn được mô tả bên dưới.
Hành động-cài đặt
Khi quy trình làm việc GitHub Actions buộc cài đặt Power Platform CLI trong ngữ cảnh của trình chạy và xảy ra lỗi hết thời gian chờ thì bạn phải sử dụng phiên bản 1 (@v1) với hành động bổ sung (actions-install) như bên dưới.
Quan trọng
- Việc sử dụng phiên bản 1 (@v1) có thể dẫn đến việc cập nhật các hành động GitHub hiện có, từ đó có thể dẫn đến việc cập nhật quy trình công việc hiện tại.
- Bạn phải thêm tác vụ Cài đặt Power Platform Công cụ làm tác vụ đầu tiên trong quy trình làm việc của mình trước bất kỳ Hành động GitHub nào khác cho Power Platform.
jobs:
builds:
runs-on: windows-latest # alternate runner OS is: ubuntu-latest
steps:
- name: Install Power Platform Tools
uses: microsoft/powerplatform-actions/actions-install@v1
- name: Export Solution
uses: microsoft/powerplatform-actions/export-solution@v1
with:
environment-url: 'https://myenv.crm.dynamics.com'
user-name: 'me@myenv.onmicrosoft.com'
password-secret: ${{ secrets.MYPASSWORD }}
solution-name: aSolution
solution-output-file: 'aSolution.zip'
working-directory: 'out'
Bạn có thể tìm thêm các mẫu GitHub Actions tại Power Platform Actions.
whoAmI
Xác minh kết nối dịch vụ bằng cách kết nối với dịch vụ và gửi yêu cầu WhoAmI [SDK/Web API]. Tác vụ này có thể hữu ích khi sớm đưa vào quy trình làm việc GitHub của bạn, để xác minh kết nối trước khi bắt đầu xử lý.
| Tham số | Nội dung mô tả |
|---|---|
| environment-url | URL cho môi trường bạn đang kết nối. |
| user-name | Tên người dùng của tài khoản bạn đang sử dụng để kết nối. |
| password-secret | Mật khẩu cho tên người dùng. Mật khẩu GitHub được xác định trong Cài đặt trong Khóa bí mật. Bạn không thể truy xuất bí mật sau khi nó đã được xác định và lưu. |
| app-id | ID ứng dụng để xác thực. Tham số này là cần thiết khi xác thực bằng thông tin xác thực Chính của Dịch vụ. |
| client-secret | Bí mật ứng dụng khách được sử dụng để xác thực đường dẫn GitHub. Tham số này là cần thiết khi xác thực bằng thông tin xác thực Chính của Dịch vụ. |
| tenant-id | ID đối tượng thuê khi xác thực bằng app-id và client-secret. |
Nhiệm vụ giải pháp
Các nhiệm vụ này thực hiện các hành động dựa trên các giải pháp và bao gồm những điều sau đây.
import-solution
Nhập một giải pháp vào môi trường đích.
| Tham số | Nội dung mô tả |
|---|---|
| environment-url | (Bắt buộc) URL cho môi trường đích mà bạn muốn nhập giải pháp vào (ví dụ: https://YourOrg.crm.dynamics.com). |
| user-name | (Bắt buộc) Nếu bạn đang sử dụng xác thực tên người dùng/mật khẩu, tên người dùng của tài khoản bạn đang sử dụng để kết nối. |
| password-secret | (Bắt buộc) Nếu bạn đang sử dụng xác thực tên người dùng/mật khẩu, mật khẩu của tài khoản bạn đang sử dụng để kết nối. |
| solution-file | (Bắt buộc) Đường dẫn và tên của tệp giải pháp bạn muốn nhập. |
| app-id | ID ứng dụng để xác thực. Tham số này là cần thiết khi xác thực bằng thông tin xác thực Chính của Dịch vụ. |
| client-secret | Bí mật ứng dụng khách được sử dụng để xác thực đường dẫn GitHub. Tham số này là cần thiết khi xác thực bằng thông tin xác thực Chính của Dịch vụ. |
| tenant-id | ID đối tượng thuê khi xác thực bằng app-id và client-secret. |
export-solution
Xuất giải pháp từ một môi trường nguồn.
| Tham số | Nội dung mô tả |
|---|---|
| environment-url | (Bắt buộc) URL cho môi trường mà bạn muốn xuất giải pháp (ví dụ: https://YourOrg.crm.dynamics.com). |
| user-name | (Bắt buộc) Nếu bạn đang sử dụng xác thực tên người dùng/mật khẩu, tên người dùng của tài khoản bạn đang sử dụng để kết nối. |
| password-secret | (Bắt buộc) Nếu bạn đang sử dụng xác thực tên người dùng/mật khẩu, mật khẩu cho tên người dùng. Mật khẩu GitHub được xác định trong Cài đặt trong Khóa bí mật. Bạn không thể truy xuất bí mật sau khi nó đã được xác định và lưu. |
| app-id | ID ứng dụng để xác thực. Tham số này là cần thiết khi xác thực bằng thông tin xác thực Chính của Dịch vụ. |
| client-secret | Bí mật ứng dụng khách được sử dụng để xác thực đường dẫn GitHub. Tham số này là cần thiết khi xác thực bằng thông tin xác thực Chính của Dịch vụ. |
| tenant-id | ID đối tượng thuê khi xác thực bằng app-id và client-secret. |
| solution-name | (Bắt buộc) Tên của giải pháp cần xuất. Luôn sử dụng tên của giải pháp, chứ không phải tên hiển thị của giải pháp. |
| solution-output-file | (Bắt buộc) Đường dẫn và tên của tệp solution.zip để xuất môi trường nguồn vào. |
| được quản lý | (Bắt buộc) Đặt thành true để xuất dưới dạng giải pháp được quản lý; mặc định (false) để xuất dưới dạng một giải pháp chưa được quản lý. |
unpack-solution
Lấy tệp giải pháp đã nén rồi giải nén thành nhiều tệp XML và các tệp khác để hệ thống kiểm soát nguồn có thể dễ dàng đọc và quản lý các tệp này.
| Tham số | Nội dung mô tả |
|---|---|
| solution-file | (Bắt buộc) Đường dẫn và tên tệp của tệp solution.zip cần giải nén. |
| solution-folder | (Bắt buộc) Đường dẫn và thư mục đích bạn muốn giải nén giải pháp vào. |
| solution-type | (Bắt buộc) Loại giải pháp bạn muốn giải nén. Các tùy chọn bao gồm: Không được quản lý (khuyên dùng), Được quản lý và Cả hai. |
pack-solution
Gói một giải pháp được thể hiện trong kiểm soát nguồn vào tệp solution.zip có thể được nhập vào môi trường khác.
| Tham số | Nội dung mô tả |
|---|---|
| solution-file | (Bắt buộc) Đường dẫn và tên tệp của tệp solution.zip để đóng gói giải pháp vào (ví dụ: out/CI/ALMLab.zip). |
| solution-folder | (Bắt buộc) Đường dẫn và thư mục nguồn của giải pháp để đóng gói. |
| solution-type | (Tùy chọn) Loại giải pháp để đóng gói. Các tùy chọn bao gồm: Không được quản lý (khuyên dùng), Được quản lý và Cả hai. |
publish-solution
Phát hành các tùy chỉnh giải pháp.
| Tham số | Mô tả |
|---|---|
| environment-url | (Bắt buộc) URL của môi trường mà bạn muốn phát hành giải pháp vào (ví dụ: https://YourOrg.crm.dynamics.com). |
| user-name | (Bắt buộc) Nếu bạn đang sử dụng xác thực tên người dùng/mật khẩu, tên người dùng của tài khoản bạn đang sử dụng để kết nối. |
| password-secret | (Bắt buộc) Nếu bạn đang sử dụng xác thực tên người dùng/mật khẩu, mật khẩu của tài khoản bạn đang sử dụng để kết nối. |
| solution-file | (Bắt buộc) Đường dẫn và tên của tệp giải pháp bạn muốn nhập. |
| app-id | ID ứng dụng để xác thực. Tham số này là cần thiết khi xác thực bằng thông tin xác thực Chính của Dịch vụ. |
| client-secret | Bí mật ứng dụng khách được sử dụng để xác thực đường dẫn GitHub. Tham số này là cần thiết khi xác thực bằng thông tin xác thực Chính của Dịch vụ. |
| tenant-id | ID đối tượng thuê khi xác thực bằng app-id và client-secret. |
clone-solution
Sao chép giải pháp cho một môi trường nhất định.
| Tham số | Mô tả |
|---|---|
| environment-url | (Bắt buộc) URL của môi trường mà bạn muốn sao chép giải pháp (ví dụ: https://YourOrg.crm.dynamics.com). |
| user-name | (Bắt buộc) Nếu bạn đang sử dụng xác thực tên người dùng/mật khẩu, tên người dùng của tài khoản bạn đang sử dụng để kết nối. |
| password-secret | (Bắt buộc) Nếu bạn đang sử dụng xác thực tên người dùng/mật khẩu, mật khẩu của tài khoản bạn đang sử dụng để kết nối. |
| solution-file | (Bắt buộc) Đường dẫn và tên của tệp giải pháp bạn muốn nhập. |
| app-id | ID ứng dụng để xác thực. Tham số này là cần thiết khi xác thực bằng thông tin xác thực Chính của Dịch vụ. |
| client-secret | Bí mật ứng dụng khách được sử dụng để xác thực đường dẫn GitHub. Tham số này là cần thiết khi xác thực bằng thông tin xác thực Chính của Dịch vụ. |
| tenant-id | ID đối tượng thuê khi xác thực bằng app-id và client-secret. |
| solution-name | (Bắt buộc) Đường dẫn và tên của tệp solution.zip cần để sao chép (ví dụ: out / CI / ALMLab.zip). |
| solution-version | Phiên bản giải pháp sẽ sao chép. |
| target-folder | Thư mục đích để đặt giải pháp đã giải nén vào. (ví dụ: Git repository\target-solution-folder). |
| Working-directory | Thư mục tạm thời cho các hiện vật đang xử lý cần thiết để sao chép giải pháp. mặc định: root of the repository |
check-solution
Kiểm tra tệp giải pháp để phát hiện sự không nhất quán.
| Tham số | Mô tả |
|---|---|
| environment-url | (Bắt buộc) URL của môi trường mà bạn muốn sao chép giải pháp (ví dụ: https://YourOrg.crm.dynamics.com). |
| user-name | (Bắt buộc) Nếu bạn đang sử dụng xác thực tên người dùng/mật khẩu, tên người dùng của tài khoản bạn đang sử dụng để kết nối. |
| password-secret | (Bắt buộc) Nếu bạn đang sử dụng xác thực tên người dùng/mật khẩu, mật khẩu của tài khoản bạn đang sử dụng để kết nối. |
| app-id | ID ứng dụng để xác thực. Tham số này là cần thiết khi xác thực bằng thông tin xác thực Chính của Dịch vụ. |
| client-secret | Bí mật ứng dụng khách được sử dụng để xác thực đường dẫn GitHub. Tham số này là cần thiết khi xác thực bằng thông tin xác thực Chính của Dịch vụ. |
| tenant-id | ID đối tượng thuê khi xác thực bằng app-id và client-secret. |
| path | (Bắt buộc) Đường dẫn và tên của tệp giải pháp bạn muốn kiểm tra. |
| địa lý | Vị trí địa lý của dịch vụ Trình kiểm tra Microsoft Power Platform sẽ sử dụng. Giá trị mặc định là 'Hoa Kỳ'. |
| rule-level-override | Đường dẫn đến tệp a chứa một mảng quy tắc JSON và các cấp của chúng. Các giá trị được chấp nhận là: Quan trọng, Cao, Thấp và Thông tin. Ví dụ: [{"Id":"meta-remove-dup-reg","OverrideLevel":"Medium"},{"Id":"il-avoid-specialized-update-ops","OverrideLevel":"Medium"}] |
| checker-logs-artifact-name | Tên của thư mục tạo tác mà Microsoft Power Platform nhật ký kiểm tra sẽ được tải lên. Giá trị mặc định là 'CheckSolutionLogs'. |
upgrade-solution
Cung cấp khả năng nâng cấp giải pháp.
| Tham số | Mô tả |
|---|---|
| environment-url | (Bắt buộc) URL của môi trường mà bạn muốn sao chép giải pháp (ví dụ: https://YourOrg.crm.dynamics.com). |
| user-name | (Bắt buộc) Nếu bạn đang sử dụng xác thực tên người dùng/mật khẩu, tên người dùng của tài khoản bạn đang sử dụng để kết nối. |
| password-secret | (Bắt buộc) Nếu bạn đang sử dụng xác thực tên người dùng/mật khẩu, mật khẩu của tài khoản bạn đang sử dụng để kết nối. |
| solution-file | (Bắt buộc) Đường dẫn và tên của tệp giải pháp bạn muốn nhập. |
| app-id | ID ứng dụng để xác thực. Tham số này là cần thiết khi xác thực bằng thông tin xác thực Chính của Dịch vụ. |
| client-secret | Bí mật ứng dụng khách được sử dụng để xác thực đường dẫn GitHub. Tham số này là cần thiết khi xác thực bằng thông tin xác thực Chính của Dịch vụ. |
| tenant-id | ID đối tượng thuê khi xác thực bằng app-id và client-secret. |
| solution-name | (Bắt buộc) Tên của Giải pháp được nâng cấp. |
| async | Nâng cấp giải pháp không đồng bộ. |
| max-async-wait-time | Thời gian chờ không đồng bộ tối đa tính bằng phút. Giá trị mặc định là 60 phút. |
Gói nhiệm vụ
Các tác vụ này thực hiện các hành động đối với các gói và bao gồm những điều sau.
deploy-package
Cung cấp khả năng triển khai một dll gói hoặc một tệp zip với một gói.
Lưu ý
Hành động này chỉ được hỗ trợ trên Windows.
| Tham số | Description |
|---|---|
| environment-url | (Bắt buộc) URL của môi trường mà bạn muốn sao chép giải pháp (ví dụ: https://YourOrg.crm.dynamics.com). |
| user-name | (Bắt buộc) Nếu bạn đang sử dụng xác thực tên người dùng/mật khẩu, tên người dùng của tài khoản bạn đang sử dụng để kết nối. |
| password-secret | (Bắt buộc) Nếu bạn đang sử dụng xác thực tên người dùng/mật khẩu, mật khẩu của tài khoản bạn đang sử dụng để kết nối. |
| app-id | ID ứng dụng để xác thực. Tham số này là cần thiết khi xác thực bằng thông tin xác thực Chính của Dịch vụ. |
| client-secret | Bí mật ứng dụng khách được sử dụng để xác thực đường dẫn GitHub. Tham số này là cần thiết khi xác thực bằng thông tin xác thực Chính của Dịch vụ. |
| tenant-id | ID đối tượng thuê khi xác thực bằng app-id và client-secret. |
| package | (Bắt buộc) Đường dẫn đến một dll gói hoặc tệp zip kèm theo gói. |
Tác vụ cổng thông tin
Các tác vụ này thực hiện những hành động sau đây đối với Power Pages.
upload-paportal
Tải dữ liệu lên Power Pages.
| Tham số | Description |
|---|---|
| environment-url | (Bắt buộc) URL của môi trường mà bạn muốn nhập giải pháp vào (ví dụ: https://YourOrg.crm.dynamics.com). |
| app-id | ID ứng dụng để xác thực. Tham số này là cần thiết khi xác thực bằng thông tin xác thực Chính của Dịch vụ. |
| client-secret | Bí mật ứng dụng khách được sử dụng để xác thực đường dẫn GitHub. Tham số này là cần thiết khi xác thực bằng thông tin xác thực Chính của Dịch vụ. |
| tenant-id | ID đối tượng thuê khi xác thực bằng app-id và client-secret. |
| upload-path | Đường dẫn đến vị trí nội dung trang web được lưu trữ (bí danh: -p). |
| deployment-profile | Tải lên dữ liệu cổng thông tin cùng chi tiết về môi trường được xác định thông qua biến cấu hình trong tệp deployment-profiles/[profile-name].deployment.yaml. |
| Phiên bản mô hình | Chỉ ra liệu dữ liệu trang web được tải lên sẽ sử dụng mô hình dữ liệu chuẩn (1) hay mô hình dữ liệu nâng cao ( ). 2 Giá trị mặc định là '1'. |
Tìm hiểu thêm về Microsoft Power Platform hỗ trợ CLI cho Power Pages.
Nhiệm vụ danh mục (bản xem trước)
Các tác vụ này thực hiện các hành động đối với danh mục trong Power Platform và bao gồm các mục sau.
Lưu ý
Hiện tại, các tác vụ trong danh mục Power Platform là bản phát hành bản xem trước .
cài đặt
Cài đặt một mục danh mục vào môi trường đích.
| Tham số | Description |
|---|---|
| id-mục-danh-mục | (Bắt buộc) Mục danh mục cần cài đặt trên môi trường mục tiêu. |
| target-url | (Bắt buộc) Url của môi trường đích để cài đặt mục danh mục vào (ví dụ: "https://YourOrg.crm.dynamics.com"). |
| thiết đặt | (Bắt buộc) Cài đặt gói thời gian chạy để thực thi khung cài đặt. Định dạng của chuỗi phải là key=value|key=value. |
| Phiên bản mục tiêu | Phiên bản mục tiêu cần cài đặt. Nếu để trống, phiên bản đã xuất bản sẽ được chọn. |
| Tình trạng thăm dò | Khảo sát để kiểm tra tình trạng yêu cầu của bạn. |
gửi
Liệt kê tất cả các mục danh mục đã xuất bản từ môi trường hiện tại (tổ chức). Dataverse
| Tham số | Description |
|---|---|
| path | (Bắt buộc) Đường dẫn đến tài liệu nộp danh mục. |
| gói-zip | Đường dẫn đến tệp zip gói. |
| Giải pháp-zip | Đường dẫn đến tệp zip giải pháp. |
| Tình trạng thăm dò | Khảo sát để kiểm tra tình trạng yêu cầu của bạn. |
trạng thái
Nhận trạng thái của yêu cầu cài đặt/gửi danh mục.
| Tham số | Description |
|---|---|
| Theo dõi-id | (Bắt buộc) Yêu cầu mã theo dõi. |
| loại | (Bắt buộc) Loại yêu cầu (Giá trị: Cài đặt, Gửi) |
Tác giả luồng công việc GitHub
Để tìm hiểu thêm về cách soạn dòng công việc GitHub bằng cách sử dụng các tác vụ GitHub, hãy hoàn thành Hành động GitHub for Microsoft Power Platform phòng thí nghiệm.
Thông tin thêm: Giới thiệu về Hành động GitHub