Panduan Cepat: Membuat Kumpulan DevOps Terkelola menggunakan templat ARM

Artikel ini memperlihatkan kepada Anda cara membuat Kumpulan DevOps Terkelola menggunakan templat ARM, dan menjalankan alur di kumpulan baru.

Prasyarat

Sebelum menyelesaikan langkah-langkah dalam artikel ini, pastikan telah mengonfigurasi langganan Azure dan organisasi Azure DevOps Anda untuk digunakan dengan Kumpulan DevOps Terkelola, seperti yang dijelaskan dalam artikel Prasyarat. Langkah-langkah ini perlu diselesaikan hanya sekali per langganan Azure dan organisasi Azure DevOps.

Buka prompt perintah (di Windows, gunakan Windows Command Prompt atau PowerShell) dan jalankan perintah berikut.

Masuk ke Azure CLI.
```
az login
```
Jika Anda memiliki lebih dari satu langganan Azure, atur langganan Azure default Anda.
```
az account set --subscription "My subscription name"
```
Untuk mendapatkan daftar langganan, Anda bisa menjalankan perintah berikut.
```
az account list -o table
```
Jika Anda memiliki beberapa penyewa, atau ingin melihat informasi selengkapnya tentang bekerja dengan langganan Azure menggunakan Azure CLI, lihat Cara mengelola langganan Azure dengan Azure CLI.

Membuat grup sumber daya, Dev Center, dan Dev Center Project

Ikuti langkah-langkah Buat pusat pengembangan di Membuat dan mengonfigurasi pusat pengembangan untuk Lingkungan Penyebaran Azure dengan menggunakan Azure CLI.

Anda hanya perlu mengikuti langkah-langkah di bagian Buat pusat pengembangan. Catat nama grup sumber daya dan nama Pusat Dev.
Ikuti langkah-langkah Buat proyek di Membuat dan mengonfigurasi proyek dengan menggunakan Azure CLI.

Catat id proyek yang dibuat (bukan devCenterId).

Meninjau dan menyimpan templat

Buat nama file lokal mdp-azure-deploy.json dengan konten berikut. File ini adalah templat ARM berparameter yang membuat microsoft.devopsinfrastructure/pools sumber daya.

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "poolName": {
            "type": "string"
        },
        "adoOrg": {
            "type": "string"
        },
        "devCenterResourceId": {
            "type": "string"
        },
        "imageName": {
            "type": "string"
        },
        "poolSize": {
            "type": "int"
        },
        "location": {
            "type": "string",
            "defaultValue": "eastus"
        }
    },
    "variables": {},
    "resources": [
        {
            "name": "[parameters('poolName')]",
            "type": "microsoft.devopsinfrastructure/pools",
            "apiVersion": "2025-09-20",
            "location": "[parameters('location')]",
            "tags": {},
            "properties": {
                "organizationProfile": {
                    "organizations": [
                        {
                            "url": "[parameters('adoOrg')]",
                            "parallelism": 1
                        }
                    ],
                    "permissionProfile": {
                        "kind": "CreatorOnly"
                    },
                    "kind": "AzureDevOps"
                },
                "devCenterProjectResourceId": "[parameters('devCenterResourceId')]",
                "maximumConcurrency": "[parameters('poolSize')]",
                "agentProfile": {
                    "kind": "Stateless"
                },
                "fabricProfile": {
                    "sku": {
                        "name": "Standard_D2ads_v5"
                    },
                    "images": [
                        {
                            "wellKnownImageName": "[parameters('imageName')]",
                            "buffer": "*"
                        }
                    ],
                    "kind": "Vmss"
                }
            }
        }
    ]
}

Buat file lokal lain bernama mdp-azure-deploy-parameters.json dan simpan di folder yang sama dengan file pertama. Perbarui properti berikut agar sesuai dengan detail lingkungan Anda.

Pengaturan	Nilai
`poolName`	Perbarui `value` dengan nama kumpulan yang diinginkan. Nama harus terdiri dari karakter alfanumerik, `.`, , `-`atau `_`, dan panjangnya antara 3 dan 44 karakter. Namanya harus unik secara global di Azure.
`adoOrg`	Perbarui `value` dan ganti `your-organization` dengan nama organisasi Azure DevOps Anda.
`devCenterResourceId`	Perbarui `value` dengan `id` dari langkah buat grup sumber daya, Dev Center, dan Dev Center Project sebelumnya.
`imageName`	Contoh ini dikonfigurasi untuk menggunakan image Azure Pipelines, dan menggunakan image Windows Server 2022. Jika Anda ingin mengubahnya, pilih dari alias gambar Azure Pipelines yang telah ditentukan sebelumnya. Kumpulan DevOps Terkelola juga mendukung gambar Azure Compute Gallery dan gambar marketplace yang dipilih. Untuk informasi tentang mengonfigurasi sumber daya Kumpulan DevOps Terkelola untuk tipe gambar ini, lihat Mengonfigurasi gambar pada Kumpulan DevOps Terkelola.
`poolSize`	Perbarui `value` dengan jumlah maksimum agen yang Anda inginkan untuk dapat menjalankan pekerjaan bersamaan. Dalam contoh `poolSize` ini adalah `1`.
`location`	Wilayah Azure untuk kumpulan sumber daya. Dalam contoh ini, wilayahnya adalah `eastus`.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "poolName": {
            "value": "my-first-managed-pool"
        },
        "adoOrg": {
            "value": "https://dev.azure.com/your-organization"
        },
        "devCenterResourceId": {
            "value": "/subscriptions/subscription_id_placeholder/resourceGroups/fabrikam-managed-devops-pools/providers/Microsoft.DevCenter/projects/fabrikam-dev-center-project"
        },
        "imageName": {
            "value": "windows-2022"
        },
        "poolSize": {
            "value": 1
        },
        "location": {
            "value": "eastus"
        }
    }
}

