Git リポジトリの設定とポリシーを設定する

Web ポータルを使用してリポジトリの設定とポリシーを構成するには、Web ブラウザーから [プロジェクトの設定]>[リポジトリ] を開きます。

1. すべての Git リポジトリの設定またはポリシーを表示または変更するには、[ すべてのリポジトリ ] ページを開き、[ 設定 ] タブまたは [ポリシー ] タブを選択します。

   

   特定のリポジトリの設定とポリシーを構成するには、[ リポジトリ ] タブを選択し、リポジトリを選択して、[ 設定] タブまたは [ポリシー] タブ を 選択します。

   

2. [ 設定] タブでは、すべての Git リポジトリまたは個々のリポジトリの設定を定義できます。

   

3. [ ポリシー ] タブでは、すべての Git リポジトリまたは個々のリポジトリのポリシーを定義できます。

   

Azure DevOps CLI を使用してリポジトリを一覧表示したり、リポジトリを表示または更新したりできます。 また、ブランチまたはリポジトリのポリシーの詳細を一覧表示、表示、更新することもできます。

リポジトリの一覧を表示する | リポジトリの詳細を一覧表示する | リポジトリを更新または名前変更する
リポジトリ ポリシーを一覧表示する | ポリシーの詳細を一覧表示する | リポジトリ ポリシーを更新する

Azure CLI を使用して、ブランチまたはリポジトリ、またはプロジェクト内のすべてのリポジトリのポリシーの一覧表示、表示、更新を行うことができます。

リポジトリの一覧を表示する

az repos list を使用すると、プロジェクトのすべてのリポジトリを一覧表示できます。

az repos list [--detect {false, true}]
              [--org]
              [--project]
              [--subscription]

パラメーター

例

次のコマンドは、既定の構成 az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber" のすべての Git リポジトリを返します。

az repos list --output table
ID                                    Name            Default branch    Project
------------------------------------  --------------  ----------------  --------------
50a9df8e-5024-49d7-bf63-d3989139627e  Fabrikam Fiber  main              Fabrikam Fiber
ac228555-ea89-4881-9ace-dfa065baf7d3  Test 1-2-3      main              Fabrikam Fiber
0d58f562-4a10-495d-94d7-7ac61a22d7cc  Testing 1 2 3   main              Fabrikam Fiber
30954ce5-417b-4930-b8d2-8b6cac934a34  contosoREPO     main              Fabrikam Fiber

リポジトリの詳細を一覧表示する

az repos show を使用すると、リポジトリに関する情報を一覧表示することや、Web ブラウザーでその情報を開くことができます。

az repos show --repository
              [--detect {false, true}]
              [--open]
              [--org]
              [--project]
              [--subscription]

パラメーター

例

次のコマンドは、既定の構成contosoREPOのaz devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"の詳細を一覧表示します。

az repos show --repository contosoREPO --output table
ID                                    Name         Default Branch    Project
------------------------------------  -----------  ----------------  --------------
30954ce5-417b-4930-b8d2-8b6cac934a34  contosoREPO  main              Fabrikam Fiber

詳細については、次のコマンドを入力してください。

az repos show --repository contosoREPO
{
  "defaultBranch": "refs/heads/main",
  "id": "30954ce5-417b-4930-b8d2-8b6cac934a34",
  "isDisabled": false,
  "isFork": null,
  "name": "contosoREPO",
  "parentRepository": null,
  "project": {
    "abbreviation": null,
    "defaultTeamImageUrl": null,
    "description": "Guidance and source control to foster a vibrant ecosystem for Fabrikam Fiber applications and extensions.",
    "id": "56af920d-393b-4236-9a07-24439ccaa85c",
    "lastUpdateTime": "2021-05-24T21:52:14.95Z",
    "name": "Fabrikam Fiber",
    "revision": 438023732,
    "state": "wellFormed",
    "url": "https://dev.azure.com/fabrikamprime/_apis/projects/56af920d-393b-4236-9a07-24439ccaa85c",
    "visibility": "private"
  },
  "remoteUrl": "https://fabrikamprime@dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/contosoREPO",
  "size": 1627,
  "sshUrl": "git@ssh.dev.azure.com:v3/fabrikamprime/Fabrikam%20Fiber/contosoREPO",
  "url": "https://dev.azure.com/fabrikamprime/56af920d-393b-4236-9a07-24439ccaa85c/_apis/git/repositories/30954ce5-417b-4930-b8d2-8b6cac934a34",
  "validRemoteUrls": null,
  "webUrl": "https://dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/contosoREPO"
}

リポジトリの更新

az repos update を使用すると、既定のブランチを更新することや、リポジトリの名前を変更することができます。

az repos show --repository
                [--default-branch]
                [--detect {false, true}]
                [--name]
                [--org]
                [--project]
                [--subscription]

パラメーター

例

次のコマンドは、既定の構成contosoREPOのcontosoFabrikamの名前をaz devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"に変更します。

