Bagikan melalui

Panduan Cepat: Membuat Kumpulan DevOps Terkelola menggunakan Azure CLI

Artikel ini memperlihatkan kepada Anda cara membuat Kumpulan DevOps Terkelola menggunakan Azure CLI, dan menjalankan alur di dalamnya.

Prasyarat

  • Prasyarat Kumpulan DevOps Terkelola

    Sebelum menyelesaikan langkah-langkah dalam artikel ini, Anda harus mengonfigurasi langganan Azure dan organisasi Azure DevOps 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.

  • Prasyarat Azure CLI

    • Jika Anda ingin menjalankan perintah Azure CLI di komputer lokal Anda, lihat instruksi penginstalan Azure CLI. Jika Anda sudah menginstal Azure CLI, jalankan az version untuk memeriksa versi Anda. Ekstensi Azure CLI untuk Kumpulan DevOps Terkelola memerlukan Azure CLI versi 2.57.0 atau yang lebih tinggi. Jika Azure CLI Anda lebih rendah dari 2.57.0, jalankan az upgrade. Untuk informasi selengkapnya, lihat Cara memperbarui Azure CLI.

    • Jika Anda ingin menggunakan Azure Cloud Shell melalui browser Anda, ikuti instruksi di Memulai sesi ephemeral Azure Cloud Shell untuk mendaftarkan namespace Microsoft.CloudShell . Anda hanya perlu mendaftarkan namespace sekali per langganan.

      Contoh berikut menggunakan bash, jadi jika Anda menggunakan Azure Cloud Shell, pilih Bash saat memulai Azure Cloud Shell.

Masuk ke Azure CLI

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

  1. Masuk ke Azure CLI. Jika Anda menggunakan Azure Cloud Shell , Anda tidak perlu menjalankan az login kecuali Anda ingin menggunakan akun lain.

    az login

  2. 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.

Menentukan variabel lingkungan

  1. Jalankan perintah berikut untuk menciptakan nama sumber daya dalam panduan cepat ini. Contoh ini menggunakan EastUS2 wilayah . Ganti EastUS2 dengan wilayah yang Anda inginkan.

    export REGION=EastUS2
export RANDOM_ID="$(openssl rand -hex 3)"
export RESOURCE_GROUP_NAME="myManagedDevOpsPoolGroup$RANDOM_ID"
export POOL_NAME="mdpPool$RANDOM_ID"
export DEV_CENTER_NAME="mdpDevCenter$RANDOM_ID"
export DEV_CENTER_PROJECT_NAME="mdpDevCenterProject$RANDOM_ID"

# Echo the generated resource names
echo $REGION
echo $RESOURCE_GROUP_NAME
echo $POOL_NAME
echo $DEV_CENTER_NAME
echo $DEV_CENTER_PROJECT_NAME

Buat grup sumber daya

  1. Jalankan perintah berikut untuk membuat grup sumber daya yang akan menampung sumber daya yang digunakan dalam panduan cepat ini.

    az group create --name $RESOURCE_GROUP_NAME --location $REGION

Membuat pusat pengembangan dan proyek pusat pengembangan

  1. Jalankan perintah berikut, yang menginstal ekstensi Azure CLI devcenter jika tidak diinstal, dan memperbaruinya ke versi terbaru jika sudah diinstal.

    az extension add --name devcenter --upgrade

  2. Jalankan perintah berikut untuk membuat pusat pengembangan dan proyek pusat pengembangan.

    # Create a dev center
az devcenter admin devcenter create -n $DEV_CENTER_NAME \
    -g $RESOURCE_GROUP_NAME \
    -l $REGION

# Save the id of the newly created dev center
DEVCID=$( \
    az devcenter admin devcenter show -n $DEV_CENTER_NAME \
    -g $RESOURCE_GROUP_NAME \
    --query id -o tsv)

# Create a dev center project
az devcenter admin project create -n $DEV_CENTER_PROJECT_NAME \
    --description "My dev center project." \
    -g $RESOURCE_GROUP_NAME \
    -l $REGION \
    --dev-center-id $DEVCID

