Điền trước các tham chiếu kết nối và các biến môi trường để triển khai tự động

Bài viết
08/04/2023

Tham chiếu kết nối và biến môi trường cho phép bạn chỉ định tương tác các chi tiết kết nối và cài đặt cấu hình cụ thể cho môi trường mục tiêu nơi ứng dụng hoặc giải pháp của bạn được triển khai.

Thông tin khác:

Sau khi nhập giải pháp chứa thông tin tham chiếu kết nối và biến môi trường, bạn sẽ được nhắc cung cấp thông tin cụ thể cho môi trường của bạn trong giao diện người dùng. Tuy nhiên, việc nhập thông tin này không hiệu quả đối với các tình huống Tích hợp liên tục/Phân phối liên tục (CI/CD) hoàn toàn tự động.

Để kích hoạt triển khai hoàn toàn tự động, bây giờ bạn có thể điền trước thông tin tham chiếu kết nối và biến môi trường cụ thể cho môi trường đích để bạn không phải cung cấp tương tác sau khi nhập giải pháp.

Tệp thiết đặt triển khai

Để điền trước thông tin tham chiếu kết nối và biến môi trường cho việc triển khai của bạn, hãy sử dụng tệp cài đặt triển khai (JSON) để lưu trữ thông tin và chuyển nó dưới dạng tham số khi nhập giải pháp bằng Power Platform Build Tools. Bạn có thể lưu trữ tệp JSON trong hệ thống kiểm soát nguồn của mình để cập nhật và quản lý theo yêu cầu cho tổ chức của bạn.

Dưới đây là ví dụ về tệp cài đặt triển khai:

{
  "EnvironmentVariables": [
    {
      "SchemaName": "tst_Deployment_env",
      "Value": ""
    },
    {
      "SchemaName": "tst_EnvironmentType",
      "Value": ""
    }
  ],
  "ConnectionReferences": [
    {
      "LogicalName": "tst_sharedtst5fcreateuserandjob5ffeb85c4c63870282_b4cc7",
      "ConnectionId": "",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_tst-5fcreateuserandjob-5ff805fab2693f57dc"
    },
    {
      "LogicalName": "tst_SharepointSiteURL",
      "ConnectionId": "",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline"
    },
    {
      "LogicalName": "tst_AzureDevopsConnRef",
      "ConnectionId": "",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_visualstudioteamservices"
    },
    {
      "LogicalName": "tst_GHConn",
      "ConnectionId": "",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_github"
    }
  ]
}

Trong tệp JSON mẫu ở trên, các giá trị được hiển thị là "" bị thiếu và sẽ cần được điền. Chúng tôi sẽ giải quyết việc đó ở phần sau của bài viết này.

Bước 1: Tạo tệp cài đặt triển khai

Tệp cài đặt triển khai có thể được tạo bằng cách sử dụng Power Platform CLI. Bạn có thể tạo tệp trong khi xuất hoặc sao chép giải pháp.

Tùy chọn 1: Tạo tệp cài đặt triển khai bằng thuộc tính tạo cài đặt

Sử dụng thuộc tính create-settings với Power Platform CLI:

C:\> pac solution create-settings --solution-zip <solution_zip_file_path> --settings-file <settings_file_name>

Lệnh này sẽ tạo một tệp JSON như hình dưới đây.

Trong tệp JSON, một số giá trị trống trong phần ConnectionReferences. Bạn cần thu thập các giá trị này sau khi tạo trong môi trường đích.

Tùy chọn 2: Tạo tệp cài đặt triển khai bằng cách sao chép giải pháp

Một bản sao giải pháp dự án là cần thiết cho bước này vì nó hiển thị giải pháp ban đầu thành một định dạng có thể xây dựng. Sau khi bạn đã nhân bản một giải pháp bằng cách sử dụng Power Platform CLI, bạn nhận được cấu trúc thư mục sau được tạo trên máy tính của bạn:

Tiến hành tạo tệp cài đặt trong ngữ cảnh của thư mục hiện tại và điền giá trị của tệp cài đặt như hình dưới đây.

Bước 2: Nhận tham chiếu kết nối và thông tin biến môi trường

Để điền tệp cài đặt triển khai, bạn sẽ cần lấy tham chiếu kết nối và thông tin biến môi trường của giải pháp đích.

Nhận thông tin tham chiếu kết nối

