Menetapkan pengaturan dan kebijakan repositori Git

Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

Ada beberapa cara untuk menyesuaikan repositori Azure Repos Git Anda dengan menggunakan pengaturan dan kebijakan cabang dan repositori. Artikel ini membahas pengaturan dan kebijakan tingkat repositori.

• Pengaturan dan kebijakan repositori mengonfigurasi opsi global untuk semua repositori Git untuk proyek atau organisasi, atau untuk repositori individual.

  Artikel ini membahas pengaturan dan kebijakan repositori sisi server. Untuk mempelajari tentang preferensi Git sisi klien, lihat Preferensi dan pengaturan Git di Visual Studio.

• Kebijakan cabang mencakup kontrol khusus cabang.

  Kebijakan cabang mencakup opsi seperti memerlukan permintaan pull, build yang berhasil, atau tinjauan kode sebelum perubahan dapat digabungkan ke cabang. Untuk informasi selengkapnya, lihat Kebijakan dan pengaturan cabang.

• Izin keamanan cabang dan repositori mengontrol penetapan pengguna.

  Izin ini mengontrol siapa yang dapat membaca, menulis, berkontribusi pada permintaan pull, dan mengambil tindakan spesifik lainnya. Untuk informasi selengkapnya, lihat Mengatur izin untuk repositori.

Ringkasan semua pengaturan dan kebijakan repositori dan cabang

Anda dapat mengonfigurasi pengaturan dan kebijakan untuk semua repositori dalam proyek, untuk repositori individual, dan untuk cabang repositori. Di browser, Anda mengonfigurasi semua pengaturan dan kebijakan ini melalui Repositori pengaturan>Proyek.

Catatan

Anda dapat mengatur beberapa pengaturan dan kebijakan cabang dengan Azure CLI menggunakan kebijakan repositori az.

Tabel berikut ini meringkas pengaturan dan kebijakan yang dapat Anda aktifkan dan konfigurasikan untuk repositori dan cabang Git.

Semua Pengaturan Repositori

Tabel berikut ini meringkas pengaturan yang dapat Anda aktifkan dan konfigurasikan untuk semua repositori Git baru dalam proyek atau di organisasi.

Pengaturan

Default

Keterangan

---

Nama cabang default untuk repositori baru

Nonaktif

Inisialisasi repositori baru dengan nama cabang default yang Anda tentukan. Anda dapat mengubah cabang default untuk repositori tertentu kapan saja. Jika Anda tidak mengaktifkan fitur ini, repositori menginisialisasi dengan cabang default bernama main.

Mengizinkan pengguna mengelola izin untuk cabang yang dibuat

Aktif

Izinkan pengguna mengelola izin untuk cabang yang dibuat di semua repositori baru.

Pengaturan repositori

Tabel berikut ini meringkas pengaturan yang dapat Anda aktifkan atau konfigurasi untuk setiap repositori Git individual.

Pengaturan

Default

Keterangan

---

Fork

Aktif

Izinkan pengguna membuat fork dari repositori.

Penerapan penyebutan penautan

Aktif

Buat tautan secara otomatis untuk item kerja yang disebutkan dalam komentar penerapan.

Menerapkan penyebutan resolusi item kerja

Aktif

Izinkan penyebutan dalam komentar penerapan untuk menutup item kerja. Memerlukan pembaruan Azure DevOps Server 2020.1 atau versi yang lebih baru.

Preferensi transisi item kerja

Aktif

Ingat preferensi pengguna untuk menyelesaikan item kerja dengan permintaan pull.

Manajemen izin

Aktif

Perbolehkan pengguna mengelola izin untuk cabang yang mereka buat

Mode Pemungutan Suara Ketat

Aktif

Aktifkan Mode Pemungutan Suara Ketat untuk repositori, yang memerlukan izin Kontribusi untuk memilih permintaan pull.

Nonaktifkan Repositori

Aktif

Nonaktifkan akses ke repositori, termasuk build dan permintaan pull, tetapi biarkan repositori tetap dapat ditemukan dengan peringatan.

Cabang yang dapat dicari

Aktif

Tentukan hingga lima cabang lagi untuk berpartisipasi dalam pencarian kode, yang secara default hanya berlaku untuk cabang default. Memerlukan ekstensi Pencarian Kode yang diinstal dan diaktifkan.

Kebijakan atau opsi repositori

Tabel berikut ini meringkas kebijakan atau opsi yang bisa Anda atur untuk semua atau repositori individual. Kebijakan yang ditetapkan untuk Semua Repositori menetapkan default untuk repositori individual yang ditambahkan di kemudian hari.

Kebijakan atau Opsi

Default

Keterangan

---

Menerapkan validasi email pembuat

Nonaktif

Blokir pendorongan dengan email pembuat penerapan yang tidak cocok dengan pola yang ditentukan. Pengaturan ini memerlukan Azure DevOps Server 2020.1 atau versi yang lebih baru.

Validasi jalur file

Nonaktif

Blokir dorongan untuk memperkenalkan jalur file yang cocok dengan pola yang ditentukan. Pengaturan ini memerlukan Azure DevOps Server 2020.1 atau versi yang lebih baru.

Penegakan kasus

Nonaktif

