Buat dan kelola kumpulan agen

Layanan Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Kumpulan agen adalah sekumpulan agen. Alih-alih mengelola setiap agen satu per satu, Anda mengatur agen ke dalam kumpulan agen. Saat Anda mengonfigurasi agen, agen tersebut didaftarkan ke satu pool. Saat membuat alur, Anda menentukan kumpulan tempat alur berjalan. Saat Anda menjalankan pipeline, pipeline tersebut berjalan pada agen dari kumpulan yang memenuhi kebutuhan pipeline tersebut.

Kumpulan Agen DevOps Terkelola dikelola di portal Azure. Jika Anda menggunakan Kumpulan DevOps Terkelola, lihat panduan cepat untuk membuat kumpulan.

Di Azure Pipelines, kumpulan dilingkupkan ke seluruh organisasi, sehingga Anda dapat berbagi komputer agen di seluruh proyek.

Pekerjaan kumpulan agen menjalankan pekerjaan pada satu agen. Jika Anda perlu menjalankan pekerjaan di semua agen, seperti grup penyebaran untuk alur rilis klasik, lihat Menyediakan grup penyebaran.

Jika Anda adalah administrator organisasi, Anda membuat dan mengelola kumpulan agen dari tab Kumpulan agen di pengaturan admin.

1. Masuk ke organisasi Anda (https://dev.azure.com/{yourorganization}).

2. PilihPengaturan Organisasi>.

   

3. Pilih Kumpulan agen.

   

Jika Anda adalah anggota tim proyek, Anda membuat dan mengelola kumpulan agen dari tab Kumpulan agen di pengaturan proyek.

Buka proyek Anda dan pilih Pengaturan> proyekKumpulan agen.

Kumpulan agen default

Kumpulan agen berikut disediakan secara default:

• Kumpulan default: Gunakan untuk mendaftarkan agen yang dikelola sendiri yang Anda siapkan.

• Azure Pipelines: Kumpulan yang dihosting ini dilengkapi dengan berbagai gambar Windows, Linux, dan macOS. Untuk daftar lengkap gambar yang tersedia dan perangkat lunak yang diinstal, lihat Agen yang dihosting Microsoft.

Secara bawaan, semua kontributor dalam proyek adalah anggota peran Pengguna pada kumpulan yang di-host. Penunjukan ini memungkinkan setiap kontributor dalam proyek untuk membuat dan menjalankan pipeline dengan agen-agen yang dihosting Microsoft.

Tetapkan kumpulan di pipa Anda

YAML

Untuk memilih agen yang dihosting Microsoft dari kumpulan Azure Pipelines di alur YAML Azure DevOps Services Anda, tentukan nama gambar dengan menggunakan Label Gambar VM YAML dari tabel ini.

pool:
  vmImage: ubuntu-latest # This is the default if you don't specify a pool or vmImage.

Untuk menggunakan kolam privat tanpa permintaan:

pool: MyPool

Untuk informasi selengkapnya, lihat skema YAML untuk kumpulan.

Klasik

Untuk memilih kumpulan dan agen di editor klasik, buka pengaturan alur. Pilih nilai kumpulan Agen yang diinginkan dan gambar yang diinginkan dari menu dropdown Spesifikasi Agen . Pilihan Spesifikasi Agen default adalah windows-2019. Untuk informasi selengkapnya tentang perangkat lunak yang diinstal pada gambar yang dihosting Microsoft, lihat entri terkait di kolom Kumpulan Editor Klasik dari tabel ini.

Mengelola kumpulan dan antrean

Antarmuka Pengguna Azure Pipelines

Administrator organisasi membuat dan mengelola kumpulan agen dari tab Kumpulan agen di pengaturan admin.

1. Masuk ke organisasi Anda (https://dev.azure.com/{yourorganization}).

2. PilihPengaturan Organisasi>.

   

3. Pilih Kumpulan agen.

   

Anggota tim proyek membuat dan mengelola kumpulan agen dari tab Kumpulan agen di pengaturan proyek.

Buka proyek Anda dan pilih Pengaturan> proyekKumpulan agen.

Untuk menghapus kumpulan, buka daftar Kumpulan agen, lalu pilih Opsi> lainnyaHapus.

Azure DevOps CLI

Mencantumkan kumpulan agen | Tampilkan detail kumpulan agen | Mencantumkan antrean agen | Tampilkan detail antrean agen

Catatan

Pengguna dapat melihat informasi tentang kumpulan dan antrean agen, tetapi tidak mengeditnya, dengan menggunakan Azure CLI.

Jika ini pertama kalinya Anda menggunakan az devops pipelines perintah, lihat Mulai menggunakan Azure DevOps CLI.

Mencantumkan kumpulan agen

az pipelines pool list [--action {manage, none, use}]
                       [--detect {false, true}]
                       [--org]
                       [--pool-name]
                       [--pool-type {automation, deployment}]

Parameter

• action: Filter daftar dengan tindakan pengguna yang diizinkan. Nilai yang diterima adalah manage, none, dan use.
• detect: Mendeteksi organisasi secara otomatis. Nilai yang diterima adalah false dan true.
• org atau organization: URL organisasi Azure DevOps. Anda dapat mengonfigurasi organisasi default dengan menggunakan az devops configure -d organization=ORG_URL. Proses ini diperlukan jika tidak dikonfigurasi sebagai bawaan atau diambil melalui konfigurasi Git. Misalnya: https://dev.azure.com/MyOrganizationName/.
• pool-name: Saring daftar berdasarkan nama kumpulan yang cocok.
• pool-type: Filter daftar dengan tipe kolam. Nilai yang diterima adalah automation dan deployment.

Contoh

Contoh berikut mencantumkan semua kumpulan dalam format tabel. Contoh ini menggunakan konfigurasi default berikut: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber.

az pipelines pool list --output table

ID    Name                             Is hosted    Pool type
----  -------------------------------  -----------  -----------
1     Default                          False        automation
2     Hosted                           True         automation
3     Hosted VS2017                    True         automation
4     Hosted Windows 2019 with VS2019  True         automation
5     Hosted Windows Container         True         automation
6     Hosted macOS                     True         automation
7     Hosted macOS High Sierra         True         automation
8     Hosted Ubuntu 1604               True         automation
9     Azure Pipelines                  True         automation
10    MyAgentPool                      False        automation

Perlihatkan detail kumpulan agen

az pipelines pool show --id
                       [--action {manage, none, use}]
                       [--detect {false, true}]
                       [--org]

Parameter

• id atau pool-id: (Wajib) ID kumpulan untuk mencantumkan detailnya.
• action: Filter daftar dengan tindakan pengguna yang diizinkan. Nilai yang diterima adalah manage, none, dan use.
• detect: Mendeteksi organisasi secara otomatis. Nilai yang diterima adalah false dan true.
• org atau organization: URL organisasi Azure DevOps. Anda dapat mengonfigurasi organisasi default dengan menggunakan az devops configure -d organization=ORG_URL. Proses ini diperlukan jika tidak dikonfigurasi sebagai bawaan atau diambil melalui konfigurasi Git. Misalnya: https://dev.azure.com/MyOrganizationName/.

Contoh

Contoh berikut menampilkan detail kumpulan untuk Hosted Windows 2019 dengan VS2019. Contoh ini menggunakan konfigurasi default berikut: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber.

az pipelines pool show --id 4

{
  "agentCloudId": 1,
  "autoProvision": true,
  "autoSize": null,

  <Some properties omitted for space>

  "poolType": "automation",
  "properties": null,
  "scope": "941fcaeb-be37-4309-b7b0-5cf156e1236e",
  "size": 1,
  "targetSize": 1
}

Anda juga dapat menggunakan --output table, yang mengembalikan informasi yang sama dengan list perintah .

az pipelines pool show --id 4 --output table

ID    Name                             Is Hosted    Pool Type
----  -------------------------------  -----------  -----------
4     Hosted Windows 2019 with VS2019  True         automation

Daftar antrian agen

az pipelines queue list [--action {manage, none, use}]
                        [--detect {false, true}]
                        [--org]
                        [--project]
                        [--queue-name]

Parameter

• action: Filter daftar dengan tindakan pengguna yang diizinkan. Nilai yang diterima adalah manage, none, dan use.
• detect: Mendeteksi organisasi secara otomatis. Nilai yang diterima adalah false dan true.
• org atau organization: URL organisasi Azure DevOps. Anda dapat mengonfigurasi organisasi default menggunakan az devops configure -d organization=ORG_URL. Proses ini diperlukan jika tidak dikonfigurasi sebagai bawaan atau diambil melalui konfigurasi Git. Misalnya: https://dev.azure.com/MyOrganizationName/.
• project atau p: Nama atau ID proyek. Anda dapat mengonfigurasi proyek default dengan menggunakan az devops configure -d project=NAME_OR_ID. Proses ini diperlukan jika tidak dikonfigurasi sebagai bawaan atau diambil melalui konfigurasi Git.
• queue-name: Filter daftar dengan regex nama antrean yang cocok (misalnya, ubuntu untuk antrean bernama Hosted Ubuntu 1604).

Contoh

Contoh berikut mencantumkan semua antrean dalam format tabel. Contoh ini menggunakan konfigurasi default berikut: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber.

az pipelines queue list --output table
This command group is in preview. It might be changed/removed in a future release.
ID    Name                             Pool IsHosted    Pool Type
----  -------------------------------  ---------------  -----------
11    Default                          False            automation
12    Hosted                           True             automation
13    Hosted VS2017                    True             automation
14    Hosted Windows 2019 with VS2019  True             automation
15    Hosted Windows Container         True             automation
16    Hosted macOS                     True             automation
17    Hosted macOS High Sierra         True             automation
18    Hosted Ubuntu 1604               True             automation
19    Azure Pipelines                  True             automation

Tampilkan detail antrean agen

az pipelines queue show --id
                        [--action {manage, none, use}]
                        [--detect {false, true}]
                        [--org]
                        [--project]

Parameter

• id atau queue-id: ID antrian agen untuk mendapatkan informasi mengenai.
• action: Filter daftar dengan tindakan pengguna yang diizinkan. Nilai yang diterima adalah manage, none, dan use.
• detect: Mendeteksi organisasi secara otomatis. Nilai yang diterima adalah false dan true.
• org atau organization: URL organisasi Azure DevOps. Anda dapat mengonfigurasi organisasi default menggunakan az devops configure -d organization=ORG_URL. Proses ini diperlukan jika tidak dikonfigurasi sebagai bawaan atau diambil melalui konfigurasi Git. Misalnya: https://dev.azure.com/MyOrganizationName/.
• project atau p: Nama atau ID proyek. Anda dapat mengonfigurasi proyek default dengan menggunakan az devops configure -d project=NAME_OR_ID. Proses ini diperlukan jika tidak dikonfigurasi sebagai bawaan atau diambil melalui konfigurasi Git.

Contoh

Contoh berikut menampilkan detail antrean untuk antrean Hosted Windows 2019 dengan VS2019. Ini menggunakan konfigurasi default berikut: az devops configure --defaults organization=https://dev.azure.com/fabrikam-tailspin project=FabrikamFiber.

az pipelines queue show --id 14

{
  "id": 14,
  "name": "Hosted Windows 2019 with VS2019",
  "pool": {
    "id": 4,
    "isHosted": true,
    "isLegacy": true,
    "name": "Hosted Windows 2019 with VS2019",
    "poolType": "automation",
    "scope": "941fcaeb-be37-4309-b7b0-5cf156e1236e",
    "size": 1
  },
  "projectId": "16836457-4ce1-4e77-b97a-e7e0c6508e84"
}

Kumpulan digunakan untuk menjalankan pekerjaan. Pelajari tentang menentukan kumpulan untuk pekerjaan.

Jika Anda memiliki banyak agen yang dihost sendiri yang ditujukan untuk tim atau tujuan yang berbeda, Anda mungkin ingin membuat lebih banyak kumpulan. Gunakan instruksi berikut.

Membuat kumpulan agen

Berikut adalah beberapa situasi umum ketika Anda mungkin ingin membuat kumpulan agen yang dihost sendiri.

Anda adalah anggota proyek dan ingin menggunakan sekumpulan komputer yang dimiliki tim Anda untuk menjalankan pekerjaan build dan penyebaran:

1. Pastikan Anda memiliki izin untuk membuat kumpulan di proyek Anda. Di Pengaturan proyek, buka panel Kumpulan agen dan pilih Keamanan. Untuk membuat kumpulan baru, Anda harus memiliki peran Administrator .
2. Pilih Tambahkan kumpulan, lalu pilih opsi untuk membuat kumpulan baru.
3. Instal dan konfigurasikan agen untuk menjadi bagian dari kumpulan agen baru.

Anda adalah anggota tim infrastruktur dan ingin menyiapkan kumpulan agen untuk digunakan di semua proyek:

1. Pastikan Anda memiliki izin untuk membuat kumpulan di proyek Anda. Di Pengaturan organisasi, buka panel Kumpulan agen dan pilih Keamanan.
2. Buat kumpulan agen baru dan pilih opsi Provisi otomatis kumpulan agen ini di semua proyek saat Anda membuat kumpulan. Pengaturan ini memastikan bahwa semua proyek memiliki akses ke kumpulan agen ini.
3. Instal dan konfigurasikan agen untuk menjadi bagian dari kumpulan agen baru.

Anda ingin berbagi sekumpulan mesin agen dengan beberapa, tetapi tidak semua, dari proyek Anda:

1. Buka Pengaturan untuk salah satu proyek. Tambahkan kumpulan agen, dan pilih opsi untuk membuat kumpulan baru di tingkat organisasi.
2. Buka proyek lain dan buat kumpulan di masing-masing proyek tersebut. Pilih Gunakan kumpulan agen yang sudah ada dari organisasi.
3. Instal dan konfigurasikan agen untuk menjadi bagian dari kumpulan agen bersama.

Keamanan kumpulan agen

Ketika Anda memahami cara kerja keamanan untuk kumpulan agen, Anda dapat mengontrol berbagi dan penggunaan agen dengan lebih baik.

Peran didefinisikan pada setiap kumpulan agen. Keanggotaan dalam peran ini mengatur operasi apa yang dapat Anda lakukan pada kumpulan agen.

Pengaturan keamanan tingkat organisasi

Peran pada kumpulan agen di Pengaturan Organisasi	Tujuan
Reader	Anggota peran ini dapat melihat kumpulan agen dan agen. Anda biasanya menggunakan peran ini untuk menambahkan operator yang bertanggung jawab untuk memantau agen dan kesehatannya.
Akun Layanan	Anggota peran ini dapat menggunakan kumpulan agen organisasi untuk membuat kumpulan agen proyek dalam sebuah proyek. Jika Anda mengikuti panduan sebelumnya untuk membuat kumpulan agen proyek baru, Anda biasanya tidak perlu menambahkan anggota apa pun di sini.
Administrator	Selain semua izin di atas, anggota peran ini dapat mendaftarkan atau membatalkan pendaftaran agen dari kumpulan agen organisasi. Mereka juga dapat merujuk ke kumpulan agen organisasi saat membuat kumpulan agen proyek dalam proyek. Mereka juga dapat mengelola keanggotaan untuk semua peran kumpulan agen organisasi. Pengguna yang membuat kumpulan agen organisasi secara otomatis diberi peran Administrator untuk kumpulan tersebut.

Simpul Semua kumpulan agen pada tab Kumpulan Agen mengontrol keamanan semua kumpulan agen organisasi. Keanggotaan peran untuk kumpulan agen organisasi individu secara otomatis diwarisi dari simpul Semua kumpulan agen . Secara default, administrator Azure DevOps Server juga merupakan administrator dari simpul Semua kumpulan agen saat menggunakan Azure DevOps Server.

Pengaturan keamanan tingkat proyek

Peran juga didefinisikan pada setiap kumpulan agen proyek. Keanggotaan dalam peran ini mengatur operasi apa yang dapat Anda lakukan pada kumpulan agen di tingkat proyek.

Peran dalam kumpulan agen di Pengaturan Proyek	Tujuan
Reader	Anggota peran ini dapat melihat kumpulan agen proyek. Anda biasanya menggunakan peran ini untuk menambahkan operator yang memantau tugas build dan deployment dalam kumpulan agen proyek tersebut.
User	Anggota peran ini dapat menggunakan kumpulan agen proyek saat mereka menulis alur.
Administrator	Selain semua operasi di atas, anggota peran ini dapat mengelola keanggotaan untuk semua peran kumpulan agen proyek. Pengguna yang membuat kumpulan agen organisasi secara otomatis diberi peran Administrator untuk kumpulan tersebut.

Izin Alur Kerja

Izin jalur pipa mengatur alur YAML mana yang berwenang menggunakan kumpulan agen. Izin alur tidak membatasi akses dari alur klasik.

Pilih dari salah satu proses berikut:

• Buka akses untuk semua alur untuk menggunakan kumpulan agen dari opsi lainnya di sudut kanan atas bagian Izin alur pada tab keamanan kumpulan agen.
• Kunci kumpulan agen dan hanya izinkan alur YAML yang dipilih untuk menggunakannya. Jika alur YAML lainnya mengacu pada kumpulan agen, permintaan otorisasi akan diajukan, yang harus disetujui oleh Administrator kumpulan agen. Proses ini tidak membatasi akses dari alur klasik.

Izin alur untuk kumpulan agen Azure Pipelines tidak dapat dikonfigurasi, karena kumpulan dapat diakses oleh semua alur secara default.

Tindakan Keamanan pada tab Kumpulan agen mengontrol keamanan semua kumpulan agen proyek dalam proyek. Keanggotaan peran untuk setiap kumpulan agen proyek secara otomatis diwarisi dari definisi yang Anda tetapkan di sini. Secara default, grup berikut ditambahkan ke peran Administrator dari Semua kumpulan agen: Administrator Build, Administrator Rilis, dan Administrator Proyek.

FAQ

Jika saya tidak menjadwalkan jendela pemeliharaan, kapan agen menjalankan pemeliharaan?

Jika Anda tidak menjadwalkan jendela waktu, agen di kumpulan tersebut tidak akan menjalankan pekerjaan pemeliharaan.

Apa itu pekerjaan pemeliharaan?

Anda dapat mengonfigurasi kumpulan agen untuk membersihkan direktori dan repositori kerja kedaluarsa secara berkala. Proses ini mengurangi potensi agen kehabisan ruang disk. Pekerjaan pemeliharaan dikonfigurasi pada tingkat organisasi di pengaturan kumpulan Agen .

Mengonfigurasi pengaturan pekerjaan pemeliharaan:

1. Masuk ke organisasi Anda (https://dev.azure.com/{yourorganization}).

2. PilihPengaturan Organisasi>.

   

3. Pilih Kumpulan agen.

   

Pilih kumpulan yang diinginkan, lalu pilih Pengaturan untuk mengonfigurasi pengaturan pekerjaan pemeliharaan untuk kumpulan agen tersebut.

Penting

Anda harus memiliki izin Kelola antrean build untuk mengonfigurasi pengaturan pekerjaan pemeliharaan. Jika Anda tidak melihat tab Pengaturan atau Riwayat Pemeliharaan , Anda tidak memiliki izin tersebut, yang dimiliki peran Administrator secara default. Untuk informasi selengkapnya, lihat Keamanan kumpulan agen.

Konfigurasikan pengaturan yang Anda inginkan, lalu pilih Simpan.

Pilih Riwayat Pemeliharaan untuk melihat riwayat pekerjaan pemeliharaan untuk kumpulan agen saat ini. Anda dapat mengunduh dan meninjau log untuk melihat langkah-langkah pembersihan dan tindakan yang diambil.

Pemeliharaan dilakukan per kumpulan agen, bukan per mesin. Jika Anda memiliki beberapa kumpulan agen pada satu komputer, Anda mungkin masih mengalami masalah ruang disk.

Pekerjaan pemeliharaan kumpulan agen yang dihosting sendiri tampak terhenti. Mengapa?

Biasanya, pekerjaan pemeliharaan terhambat saat menunggu dijalankan di agen yang tidak lagi termasuk dalam kumpulan agen. Misalnya, agen sengaja dimatikan, atau ada masalah saat berkomunikasi dengannya.

Pekerjaan pemeliharaan yang diantrekan untuk dijalankan menunggu selama tujuh hari untuk dijalankan. Jika tidak dijalankan selama waktu tersebut, mereka secara otomatis berada dalam status gagal. Anda tidak dapat mengubah batas waktu ini.

Batas tujuh hari berbeda dengan pengaturan batas waktu tugas pemeliharaan. Yang terakhir mengontrol jumlah menit maksimum yang dapat dihabiskan agen untuk melakukan pemeliharaan. Timer dimulai ketika tugas dimulai, bukan ketika tugas diantrekan di agen.

Saya mencoba membuat kumpulan agen proyek yang menggunakan kumpulan agen organisasi yang ada, tetapi kontrolnya tidak tersedia. Mengapa?

Dalam dialog Buat kumpulan agen proyek , Anda tidak dapat menggunakan kumpulan agen organisasi yang ada jika kumpulan agen proyek lain sudah mereferensikannya. Setiap kumpulan agen organisasi hanya dapat dirujuk oleh satu kumpulan agen proyek dalam kumpulan proyek.

Saya tidak dapat memilih kumpulan yang dihosting Microsoft dan saya tidak dapat mengantrekan build saya. Bagaimana cara memperbaiki masalah ini?

Minta pemilik organisasi Azure DevOps memberi Anda izin untuk menggunakan kumpulan. Lihat Keamanan kumpulan agen.

Saya perlu lebih banyak sumber daya build yang dihosting. Apa yang bisa saya lakukan?

Pool Azure Pipelines menyediakan semua organisasi Azure DevOps dengan agen build yang dihosting di cloud dan menit build gratis setiap bulan. Jika Anda memerlukan lebih banyak sumber daya build yang dihosting Microsoft, atau Anda perlu menjalankan lebih banyak pekerjaan secara paralel, maka Anda dapat:

• Menghosting agen Anda sendiri pada infrastruktur yang Anda kelola
• Beli lebih banyak pekerjaan paralel