Konfigurasikan alur kerja CI/CD Anda secara manual untuk menjalankan pengujian beban

Artikel
12/15/2023

Anda dapat mengotomatiskan pengujian beban di Azure Load Testing dengan membuat alur CI/CD. Dalam artikel ini, Anda mempelajari cara mengonfigurasi GitHub Actions, Azure Pipelines, atau alat CI lainnya secara manual untuk memanggil pengujian yang ada di Azure Load Testing. Otomatiskan pengujian beban untuk terus memvalidasi performa dan stabilitas aplikasi Anda di bawah beban.

Untuk menambahkan uji beban yang ada ke alur CI/CD:

Konfigurasikan autentikasi layanan untuk memungkinkan alat CI tersambung ke sumber daya pengujian beban Azure Anda.
Tambahkan file input pengujian beban ke repositori Anda, seperti skrip pengujian JMeter dan konfigurasi YAML uji beban.
Perbarui definisi alur CI/CD untuk memanggil Azure Load Testing.

Prasyarat

Akun Azure dengan langganan aktif. Buat akun secara gratis.
Pengujian Azure Load Testing. Buat pengujian beban berbasis URL atau gunakan skrip JMeter yang ada untuk membuat uji beban.

Organisasi dan proyek Azure DevOps. Jika Anda tidak memiliki organisasi Azure DevOps, Anda dapat membuatnya secara gratis. Jika Anda memerlukan bantuan untuk mulai menggunakan Azure Pipelines, lihat Membuat alur pertama Anda.

Mengonfigurasi autentikasi layanan

Untuk menjalankan uji beban di alur kerja CI/CD, Anda perlu memberikan izin ke alur kerja CI/CD untuk mengakses sumber daya pengujian beban Anda. Buat perwakilan layanan untuk alur kerja CI/CD dan tetapkan peran Azure RBAC Kontributor Uji Beban.

Membuat koneksi layanan di Azure Pipelines

Di Azure Pipelines, Anda membuat koneksi layanan di proyek Azure DevOps untuk mengakses sumber daya di langganan Azure Anda. Saat Anda membuat koneksi layanan, Azure DevOps membuat objek perwakilan layanan Microsoft Entra.