Hindari konflik sensitivitas huruf besar/kecil dengan memblokir dorongan yang mengubah casing nama pada file, folder, cabang, dan tag.

Nama yang dicadangkan

Nonaktif

Dorongan blokir yang memperkenalkan file, folder, atau nama cabang yang menyertakan nama yang dipesan platform atau karakter yang tidak kompatibel.

Panjang jalur maksimum

Nonaktif

Blokir mendorong yang memperkenalkan jalur yang melebihi panjang yang ditentukan.

Ukuran file maksimum

Nonaktif

Dorongan blokir yang berisi file baru atau yang diperbarui lebih besar dari batas yang dipilih.

Kebijakan cabang

Tabel berikut ini meringkas kebijakan yang bisa Anda tentukan untuk mengkustomisasi cabang. Untuk informasi selengkapnya tentang mengonfigurasi pengaturan ini, lihat Meningkatkan kualitas kode dengan kebijakan cabang. Saat Anda menetapkan kebijakan apa pun di cabang, kebijakan berikut secara otomatis diberlakukan:

• Permintaan pull diperlukan untuk memperbarui cabang.
• Cabang tidak dapat dihapus.

Catatan

Kebijakan cabang diterapkan ke Permintaan Pull berdasarkan cabang target Permintaan Pull. Kebijakan cabang tidak boleh diatur pada cabang sementara yang akan dihapus setelah permintaan pull. Menambahkan kebijakan cabang ke cabang sementara akan menyebabkan penghapusan cabang otomatis gagal.

Kebijakan

Default

Keterangan

---

Memerlukan jumlah minimum peninjau

Nonaktif

Memerlukan persetujuan dari sejumlah peninjau tertentu tentang permintaan pull.

Periksa item kerja tertaut

Nonaktif

Dorong keterlacakan dengan memeriksa item kerja tertaut pada permintaan pull.

Periksa resolusi komentar

Nonaktif

Periksa untuk melihat bahwa semua komentar telah diselesaikan pada permintaan pull.

Membatasi jenis penggabungan atau Menerapkan strategi penggabungan

Nonaktif

Kontrol riwayat cabang dengan membatasi jenis penggabungan yang tersedia saat permintaan pull selesai.

Validasi Build

Nonaktif

Tambahkan, aktifkan, atau nonaktifkan satu atau beberapa kebijakan untuk memvalidasi kode dengan melakukan pra-penggabungan dan membangun perubahan permintaan pull.

Pemeriksaan Status atau
Memerlukan persetujuan dari layanan tambahan atau eksternal

Nonaktif

Tambahkan, aktifkan, atau nonaktifkan satu atau beberapa kebijakan untuk mengharuskan layanan lain memposting status berhasil untuk menyelesaikan permintaan pull.

Peninjau yang disertakan secara otomatis

Nonaktif

Tambahkan, aktifkan, atau nonaktifkan satu atau beberapa kebijakan untuk menunjuk peninjau kode untuk disertakan secara otomatis saat permintaan pull mengubah area kode tertentu.

Prasyarat

• Untuk mengonfigurasi kebijakan, Anda harus menjadi anggota grup keamanan Administrator Proyek, atau memiliki izin Edit kebijakan tingkat repositori. Untuk informasi selengkapnya, lihat Mengatur izin repositori Git.

• Jika Anda ingin menggunakan perintah az repos , pastikan untuk mengikuti langkah-langkah di Mulai menggunakan Azure DevOps CLI.

Menampilkan dan mengedit pengaturan dan kebijakan

Anda dapat mengonfigurasi pengaturan untuk semua repositori di seluruh organisasi atau proyek, atau untuk repositori individual. Anda dapat mengonfigurasi kebijakan untuk semua repositori, untuk repositori individual, atau untuk cabang tertentu di seluruh repositori. Untuk informasi tentang pengaturan kebijakan cabang, lihat Kebijakan cabang.

Catatan

Yang terbaik adalah mengonfigurasi pengaturan repositori baik di tingkat proyek atau untuk repositori individual, tetapi tidak keduanya. Jika Anda mengonfigurasi pengaturan di lebih dari satu tingkat, sistem akan mematuhi pengaturan yang paling ketat. Mengonfigurasi pengaturan hanya pada satu tingkat mengurangi kebingungan dan masalah performa Git.

Browser

Untuk mengonfigurasi pengaturan dan kebijakan repositori melalui portal web, buka Repositori pengaturan>Proyek dari browser web Anda.

1. Untuk melihat atau mengubah pengaturan atau kebijakan untuk semua repositori Git, buka halaman Semua Repositori dan pilih Pengaturan atau Kebijakan.

   

   Untuk mengonfigurasi pengaturan dan kebijakan untuk repositori tertentu, pilih tab Repositori , pilih repositori, lalu pilih tab Pengaturan atau Kebijakan .

   

2. Cuplikan layar berikut menunjukkan tab Pengaturan dipilih. Anda dapat menentukan pengaturan ini untuk semua repositori Git atau untuk repositori individual.

   

3. Cuplikan layar berikut menunjukkan tab Kebijakan dipilih. Anda dapat menentukan kebijakan ini untuk semua repositori Git atau untuk repositori individual.

   

Azure DevOps CLI

