Power Pages에 대한 Microsoft Power Platform CLI 지원

Microsoft Power Platform CLI(명령줄 인터페이스)는 개발자와 앱 제작자가 코드 구성 요소를 만들 수 있도록 하는 간단한 단일 중지 개발자 명령줄 인터페이스입니다.

Microsoft Power Platform CLI 도구는 엔터프라이즈 개발자와 ISV가 확장 및 사용자 지정을 빠르고 효율적으로 생성, 빌드, 디버그 및 게시할 수 있는 포괄적인 응용 프로그램 수명 주기 관리(ALM) 스토리를 향한 첫 번째 단계입니다. 자세한 내용은 Microsoft Power Platform CLI란 무엇입니까?를 참조하십시오.

이 기능을 통해 Microsoft Power Platform CLI는 Power Pages 사이트 구성의 CI/CD(지속적인 통합/지속적인 배포)를 활성화합니다. 이제 Microsoft Power Platform CLI를 사용하여 웹 사이트 구성을 소스 제어에 체크인하고 웹 사이트 구성을 모든 환경으로 이동할 수 있습니다.

웹 사이트 개발에 Microsoft Power Platform CLI를 사용하는 이유는 무엇입니까?

Microsoft Power Platform CLI를 사용하면 이제 웹 사이트 콘텐츠를 변경하여 웹 사이트 사용자 지정에 오프라인과 같은 기능을 사용할 수 있습니다. 그리고 모든 사용자 지정 또는 변경 사항이 저장되면 웹 사이트 구성을 Microsoft Dataverse에 다시 업로드할 수 있습니다. Microsoft Power Platform CLI를 사용하여 웹 사이트 콘텐츠를 다운로드하면 콘텐츠가 YAML 및 HTML 형식으로 구조화되어 쉽게 사용자 지정할 수 있으므로 프로 개발 경험이 가능합니다.

다음은 Microsoft Power Platform CLI 지원으로 포털에서 이점을 얻을 수 있는 기능 목록입니다.

사용이 용이함

• 로컬 파일 시스템과의 웹 사이트 구성 데이터 다운로드/업로드 지원

• 기존 Microsoft Power Platform CLI 도구에서 빌드.

응용 프로그램 수명 주기 관리(ALM)

• 조직 내 웹 사이트 구성 변경 사항 추적

• 조직 또는 테넌트 간 구성 파일 이동

전문가 개발 및 기업 지원

• "git" 같은 모든 원본 제어 도구와 원활한 통합

• CI/CD 파이프라인을 쉽게 설정

Microsoft Power Platform CLI 설치

단계별 지침은 Microsoft Power Platform CLI 설치를 참조하십시오.

지원되는 테이블

Microsoft Power Platform CLI에 대한 포털 지원은 다음 표로 제한됩니다.

포털용 Microsoft Power Platform CLI 설치 및 확인

Microsoft Power Platform CLI 설치에 대해 알아보려면 Microsoft Power Platform CLI 설치로 이동합니다.

Microsoft Power Platform CLI를 설치한 후 명령 프롬프트를 열고 pac를 실행하여 출력에 Power Apps 포털에 대한 명령인 "paportal"이 포함되어 있는지 확인합니다.

포털에 대한 Microsoft Power Platform CLI 명령

포털에 대한 Microsoft Power Platform CLI 명령은 "paportal"입니다.

다음 섹션에서는 "paportal" 명령의 다양한 속성에 대해 자세히 설명합니다.

매개 변수

배포 프로필 사용

deploymentProfile 스위치를 사용하면 환경에 대한 변수 집합을 YAML 형식으로 정의할 수 있습니다. 예를 들어 프로필에 다른 스키마 세부 정보가 정의된 다른 배포 프로필(예: dev, test, prod)이 있을 수 있습니다.

테스트 프로필을 생성하는 경우 deployment-profiles 아래에 "test.deployment.yml"이라는 이름의 파일을 생성할 수 있습니다(즉, <profileTag>.deployment.yml). 그리고 태그(<profileTag>)와 함께 명령을 실행하여 다음 프로필을 사용할 수 있습니다.

pac pages upload --path "C:\portals\starter-portal" --deploymentProfile test --modelVersion 2

이 파일에는 deploymentProfile 매개 변수를 사용하여 포털 구성을 업로드하는 동안 재정의하려는 테이블 ID, 속성 목록 및 값이 포함된 테이블(엔터티) 이름을 가질 수 있습니다.

