프로젝트에 대한 Wiki 만들기

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

Azure DevOps에서 모든 팀 프로젝트에는 wiki가 있습니다. 위키를 사용하여 팀과 정보를 공유하고 프로젝트 기여를 지원할 수 있습니다. 위키는 백 엔드의 Git 리포지토리에 의해 구동됩니다. 이 문서에서는 프로젝트 wiki를 열고 Git 리포지토리를 만드는 방법을 설명합니다.

팀 프로젝트를 만들 때 Wiki Git 리포지토리는 기본적으로 만들어지지 않습니다. 리포지토리를 만들어 위키 Markdown 파일을 저장하거나 Git 리포지토리의 기존 Markdown 파일을 wiki에 게시할 수 있습니다.

필수 조건

범주	요구 사항
프로젝트 액세스	위키가 있는 프로젝트의 구성원입니다. 액세스 권한이 없는 경우 프로젝트 관리자에게 요청합니다. 팀 프로젝트에 액세스할 수 있는 모든 사용자는 이해 관계자를 포함하여 위키를 볼 수 있습니다.
사용 권한	- 위키 페이지를 추가하거나 편집하려면: 기여자 그룹의 구성원입니다. - 코드를 wiki로 게시하려면 리포지토리 권한을 만듭니다. 기본적으로 이 권한은 프로젝트 관리자 그룹의 멤버에게 설정됩니다.
액세스 수준	적어도 기본 액세스.

Wiki 열기

브라우저에서 Azure DevOps에서 팀 프로젝트에 대한 위키 페이지를 열고 보거나 Azure DevOps CLI를 사용할 수 있습니다.

브라우저

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

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

Azure DevOps CLI

다음 명령을 사용하여 프로젝트의 위키 페이지를 보고 열 수 있습니다.az devops wiki show

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

자세한 내용은 Azure DevOps CLI 시작을 참조하세요.

기본 매개 변수

wiki show 명령을 사용할 수 있는 매개 변수는 다음과 같습니다.

매개 변수	필수	설명
--wiki	예	위키의 이름 또는 ID입니다.
--open	아니오	웹 브라우저에서 위키 페이지를 엽니다.
--project -p	아니오	프로젝트의 이름 또는 ID입니다.
--subscription	아니오	구독의 이름 또는 ID입니다. 명령을 사용하여 기본 구독을 az account set -s NAME_OR_ID 구성할 수 있습니다.

자세한 내용은 Azure DevOps CLI 명령 참조를 참조하세요.

예: 프로젝트 위키 보기

다음 예제에서는 "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]

추가 매개 변수

다음 표에서는 특정 페이지를 보려는 경우 명령에 대한 wiki show를 나열합니다.

매개 변수	필수	설명
--path	예	위키 페이지의 정규화된 경로입니다.
--include-content	아니오	페이지 메타데이터와 함께 전체 페이지 콘텐츠를 표시합니다.
--version -v	아니오	ETag 엔터티 태그 값에 해당하는 wiki 페이지의 버전입니다.

자세한 내용은 Azure DevOps CLI 명령 참조를 참조하세요.

예: 특정 페이지 보기

다음 예제에서는 "MyProjectwiki" wiki의 "시작" 페이지에 대한 콘텐츠를 가져오는 방법을 보여줍니다.

az devops wiki page show --path 'Get Started' --wiki 'MyProjectwiki' --content "Hello World"

wiki Git 리포지토리 만들기

이 섹션에서는 위키에 대한 Git 리포지토리를 만드는 방법을 설명합니다. 브라우저에서 Azure DevOps UI로 직접 작업하거나 Azure DevOps CLI를 사용할 수 있습니다.

브라우저

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

wiki Git 리포지토리를 만드는 데 필요한 권한이 없거나 기존 Wiki에 액세스할 수 없는 경우 다음 메시지가 표시됩니다.

프로젝트 관리자 수준 액세스 권한이 있는 사용자는 wiki Git 리포지토리를 만들 수 있습니다. 관련자 액세스 권한이 있는 사용자는 프로젝트의 리포지토리 또는 코드 섹션에서 작업할 수 있는 권한이 없기 때문에 Wiki를 만들 수 없습니다.