Anda dapat menggunakan Azure DevOps CLI untuk mencantumkan repositori atau menampilkan atau memperbarui repositori. Selain itu, Anda dapat mencantumkan, menampilkan, atau memperbarui detail kebijakan untuk cabang atau repositori.

Daftar repositori Daftar detail repositori | Memperbarui atau mengganti nama repositori |
Mencantumkan kebijakan | repositori Mencantumkan detail | kebijakan Memperbarui kebijakan repositori

Anda dapat menggunakan Azure CLI untuk mencantumkan, menampilkan, dan memperbarui kebijakan untuk cabang atau repositori, atau untuk semua repositori dalam proyek.

Daftar repositori

Gunakan daftar repositori az untuk mencantumkan semua repositori untuk proyek.

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

Parameter

Parameter	Deskripsi
detect	Mendeteksi organisasi secara otomatis. Nilai yang diterima: false, true.
org, organization	URL organisasi Azure DevOps. Anda dapat mengonfigurasi organisasi default dengan menggunakan az devops configure -d organization=<ORG_URL>. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui konfigurasi git. Contoh: https://dev.azure.com/MyOrganizationName/.
project, p	Nama atau ID proyek. Anda dapat mengonfigurasi proyek default menggunakan az devops configure -d project=<NAME_OR_ID>. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui konfigurasi git.
subscription	Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s <NAME_OR_ID>.

Contoh

Perintah berikut mengembalikan semua repositori Git untuk konfigurasi az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"default .

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

Mencantumkan detail repositori

Gunakan az repos show untuk mencantumkan informasi tentang repositori atau membukanya di browser web.

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

Parameter

Parameter	Deskripsi
repository	Nama atau ID repositori.
detect	Mendeteksi organisasi secara otomatis. Nilai yang diterima: false, true.
open	Buka halaman repositori di browser web Anda.
org, organization	URL organisasi Azure DevOps. Anda dapat mengonfigurasi organisasi default dengan menggunakan az devops configure -d organization=<ORG_URL>. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui konfigurasi git. Contoh: https://dev.azure.com/MyOrganizationName/.
project, p	Nama atau ID proyek. Anda dapat mengonfigurasi proyek default menggunakan az devops configure -d project=<NAME_OR_ID>. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui konfigurasi git.
subscription	Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s <NAME_OR_ID>.

Contoh

Perintah berikut mencantumkan detail contosoREPO untuk konfigurasi az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"default .

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

Untuk detail selengkapnya, masukkan perintah berikut:

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"
}

Memperbarui repositori

Anda dapat menggunakan pembaruan az repos untuk memperbarui cabang default atau mengganti nama repositori.

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

Parameter

Parameter	Deskripsi
repository	Nama atau ID repositori.
default-branch	Tentukan cabang default yang akan diatur untuk repositori. Contoh: 'refs/heads/live' atau 'live'.
detect	Mendeteksi organisasi secara otomatis. Nilai yang diterima: false, true.
name	Nama baru untuk repositori.
org, organization	URL organisasi Azure DevOps. Anda dapat mengonfigurasi organisasi default dengan menggunakan az devops configure -d organization=<ORG_URL>. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui konfigurasi git. Contoh: https://dev.azure.com/MyOrganizationName/.
project, p	Nama atau ID proyek. Anda dapat mengonfigurasi proyek default menggunakan az devops configure -d project=<NAME_OR_ID>. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui konfigurasi git.
subscription	Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s <NAME_OR_ID>.

Contoh

Perintah berikut mengganti nama contosoREPO menjadi contosoFabrikam untuk konfigurasi az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"default .

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

Untuk detail selengkapnya, masukkan perintah berikut:

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"
}

Mencantumkan kebijakan

Gunakan az repos policy list untuk mencantumkan semua kebijakan untuk semua repositori dan cabang proyek. repository-id Gunakan parameter dan branch untuk mencantumkan kebijakan untuk repositori dan cabang tertentu.

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

Parameter

Parameter	Deskripsi
branch	Nama cabang untuk memfilter hasil dengan kecocokan yang tepat. Parameter --repository-id diperlukan untuk menggunakan filter cabang. Misalnya: --branch main.
detect	Mendeteksi organisasi secara otomatis. Nilai yang diterima: false, true.
org, organization	URL organisasi Azure DevOps. Anda dapat mengonfigurasi organisasi default dengan menggunakan az devops configure -d organization=<ORG_URL>. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui konfigurasi git. Contoh: https://dev.azure.com/MyOrganizationName/.
project, p	Nama atau ID proyek. Anda dapat mengonfigurasi proyek default menggunakan az devops configure -d project=<NAME_OR_ID>. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui konfigurasi git.
query-examples	String JMESPath yang direkomendasikan. Anda dapat menyalin salah satu kueri dan menempelkannya setelah --query parameter dalam tanda kutip ganda untuk melihat hasilnya. Anda dapat menambahkan satu atau beberapa kata kunci posisional sehingga saran didasarkan pada kata kunci ini.
repository-id	ID repositori untuk memfilter hasil berdasarkan kecocokan yang tepat. Contohnya,--repository-id e556f204-53c9-4153-9cd9-ef41a11e3345.
subscription	Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s <NAME_OR_ID>.

