자동화된 배포에 연결 참조 및 환경 변수 미래 채우기

아티클
08/09/2023

연결 참조와 환경 변수는 앱 또는 솔루션이 배포된 대상 환경과 관련된 연결 세부 정보 및 구성 설정을 대화식으로 지정할 수 있게 해줍니다.

추가 정보:

연결 참조 및 환경 변수 정보가 포함된 솔루션을 가져온 다음 UI에서 사용자 환경과 관련된 정보를 제공하라는 메시지가 표시됩니다. 그러나 완전히 자동화된 CI/CD(지속적인 통합/지속적인 전달) 시나리오에서는 이런 정보 입력이 제대로 되지 않습니다.

대상 환경과 관련된 연결 참조 및 환경 변수 정보를 미리 채워 완전히 자동화된 배포를 활성화할 수 있어서 솔루션을 가져온 다음 대화식으로 제공할 필요가 없습니다.

배포 설정 파일

배포에 대한 연결 참조 및 환경 변수 정보를 미리 채우려면 배포 설정 파일(JSON)을 사용하여 정보를 저장하고 Power Platform 빌드 도구를 사용하여 솔루션을 가져올 때 매개변수로 전달합니다. JSON 파일을 소스 제어 시스템에 저장하여 조직의 필요에 따라 업데이트하고 관리할 수 있습니다.

아래는 배포 설정 파일의 예입니다.

{
  "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"
    }
  ]
}

위의 JSON 파일 예에서 ""로 표시된 값이 누락되어 채워 넣어야 합니다. 이 문서 뒷부분에서 이에 대해 다룰 것입니다.

1단계: 배포 설정 파일 생성

배포 설정 파일은 Power Platform CLI 를 사용하여 생성할 수 있습니다. 솔루션을 내보내거나 복제하는 동안 파일을 생성할 수 있습니다.

옵션 1: create-settings 속성을 사용하여 배포 설정 파일 생성

Power Platform CLI와 함께 create-settings 속성을 사용합니다.

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

이 명령은 아래와 같은 JSON 파일을 생성합니다.

JSON 파일의 ConnectionReferences 섹션에 비어있는 값이 거의 없습니다. 이러한 값은 대상 환경에서 생성한 후 수집해야 합니다.

옵션 2: 솔루션을 복제하여 배포 설정 파일 생성

이 단계에서는 원래 솔루션을 빌드 가능한 형식으로 렌더링하기 때문에 프로젝트 솔루션 클론이 필요합니다. Power Platform CLI를 사용하여 솔루션을 복제하면 컴퓨터에 다음 디렉터리 구조가 생성됩니다.

현재 폴더의 컨텍스트에서 설정 파일을 생성하고 아래와 같이 설정 파일의 값을 채웁니다.

2단계: 연결 참조 및 환경 변수 정보 가져오기

배포 설정 파일을 채우려면 대상 솔루션의 연결 참조 및 환경 변수 정보를 가져와야 합니다.

연결 참조 정보 가져오기

대상 환경의 연결 ID를 가져오려면 다음 방법 중 하나를 사용합니다.

Power Apps에 로그인하고 원하는 환경을 선택합니다. 왼쪽 탐색 창에서데이터>연결을 선택하고, 연결 ID를 가져올 연결을 선택한 다음 URL을 확인하여 연결 ID를 가져옵니다.
연결 참조 엔터티에서 캔버스 앱을 만듭니다. 절차는 다음과 같습니다.
1. Power Apps에 로그인하고 원하는 환경을 선택합니다.
2. 왼쪽 탐색 창에서 앱을 선택한 다음 새 앱>캔버스를 선택합니다.
3. Dataverse를 데이터 원본으로 선택합니다.
4. 연결 참조 테이블을 선택한 다음 연결을 선택합니다.
5. 그러면 환경 내의 모든 연결과 해당 연결 ID를 나열하는 갤러리 애플리케이션이 생성됩니다.

환경 변수 정보 가져오기

대상 환경에서 환경 변수 값을 가져오려면 Power Apps에 로그인하고 대상 환경을 선택한 다음 줄임표를 마우스 오른쪽 버튼으로 클릭하고 편집을 선택합니다. 이렇게 하면 배포 설정 파일에 값을 채우는 데 필요한 정보가 제공됩니다(밑줄이 그어진 값이 파일에 필요한 값임).

대상 환경의 환경 변수 값

그렇지 않으면 대상 환경에 대한 지식을 기반으로 대상 환경에 적절한 값을 제공할 수 있습니다.

3단계: 배포 설정 파일의 값 업데이트

배포 설정 파일(JSON)을 수동으로 편집하여 연결 및 환경 변수 정보를 적절하게 추가합니다. 아래는 (이전에) 누락된 값이 추가된 예제 설정 파일입니다.

{
  "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"
    }
  ]
}

4단계: 빌드 도구 작업에 배포 설정 파일 사용

솔루션을 대상 환경으로 가져올 때 배치 설정 파일을 매개변수로 전달하십시오. 이렇게 하면 사용자가 값을 대화식으로 지정할 필요 없이 가져올 때 적절한 값으로 필요한 연결 참조 및 환경이 생성됩니다.

Power Platform 빌드 도구에서 솔루션 가져오기 작업을 사용할 때 배포 설정 파일 사용을 선택하고 배포 설정 파일의 경로를 제공합니다. 다음으로 파이프라인을 시작합니다.

유효성 검사

솔루션을 가져오는 동안 연결 참조의 담당자가 내부에 배치된 연결을 사용할 수 있도록 연결 참조의 유효성을 검사합니다. 연결 참조의 담당자가 연결을 소유하거나 연결이 공유되는지 확인하십시오.

참조 항목

Microsoft Power Platform CLI는 무엇인가?
Microsoft Power Platform 빌드 도구 작업

다음을 통해 공유