또한 OS 변수를 사용하여 운영 체제의 환경 변수에 액세스할 수 있습니다.

다음은 고유한 스키마 세부 정보가 있는 "test.deployment.yml" 프로필 YAML 파일의 예입니다.

adx_sitesetting:
    - adx_sitesettingid: 4ad86900-b5d7-43ac-1234-482529724970
      adx_value: ${OS.FacebookAppId} 
      adx_name: Authentication/OpenAuth/Facebook/AppId
    - adx_sitesettingid: 5ad86900-b5d7-43ac-8359-482529724979
      adx_value: contoso_sample
      adx_name: Authentication/OpenAuth/Facebook/Secret
adx_contentsnippet:
    - adx_contentsnippetid: b0a1bc03-0df1-4688-86e8-c67b34476510
      adx_name: PowerBI/contoso/sales
      adx_value:  https://powerbi.com/group/contoso/sales

매니페스트 파일

pac pages download CLI 명령을 사용하여 웹 사이트 콘텐츠를 다운로드할 때, 사이트 콘텐츠를 다운로드함과 동시에 두 개의 매니페스트 파일도 생성됩니다.

• 환경 매니페스트 파일(org-url-manifest.yml)
• 추적 매니페스트 파일(manifest.yml) 삭제

환경 매니페스트 파일(org-url-manifest.yml)

환경 매니페스트 파일은 pac pages 다운로드 명령이 실행될 때마다 생성됩니다.

다운로드할 때마다 PAC CLI 도구는 기존 환경 매니페스트 파일을 읽고 환경에서 삭제된 항목을 업데이트하거나 환경 매니페스트 파일이 없는 경우 생성합니다.

pac pages 업로드 명령을 실행하면 포털 웹 사이트 콘텐츠를 업로드합니다. 환경 매니페스트 파일을 읽고 마지막 다운로드 이후 변경 사항을 식별하고 업데이트된 콘텐츠만 업로드합니다. 이렇게 하면 모든 업로드 명령에서 모든 콘텐츠를 업로드하는 대신 업데이트된 웹사이트 콘텐츠만 업로드되므로 업로드 프로세스를 최적화하는 데 도움이 됩니다.

환경 매니페스트 파일은 실수로 변경되는 것을 방지하기 위해 동일한 환경(환경 URL이 파일 이름과 일치)에 연결할 때 읽기 전용입니다.

추적 매니페스트 파일(manifest.yml) 삭제

이 파일은 환경에서 삭제된 레코드를 추적하는 데 사용됩니다.

pac pages 다운로드 명령을 사용하여 웹 사이트 콘텐츠를 다운로드하면 환경 매니페스트 파일(org-url-manifest.yml)에서 삭제된 레코드가 manifest.yml 파일에 추가됩니다. 따라서 pac pages upload 명령을 사용하여 웹 사이트 콘텐츠를 업로드하면 환경에서 파일을 삭제합니다(다른 환경으로도). 이 파일은 삭제되지 않으며 연결 환경에 관계없이 사용됩니다. 대상 환경에서 항목 삭제를 고려하려면 변경 사항을 소스 제어에 푸시할 때 이 파일을 고려해야 합니다.

Visual Studio Code 확장 사용

또한 VS Code 확장 Power Platform VS Code 확장을 사용하여 IntelliSense, 코드 완성 지원, 힌트 제공 및 VS Code 통합 터미널을 사용하여 Microsoft Power Platform CLI와 상호 작용하는 내장 Liquid 언어를 활용할 수 있습니다. 추가 정보: Visual Studio Code 확장 사용(프리뷰)

추가 고려 사항

• 파일 경로가 최대 경로 길이 제한을 초과하면 오류가 보고됩니다. 추가 정보: Windows의 최대 경로 길이 제한
• 중복된 웹 페이지 이름과 같은 중복 레코드의 경우 Microsoft Power Platform CLI는 웹 페이지 이름이 있는 두 개의 다른 폴더 를 생성하고 다른 하나는 해시 코드가 접두사로 붙은 동일한 이름을 사용합니다. 예: "마이 페이지" 및 "마이 페이지-해시 코드".

다음 단계

자습서: 포털이 있는 Microsoft Power Platform CLI 사용

참조

• Microsoft Power Platform CLI
• Visual Studio Code 확장 사용(프리뷰)