프로젝트에 대한 Wiki 만들기

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

이 문서에서는 위키를 열고 위키에 대한 Git 리포지토리를 만드는 방법을 알아봅니다. 모든 팀 프로젝트에는 위키가 있습니다. 위키를 사용하여 팀과 정보를 공유하여 프로젝트를 이해하고 기여합니다.

각 팀 프로젝트 wiki는 백 엔드의 Git 리포지토리에 의해 구동됩니다. 팀 프로젝트를 만들 때 Wiki Git 리포지토리는 기본적으로 만들어지지 않습니다. Git 리포지토리를 만들어 위키 Markdown 파일을 저장하거나 Git 리포지 토리의 기존 Markdown 파일을 wiki에 게시합니다.

필수 조건

• 팀 프로젝트가 있어야 합니다. 아직 팀 프로젝트가 없는 경우 Azure DevOps에서 만듭니다.
• 위키를 만들고 수정하려면 최소한 기본 액세스 권한이 있어야 합니다.
• 코드를 wiki로 게시하려면 리포지토리 만들기 권한이 있어야 합니다. 기본적으로 이 권한은 프로젝트 관리자 그룹의 멤버에게 설정됩니다.
• 기여자 보안 그룹의 멤버인 누구나 Wiki 페이지를 추가하거나 편집할 수 있습니다. 관련자를 포함하여 팀 프로젝트에 액세스할 수 있는 모든 사용자는 위키를 볼 수 있습니다.

Wiki 열기

프로젝트의 위키 페이지를 열고 볼 수 있습니다.

브라우저

지원되는 웹 브라우저를 사용하여 프로젝트에 연결하고 Wiki를 선택합니다.

팀 프로젝트를 전환해야 하는 경우 Azure DevOps를 선택하여 모든 팀 프로젝트 및 팀을 찾아봅니다.

Azure DevOps CLI

명령을 사용하여 az devops wiki show 프로젝트에 대해 정의된 위키 페이지를 보고 열 수 있습니다. 시작하려면 Azure DevOps CLI 시작을 참조하세요.

az devops wiki show --wiki
                      [--open]
                      [--project]
                      [--subscription]

매개 변수

• --wiki: 필수입니다. 위키의 이름 또는 ID입니다.
• --open: 선택 사항입니다. 웹 브라우저에서 위키 페이지를 엽니다.
• --project -p: 선택 사항입니다. 프로젝트의 이름 또는 ID입니다.
• --subscription: 선택 사항입니다. 구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID를 사용하여 기본 위치를 구성할 수 있습니다.

예시

'myprojectwiki'라는 위키를 엽니다.

az devops wiki show --wiki myprojectwiki --open

위키 페이지 보기

Azure DevOps CLI를 통해 페이지의 콘텐츠를 얻으려면 명령을 입력합니다 az devops wiki show .

az devops wiki page show --path
                         --wiki
                         [--include-content]
                         [--open]
                         [--project]
                         [--subscription]
                         [--version]

매개 변수

• --path: 필수입니다. 위키 페이지의 경로입니다.
• --wiki: 필수입니다. 위키의 이름 또는 ID입니다.
• --include-content: 선택 사항입니다. 페이지의 콘텐츠를 포함합니다.
• --open: 선택 사항입니다. 웹 브라우저에서 위키 페이지를 엽니다.
• --project -p: 선택 사항입니다. 프로젝트의 이름 또는 ID입니다.
• --version -v: 선택 사항입니다. 위키 페이지의 버전(ETag)입니다.

예시

'myprojectwiki'라는 위키에서 경로가 'my wiki'인 위키 페이지 콘텐츠를 가져옵니다.

az devops wiki page show --path 'my wiki' --wiki 'myprojectwiki' --content "Hello World"

wiki Git 리포지토리 만들기

브라우저

모든 위키 페이지 및 관련 아티팩트를 저장하는 새 Git 리포지토리를 만듭니다. 위키 방문 페이지에서 프로젝트 위키 만들기를 선택합니다. 소스 제어에 TFVC를 사용하는 경우에도 Git 리포지토리를 사용하여 위키를 만들 수 있습니다.