Masuk ke organisasi Azure DevOps Anda (https://dev.azure.com/<your-organization>), dan pilih proyek Anda.

<your-organization> Ganti tempat penampung teks dengan pengidentifikasi proyek Anda.
Pilih Pengaturan>proyek Koneksi layanan>+ Koneksi layanan baru.
Di panel Koneksi layanan baru, pilih Azure Resource Manager, lalu pilih Berikutnya.
Pilih metode autentikasi Perwakilan Layanan (otomatis), lalu pilih Berikutnya.

Masukkan detail koneksi layanan, lalu pilih Simpan untuk membuat koneksi layanan.

Bidang	Nilai
Tingkat cakupan	Langganan.
Langganan	Pilih langganan Azure yang menghosting sumber daya pengujian beban Anda.
Grup sumber daya	Pilih grup sumber daya yang berisi sumber daya pengujian beban Anda.
Nama koneksi layanan	Masukkan nama unik untuk koneksi layanan.
Memberikan izin akses ke semua alur	Diperiksa.

Dari daftar koneksi layanan, pilih koneksi yang Anda buat sebelumnya, lalu pilih Kelola Perwakilan Layanan.

portal Azure terbuka di tab browser terpisah dan menampilkan detail perwakilan layanan.
Di portal Azure, salin nilai Nama tampilan.

Anda menggunakan nilai ini di langkah berikutnya untuk memberikan izin untuk menjalankan pengujian beban kepada perwakilan layanan.

Memberikan akses ke Azure Load Testing

Azure Load Testing menggunakan Azure RBAC untuk memberikan izin untuk melakukan aktivitas tertentu pada sumber daya pengujian beban Anda. Untuk menjalankan uji beban dari alur CI/CD, Anda memberikan peran Kontributor Uji Beban kepada perwakilan layanan.

Di portal Azure, buka sumber daya Azure Load Testing Anda.
Pilih Kontrol akses (IAM)>Tambahkan>penetapan peran.
Di tab Peran , pilih Muat Kontributor Uji dalam daftar peran fungsi pekerjaan.
Di tab Anggota , pilih Pilih anggota, lalu gunakan nama tampilan yang Anda salin sebelumnya untuk mencari perwakilan layanan.
Pilih perwakilan layanan, lalu pilih Pilih.
Di tab Tinjau + tetapkan, pilih Tinjau + tetapkan untuk menambahkan penetapan peran.

Sekarang Anda dapat menggunakan koneksi layanan dalam definisi alur kerja Azure Pipelines Anda untuk mengakses sumber daya pengujian beban Azure Anda.

Untuk mengakses sumber daya Azure Load Testing dari alur kerja GitHub Actions, Anda terlebih dahulu membuat perwakilan layanan Microsoft Entra. Perwakilan layanan ini mewakili alur kerja GitHub Actions Anda di ID Microsoft Entra.

Selanjutnya, Anda memberikan izin kepada perwakilan layanan untuk membuat dan menjalankan pengujian beban dengan sumber daya Azure Load Testing Anda.

Membuat perwakilan layanan

Buat perwakilan layanan di langganan Azure dan tetapkan peran Kontributor Uji Beban sehingga alur kerja GitHub Actions Anda memiliki akses ke sumber daya pengujian beban Azure Anda untuk menjalankan pengujian beban.

Buat perwakilan layanan dan tetapkan Load Test Contributor peran:

# Get the resource ID for the load testing resource - replace the text place holders.
loadtest=$(az resource show -g <resource-group-name> -n <load-testing-resource-name> --resource-type "Microsoft.LoadTestService/loadtests" --query "id" -o tsv)
echo $loadtest

# Create a service principal and assign the Load Test Contributor role - the scope is limited to the load testing resource.
az ad sp create-for-rbac --name "my-load-test-cicd" --role "Load Test Contributor" \
                         --scopes $loadtest \
                         --json-auth

Output adalah objek JSON yang mewakili perwakilan layanan. Anda menggunakan informasi ini untuk mengautentikasi dengan Azure dalam alur kerja GitHub Actions.

Creating 'Load Test Contributor' role assignment under scope
{
  "clientId": "00000000-0000-0000-0000-000000000000",
  "clientSecret": "00000000-0000-0000-0000-000000000000",
  "subscriptionId": "00000000-0000-0000-0000-000000000000",
  "tenantId": "00000000-0000-0000-0000-000000000000",
  "activeDirectoryEndpointUrl": "https://login.microsoftonline.com",
  "resourceManagerEndpointUrl": "https://management.azure.com/",
  "activeDirectoryGraphResourceId": "https://graph.windows.net/",
  "sqlManagementEndpointUrl": "https://management.core.windows.net:8443/",
  "galleryEndpointUrl": "https://gallery.azure.com/",
  "managementEndpointUrl": "https://management.core.windows.net/"    
}

Catatan

Anda mungkin mendapatkan --sdk-auth peringatan penghentian saat menjalankan perintah ini. Atau, Anda dapat menggunakan autentikasi berbasis OpenID Koneksi (OIDC) untuk mengautentikasi GitHub dengan Azure. Pelajari cara menggunakan tindakan masuk Azure dengan OpenID Koneksi.

Salin objek JSON output ke clipboard.

Pada langkah berikutnya, Anda menyimpan informasi perwakilan layanan sebagai rahasia GitHub Actions.

Menyimpan kredensial Azure di rahasia GitHub Actions

Buat rahasia GitHub Actions untuk menyimpan informasi perwakilan layanan dengan aman. Anda menggunakan rahasia ini dalam definisi alur kerja Anda untuk menyambungkan untuk mengautentikasi dengan Azure dan mengakses sumber daya pengujian beban Azure Anda.

Catatan

Jika Anda menggunakan OpenID Koneksi untuk mengautentikasi dengan Azure, Anda tidak perlu meneruskan objek perwakilan layanan dalam tindakan masuk Azure. Pelajari cara menggunakan tindakan masuk Azure dengan OpenID Koneksi.

Untuk membuat rahasia GitHub Actions:

Di GitHub, telusuri ke repositori Anda.
Pilih Pengaturan> Tindakan Keamanan & variabel.>
Pilih Rahasia repositori baru, masukkan informasi rahasia, lalu pilih Tambahkan rahasia untuk membuat rahasia baru.

Bidang Nilai

Nama AZURE_CREDENTIALS

Rahasia Tempelkan output JSON dari perintah pembuatan perwakilan layanan yang Anda salin sebelumnya.

Bidang	Nilai
Nama	AZURE_CREDENTIALS
Rahasia	Tempelkan output JSON dari perintah pembuatan perwakilan layanan yang Anda salin sebelumnya.

Sekarang Anda dapat mengakses langganan Azure dan memuat sumber daya pengujian dari alur kerja GitHub Actions Anda dengan menggunakan kredensial yang disimpan.

Jika Anda menggunakan alat CI/CD lain, Anda menggunakan Azure CLI untuk berinteraksi dengan sumber daya Azure Anda. Lakukan langkah-langkah berikut untuk mengotorisasi akses alat CI ke sumber daya pengujian beban Anda:

Buat perwakilan layanan Microsoft Entra untuk menyambungkan ke langganan Azure Anda dan mengakses sumber daya pengujian beban Azure Anda.
Berikan izin perwakilan layanan untuk membuat dan menjalankan pengujian beban dengan menetapkan peran Kontributor Uji Beban.
Simpan kredensial Azure dengan aman di alat CI.

Lakukan langkah-langkah berikut untuk mengonfigurasi otorisasi layanan untuk alat CI Anda:

Buat perwakilan layanan dan tetapkan peran Kontributor Uji Beban:

Ganti tempat penampung <resource-group-name> teks dan <load-testing-resource-name> .

# Get the resource ID for the load testing resource - replace the text place holders.
loadtest=$(az resource show -g <resource-group-name> -n <load-testing-resource-name> --resource-type "Microsoft.LoadTestService/loadtests" --query "id" -o tsv)
echo $loadtest

# Create a service principal and assign the Load Test Contributor role - the scope is limited to the load testing resource.
az ad sp create-for-rbac --name "my-load-test-cicd" --role "Load Test Contributor" \
                         --scopes $loadtest \
                         --json-auth

Output adalah objek JSON yang mewakili perwakilan layanan.

Creating 'Load Test Contributor' role assignment under scope
{
  "clientId": "00000000-0000-0000-0000-000000000000",
  "clientSecret": "00000000-0000-0000-0000-000000000000",
  "subscriptionId": "00000000-0000-0000-0000-000000000000",
  "tenantId": "00000000-0000-0000-0000-000000000000",
  "activeDirectoryEndpointUrl": "https://login.microsoftonline.com",
  "resourceManagerEndpointUrl": "https://management.azure.com/",
  "activeDirectoryGraphResourceId": "https://graph.windows.net/",
  "sqlManagementEndpointUrl": "https://management.core.windows.net:8443/",
  "galleryEndpointUrl": "https://gallery.azure.com/",
  "managementEndpointUrl": "https://management.core.windows.net/"    
}

clientIdSalin nilai , clientSecret, dan tenantId dan simpan dengan aman sebagai rahasia di alat CI Anda.

Anda menggunakan nilai-nilai ini untuk masuk ke langganan Azure Anda dengan perintah Azure CLI az login .

Menambahkan file uji beban di repositori Anda

Untuk menjalankan pengujian beban dengan Azure Load Testing dalam alur kerja CI/CD, Anda perlu menambahkan semua file input pengujian beban di repositori kontrol sumber Anda.

Jika Anda tidak memiliki pengujian beban yang sudah ada, tambahkan file berikut ke repositori kode sumber Anda:

Muat file YAML konfigurasi pengujian. Pelajari cara membuat file YAML konfigurasi pengujian beban.
File rencana pengujian. Untuk pengujian berbasis JMeter, tambahkan skrip uji JMeter (JMX file). Untuk pengujian berbasis URL, tambahkan file JSON permintaan.
File properti pengguna JMeter apa pun.
Setiap file data input yang digunakan rencana pengujian Anda. Misalnya, file data CSV.

Jika Anda memiliki pengujian beban yang ada, Anda dapat mengunduh pengaturan konfigurasi dan semua file input langsung dari portal Azure. Lakukan langkah-langkah berikut untuk mengunduh file input untuk pengujian beban yang ada di portal Azure:

Di portal Azure, buka sumber daya Azure Load Testing Anda.
Di panel kiri, pilih Pengujian untuk menampilkan daftar pengujian beban, lalu pilih pengujian Anda.
Memilih elipsis (...) di samping uji coba yang sedang Anda kerjakan, lalu pilih Unduh file input.

Browser mengunduh folder zip yang berisi file input uji beban.
Gunakan alat zip apa pun untuk mengekstrak file input.

Folder berisi file berikut:
- config.yaml: file konfigurasi YAML uji beban. Anda mereferensikan file ini dalam definisi alur kerja CI/CD.
- .jmx: skrip pengujian JMeter
- File input tambahan apa pun, seperti file CSV atau file properti pengguna yang diperlukan untuk menjalankan pengujian beban.
Terapkan semua file input yang diekstrak ke repositori kontrol sumber Anda.

Gunakan repositori kode sumber tempat Anda mengonfigurasi alur CI/CD.

Memperbarui definisi alur kerja CI/CD

Azure Load Testing mendukung GitHub Actions dan Azure Pipelines untuk menjalankan pengujian beban.

Menginstal ekstensi Azure Load Testing untuk Azure DevOps

Untuk membuat dan menjalankan pengujian beban, definisi alur kerja Azure Pipelines menggunakan ekstensi tugas Azure Load Testing dari Azure DevOps Marketplace.

Buka ekstensi tugas Azure Load Testing di Azure DevOps Marketplace, dan pilih Dapatkan gratis.
Pilih organisasi Azure DevOps Anda, lalu pilih Instal untuk menginstal ekstensi.

Jika Anda tidak memiliki hak istimewa administrator untuk organisasi Azure DevOps yang dipilih, pilih Minta untuk meminta administrator menginstal ekstensi.

Memperbarui alur kerja Azure Pipelines

Perbarui alur kerja Azure Pipelines Anda untuk menjalankan pengujian beban untuk sumber daya pengujian beban Azure Anda.

Masuk ke organisasi Azure DevOps Anda (https://dev.azure.com/<your-organization>), dan pilih proyek Anda.
Pilih Alur di navigasi kiri, pilih alur Anda, lalu pilih Edit untuk mengedit definisi alur kerja Anda.

Secara bergantian, pilih Buat Alur untuk membuat alur baru di Azure Pipelines.
AzureLoadTest Gunakan tugas untuk menjalankan uji beban.

Tentukan file konfigurasi uji beban yang Anda ekspor sebelumnya di loadTestConfigFile properti .

<load-testing-resource> Ganti tempat penampung teks dan <load-testing-resource-group> dengan nama sumber daya pengujian beban Azure dan grup sumber daya Anda.
```
    - task: AzureLoadTest@1
      inputs:
        azureSubscription: $(serviceConnection)
        loadTestConfigFile: 'config.yaml'
        loadTestResource: <load-testing-resource>
        resourceGroup: <load-testing-resource-group>
```
Secara opsional, Anda dapat meneruskan parameter atau rahasia ke pengujian beban dengan menggunakan env properti atau secrets .
publish Gunakan tugas untuk menerbitkan hasil pengujian sebagai artefak dalam eksekusi alur kerja Azure Pipelines Anda.
```
    - publish: $(System.DefaultWorkingDirectory)/loadTest
      artifact: loadTestResults
```

Memperbarui alur kerja GitHub Actions

Perbarui alur kerja GitHub Actions Anda untuk menjalankan uji beban untuk sumber daya pengujian beban Azure Anda.

Di GitHub, telusuri ke repositori Anda.
Edit alur kerja GitHub Actions Anda atau buat alur kerja baru di repositori GitHub Anda.
actions/checkout Gunakan tindakan untuk memeriksa repositori dengan file input uji beban.
```
    - name: Checkout
      uses: actions/checkout@v3
```
azure/login Gunakan tindakan untuk mengautentikasi dengan Azure dengan menggunakan kredensial yang disimpan.

Tempelkan konten YAML berikut dalam definisi alur kerja Anda:
```
    - name: Login to Azure
      uses: azure/login@v1
      continue-on-error: false
      with:
        creds: ${{ secrets.AZURE_CREDENTIALS }}
```
azure/load-testing Gunakan tindakan untuk menjalankan uji beban.

Tentukan file konfigurasi uji beban yang Anda ekspor sebelumnya di loadTestConfigFile properti .

<load-testing-resource> Ganti tempat penampung teks dan <load-testing-resource-group> dengan nama sumber daya pengujian beban Azure dan grup sumber daya Anda.
```
    - name: 'Azure Load Testing'
      uses: azure/load-testing@v1
      with:
        loadTestConfigFile: 'config.yaml'
        loadTestResource: <load-testing-resource>
        resourceGroup: <load-testing-resource-group>
```
Secara opsional, Anda dapat meneruskan parameter atau rahasia ke pengujian beban dengan menggunakan env properti atau secrets .
actions/upload-artifact Gunakan tindakan untuk menerbitkan hasil pengujian sebagai artefak dalam eksekusi alur kerja GitHub Actions Anda.
```
    - uses: actions/upload-artifact@v2
      with:
        name: loadTestResults
        path: ${{ github.workspace }}/loadTest
```

Perbarui alur kerja CI Anda untuk menjalankan uji beban untuk sumber daya pengujian beban Azure Anda dengan menggunakan Azure CLI. Gunakan spesifikasi alat CI Anda untuk menambahkan perintah berikut ke alur kerja CI Anda:

Masuk ke langganan Azure dengan menggunakan perwakilan layanan.

clientIdGunakan nilai , clientSecret, dan tenandId yang Anda simpan sebelumnya.
```
az login --service-principal -u $AZURE_CLIENT_ID -p $AZURE_CLIENT_SECRET -t $AZURE_TENANT_ID
az account set -s $AZURE_SUBSCRIPTION_ID
```
Buat pengujian beban dengan menggunakan file YAML konfigurasi uji beban.

<load-testing-resource>Ganti tempat penampung teks , <load-testing-resource-group>, dan <load-test-config-yaml> dengan nama sumber daya pengujian beban, nama grup sumber daya, dan nama file file YAML konfigurasi pengujian beban yang Anda tambahkan ke repositori sebelumnya.
```
az load test create --load-test-resource <load-testing-resource> --resource-group <load-testing-resource-group> --test-id sample-test-id --load-test-config-file <load-test-config-yaml>
```

Jalankan uji beban.

testRunId="run_"`date +"%Y%m%d%_H%M%S"`
displayName="Run"`date +"%Y/%m/%d_%H:%M:%S"`

az load test-run create --load-test-resource <load-testing-resource> --test-id sample-test-id --test-run-id $testRunId --display-name $displayName --description "Test run from CLI"

Mengambil dan menampilkan metrik sisi klien untuk eksekusi pengujian beban.

az load test-run metrics list --load-test-resource <load-testing-resource> --test-run-id $testRunId --metric-namespace LoadTestRunMetrics

Lihat hasil pengujian beban

Saat menjalankan uji beban dari alur CI/CD, Anda dapat melihat hasil ringkasan langsung di log output CI/CD. Jika Anda menerbitkan hasil pengujian sebagai artefak alur, Anda juga dapat mengunduh file CSV untuk pelaporan lebih lanjut.

Screenshot that shows the workflow logging information.

Membersihkan sumber daya

Jika Anda tidak berencana untuk menggunakan salah satu sumber daya yang Anda buat, hapus sumber daya tersebut sehingga Anda tidak dikenakan biaya lebih lanjut.

Hapus perubahan Azure Pipelines:
1. Masuk ke organisasi Azure DevOps Anda (https://dev.azure.com/<your-organization>), dan pilih proyek Anda.
  
  <your-organization> Ganti tempat penampung teks dengan pengidentifikasi proyek Anda.
2. Jika Anda membuat alur baru":
  1. Pilih Alur, lalu pilih alur Anda.
  2. Pilih elipsis, lalu pilih Hapus.
  3. Masukkan nama alur, lalu pilih Hapus untuk menghapus alur.
3. Jika Anda memodifikasi definisi alur kerja yang ada, batalkan modifikasi untuk menjalankan pengujian beban, dan simpan alur kerja.
Hapus koneksi layanan:
1. Pilih Pengaturan proyek>Koneksi layanan, lalu pilih koneksi layanan Anda.
2. Pilih Edit>Hapus untuk menghapus koneksi layanan.

Hapus perubahan GitHub Actions:
1. Di GitHub, telusuri ke repositori Anda.
2. Jika Anda membuat definisi alur kerja baru, hapus file YAML alur kerja di .github/workflows folder .
3. Jika Anda memodifikasi definisi alur kerja yang ada, batalkan modifikasi untuk menjalankan pengujian beban, dan simpan alur kerja.

Hapus perwakilan layanan:

az ad sp delete --id $(az ad sp show --display-name "my-load-test-cicd" -o tsv)

Langkah berikutnya

Lanjutkan ke artikel berikutnya untuk mempelajari cara mengidentifikasi regresi performa dengan menentukan kriteria kegagalan pengujian dan membandingkan eksekusi pengujian.