プロジェクト用 Wiki の作成。
[アーティクル] 04/04/2024
9 人の共同作成者
フィードバック
この記事の内容
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
この記事では、Wiki を開き、Wiki の Git リポジトリを作成する方法について説明します。 すべてのチーム プロジェクトに Wiki があります。 Wiki を使用してチームと情報を共有し、プロジェクトを理解して貢献します。
各チーム プロジェクト Wiki には、バックエンドの Git リポジトリが用意されています。 チーム プロジェクトを作成する場合、Wiki Git リポジトリは既定では作成されません。 Wiki Markdown ファイルを格納する Git リポジトリを作成するか 、Git リポジトリ から Wiki に既存の Markdown ファイルを発行します。
前提条件
チーム プロジェクトが必要です。 チーム プロジェクトがまだない場合は、Azure DevOps で 作成します 。
Wiki を作成および変更するには、少なくとも Basic アクセス権が必要です。
Wiki としてコードを発行するには、リポジトリの作成アクセス許可 が必要です。 既定では、このアクセス許可はプロジェクト管理者グループ のメンバーに設定されます。
共同作成者セキュリティ グループのメンバーであるすべてのユーザーは、Wiki ページを追加または編集できます。 関係者を含め 、チーム プロジェクトにアクセスできるユーザーは、Wiki を表示できます。
チーム プロジェクトが必要です。 チーム プロジェクトがまだない場合は、オンプレミスで 1 つ 作成します 。
Wiki としてコードを発行するには、リポジトリの作成アクセス許可 が必要です。 既定では、このアクセス許可はプロジェクト管理者グループ のメンバーに設定されます。
共同作成者セキュリティ グループのメンバーであるすべてのユーザーは、Wiki ページを追加または編集できます。 関係者を含め 、チーム プロジェクトにアクセスできるユーザーは、Wiki を表示できます。
Wiki を開く
コマンドを使用して、プロジェクトに対して定義された Wiki ページを表示および az devops wiki show
開くことができます。 開始するには、「 Azure DevOps CLI の概要 」を参照してください。
az devops wiki show --wiki
[--open]
[--project]
[--subscription]
パラメーター
--wiki : 必須。 Wiki の名前または ID。
--open : 省略可能。 Web ブラウザーで Wiki ページを開きます。
--project -p : 省略可能。 プロジェクトの名前または ID。
--subscription : 省略可能。 サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
例
'myprojectwiki' という名前の Wiki を開きます。
az devops wiki show --wiki myprojectwiki --open
Wiki ページを表示する
Azure DevOps CLI を使用してページのコンテンツを取得するには、 コマンドを az devops wiki show
入力します。
az devops wiki page show --path
--wiki
[--include-content]
[--open]
[--project]
[--subscription]
[--version]
パラメーター
--path : 必須。 Wiki ページのパス。
--wiki : 必須。 Wiki の名前または ID。
--include-content : 省略可能。 ページのコンテンツを含めます。
--open : 省略可能。 Web ブラウザーで Wiki ページを開きます。
--project -p : 省略可能。 プロジェクトの名前または ID。
--version -v : 省略可能。 Wiki ページのバージョン (ETag)。
例
'myprojectwiki' という名前の Wiki のパス 'my wiki' を含む Wiki ページのコンテンツを取得します。
az devops wiki page show --path 'my wiki' --wiki 'myprojectwiki' --content "Hello World"
Wiki Git リポジトリを作成する
すべての Wiki ページと関連する成果物を格納する新しい Git リポジトリを作成します。 Wiki のランディング ページで、[プロジェクト Wiki の作成] を選択します 。 ソース管理に TFVC を使用する場合でも、Git リポジトリを使用して Wiki を作成できます。
Wiki Git リポジトリを作成するためのアクセス権がない場合、または既存の Wiki にアクセスできない場合は、次のメッセージが表示されます。
管理者は Wiki Git リポジトリを作成することも、アクセス許可の昇格を要求することもできます。 リポジトリまたはコード で 作業するアクセス許可がないため、利害関係者は Wiki を作成できません。
Wiki Git リポジトリは .TeamProjectName.wiki
たとえば、チーム プロジェクトが foobar
Wiki リポジトリにラベル付けされている foobar.wiki
場合、
Note
Wiki をさらに作成する場合は、コードを Wiki として発行する必要があります 。 1 つのプロジェクト内に複数の Wiki リポジトリを設定できます。
Git リポジトリに移動するにはどうすればよいですか?
リポジトリまたはコード の リポジトリのドロップダウン メニューに TeamProjectName.wiki が表示されません。 また、[プロジェクト 設定 リポジトリ] ページまたは > [プロジェクト 設定 > バージョン 管理 ] ページから 提供される一覧にも含まれません。
ただし、次の URL からアクセスできます。
https://dev.azure.com/<Org_Name>/<Team_Project_Name>/_git/<Wiki_Name>
https://<Server_Name>/Default_Collection/<Team_Project_Name>/_git/<Wiki_Name>
Wiki ピッカーの近くの省略記号から [Wiki の複製] を選択 して、Wiki URL にアクセスします。
Wiki Git リポジトリの URL が公開されています。 それをコピーして Web ブラウザーに貼り付けて、基になる Git リポジトリにアクセスします。
az devops wiki create コマンドを使用して Wiki を作成 できます。 開始するには、「Azure DevOps CLI の概要 」を参照してください。
Note
複数の Wiki を作成するには、コードを wiki として発行する必要があります 。 1 つのプロジェクト内に複数の Wiki リポジトリを設定できます。
az devops wiki create [--mapped-path]
[--name]
[--org]
[--project]
[--repository]
[--type {codewiki, projectwiki}]
[--version]
パラメーター
mapped-path : (codewiki 型に 必須)。 新しい Wiki のマップされたパス。 たとえば、リポジトリのルートから発行するように指定 /
できます。
name : (codewiki 型に 必須)。 新しい Wiki の名前。 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
を使用して取得された場合は必須です。
repository : (codewiki 型に 必須)。 Wiki を発行するリポジトリの名前または ID。
type : 作成する Wiki の種類。 指定できる値は projectwiki (既定) と codewiki です 。
version : (codewiki 型に 必須)。 コード Wiki を発行するリポジトリ ブランチ名。
Note
Azure DevOps Server 2020 では、次のコマンドを使用して、既定のサーバー インスタンス、コレクション、およびプロジェクトを設定できます。
az devops configure --defaults organization=https://ServerName/CollectionName project=ContosoWebApp
例
次のコマンドは、"Fabrikam Fiber" という名前の 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 ではサポートされていません。
次のステップ