위키 확장에서 팀 프로젝트 wiki로 페이지 마이그레이션

  • 아티클

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Wiki Marketplace 확장을 사용하여 만든 페이지를 팀 프로젝트 wiki로 마이그레이션하는 방법을 알아봅니다. 기본 제공 wiki가 릴리스되면 Wiki Marketplace 확장을 사용하여 만든 모든 위키 페이지를 팀 프로젝트의 Git 리포지토리에 저장할 수 있습니다.

필수 조건

위키 페이지를 팀 프로젝트 위키로 마이그레이션하려면 팀 프로젝트의 기여자 그룹의 구성원이어야 합니다.

페이지 및 기타 아티팩트 마이그레이션

  1. vsts-wikiTools 리포지토리를 복제하고 MigrateToVSTSWiki 도구를 컴파일합니다.
  2. Azure DevOps Wiki를 만든 다음 복제합니다.
  3. 모든 Markdown 페이지를 Azure DevOps Wiki로 이동하고 커밋합니다.
  4. wiki 마이그레이션 도구 실행, MigrateToVSTSWiki.exe
  5. 위키 마이그레이션 도구가 완료되면 Azure DevOps wiki 리포지토리의 기본 기본 분기wikiMain로 변경 내용을 푸시합니다.

자세한 단계

  1. vsts-wikiTools 리포지토리를 복제하고 MigrateToVSTSWiki 도구를 컴파일합니다.

  2. 마이그레이션 도구 EXE를 생성하기 위해 경로 Tools/MigrateToVSTSWiki 아래에 프로젝트를 컴파일합니다.

  3. 웹 브라우저에서 Azure DevOps 팀 프로젝트를 열고 첫 번째 위키 페이지를 만듭니다.

  4. URL을 가져와서 위키를 복제합니다. 위키 복제를 참조 하고 오프라인으로 위키 페이지를 편집합니다.
    이 절차와 같이 LocationA 이 복제 위치의 이름을 지정합니다.

  5. IDE 또는 git clone 명령을 사용하여 위키 리포지토리를 복제 합니다.

  6. 위키 확장 리포지토리를 복제합니다. 위키는 위키를 만드는 동안 사용자에게 제공된 폴더에 매핑됩니다. 다음 예제와 같이 기존 wiki의 wiki 관리 옵션으로 이동하여 확인할 수 있습니다. 기존 위키 페이지는 레이블이 지정된 폴더 아래에 저장됩니다 Root.

    예를 들어 이전에 멘션 위치에 복제했습니다sampleWiki.C:\wiki\sampleWiki*. The wiki pages are saved in the path *C:\wiki\sampleWiki\ _extensionWiki

    이 절차의 이름을 이 위치로 지정 LocationB 합니다.

  7. 로컬 컴퓨터의 경로에 빈 폴더를 만들고 이 절차의 LocationC 이름을 지정합니다.

    요약하면 다음과 같은 위치가 표시됩니다.

    • Location A = Azure DevOps Wiki 리포지토리
    • 위치 B = Wiki 확장 리포지토리
    • 위치 C = 마이그레이션 도구를 실행할 빈 폴더

  8. 관리자 권한으로 명령 프롬프트를 열고 실행 MigrateToVSTSWiki.exe합니다. 이 도구는 기존 wiki의 파일을 제공한 대상 디렉터리로 복사합니다. 복사하는 동안 도구는 페이지를 Azure DevOps wiki와 호환되도록 변환합니다.

    MigrateToVSTSWiki.exe /source:LocationB /destination:LocationC

    예시:

    • E:\wiki\sampleWiki\_extensionWiki 은 기존 wiki 파일이 있는 폴더입니다.
    • E:\Temp\Wiki\New 는 마이그레이션된 파일을 복사할 빈 폴더입니다.

  9. Git 관련 파일 LocationA (예: .gitignore등)을 제외한 모든 파일을 제거합니다(있는 경우).

  10. 에서 모든 파일을 LocationC 복사하여 붙여넣습니다 LocationA.

  11. 실행 git add . 하여 새로 추가된 모든 파일을 커밋에 LocationA 대해 스테이징합니다.

  12. 실행 git commit -m <commit message> 하여 로컬로 준비된 파일을 커밋합니다.

  13. 실행 git push origin wikiMain -f 하여 변경 내용을 Azure DevOps wiki의 기본 분기 푸시합니다.

위키 확장 파일을 Azure DevOps Wiki로 마이그레이션하면 Wiki 확장을 제거할 준비가 된 것입니다.

참여

이 프로젝트는 Microsoft 오픈 소스 행동 강령을 채택 했습니다. 자세한 내용은 행동 강령 FAQ를 참조하거나 질문이나 의견을 문의 opencode@microsoft.com 하세요.