위키 리포지토리의 이름은 프로젝트 이름을 기반으로 합니다. 규칙은 <ProjectName>.wiki입니다. 팀 프로젝트 이름이 Contoso라면 위키 리포지토리 이름은 Contoso.wiki입니다.

팁 (조언)

코드를 wiki로 게시하여 단일 프로젝트에 대해 여러 위키를 만들 수 있습니다.

Wiki 리포지토리에 액세스

위키(ProjectName.wiki)의 Git 리포지토리는 프로젝트의 리포지토리 또는 코드 섹션에 있는 리포지토리 드롭다운 목록에 포함되지 않습니다. 위키 리포지토리는 프로젝트 설정 > 리포지토리 또는 버전 제어 페이지에도 나열되지 않습니다. 대신, 위키의 리포지토리>파일 페이지에서 위키 리포지토리에 액세스할 수 있습니다.

1. 리포지토리>파일 페이지의 URL을 만듭니다. 다음 URL에서 각 <Placeholder> 부분을 서버, 조직, 프로젝트 및 위키 이름으로 대체합니다.

   https://dev.azure.com/<Organization>/<ProjectName>/_git/<WikiName>

2. URL을 브라우저에 붙여넣고 Wiki의 파일 페이지를 엽니다.

3. 리포지토리>파일 페이지에서 위키 리포지토리 이름을 찾고 추가 옵션(...) > 을 선택합니다.복제합니다.

   

   클론 옵션은 위키 리포지토리의 URL을 포함하는 대화창을 엽니다.

4. 대화 상자에서 HTTP 를 선택한 다음 복사 아이콘(두 페이지)을 선택합니다.

   

   URL이 클립보드에 복사됩니다.

   대화 상자를 닫습니다.

5. 위키 리포지토리에 액세스하려면 복사한 URL을 브라우저에 붙여넣습니다.

Azure DevOps CLI

az devops wiki create 명령을 사용하여 wiki를 만들 수 있습니다.

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

자세한 내용은 Azure DevOps CLI 시작하기를 참조하세요.

참고

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

매개 변수

명령에 사용할 수 있는 wiki create 매개 변수는 다음과 같습니다. 매개 변수는 type 만들 위키의 유형을 지정합니다. Project wiki(projectwiki) 또는 코드를 wiki로 게시(codewiki).

매개 변수	필수	설명
mapped-path	예(codewiki)	wiki에 매핑된 경로입니다. wiki 리포지토리의 루트에서 게시할 백슬래시(/)를 지정할 수 있습니다.
name	예(codewiki)	위키의 이름입니다. projectwiki 형식의 경우 이름이 지정되지 않았을 때, 위키 이름은 TeamProjectName.wiki입니다.
org	아마	Azure DevOps 조직 URL입니다. 기본 조직을 구성하려면 az devops configure -d organization=ORG_URL 명령을 사용할 수 있습니다. 참고: 조직이 기본적으로 구성되지 않거나 명령을 이용하여 git config 처리되는 경우 매개 변수는 필수적입니다. 예: --org https://dev.azure.com/<OrganizationName>/
project	아마	프로젝트의 이름 또는 ID입니다. 명령을 사용하여 az devops configure -d project=NAME_OR_ID 기본 프로젝트를 구성할 수 있습니다. 참고: 프로젝트가 기본적으로 구성되지 않거나 명령을 사용하여 git config 선택되는 경우 매개 변수는 필수입니다.
repository	예(codewiki)	위키를 게시할 Git 리포지토리의 이름 또는 ID입니다.
type	아니오	만들 위키의 유형: 프로젝트 위키(projectwiki) 또는 코드를 wiki(codewiki)로 게시합니다. 기본값은 projectwiki입니다.
version	예(codewiki)	코드 wiki를 게시할 Git 리포지토리 분기 이름입니다.

예: 프로젝트 위키 만들기

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

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

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

다음 단계

위키 페이지 추가 및 편집