Power Pages에 대한 Microsoft Power Platform CLI 지원

아티클
09/27/2023

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를 사용하여 웹 사이트 구성을 소스 제어에 체크인하고 웹 사이트 구성을 모든 환경으로 이동할 수 있습니다.

노트

이 기능은 Power Platform CLI 버전 1.9.8부터 정식 출시되었습니다. 최신 버전 설치에 대한 자세한 내용은 Microsoft Power Platform CLI 설치를 참고하세요.
Power Platform CLI 버전 1.27부터 pac paportal 명령이 pac powerpages로 변경되었습니다. paportal은 계속 작동하지만 앞으로는 powerpages를 사용하는 것이 좋습니다. 이 문서는 곧 paportal 대신 powerpages를 사용하도록 업데이트될 예정입니다.

웹 사이트 개발에 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에 대한 포털 지원은 아래 나열된 표로 제한됩니다.

adx_ad

adx_adplacement

adx_blogpost

adx_botconsumer

adx_communityforum

adx_communityforumaccesspermission

adx_contentsnippet

adx_entityform

adx_entityformmetadata

adx_entitylist

adx_entitypermission

adx_forumthreadtype

adx_pagetemplate

adx_poll

adx_polloption

adx_pollplacement

adx_portallanguage

adx_publishingstate

adx_redirect

adx_shortcut

adx_sitemarker

adx_sitesetting

adx_tag

adx_urlhistory

adx_webfile

adx_webform

adx_webformmetadata

adx_webformstep

adx_weblink

adx_weblinkset

adx_webpage

adx_webpageaccesscontrolrule

adx_webrole

adx_website

adx_websiteaccess

adx_websitebinding(다운로드 전용)

adx_websitelanguage

adx_webtemplate

주석

중요

Microsoft Power Platform CLI를 사용한 사용자 지정에 대해 사용자 지정 테이블 및 포털 템플릿별 테이블(예: 블로그, 커뮤니티 또는 아이디어 포털)이 지원되지 않습니다.
광고(adx_ad) 레코드에 대한 이미지 파일 첨부는 Power Platform CLI를 사용하여 다운로드되지 않습니다. 이 문제를 해결하려면 이미지 URL 필드를 사용하거나 복사 필드의 HTML 참조를 이미지 파일이 포함된 웹 파일 레코드에 추가하세요.

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

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

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

Microsoft Power Platform CLI에서 paportal 명령을 확인합니다.

포털에 대한 Microsoft Power Platform CLI 명령

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

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

매개 변수

속성 이름	설명	예
목록	현재 Dataverse 환경의 모든 포털 웹 사이트 나열 미리 보기 -v 매개 변수를 추가하여 사이트가 표준 또는 고급 데이터 모델을 사용하는지 여부를 나타낼 수 있습니다	`pac paportal list`
다운로드	현재 Dataverse 환경에서 포털 웹 사이트 콘텐츠 다운로드 다음 매개 변수가 있습니다. - path: 웹 사이트 콘텐츠를 다운로드할 경로(별칭: -p) - webSiteId: 다운로드할 포털 웹 사이트 ID(별칭: -id) - overwrite: (선택 사항) true - 기존 콘텐츠를 덮어씁니다. false - 폴더에 이미 웹 사이트 콘텐츠가 있는 경우 실패합니다(별칭: -o) 미리 보기 - modelVersion: `1` 또는 `2`는 다운로드할 사이트 데이터가 표준(1) 또는 향상된 데이터 모델을 사용할지 여부를 나타냅니다.	`pac paportal download --path "C:\portals" --webSiteId f88b70cc-580b-4f1a-87c3-41debefeb902`
업로드	현재 Dataverse 환경에 포털 웹 사이트 콘텐츠를 업로드합니다. 다음 매개 변수가 있습니다. - path: 웹 사이트 콘텐츠가 저장된 경로(alias: -p) -deploymentProfile: deployment-profiles/[profile-name].deployment.yaml 파일의 프로필 변수를 통해 정의된 환경 세부 정보로 포털 데이터 업로드 미리 보기 - modelVersion: `1` 또는 `2`는 업로드할 사이트 데이터가 표준(1) 또는 향상된 데이터 모델을 사용할지 여부를 나타냅니다.	`pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile "profile-name"`

배포 프로필 사용

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

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

pac paportal upload --path "C:\portals\starter-portal" --deploymentProfile test

이 파일에는 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

노트

포털 외에 CLI에서 사용되는 모든 명령에 대해 알아 보려면 Microsoft Power Platform CLI의 공통 명령으로 이동하십시오.

매니페스트 파일

pac paportal download CLI 명령을 사용하여 웹사이트 콘텐츠를 다운로드하고 사이트 콘텐츠를 다운로드하면 두 개의 매니페스트 파일도 생성됩니다.

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

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

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

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

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

환경 매니페스트 파일은 우발적인 변경을 방지하기 위해 동일한 환경(환경 URL이 파일 이름과 일치)에 연결할 때 읽기 전용이 됩니다.

노트

환경 매니페스트 파일은 웹 사이트를 다른 환경에 배포할 때 변경 사항을 추적하도록 설계되지 않았습니다.
환경 매니페스트 파일은 개발자가 개발자 환경에서 로컬로 배포하는 데 사용하도록 설계되었으며 Git 무시 목록에 추가해야 합니다.

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

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

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

노트

PAC CLI를 사용하여 한 환경에서 사이트 콘텐츠 기록을 삭제하고 다른 환경에서도 동일한 콘텐츠 기록을 삭제하려면 웹사이트 기록 콘텐츠를 삭제하기 전과 후에 pac paportal download 명령을 실행해야 합니다. manifest.yml은 이러한 변경 사항을 추적하고 pac paportal 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 사용