Contoh

Perintah berikut mengembalikan semua kebijakan yang berlaku dalam proyek default. Contoh ini menggunakan konfigurasi az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"default .

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

Tampilkan detail kebijakan

Untuk menampilkan detail kebijakan apa pun, gunakan az repos policy show. Anda bisa mendapatkan ID kebijakan dengan menjalankan az repos policy list.

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

Parameter

Parameter	Deskripsi
id, policy-id	ID kebijakan. Diperlukan.
detect	Mendeteksi organisasi secara otomatis. Nilai yang diterima: false, true.
org, organization	URL organisasi Azure DevOps. Anda dapat mengonfigurasi organisasi default dengan menggunakan az devops configure -d organization=<ORG_URL>. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui konfigurasi git. Contoh: https://dev.azure.com/MyOrganizationName/.
project, p	Nama atau ID proyek. Anda dapat mengonfigurasi proyek default menggunakan az devops configure -d project=<NAME_OR_ID>. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui konfigurasi git.
query-examples	String JMESPath yang direkomendasikan. Anda dapat menyalin salah satu kueri dan menempelkannya setelah --query parameter dalam tanda kutip ganda untuk melihat hasilnya. Anda dapat menambahkan satu atau beberapa kata kunci posisional sehingga saran didasarkan pada kata kunci ini.
subscription	Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s <NAME_OR_ID>.

Contoh

Contoh berikut menunjukkan nama dan detail untuk ID 1 kebijakan dalam proyek default. Contoh ini menggunakan konfigurasi default 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

Memperbarui kebijakan

Anda dapat menggunakan azure CLI az repos policy update dengan file konfigurasi kebijakan untuk memperbarui kebijakan. File konfigurasi kebijakan dapat menerapkan kebijakan di lebih dari satu cakupan pada satu waktu. Untuk informasi selengkapnya, lihat Mengonfigurasi kebijakan repositori Git dengan menggunakan file konfigurasi. Untuk contoh file konfigurasi kebijakan, lihat Konfigurasi - Buat.

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

Parameter

Parameter	Deskripsi
--config, --policy-configuration	Jalur file lokal untuk file konfigurasi kebijakan. Gunakan garis miring terbelakang \ saat memasukkan jalur direktori. Diperlukan.
id, policy-id	ID kebijakan yang akan diperbarui. Diperlukan.
detect	Mendeteksi organisasi secara otomatis. Nilai yang diterima: false, true.
org, organization	URL organisasi Azure DevOps. Anda dapat mengonfigurasi organisasi default dengan menggunakan az devops configure -d organization=<ORG_URL>. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui konfigurasi git. Contoh: https://dev.azure.com/MyOrganizationName/.
project, p	Nama atau ID proyek. Anda dapat mengonfigurasi proyek default menggunakan az devops configure -d project=<NAME_OR_ID>. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui konfigurasi git.
subscription	Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s <NAME_OR_ID>.

Contoh

File policy.json berikut menetapkan kebijakan peninjau minimum untuk memerlukan tiga persetujuan di semua main cabang di semua repositori dalam proyek default.

{
  "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"
      }
    ]
  }
}

Baris az repos policy update perintah memperbarui kebijakan peninjau minimum per file policy.json . Anda dapat menemukan ID kebijakan dengan menggunakan daftar kebijakan repositori az. Contoh menggunakan konfigurasi default 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

Nama cabang default

Anda dapat mengatur nama cabang repositori default di tingkat organisasi atau proyek. Pengaturan tingkat organisasi berlaku untuk semua repositori baru di semua proyek di organisasi. Pengaturan tingkat proyek memengaruhi semua repositori baru dalam proyek, dan menggantikan nama apa pun yang ditetapkan di tingkat organisasi.

Anda dapat:

• Pilih nama cabang hukum yang akan digunakan saat repositori diinisialisasi.
• Ubah nama default kapan saja untuk memengaruhi semua repositori di masa mendatang.
• Ubah nama cabang default untuk repositori tertentu kapan saja.

Jika Anda tidak mengaktifkan fitur nama cabang default, repositori menginisialisasi dengan nama maincabang default Azure Repos .

Untuk mengatur nama cabang default di tingkat organisasi:

1. Pada halaman organisasi Azure DevOps Anda, pilih Pengaturan organisasi di kiri bawah, lalu pilih Repositori di navigasi kiri.
2. Pada halaman Semua Repositori , atur Nama cabang default untuk repositori baru ke Aktif, lalu masukkan nama cabang default.

Untuk mengatur nama cabang default di tingkat proyek:

1. Pada halaman proyek Azure DevOps Anda, pilih Pengaturan proyek di kiri bawah, lalu pilih Repositori di navigasi kiri.
2. Pada tab Pengaturan dari halaman Semua Repositori , atur Nama cabang default untuk repositori baru ke Aktif, lalu masukkan nama cabang default.

Manajemen izin cabang

Anda dapat mengontrol siapa yang dapat mengelola izin untuk cabang repositori dengan mengatur pengaturan manajemen izin untuk semua repositori Git atau untuk repositori individual. Jika Anda mengaktifkan pengaturan Izinkan pengguna mengelola izin untuk cabang yang dibuat di tingkat Semua Repositori , semua repositori proyek baru dikonfigurasi untuk memungkinkan pengguna mengelola izin untuk cabang yang dibuat.