az repos show --repository contosoREPO --output table
ID                                    Name         Default Branch    Project
------------------------------------  -----------  ----------------  --------------
30954ce5-417b-4930-b8d2-8b6cac934a34  contosoREPO  main              Fabrikam Fiber

詳細については、次のコマンドを入力してください。

az repos update --repository contosoREPO --name contosoFabrikam
{
  "defaultBranch": "refs/heads/main",
  "id": "30954ce5-417b-4930-b8d2-8b6cac934a34",
  "isDisabled": false,
  "isFork": null,
  "name": "contosoFabrikam",
  "parentRepository": null,
  "project": {
    "abbreviation": null,
    "defaultTeamImageUrl": null,
    "description": "Guidance and source control to foster a vibrant ecosystem for Fabrikam Fiber applications and extensions.",
    "id": "56af920d-393b-4236-9a07-24439ccaa85c",
    "lastUpdateTime": "2021-05-24T21:52:14.95Z",
    "name": "Fabrikam Fiber",
    "revision": 438023732,
    "state": "wellFormed",
    "url": "https://dev.azure.com/fabrikamprime/_apis/projects/56af920d-393b-4236-9a07-24439ccaa85c",
    "visibility": "private"
  },
  "remoteUrl": "https://fabrikamprime@dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/contosoFabrikam",
  "size": 1627,
  "sshUrl": "git@ssh.dev.azure.com:v3/fabrikam/Fabrikam%20Fiber/contosoFabrikam",
  "url": "https://dev.azure.com/fabrikamprime/56af920d-393b-4236-9a07-24439ccaa85c/_apis/git/repositories/30954ce5-417b-4930-b8d2-8b6cac934a34",
  "validRemoteUrls": null,
  "webUrl": "https://dev.azure.com/fabrikamprime/Fabrikam%20Fiber/_git/contosoFabrikam"
}

ポリシーを一覧表示する

az repos policy list を使用すると、プロジェクトのすべてのリポジトリとブランチのすべてのポリシーを一覧表示できます。 特定のリポジトリとブランチのポリシーを一覧表示するには、repository-id パラメーターと branch パラメーターを使用します。

az repos policy list [--branch]
                     [--detect {false, true}]
                     [--org]
                     [--project]
                     [--query-examples]
                     [--repository-id]
                     [--subscription]

パラメーター

例

次のコマンドは、既定のプロジェクトで有効なすべてのポリシーを返します。 この例では、既定の構成 az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber" が使用されています。

az repos policy list --output table

ID    Name                         Is Blocking    Is Enabled    Repository ID                         Branch
----  ---------------------------  -------------  ------------  ------------------------------------  ---------------------
1     Git repository settings      True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  All branches
3     Work item linking            True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main
5     Minimum number of reviewers  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main
6     Comment requirements         False          True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main
7     Minimum number of reviewers  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/big-branch
8     Work item linking            False          True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/big-branch
9     Required reviewers           True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/new
10    Required reviewers           True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/new
11    Required reviewers           True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/new
12    Required reviewers           True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main
13    Required reviewers           False          True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  refs/heads/main

ポリシーの詳細を表示する

ポリシーの詳細を表示するには、az repos policy show を使用します。 az repos policy list を実行することで、ポリシー ID を取得できます。

az repos policy show --id
                     [--detect {false, true}]
                     [--org]
                     [--project]
                     [--query-examples]
                     [--subscription]

パラメーター

例

次の例では、既定のプロジェクトのポリシー ID 1 の名前と詳細が表示されます。 この例では、既定の構成 az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber" が使用されています。

az repos policy show --id 1 --output table

ID    Name                     Is Blocking    Is Enabled    Repository Id                         Branch
----  -----------------------  -------------  ------------  ------------------------------------  ------------
1     Git repository settings  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  All Branches

更新ポリシー

Azure CLI az repos policy update をポリシー 構成ファイルと共に使用して、ポリシーを更新できます。 ポリシー構成ファイルにより、一度に複数のスコープに対してポリシーを適用できます。 詳細については、構成ファイルを使用した Git リポジトリ ポリシーの構成に関する記事を参照してください。 ポリシー構成ファイルの例については、構成 - 作成に関する記事を参照してください。

az repos policy update --config
                       --id
                       [--detect {false, true}]
                       [--org]
                       [--project]
                       [--subscription]

パラメーター

例

次の policy.json ファイルは、既定のプロジェクトのすべてのリポジトリのすべての main ブランチで 3 つの承認を必須とする最小レビュー担当者ポリシーを設定します。

{
  "isEnabled": true,
  "isBlocking": false,
  "type": {
    "id": "fa4e907d-c16b-4a4c-9dfa-4906e5d171dd"
  },
  "settings": {
    "minimumApproverCount": 3,
    "creatorVoteCounts": false,
    "scope": [
      {
        "repositoryId": null,
        "refName": "refs/heads/main",
        "matchKind": "exact"
      }
    ]
  }
}