위키 Git 리포지토리를 만들 수 있는 액세스 권한이 없거나 기존 위키에 액세스할 수 없는 경우 다음 메시지가 나타납니다.

관리자는 위키 Git 리포지토리를 만들거나 권한을 높이도록 요청할 수 있습니다. 관련자는 리포지토리 또는 코드에서 작업할 수 있는 권한이 없으므로 위키를 만들 수 없습니다.

위키 Git 리포지토리를 입니다 TeamProjectName.wiki. 예를 들어 팀 프로젝트가 foobar 있으면 위키 리포지토리에 레이블이 지정됩니다 foobar.wiki.

참고 항목

더 많은 위키를 만들려면 코드를 wiki로 게시해야 합니다. 단일 프로젝트 내에서 여러 위키 리포지토리를 설정할 수 있습니다.

Git 리포지토리로 이동하려면 어떻게 해야 하나요?

TeamProjectName.wiki는 리포지토리 또는 코드의 리포지토리 드롭다운 메뉴에 표시되지 않습니다. 또한 프로젝트 설정 리포지토리 또는 > 프로젝트 설정 > 버전 제어 페이지에서 제공하는 목록에도 없습니다.
그러나 다음 URL에서 가져올 수 있습니다.

https://dev.azure.com/<Org_Name>/<Team_Project_Name>/_git/<Wiki_Name>

위키 선택기 근처의 줄임표에서 위키 복제를 선택하여 위키 URL에 액세스합니다.

위키 Git 리포지토리의 URL이 노출됩니다. 복사하여 웹 브라우저에 붙여넣어 기본 Git 리포지토리에 액세스합니다.

Azure DevOps CLI

az devops wiki create 명령을 사용하여 위 키를 만들 수 있습니다. 시작하려면 Azure DevOps CLI 시작을 참조하세요.

참고 항목

둘 이상의 위키를 만들려면 코드를 wiki로 게시해야 합니다. 단일 프로젝트 내에서 여러 위키 리포지토리를 설정할 수 있습니다.

az devops wiki create [--mapped-path]
                      [--name]
                      [--org]
                      [--project]
                      [--repository]
                      [--type {codewiki, projectwiki}]
                      [--version]

매개 변수

• mapped-path: (codewiki 형식에 필요). 새 Wiki의 매핑된 경로입니다. 예를 들어 리포지토리의 루트에서 게시하도록 지정할 / 수 있습니다.
• name: (codewiki 형식에 필요). 새 위키의 이름입니다. projectwiki 형식의 이름을 지정하지 않으면 새 wiki의 이름이 지정TeamProjectName.wiki됩니다.
• org: Azure DevOps 조직 URL. 를 사용하여 az devops configure -d organization=ORG_URL기본 조직을 구성할 수 있습니다. 기본값으로 구성되지 않았거나 git config. 예: --org https://dev.azure.com/MyOrganizationName/
• project: 프로젝트의 이름 또는 ID입니다. 를 사용하여 az devops configure -d project=NAME_OR_ID기본 프로젝트를 구성할 수 있습니다. 기본값으로 구성되지 않았거나 git config.
• 리포지토리: (codewiki 형식에 필요). wiki를 게시할 리포지토리의 이름 또는 ID입니다.
• 형식: 만들 위키의 유형입니다. 허용되는 값은 projectwiki (기본값) 및 codewiki입니다.
• version: (codewiki 형식에 필요). 코드 wiki를 게시할 리포지토리 분기 이름입니다.

예시

다음 명령은 "Fabrikam 파이버"라는 위키를 만들고 출력을 테이블 형식으로 표시합니다.

az devops wiki create --name "Fabrikam Fiber" --output table

ID                                    Name                 Type
------------------------------------  -------------------  -----------
7edcc35b-89be-465e-855e-377ba8660af7  Fabrikam Fiber.wiki  projectWiki

다음 단계

위키 페이지 추가 및 편집