# Save the dev center project for use when creating
# the Managed DevOps Pool
DEVCPID=$( \
    az devcenter admin project show -n $DEV_CENTER_PROJECT_NAME \
    -g $RESOURCE_GROUP_NAME \
    --query id -o tsv)

    Setelah beberapa saat, output menunjukkan bahwa pusat pengembangan telah dibuat. Pusat pengembangan yang dibuat disimpan di id dan digunakan di DEVCID untuk membuat proyek pusat pengembangan.

    {
    "devCenterUri": "https://...",
    "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/resourceGroupName/providers/Microsoft.DevCenter/devcenters/devCenterName",
    "location": "eastus",
    "name": "devCenterName",
    "provisioningState": "Succeeded",
    "resourceGroup": "resourceGroupName",
    "systemData": { ... },
    "type": "microsoft.devcenter/devcenters"
}

    Setelah beberapa saat lagi, output menunjukkan bahwa proyek pusat pengembangan dibuat. Proyek id pusat pengembangan yang dibuat disimpan di DEVCPID dan digunakan saat membuat Kumpulan DevOps Terkelola di bagian berikutnya.

    {
  "description": "My dev center project.",
  "devCenterId": "...",
  "devCenterUri": "https://...",
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/resourceGroupName/providers/Microsoft.DevCenter/projects/devCenterProjectName",
  "location": "eastus",
  "name": "devCenterProjectName",
  "provisioningState": "Succeeded",
  "resourceGroup": "resourceGroupName",
  "systemData": { ... },
  "type": "microsoft.devcenter/projects"
}

Menyiapkan file konfigurasi Kumpulan DevOps Terkelola

Metode mdp pool create memiliki beberapa parameter yang menerima nilai JSON yang mengonfigurasi berbagai aspek dari pool.

  • agent-profile menentukan apakah kumpulan bersifat stateful atau stateless, dan berisi jadwal agen siaga. Ini adalah kamus dengan satu kunci dengan nama Stateful atau Stateless, tergantung pada konfigurasi agen yang Anda inginkan. Untuk informasi selengkapnya tentang agent-profile properti, lihat Mengonfigurasi penskalaan.
  • fabric-profile menentukan ukuran agen, gambar VM, disk OS, dan penyimpanan terlampir. Untuk informasi selengkapnya tentang fabric-profile properti, lihat Mengonfigurasi pengaturan kumpulan dan Mengonfigurasi penyimpanan tambahan.
  • organization-profile menentukan organisasi dan proyek Azure DevOps yang dapat menggunakan kumpulan. Untuk informasi selengkapnya tentang organization-profile pengaturan, lihat Mengonfigurasi pengaturan keamanan - Mengonfigurasi akses organisasi.

Buat tiga file berikut dan simpan ke folder tempat Anda berencana menjalankan perintah Azure CLI untuk membuat kumpulan.

  1. Buat file bernama agent-profile.json dengan konten berikut.

    {
  "Stateless": {}
}

    Konfigurasi ini menentukan stateless agent untuk kumpulan Anda.

  2. Buat file bernama fabric-profile.json dengan konten berikut.

    {
  "vmss": {
    "sku": {
      "name": "Standard_D2as_v5"
    },
    "images": [
      {
        "aliases": [
          "ubuntu-24.04"
        ],
        "buffer": "*",
        "wellKnownImageName": "ubuntu-24.04/latest"
      }
    ],
    "osProfile": {
      "secretsManagementSettings": {
        "observedCertificates": [],
        "keyExportable": false
      },
      "logonType": "Service"
    },
    "storageProfile": {
      "osDiskStorageAccountType": "Standard",
      "dataDisks": []
    }
  }
}

    Konfigurasi ini menentukan kumpulan menggunakan gambar Standard_D2as_v5, gambar Azure Pipelinesubuntu-24.04, dan jenis Disk OSStandar tanpa disk data yang terpasang.

  3. Buat file bernama organization-profile.json dengan konten berikut. Ganti <organization-name> dengan nama untuk organisasi Azure DevOps Anda.

    {
  "AzureDevOps": {
    "organizations": [
      {
        "url": "https://dev.azure.com/<organization-name>",
        "projects": [],
        "parallelism": 1
      }
    ],
    "permissionProfile": {
      "kind": "CreatorOnly"
    }
  }
}

    Konfigurasi ini menentukan kumpulan yang tersedia untuk semua proyek di organisasi Azure DevOps Anda.