Untuk mengelola pengaturan ini:

1. Pada halaman proyek Azure DevOps Anda, pilih Pengaturan proyek di kiri bawah, lalu pilih Repositori di navigasi kiri.
2. Pada tab Pengaturan dari halaman Semua Repositori , atur Izinkan pengguna mengelola izin untuk cabang yang dibuat ke Aktif atau Nonaktif.

Untuk mengaktifkan atau menonaktifkan pengaturan ini untuk repositori individual:

1. Pilih Repositori Pengaturan>Proyek, lalu pilih repositori.
2. Pada tab Pengaturan dari <halaman Nama> repositori, atur Manajemen izin ke Aktif atau Nonaktif.

Gambar Gravatar

Pengaturan ini memungkinkan atau menonaktifkan penggunaan gambar Gravatar untuk pengguna di luar perusahaan Anda.

Gambar Gravatar adalah pengaturan tingkat organisasi.

1. Pada halaman organisasi Azure DevOps Anda, pilih Pengaturan organisasi di kiri bawah, lalu pilih Repositori di navigasi kiri.
2. Pada halaman Semua Repositori , atur gambar Gravatar ke Aktif atau Nonaktif.

Aktifkan fork

Pengaturan repositori ini mengontrol apakah pengguna dapat membuat fork sisi server baru. Menonaktifkan pengaturan ini tidak menghapus fork yang ada.

1. Dari Pengaturan Proyek, pilih Repositori di navigasi kiri.
2. Pada tab Repositori dari halaman Semua Repositori , pilih repositori.
3. Pada tab Pengaturan dari< halaman Nama> repositori, atur Fork ke Aktif atau Nonaktif.

Pengaturan penautan item kerja

Pengaturan repositori ini mengelola penautan item kerja.

1. Pilih Repositori Pengaturan>Proyek, lalu pilih repositori.
2. Pada tab Pengaturan dari <halaman Nama> repositori, aktifkan atau Nonaktifkan pengaturan.

Penerapan penyebutan penautan

Saat diaktifkan, terapkan pesan yang berisi # diikuti oleh ID item kerja yang valid secara otomatis menautkan penerapan ke item kerja tersebut. Nonaktifkan pengaturan ini jika repositori sebelumnya menggunakan akun atau layanan yang berbeda. Repositori tersebut mungkin memiliki pesan penerapan dengan sebutan yang tidak cocok dengan # ID item kerja di akun saat ini.

Menerapkan penyebutan resolusi item kerja

Aktifkan pengaturan ini untuk menyelesaikan item kerja secara otomatis saat permintaan pull tertaut selesai. Pengaturan ini juga memungkinkan menentukan status transisi item kerja lainnya dalam pesan penerapan permintaan pull. Untuk informasi selengkapnya, lihat Menyelesaikan item kerja secara otomatis dengan permintaan pull.

Preferensi transisi item kerja

Secara default, opsi untuk menyelesaikan item kerja tertaut selama penyelesaian permintaan pull mengingat pilihan terakhir setiap pengguna. Teams yang ingin mencegah pengguna menyelesaikan item kerja dengan permintaan pull mereka dapat menonaktifkan pengaturan ini. Pengguna kemudian harus memilih untuk menyelesaikan item kerja setiap kali mereka menyelesaikan permintaan pull.

Pengaturan Mode Pemungutan Suara Ketat

Dalam situasi tertentu, pengguna yang bukan kontributor ke repositori dapat mengirimkan permintaan pull dan menyebabkannya digabungkan, tergantung pada kebijakan. Untuk mencegah kemungkinan ini, aktifkan Mode Pemungutan Suara Ketat untuk mengubah izin yang diperlukan untuk memilih permintaan pull repositori ke Kontribusi. Mengaktifkan pengaturan ini disarankan jika Anda mengandalkan fork pengguna di Azure Repos.

1. Pilih Repositori Pengaturan>Proyek, lalu pilih repositori.
2. Pada tab Pengaturan dari< halaman Nama> repositori, atur Mode Pemungutan Suara Ketat ke Aktif atau Nonaktif.

Menonaktifkan pengaturan repositori

Mengaktifkan pengaturan ini menonaktifkan akses ke repositori, termasuk permintaan build dan pull, tetapi membuat repositori dapat ditemukan dengan peringatan.

1. Pilih Repositori Pengaturan>Proyek, lalu pilih repositori.
2. Pada tab Pengaturan dari< halaman Nama> repositori, di bawah Nonaktifkan Repositori, atur Nonaktifkan Repositori ke Aktif atau Nonaktif.

Kebijakan cabang lintas repositori

Anda dapat mengatur kebijakan pada nama cabang tertentu, atau di cabang default, di semua repositori dalam proyek. Misalnya, Anda dapat memerlukan dua peninjau minimum untuk semua permintaan pull di setiap main cabang untuk semua repositori proyek.

Untuk mengatur kebijakan guna melindungi nama cabang tertentu atau default di seluruh proyek:

1. Dari Pengaturan Proyek, pilih Repositori di navigasi kiri.