az repos policy update コマンド ラインは、policy.json ファイルごとに最小レビュー担当者ポリシーを更新します。 az repos policy list を使用して、ポリシー ID を確認できます。 この例では、既定の構成 az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber" が使用されています。

az repos policy update --config C:\policies\policy.json --id 7 --output table

ID    Name                         Is Blocking    Is Enabled    Branch
----  ---------------------------  -------------  ------------  -----------------
7     Minimum number of reviewers  False          True          refs/heads/main

Azure DevOps CLI コマンドは、Azure DevOps Server ではサポートされていません。

ケース適用ポリシーを設定するには:

1. [プロジェクトの設定]>[リポジトリ] を選択し、リポジトリを選択します (そのリポジトリのみ構成する場合)。

2. [すべてのリポジトリ] または [<Repository 名> ページの [ポリシー] タブの [リポジトリ ポリシー] で、[ケースの適用] を [オン] または [オフ] に設定します。

   

Azure CLI az repos policy case-enforcement create と az repos policy case-enforcement update を使用して、ケース適用 ポリシーを構成または更新できます。

ケースの執行ポリシーを作成する

リポジトリのポリシールールを設定するためには、az repos case-enforcement create を使用します。

az repos policy case-enforcement create --blocking {false, true}
                                        --enabled {false, true}
                                        --repository-id
                                        [--detect {false, true}]
                                        [--org]
                                        [--project]

パラメーター

例

次の例では、Fabrikam リポジトリに必須ケース実施ポリシーを実装します。 az repos list を使用して、リポジトリ ID を取得できます。 この例では、既定の構成 az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber" が使用されています。

az repos policy case-enforcement create --blocking true --enabled true --repository-id d28cd374-e7f0-4b1f-ad60-f349f155d47c --output table

ID    Name                     Is Blocking    Is Enabled    Repository Id                         Branch
----  -----------------------  -------------  ------------  ------------------------------------  ------------
40    Git repository settings  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  All Branches

ケース執行ポリシーを更新する

az repos policy case-enforcement update コマンドを使用して、ケース強制ポリシーを管理します。

az repos policy case-enforcement update --id
                                        [--blocking {false, true}]
                                        [--detect {false, true}]
                                        [--enabled {false, true}]
                                        [--org]
                                        [--project]
                                        [--repository-id]

パラメーター

例

次の例では、Fabrikam リポジトリのケースの強制ポリシーを無効化し、ブロック解除を行う更新を行います。 この例では、既定の構成 az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber" が使用されています。

az repos policy case-enforcement update --blocking false --enabled false --policy-id 40 --output table

ID    Name                     Is Blocking    Is Enabled    Repository Id                         Branch
----  -----------------------  -------------  ------------  ------------------------------------  ------------
40    Git repository settings  False          False         d28cd374-e7f0-4b1f-ad60-f349f155d47c  All Branches

Azure DevOps CLI コマンドは、Azure DevOps Server ではサポートされていません。

ファイルの最大サイズ ポリシーを管理するには、az repos policy file-size create と az repos policy file-size update を使用します。

ファイル サイズ ポリシーを作成する

az repos policy file-size create --blocking {false, true}
                                 --enabled {false, true}
                                 --maximum-git-blob-size
                                 --repository-id
                                 --use-uncompressed-size {false, true}
                                 [--detect {false, true}]
                                 [--org]
                                 [--project]
                                 [--subscription]

パラメーター

例

次の例では、 Fabrikam リポジトリに最大 1 GB のブロックを含むファイル サイズ ポリシーを作成します。 az repos list を使用して、リポジトリ ID を取得できます。 この例では、既定の構成 az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber" が使用されています。

az repos policy file-size create --blocking true --enabled true --maximum-git-blob-size 10485760 --repository-id d28cd374-e7f0-4b1f-ad60-f349f155d47c --use-uncompressed-size true --output table

ID    Name                   Is Blocking    Is Enabled    Repository Id                         Branch
----  ---------------------  -------------  ------------  ------------------------------------  ------------
45    File size restriction  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  All Branches

ファイル サイズ ポリシーを更新する

最大ファイル サイズ ポリシーを管理するには、az repos policy file-size update を使用します。

az repos policy file-size update --id
                                 [--blocking {false, true}]
                                 [--detect {false, true}]
                                 [--enabled {false, true}]
                                 [--maximum-git-blob-size]
                                 [--org]
                                 [--project]
                                 [--repository-id]
                                 [--subscription]
                                 [--use-uncompressed-size {false, true}]

パラメーター

例

次の例では、Fabrikam リポジトリーの最大ファイル サイズを更新します。 この例では、既定の構成 az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber" が使用されています。

az repos policy file-size update --id 45 --maximum-git-blob-size 20971520 --output table

ID    Name                   Is Blocking    Is Enabled    Repository Id                         Branch
----  ---------------------  -------------  ------------  ------------------------------------  ------------
45    File size restriction  True           True          d28cd374-e7f0-4b1f-ad60-f349f155d47c  All Branches

Azure DevOps CLI コマンドは、Azure DevOps Server ではサポートされていません。