다음을 통해 공유

기존 사이트를 부트스트랩 버전 5로 마이그레이션

부트스트랩 버전 5는 Power Pages 사이트의 반응성을 높이고 사용자 지정을 더 쉽게 만드는 새로운 기능과 업데이트를 제공합니다.

중요

  • 사이트를 만드는 데 사용된 템플릿에 관계없이 모든 부트스트랩 버전 3 사이트를 버전 5로 마이그레이션할 수 있습니다.
  • 기존 부트스트랩 버전 3 사이트를 버전 5로 마이그레이션하는 경우 표준 데이터 모델 또는 향상된 데이터 모델을 사용할 수 있습니다.
  • 개발자 사이트를 사용하여 마이그레이션 테스트를 고려해 보세요.
  • 부트스트랩의 현재 버전을 확인하려면 웹사이트의 bootstrap.min.css웹 파일을 참조하세요.

부트스트랩 버전 3 사이트를 마이그레이션하려면 다음 단계를 따르세요.

  1. 웹 사이트 폴더 다운로드.
  2. 폴더에서 마이그레이션 도구 실행.
  3. 변경 사항 검토.
  4. 마이그레이션된 웹 사이트 레코드 업로드.
  5. 서버측 캐시 지우기.

마이그레이션 단계에서는 Microsoft Power Platform CLI를 사용해야 하므로 Power Pages에서 이를 사용하는 방법을 이해해야 합니다.

전제 조건

웹사이트 폴더 다운로드

Microsoft Power Platform CLI 버전 1.27부터 pac paportal 명령이 pac pages로 변경되었습니다. paportal이 계속 작동하지만 앞으로 powerpages를 사용하는 것이 좋습니다. 이것이 다음 지침에서 사용되는 형식입니다. Microsoft Power Platform CLI 버전 1.26.6을 사용하는 경우 pac pages 대신 pac paportal을 사용해야 합니다.

  1. 명령 프롬프트가 엽니다.

  2. Power Platform 환경에 대한 Dataverse 조직에 인증하려면 pac auth create -u [Dataverse URL] 명령을 입력하십시오.

    예:pac auth create -u https://contoso-org.crm.dynamics.com

    추가 정보: pac auth create

  3. 조직의 웹 사이트 목록을 생성하려면 pac pages list 명령을 입력하십시오.

    마이그레이션하려는 사이트의 WebSiteId를 기록해 두세요.

    추가 정보: pac pages list

  4. 다음 명령을 입력하여 pac pages download --path [PATH] -id [WebSiteId-GUID] 웹 사이트 폴더를 다운로드합니다.

    예: pac pages download --path "c:\pac-powerpages\downloads" -id d44574f9-acc3-4ccc-8d8d-85cf5b7ad141

    ID 매개 변수에 이전 단계에서 기록한 WebSiteId를 사용합니다.

    추가 정보: pac pages download

폴더에서 마이그레이션 도구 실행

다운로드한 웹 사이트 폴더에서 마이그레이션 도구를 실행하려면 pac pages bootstrap-migrate -p "WebsiteFolderPath" 명령을 입력하십시오.

예: pac pages bootstrap-migrate -p "c:\pac-powerpages\downloads\bootstrap-dev-site"

이 명령은 폴더 이름에 "V5"가 추가된 폴더를 생성합니다.

부트스트랩 버전 5로 업그레이드하는 동안 문제가 발생하거나 부트스트랩 버전 3으로 되돌리려는 경우 부트스트랩 버전 5에서 버전 3으로 되돌리는 방법을 참조하세요.

변경 사항 검토

마이그레이션하기 전에 사이트의 복사본을 만든 경우 버전 5 사이트와 비교하십시오.

  1. 이전 단계에서 생성한 V5 폴더를 엽니다.

  2. HTML 또는 CSS 파일을 엽니다.

  3. Visual Studio Code에서 Ctrl+Shift+P를 눌러 명령 프롬프트를 엽니다. bootstrap diff를 입력합니다.

  4. 버전 3 파일과 버전 5 파일이 열립니다. 강조 표시된 각 변경 사항 위로 마우스를 가져가서 검토하세요.

마이그레이션된 웹 사이트 레코드 업로드

다음 명령 pac pages upload --path [Folder-location]를 입력하여 마이그레이션된 웹 사이트 레코드를 조직에 업로드합니다.

예: pac pages upload --path C:\pac-portals\downloads\custom-portal\

추가 정보: pac pages upload

레코드를 업로드하면 마이그레이션된 사이트는 부트스트랩 버전 5 웹 사이트가 됩니다. 다시 한 번 사이트를 버전 3 사이트와 비교하고 필요에 따라 부트스트랩 버전 5 사이트를 수정하는 것이 좋습니다.

서버측 캐시 지우기

메타데이터/구성 및 데이터 테이블에 대한 서버 측 캐시를 지웁니다.

Bootstrap 버전 5에서 버전 3으로 되돌리는 방법

Bootstrap 버전 3으로 되돌리려면:

  1. 업로드 명령을 실행하여 버전 5 폴더를 부트스트랩 버전 3 폴더로 바꿉니다. pac 페이지 bootstrap-migrate에서 자세히 알아보세요.
  2. 포털 관리 앱을 열고 Site/BootstrapV5Enabled 사이트 설정을 삭제합니다. 웹 사이트의 사이트 설정 구성에서 자세히 알아보세요.
  3. 서버 측 캐시 지우기. Power Pages에서 서버 측 캐싱이 작동하는 방식에서 자세히 알아보세요.

참조 항목