2. Pada halaman Semua Repositori , pilih tab Kebijakan .

3. Pilih plus masuk + Kebijakan Cabang di bagian bawah halaman.

4. Pada layar Tambahkan perlindungan cabang, pilih Lindungi cabang default setiap repositori, atau Lindungi cabang saat ini dan yang akan datang yang cocok dengan pola yang ditentukan.

   Jika Anda memilih opsi kedua, masukkan nama cabang untuk dilindungi. Pesan informasi memungkinkan Anda mengetahui berapa banyak cabang saat ini yang terpengaruh. Cabang belum harus ada untuk melindungi nama cabang.

5. Pilih Buat.

   

6. Pada halaman Kebijakan Lintas Repositori untuk <nama> cabang, atur kebijakan yang Anda inginkan untuk cabang yang dilindungi. Untuk informasi selengkapnya tentang kebijakan cabang, lihat Kebijakan cabang.

   

Menerapkan kebijakan validasi email pembuat

Kebijakan ini memblokir penerapan ke repositori oleh penulis penerapan yang alamat emailnya tidak cocok dengan pola.

1. Pilih Repositori Pengaturan>Proyek, dan pilih repositori jika Anda hanya ingin mengonfigurasi repositori tersebut.

2. Pada tab Kebijakan dari halaman Semua Repositori atau< Nama> repositori, di bawah Kebijakan Repositori, atur Terapkan validasi email pembuat ke Aktif atau Nonaktif.

3. Jika Anda mengaktifkan kebijakan, tentukan alamat email atau alamat yang cocok.

   Anda dapat menentukan alamat email yang tepat atau menggunakan kartubebas. Gunakan ; sebagai pemisah untuk beberapa pola email. Pola email yang diawali dengan ! dikecualikan. Pesanan itu penting.

Kebijakan validasi jalur file

Anda dapat mengatur kebijakan yang mencegah penerapan ke repositori dari jalur file yang cocok dengan pola.

1. Pilih Repositori Pengaturan>Proyek, dan pilih repositori jika Anda hanya ingin mengonfigurasi repositori tersebut.

2. Pada tab Kebijakan dari halaman Semua Repositori atau <Nama> repositori, di bawah Kebijakan Repositori, atur Validasi jalur file ke Aktif atau Nonaktif.

3. Jika Anda mengaktifkan kebijakan, tentukan jalur atau jalur yang akan diblokir.

   Anda dapat menentukan jalur dan kartubebas yang tepat. Jalur yang tepat dimulai dengan /. Anda juga dapat menentukan beberapa jalur dengan menggunakan ; sebagai pemisah. Jalur yang diawali dengan ! dikecualikan. Pesanan itu penting.

Kebijakan penegakan kasus

Git peka huruf besar/kecil, yang berarti bahwa file yang disebut Foo.txt berbeda dari file yang disebut foo.txt. Namun, Windows dan macOS default ke sistem file yang tidak peka huruf besar/kecil, yang berarti bahwa Foo.txt dan foo.txt adalah nama yang sama. Perbedaan ini dapat menyebabkan masalah jika seseorang pada sistem yang tidak peka huruf besar/kecil mendorong file, folder, cabang, atau tag yang berbeda hanya dengan huruf besar/kecil. Untuk informasi selengkapnya, lihat Kompatibilitas Lintas Platform Git.

Jika sebagian besar kontributor Anda berada di Windows atau macOS, yang terbaik adalah mengaktifkan kebijakan Penegakan kasus. Pemberlakuan kasus mengalihkan server dari mode peka huruf besar/kecil default, di mana File.txt dan file.txt berbeda, ke mode ramah Windows dan macOS di mana File.txt dan file.txt dianggap sebagai file yang sama. Pengaturan ini memengaruhi file, folder, cabang, dan tag.

Pengaturan ini mencegah kontributor memperkenalkan perbedaan kasus-saja. Pengaturan menghindari konflik sensitivitas huruf besar/kecil dengan memblokir dorongan yang mengubah casing nama pada file, folder, cabang, dan tag. Pengguna harus menulis ulang riwayat yang tidak dipublikasikan untuk memperbaiki masalah, lalu mencoba dorong lagi.

Pengaturan ini tidak akan memperbaiki repositori yang sudah berisi objek yang berbeda hanya menurut kasus. Yang terbaik adalah memperbaiki masalah tersebut sebelum mengaktifkan kebijakan. Ganti nama file dan folder atau buat ulang cabang dan tag untuk menggunakan nama yang tidak bertentangan.

Browser

Untuk menetapkan kebijakan penegakan kasus:

1. Pilih Repositori Pengaturan>Proyek, dan pilih repositori jika Anda hanya ingin mengonfigurasi repositori tersebut.
2. Pada tab Kebijakan dari halaman Semua Repositori atau <Nama> repositori, di bawah Kebijakan Repositori, atur Penegakan kasus ke Aktif atau Nonaktif.

Azure DevOps CLI

Anda dapat menggunakan Azure CLI az repos policy case-enforcement create dan az repos policy case-enforcement update untuk mengonfigurasi atau memperbarui kebijakan penegakan kasus.

Membuat kebijakan penegakan kasus