Membuat Kelompok DevOps Terkelola

Buka prompt perintah (di Windows, gunakan Windows Command Prompt atau PowerShell) dan jalankan perintah berikut. Anda dapat melewati dua perintah pertama jika sesi Azure CLI Anda dari prosedur pertama masih aktif.

Masuk ke Azure CLI.
```
az login
```
Jika Anda memiliki lebih dari satu langganan Azure, atur langganan Azure default Anda.
```
az account set --subscription "My subscription name"
```
Untuk mendapatkan daftar langganan, Anda bisa menjalankan perintah berikut.
```
az account list -o table
```
Jika Anda memiliki beberapa penyewa, atau ingin melihat informasi selengkapnya tentang bekerja dengan langganan Azure menggunakan Azure CLI, lihat Cara mengelola langganan Azure dengan Azure CLI.
Buka folder saat Anda menyimpan dua file JSON dari langkah sebelumnya. Dalam contoh ini, file disimpan ke C:\examples.
```
cd c:\examples
```
Buat Kumpulan DevOps Terkelola. Ganti <resourceGroupName> dengan grup sumber daya yang dibuat pada langkah pertama.
```
az deployment group create --resource-group <resourceGroupName> --template-file mdp-azure-deploy.json --parameters mdp-azure-deploy-parameters.json
```
Jika langganan Anda tidak memiliki kapasitas untuk mengonfigurasi kumpulan Anda dengan SKU Azure VM yang diinginkan dan jumlah agen maksimum, pembuatan kumpulan gagal dengan kesalahan yang mirip dengan pesan berikut. Cores needed to complete this request is 8, which exceeds the current limit of 0 for SKU family standardDDSv4Family in region eastus. Please choose a different region if possible, or request additional quota at https://portal.azure.com/#view/Microsoft_Azure_Support/NewSupportRequestV3Blade/issueType/quota/subscriptionId/subscription_id_placeholder/topicId/3eadc5d3-b59a-3658-d8c6-9c729ba35b97. Untuk mengatasi masalah ini, lihat Meninjau kuota Kumpulan DevOps Terkelola.

Menampilkan kumpulan yang Anda buat di portal Azure

Masuk ke portal Azure.
Cari Kelompok DevOps Terkelola lalu pilih dari opsi yang tersedia.
Pilih Kumpulan DevOps Terkelola baru Anda dari daftar.
Pilih Tampilan JSON untuk melihat format JSON sumber daya Kumpulan DevOps Terkelola Anda.

Menampilkan kumpulan agen di Azure DevOps

Buka portal Azure DevOps dan masuk ke organisasi Azure DevOps Anda (https://dev.azure.com/{your-organization}).
Pergi ke Azure DevOps>Pengaturan Organisasi.
Masuk ke Alur>Kumpulan Agen, dan verifikasi bahwa kumpulan baru Anda tercantum. Jika Anda baru saja membuat Kumpulan DevOps Terkelola, diperlukan beberapa saat agar kumpulan baru muncul di daftar agen.

Menjalankan pipeline di dalam pool baru Anda

Dalam langkah ini, kita akan membuat alur sederhana di repositori default proyek Azure DevOps dan menjalankannya di Kumpulan DevOps Terkelola baru Anda.

Buka portal Azure DevOps dan masuk ke organisasi Azure DevOps Anda (https://dev.azure.com/{your-organization}).
Pergi ke proyek tempat Anda ingin menjalankan pipeline, dan pilih Pipelines.
Pilih Alur baru (atau Buat Alur jika ini adalah alur pertama Anda).
Pilih Azure Repos Git.
Pilih repositori yang memiliki nama yang sama dengan proyek Anda. Dalam contoh ini, proyek diberi nama FabrikamFiber, jadi kami memilih repositori dengan nama yang sama.
Pilih Starter pipeline.
Secara default, templat pemula menggunakan agen Linux yang dihosting Microsoft. Edit templat alur dan ubah bagian pool sehingga mengacu pada kumpulan yang Anda buat di langkah sebelumnya.
```
# Change these two lines as shown in the following example.
 pool:
  vmImage: ubuntu-latest
```
Dalam contoh ini, Kumpulan DevOps Terkelola diberi nama fabrikam-managed-pool, jadi ganti vmImage: ubuntu-latest dengan name: fabrikam-managed-pools, dan tentukan nama Kumpulan DevOps Terkelola Anda.
```
# Replace fabrikam-managed-pools with the name
# of your Managed DevOps Pool.
pool:
  name: fabrikam-managed-pool
```
Pilih Simpan dan jalankan, dan pilih Simpan dan jalankan untuk kedua kalinya untuk mengonfirmasi.
Jika ini adalah jalankan pipeline pertama di pool ini, Anda mungkin diminta untuk memberikan izin sebelum pipeline berjalan. Untuk informasi selengkapnya, lihat Alur ini memerlukan izin untuk mengakses sumber daya sebelum eksekusi ini dapat dilanjutkan.
Tonton jalannya pipeline di Azure DevOps, dan Anda dapat beralih ke portal Azure dan melihat agen yang sedang berjalan di tampilan Agen.

Membersihkan sumber daya

Saat Anda telah menyelesaikan mulai cepat, hapus sumber daya yang dibuat jika Anda tidak ingin terus menggunakannya.

Untuk menghapus Kumpulan DevOps Terkelola, Dev Center, dan Proyek Dev Center, Anda dapat menghapusnya dengan menghapus grup sumber daya yang berisinya.

Lihat juga

Referensi templat ARM untuk Kumpulan DevOps yang Dikelola

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2025-07-29