Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020
Azure DevOps에서 모든 팀 프로젝트에는 wiki가 있습니다. 위키를 사용하여 팀과 정보를 공유하고 프로젝트 기여를 지원할 수 있습니다. 위키는 백 엔드의 Git 리포지토리에 의해 구동됩니다. 이 문서에서는 프로젝트 wiki를 열고 Git 리포지토리를 만드는 방법을 설명합니다.
팀 프로젝트를 만들 때 Wiki Git 리포지토리는 기본적으로 만들어지지 않습니다. 리포지토리를 만들어 위키 Markdown 파일을 저장하거나 Git 리포지토리의 기존 Markdown 파일을 wiki에 게시할 수 있습니다.
필수 조건
| 범주 |
요구 사항 |
|
프로젝트 액세스 |
위키가 있는 프로젝트의 구성원입니다. 액세스 권한이 없는 경우 프로젝트 관리자에게 요청합니다. 팀 프로젝트에 액세스할 수 있는 모든 사용자는 이해 관계자를 포함하여 위키를 볼 수 있습니다. |
|
사용 권한 |
- 위키 페이지를 추가하거나 편집하려면: 기여자 그룹의 구성원입니다. - 코드를 wiki로 게시하려면 리포지토리 권한을 만듭니다. 기본적으로 이 권한은 프로젝트 관리자 그룹의 멤버에게 설정됩니다. |
|
액세스 수준 |
적어도 기본 액세스. |
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"
Azure DevOps CLI 명령은 Azure DevOps Server에서 지원되지 않습니다.
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 리포지토리에 액세스
위키(ProjectName.wiki)의 Git 리포지토리는 프로젝트의 리포지토리 또는 코드 섹션에 있는 리포지토리 드롭다운 목록에 포함되지 않습니다. 위키 리포지토리는 프로젝트 설정 > 리포지토리 또는 버전 제어 페이지에도 나열되지 않습니다. 대신, 위키의 리포지토리>파일 페이지에서 위키 리포지토리에 액세스할 수 있습니다.
리포지토리>파일 페이지의 URL을 만듭니다. 다음 URL에서 각 <Placeholder> 부분을 서버, 조직, 프로젝트 및 위키 이름으로 대체합니다.
https://dev.azure.com/<Organization>/<ProjectName>/_git/<WikiName>
https://<ServerName>/Default_Collection/<ProjectName>/_git/<WikiName>
URL을 브라우저에 붙여넣고 Wiki의 파일 페이지를 엽니다.
리포지토리>파일 페이지에서 위키 리포지토리 이름을 찾고 추가 옵션(...) > 을 선택합니다.복제합니다.
클론 옵션은 위키 리포지토리의 URL을 포함하는 대화창을 엽니다.
대화 상자에서 HTTP 를 선택한 다음 복사 아이콘(두 페이지)을 선택합니다.
URL이 클립보드에 복사됩니다.
대화 상자를 닫습니다.
위키 리포지토리에 액세스하려면 복사한 URL을 브라우저에 붙여넣습니다.
az devops wiki create 명령을 사용하여 wiki를 만들 수 있습니다.
az devops wiki create [--mapped-path]
[--name]
[--org]
[--project]
[--repository]
[--type {codewiki, projectwiki}]
[--version]
자세한 내용은 Azure DevOps CLI 시작하기를 참조하세요.
매개 변수
명령에 사용할 수 있는 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
Azure DevOps CLI 명령은 Azure DevOps Server에서 지원되지 않습니다.
다음 단계