Membuat Kumpulan DevOps Terkelola

  1. Jalankan perintah berikut, yang menginstal ekstensi Azure CLI mdp jika tidak diinstal, dan memperbaruinya ke versi terbaru jika sudah diinstal.

     az extension add --name mdp --upgrade

  2. Buat Kumpulan DevOps Terkelola dengan menjalankan perintah az mdp pool create berikut.

    az mdp pool create -n $POOL_NAME \
   -g $RESOURCE_GROUP_NAME \
   -l $REGION \
   --devcenter-project-id $DEVCPID \
   --maximum-concurrency 1 \
   --agent-profile agent-profile.json \
   --fabric-profile fabric-profile.json \
   --organization-profile organization-profile.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 2, 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

  1. Masuk ke portal Azure.

  2. Cari Pool DevOps Terkelola dan pilih dari opsi yang tersedia.

  3. Pilih Kumpulan DevOps Terkelola baru Anda dari daftar.

  4. Pilih Tampilan JSON untuk melihat format JSON sumber daya Kumpulan DevOps Terkelola Anda.

    Cuplikan layar tombol Tampilan JSON dalam gambaran umum kumpulan.

Menampilkan kumpulan agen di Azure DevOps

  1. Buka portal Azure DevOps dan masuk ke organisasi Azure DevOps Anda (https://dev.azure.com/{your-organization}).

  2. Pergi ke Azure DevOps>pengaturan Organisasi.

    Cuplikan layar tombol Pengaturan organisasi.

  3. 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.

    Cuplikan layar daftar kumpulan Agen.

Jalankan pipeline di kumpulan baru Anda

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

  1. Buka portal Azure DevOps dan masuk ke organisasi Azure DevOps Anda (https://dev.azure.com/{your-organization}).

  2. Buka proyek tempat Anda ingin menjalankan pipeline, dan pilih Pipeline.

    Cuplikan layar daftar Proyek.

  3. Pilih Alur baru (atau Buat Alur jika ini adalah alur pertama Anda).

    Tangkapan layar tombol pipa baru.

  4. Pilih Azure Repos Git.

    Cuplikan layar jenis repositori.

  5. 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.

    Cuplikan layar repositori FabrikamFiber.

  6. Pilih Pipeline Pemula.

    Cuplikan layar daftar templat alur.

  7. 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-pool, dan tentukan nama Kumpulan DevOps Terkelola Anda.

    # Replace fabrikam-managed-pools with the name
# of your Managed DevOps Pool.
pool:
  name: fabrikam-managed-pool

  8. Pilih Simpan dan jalankan, dan pilih Simpan dan jalankan untuk kedua kalinya untuk mengonfirmasi.

    Cuplikan layar tombol simpan dan jalankan.

  9. Jika ini adalah pelaksanaan pipeline pertama di kumpulan ini, Anda mungkin diminta untuk memberikan izin sebelum pipeline dijalankan. Untuk informasi selengkapnya, lihat Alur ini memerlukan izin untuk mengakses sumber daya sebelum eksekusi ini dapat dilanjutkan.

  10. Tonton pipeline berjalan di Azure DevOps, dan Anda dapat beralih ke portal Azure dan melihat agen yang sedang berjalan di tampilan Agents.

Membersihkan sumber daya

Jika Anda tidak akan terus menggunakan aplikasi ini, hapus grup sumber daya, pusat dev, proyek pusat pengembangan, dan Kumpulan DevOps Terkelola. Panduan cepat ini telah membuat semua sumber daya dalam grup sumber daya baru, sehingga Anda dapat menghapus semuanya dengan menggunakan perintah az group delete untuk menghapus grup sumber daya beserta seluruh sumber dayanya.

az group delete -n $RESOURCE_GROUP_NAME

Lihat juga

  • Last updated on