Gunakan az repos case-enforcement create untuk membuat kebijakan penegakan kasus.

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

Parameter

Parameter	Deskripsi
blocking	Blokir jika kebijakan tidak terpenuhi. Nilai yang diterima: false, true. Diperlukan.
enabled	Aktifkan kebijakan. Nilai yang diterima: false, true. Diperlukan.
repository-id	ID repositori untuk menerapkan kebijakan. Diperlukan.
detect	Mendeteksi organisasi secara otomatis. Nilai yang diterima: false, true.
org	URL organisasi Azure DevOps. Anda dapat mengonfigurasi organisasi default dengan menggunakan az devops configure -d organization=<ORG_URL>. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui konfigurasi git. Contoh: https://dev.azure.com/MyOrganizationName/.
project, p	Nama atau ID proyek. Anda dapat mengonfigurasi proyek default menggunakan az devops configure -d project=<NAME_OR_ID>. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui konfigurasi git.

Contoh

Contoh berikut menerapkan kebijakan penegakan kasus yang diperlukan di repositori Fabrikam . Anda bisa mendapatkan ID repositori dengan menggunakan daftar repositori az. Contoh ini menggunakan konfigurasi az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"default .

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

Memperbarui kebijakan penegakan kasus

Gunakan az repos policy case-enforcement update untuk mengelola kebijakan Penegakan kasus.

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

Parameter

Parameter	Deskripsi
id, policy-id	ID kebijakan yang akan diperbarui. Diperlukan.
blocking	Blokir jika kebijakan tidak terpenuhi. Nilai yang diterima: false, true.
detect	Mendeteksi organisasi secara otomatis. Nilai yang diterima: false, true.
enabled	Aktifkan kebijakan. Nilai yang diterima: false, true.
org	URL organisasi Azure DevOps. Anda dapat mengonfigurasi organisasi default dengan menggunakan az devops configure -d organization=<ORG_URL>. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui konfigurasi git. Contoh: https://dev.azure.com/MyOrganizationName/.
project, p	Nama atau ID proyek. Anda dapat mengonfigurasi proyek default menggunakan az devops configure -d project=<NAME_OR_ID>. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui konfigurasi git.
repository-id	ID repositori untuk menerapkan kebijakan.
subscription	Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s <NAME_OR_ID>.

Contoh

Contoh berikut memperbarui kebijakan penegakan kasus di Fabrikam repositori agar tidak lagi diaktifkan atau diblokir. Contoh ini menggunakan konfigurasi az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"default .

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

Kebijakan nama yang dipesan

Tidak semua nama file diizinkan pada tiga sistem file OS utama: Windows, macOS, dan Linux. Menerapkan ke repositori bersama mungkin berisi nama file atau folder yang tidak valid pada satu atau beberapa platform. Jika file atau folder yang tidak valid diambil dan dicek keluar pada platform ini, direktori kerja dapat menjadi rusak. Untuk informasi selengkapnya, lihat Kompatibilitas Lintas Platform Git.

Anda dapat mengaktifkan atau menonaktifkan kebijakan untuk menempatkan pembatasan pada nama file dan folder. Blok pengaturan Nama cadangan mendorong ke repositori yang berisi nama file atau folder yang tidak valid di semua platform. Untuk melihat nama apa yang tidak valid, lihat Kompatibilitas Lintas Platform Git.

Untuk mengatur kebijakan nama yang dipesan:

1. Pilih Repositori Pengaturan>Proyek, dan pilih repositori jika Anda hanya ingin mengonfigurasi repositori tersebut.
2. Pada tab Kebijakan dari halaman Semua Repositori atau <Nama> repositori, di bawah Kebijakan Repositori, atur Nama yang Dicadangkan ke Aktif atau Nonaktif.

Kebijakan panjang jalur maksimum

Tidak semua panjang jalur diizinkan pada tiga sistem file OS utama: Windows, macOS, dan Linux. Menerapkan ke repositori bersama mungkin berisi file atau direktori dengan panjang jalur yang tidak valid pada satu atau beberapa platform. Jika file atau direktori ini diambil dan dicek keluar pada platform di mana file atau direktori kerja tersebut tidak valid, direktori kerja dapat menjadi rusak. Untuk informasi selengkapnya, lihat Kompatibilitas Lintas Platform Git.

Blok pengaturan Panjang jalur maksimum mendorong yang berisi file atau direktori dengan panjang jalur yang tidak valid pada platform apa pun. Untuk melihat panjang jalur apa yang tidak valid, lihat Kompatibilitas Lintas Platform Git. Saat Anda mengaktifkan pengaturan ini, nilai maksimum default adalah 248, karena panjang maksimumnya adalah 100% yang didukung di ketiga platform utama.

Anda dapat mengubah nilai jalur maksimum. Misalnya, jika Anda hanya memiliki pengembang macOS atau Linux di organisasi Anda, Anda dapat memilih untuk mengatur panjang maksimum ke nilai yang didukung di kedua platform, 1016. Anda juga dapat memilih untuk menetapkan nilai jalur maksimum yang lebih rendah untuk memberlakukan konvensi penamaan direktori organisasi Anda.

Untuk mengatur kebijakan panjang jalur maksimum:

1. Pilih Repositori Pengaturan>Proyek, dan pilih repositori jika Anda hanya ingin mengonfigurasi repositori tersebut.
2. Pada tab Kebijakan dari halaman Semua Repositori atau <Nama> repositori, di bawah Kebijakan Repositori, atur Panjang jalur maksimum ke Aktif atau Nonaktif.
3. Jika Anda mengaktifkan pengaturan, masukkan panjang jalur maksimum.

Kebijakan ukuran file maksimum

File besar yang diperiksa ke Git tetap berada di repositori tanpa batas waktu, meningkatkan waktu kloning dan penggunaan disk. Untuk panduan tentang mengelola file besar, lihat Mengelola dan menyimpan file besar di Git.

Pengaturan Kebijakan ukuran file maksimum memblokir file dalam ukuran tertentu agar tidak memasuki repositori. Jika pendorongan berisi file baru atau yang diperbarui lebih besar dari batas yang dikonfigurasi dalam pengaturan ini, pendorongan diblokir. Pengguna harus menulis ulang riwayat yang tidak dipublikasikan untuk menghapus file besar dan mencoba dorong lagi.

Browser

Untuk mengonfigurasi kebijakan Ukuran file maksimum:

1. Pilih Repositori Pengaturan>Proyek, dan pilih repositori jika Anda hanya ingin mengonfigurasi repositori tersebut.
2. Pada tab Kebijakan dari halaman Semua Repositori atau <Nama> repositori, di bawah Kebijakan Repositori, atur Ukuran file maksimum ke Aktif atau Nonaktif.
3. Jika Anda mengaktifkan pengaturan, pilih ukuran file maksimum.

Azure DevOps CLI

Gunakan az repos policy file-size create dan az repos policy file-size update untuk mengelola kebijakan ukuran file maksimum.

Membuat kebijakan ukuran file

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]

Parameter

Parameter	Deskripsi
blocking	Blokir jika kebijakan tidak terpenuhi. Nilai yang diterima: false, true. Diperlukan.
enabled	Aktifkan kebijakan. Nilai yang diterima: false, true. Diperlukan.
maximum-git-blob-size	Ukuran blob git maksimum dalam byte. Misalnya, untuk menentukan batas 10 byte, --maximum-git-blob-size 10. Diperlukan.
repository-id	ID repositori untuk menerapkan kebijakan. Diperlukan.
use-uncompressed-size	Apakah akan menggunakan ukuran yang tidak dikompresi. Nilai yang diterima: false, true. Diperlukan.
detect	Mendeteksi organisasi secara otomatis. Nilai yang diterima: false, true.
org	URL organisasi Azure DevOps. Anda dapat mengonfigurasi organisasi default dengan menggunakan az devops configure -d organization=<ORG_URL>. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui konfigurasi git. Contoh: https://dev.azure.com/MyOrganizationName/.
project, p	Nama atau ID proyek. Anda dapat mengonfigurasi proyek default menggunakan az devops configure -d project=<NAME_OR_ID>. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui konfigurasi git.
subscription	Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s <NAME_OR_ID>.

Contoh

Contoh berikut membuat kebijakan ukuran file maksimum pemblokiran 1 GB di Fabrikam repositori. Anda bisa mendapatkan ID repositori dengan menggunakan daftar repositori az. Contoh ini menggunakan konfigurasi az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"default .

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

Memperbarui kebijakan ukuran file

Gunakan az repos policy file-size update untuk mengelola kebijakan ukuran file maksimum.

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}]

Parameter

Parameter	Deskripsi
id, policy-id	ID kebijakan yang akan diperbarui. Diperlukan.
blocking	Blokir jika kebijakan tidak terpenuhi. Nilai yang diterima: false, true.
detect	Mendeteksi organisasi secara otomatis. Nilai yang diterima: false, true.
enabled	Aktifkan kebijakan. Nilai yang diterima: false, true.
maximum-git-blob-size	Ukuran blob git maksimum dalam byte.
org	URL organisasi Azure DevOps. Anda dapat mengonfigurasi organisasi default dengan menggunakan az devops configure -d organization=<ORG_URL>. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui konfigurasi git. Contoh: https://dev.azure.com/MyOrganizationName/.
project, p	Nama atau ID proyek. Anda dapat mengonfigurasi proyek default menggunakan az devops configure -d project=<NAME_OR_ID>. Diperlukan jika tidak dikonfigurasi sebagai default atau diambil melalui konfigurasi git.
repository-id	ID repositori untuk menerapkan kebijakan.
subscription	Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s <NAME_OR_ID>.
use-uncompressed-size	Apakah akan menggunakan ukuran yang tidak dikompresi. Nilai yang diterima: false, true.

Contoh

Contoh berikut memperbarui ukuran file maksimum di Fabrikam repositori. Contoh menggunakan konfigurasi az devops configure --defaults organization=https://dev.azure.com/fabrikamprime project="Fabrikam Fiber"default .

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

Langkah berikutnya

Meningkatkan kualitas kode dengan kebijakan cabang

Artikel terkait

• Mengonfigurasi kebijakan repositori Git menggunakan file konfigurasi
• Izin Git Default (Keamanan)
• Mengatur izin (Keamanan)
• Gambaran umum integrasi lintas layanan