Để lấy ID kết nối của môi trường đích, hãy sử dụng một trong các cách sau:

Đăng nhập vào Power Apps và chọn môi trường đích của bạn. Trong ngăn điều hướng bên trái, hãy chọn Dữ liệu>Kết nối, chọn kết nối bạn muốn lấy ID kết nối rồi xem URL để lấy ID kết nối.
Tạo ứng dụng canvas trên thực thể tham chiếu kết nối. Các bước như sau:
1. Đăng nhập vào Power Apps và chọn môi trường đích của bạn.
2. Trên ngăn điều hướng bên trái, hãy chọn Ứng dụng, sau đó chọn Ứng dụng mới>Canvas.
3. Chọn Dataverse làm nguồn dữ liệu của bạn.
4. Chọn bảng Tham chiếu kết nối và chọn Kết nối.
5. Thao tác này sẽ tạo ra một ứng dụng thư viện sẽ liệt kê tất cả các kết nối và ID kết nối của chúng trong môi trường.

Nhận thông tin về biến môi trường

Để nhận các giá trị của biến môi trường trong môi trường đích, hãy đăng nhập vàoPower Apps, chọn môi trường đích và bấm chuột phải vào dấu chấm lửng và chọn chỉnh sửa. Điều này sẽ cung cấp thông tin cần thiết để điền tệp cài đặt triển khai (các giá trị được gạch chân là các giá trị cần thiết cho tệp):

Giá trị của các biến môi trường trong môi trường mục tiêu

Nếu không, bạn có thể cung cấp giá trị thích hợp cho môi trường đích dựa trên kiến thức của bạn về môi trường đích.

Bước 3: Cập nhật các giá trị trong tệp cài đặt triển khai

Chỉnh sửa thủ công tệp cài đặt triển khai (JSON) để thêm thông tin biến môi trường và kết nối một cách thích hợp. Dưới đây là một tệp cài đặt mẫu với các giá trị bị thiếu (trước đây) được thêm vào.

{
  "EnvironmentVariables": [
    {
      "SchemaName": "tst_Deployment_env",
      "Value": "Test"
    },
    {
      "SchemaName": "tst_EnvironmentType",
      "Value": "UAT"
    }
  ],
  "ConnectionReferences": [
    {
      "LogicalName": "tst_sharedtst5fcreateuserandjob5ffeb85c4c63870282_b4cc7",
      "ConnectionId": "4445162937b84457a3465d2f0c2cab7e",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_tst-5fcreateuserandjob-5ff805fab2693f57dc"
    },
    {
      "LogicalName": "tst_SharepointSiteURL",
      "ConnectionId": "ef3d1cbb2c3b4e7987e02486584689d3",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_sharepointonline"
    },
    {
      "LogicalName": "tst_AzureDevopsConnRef",
      "ConnectionId": "74e578ccc24846729f32fcee83b630de",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_visualstudioteamservices"
    },
    {
      "LogicalName": "tst_GHConn",
      "ConnectionId": "d8beb0fb533442c6aee5c18ae164f13d",
      "ConnectorId": "/providers/Microsoft.PowerApps/apis/shared_github"
    }
  ]
}

Bước 4: Sử dụng tệp cài đặt triển khai cho các tác vụ Build Tools

Chuyển tệp cài đặt triển khai làm tham số khi nhập giải pháp vào môi trường đích. Điều này sẽ tạo tham chiếu kết nối bắt buộc và các môi trường với các giá trị thích hợp khi nhập mà không cần người dùng chỉ định giá trị một cách tương tác.

Khi sử dụng Nhập tác vụ Giải pháp trong Power Platform Build Tools, chọn Sử dụng tệp cài đặt triển khai và cung cấp đường dẫn đến tệp cài đặt triển khai. Tiếp theo, khởi tạo quy trình bán hàng.

Xác thực

Trong quá trình nhập giải pháp, các tham chiếu kết nối sẽ được xác thực để đảm bảo rằng các kết nối được đặt bên trong chúng có thể được chủ sở hữu của tham chiếu kết nối sử dụng. Đảm bảo rằng các kết nối thuộc sở hữu của chủ sở hữu tham chiếu kết nối hoặc các kết nối được chia sẻ. ...

Xem thêm

CLI là gì? Microsoft Power Platform
Microsoft Power Platform Xây dựng các nhiệm vụ Công cụ

Chia sẻ qua