프로비전된 wiki와 게시된 코드를 wiki로 비교

  • 아티클

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

Azure DevOps에서 팀 프로젝트 위키 또는 코드 위키로 게시된 위키 콘텐츠를 기본 수 있습니다. 코드 위키로 게시된 경우 Azure Repos를 사용하는 경우에만 사용할 수 있지만 콘텐츠 요구 사항을 지원하기 위해 버전이 지정된 여러 위키를 기본 수 있습니다.

두 옵션 모두 Git 리포지토리에서 Wiki 콘텐츠를 유지 관리하지만 Wiki 콘텐츠를 추가, 업데이트 및 관리하는 방법은 다릅니다.

참고 항목

위키 기능으로 게시 코드는 현재 Azure DevOps Server 2018 이상 버전에서 사용할 수 있습니다. 이전 버전의 경우 팀 프로젝트에 대한 wiki만 프로비전할 수 있습니다.

Wiki 페이지 메뉴 옵션

프로비전된 위키를 사용하여 위키 내에서 직접 페이지를 추가하고 편집할 수 있습니다. 프로비전된 위키에 대한 모든 콘텐츠 업데이트는 위키 내에서 발생합니다.

게시 코드를 wiki로 사용하면 리포지토리 또는 코드에서 콘텐츠를 추가, 편집 및 업데이트할 수 있습니다.

다음 이미지는 프로비전된 Wiki에 대한 옵션을 보여 있습니다. 이러한 옵션 중 일부는 코드 위키 페이지로 게시할 수 없습니다.

프로비전된 위키 페이지 메뉴 옵션의 스크린샷.

예를 들어 게시 코드에 대한 리포지토리에서 편집 옵션은 리포지토리 페이지로 이동하여 해당 특정 페이지를 편집합니다. 위키에 대해 선택한 분기의 페이지에 업데이트 자동으로 wiki에 게시됩니다.

지원되는 기능 및 운영 차이점

두 가지 유형의 Wiki 모두 다음 기능을 지원합니다.

다음 표에는 위키 유형에 따라 다를 수 있는 작업 또는 기능이 요약되어 있습니다.

연산 프로비전된 wiki 코드를 wiki로 게시
여러 위키 지원, 위키 이름 지정 ✔️
Repos>파일 또는 코드>파일에서 페이지 추가 또는 편집 ✔️
Wiki에서 이전 수정 버전으로 되돌리기 ✔️
리포지토리 또는 코드에서 이전 수정 버전으로 되돌리기 ✔️ ✔️
버전이 지정된 Wiki 유지 관리 ✔️
위키 버전 선택 ✔️
코드 위키 게시 취소 ✔️

페이지 추가

두 가지 유형의 wiki 모두에 대해 새 페이지 또는 하위 페이지 추가를 선택합니다. 자세한 내용은 위키 페이지 추가 및 편집을 참조 하세요.

탐색 창의 페이지 시퀀스 및 페이지 목록

프로비전된 Wiki는 탐색 창 내에서 페이지를 추가하거나 이동할 때 페이지 시퀀스와 페이지 목록을 자동으로 관리합니다.

게시 코드에 대한 탐색 창의 페이지 목록을 wiki로 구성하려면 루트 및 하위 페이지가 포함된 각 하위 폴더 또는 부모 페이지에 대해 .order 파일을 정의합니다.

두 유형의 위키 모두 동일한 파일 구조를 따르며, 위키로 게시 코드를 사용하려면 페이지 시퀀스를 수동으로 기본 합니다.

.order 파일 작업에 대한 자세한 내용은 Wiki Git 리포지토리 파일 및 파일 구조를 참조하세요.

이전 버전에 대한 페이지 수정 및 되돌리기

위키에서 위키 페이지의 수정 내용을 볼 수 있습니다. 수정 버전 또는 수정 버전 보기 메뉴 옵션을 선택합니다.

그러나 되돌리기 프로세스는 위키 페이지 유형에 따라 다릅니다.

  • 프로비전된 위키 페이지의 경우 프로비전된 위키 페이지로 커밋 되돌리기에서 설명한 대로 되돌리기를 선택합니다.
  • 코드로 게시 위키 페이지의 경우 로컬 분기에서 작업하고 끌어오기 요청을 제출하여 작업 중인 분기를 업데이트합니다.

Wiki 버전 관리 및 게시 취소

버전 관리를 사용하면 Git 리포지토리의 버전이 지정된 분기에 따라 서로 다른 콘텐츠 버전을 고유한 Wiki에 게시할 수 있습니다. 위키의 버전 관리 및 게시 취소는 위키에 코드를 게시하여 만든 위키에 대해서만 지원됩니다. 자세한 내용은 코드 wiki 게시/코드 위키 게시 취소를 참조하세요.

프로젝트 위키 삭제

참고 항목

Wiki REST API는 프로젝트 위키 삭제를 지원하지 않습니다. 따라서 위키 리포지토리를 대신 삭제해야 합니다.

  1. 위키 리포지토리를 복제하여 모든 콘텐츠를 백업합니다. 기타 옵션에는 위키를 복제하는 데 사용할 수 있는 복제 위키 URL이 있습니다.

  2. 위키를 백업하는 git 리포지토리 ID를 가져옵니다. REST API를 사용하여 프로젝트의 모든 위키를 가져올 수 있습니다.

    예를 들어 GET https://fabrikam.visualstudio.com/sampleProject/_apis/wiki/wikis?api-version=4.1 프로젝트의 모든 Wiki를 반환하므로 삭제할 위키를 선택할 수 있습니다.

  3. REST API를 사용하여 지원 Git 리포지토리를 삭제합니다. 이전 단계에서 찾은 프로젝트 wiki의 리포지토리 ID를 사용하고 리포지토리 ID를 두 번 검사 잘못된 리포지토리 ID를 제거하지 않습니다.

    예를 들어 DELETE https://fabrikam.visualstudio.com/sampleProject /_apis/git/repositories/{repositoryId}?api-version=4.1

오프라인으로 위키 업데이트

오프라인 또는 로컬 분기에서 작업하여 프로비전된 wiki의 콘텐츠를 업데이트하고 코드 위키로 게시할 수 있습니다. 자세한 내용은 오프라인으로 위키 페이지 복제 및 업데이트를 참조하세요.