Mengelola sumber daya Batch dengan Azure CLI
Anda dapat mengelola sumber daya dan akun Azure Batch Anda menggunakan Azure Command-Line Interface (Azure CLI). Tersedia perintah untuk membuat dan memperbarui sumber daya Batch seperti kumpulan, pekerjaan, dan tugas. Anda juga dapat membuat skrip untuk banyak tugas yang sama dengan yang Anda lakukan melalui API Batch, cmdlet PowerShell, dan portal Azure.
Anda dapat menjalankan Azure CLI di Azure Cloud Shell atau menginstal Azure CLI secara lokal. Versi Azure CLI tersedia untuk sistem operasi (OS) Windows, Mac, dan Linux.
Artikel ini menjelaskan cara menggunakan Azure CLI dengan akun dan sumber daya Batch.
Menyiapkan Azure CLI
Pilih cara yang Anda inginkan untuk menyiapkan Azure CLI:
- Jalankan Azure CLI di Cloud Shell.
- Instal Azure CLI secara lokal.
- Instal Azure CLI di Windows
- Instal Azure CLI di macOS
- Instal Azure CLI di Linux untuk beberapa distribusi Linux.
Jika Anda masih baru menggunakan Azure CLI, lihat Mulai menggunakan Azure CLI sebelum melanjutkan.
Jika sebelumnya Anda telah memasang Azure CLI secara lokal, pastikan untuk memperbarui penginstalan Anda ke versi terbaru.
Mengautentikasi dengan Azure CLI
Untuk menggunakan Azure CLI dengan Batch, pertama-tama masuk ke akun Azure Anda, lalu masuk ke akun Batch Anda.
Masuk ke akun Azure Anda
Untuk menggunakan Azure CLI, pertama-tama masuk ke akun Azure Anda. Langkah ini memberi Anda akses ke perintah Azure Resource Manager, termasuk perintah layanan Manajemen Batch. Kemudian, Anda dapat menjalankan perintah untuk mengelola akun, kunci, paket aplikasi, dan kuota Batch.
Anda dapat mengautentikasi akun Azure Anda di Azure CLI) dengan dua cara. Untuk menjalankan perintah sendiri, masuk ke Azure CLI secara interaktif. Azure CLI memasukkan info masuk Anda ke dalam cache dan dapat menggunakan info masuk yang sama untuk memasukkan Anda ke akun Batch Anda setelahnya. Untuk menjalankan perintah dari skrip atau aplikasi, masuk ke Azure CLI dengan perwakilan layanan.
Untuk masuk ke Azure CLI secara interaktif, jalankan az login:
az login
Masuk ke akun Batch
Selanjutnya, masuk ke akun Batch Anda di Azure CLI menggunakan perintah az batch account login. Langkah ini memberi Anda akses ke perintah layanan Batch. Kemudian, Anda dapat mengelola sumber daya Batch seperti kumpulan, pekerjaan, dan tugas.
Anda dapat mengautentikasi akun Batch Anda di Azure CLI dengan dua cara. Metode default adalah mengautentikasi menggunakan ID Microsoft Entra. Kami merekomendasikan metode ini dalam sebagian besar skenario. Opsi lain adalah menggunakan autentikasi Kunci Bersama.
Jika anda membuat skrip Azure CLI untuk mengotomatisasi perintah Batch, Anda dapat menggunakan metode autentikasi yang mana saja. Dalam beberapa skenario, autentikasi Kunci Bersama mungkin bisa lebih sederhana daripada membuat perwakilan layanan.
Autentikasi dengan Microsoft Entra ID
Metode default untuk mengautentikasi dengan akun Batch Anda adalah melalui ID Microsoft Entra. Saat masuk ke Azure CLI secara interaktif atau dengan perwakilan layanan, Anda dapat menggunakan kredensial cache yang sama untuk memasukkan Anda ke akun Batch Anda dengan ID Microsoft Entra. Metode autentikasi ini juga menawarkan kontrol akses berbasis peran Azure (Azure RBAC). Dengan Azure RBAC, akses pengguna bergantung pada peran yang ditetapkan, bukan kunci akun. Anda hanya perlu mengelola peran Azure, bukan kunci akun. MICROSOFT Entra ID kemudian menangani akses dan autentikasi.
Untuk masuk ke akun Batch Anda dengan ID Microsoft Entra, jalankan az batch login. Pastikan untuk menyertakan parameter yang diperlukan untuk nama akun Batch Anda (-n), dan nama grup sumber daya Anda (-g).
az batch account login -g <your-resource-group> -n <your-batch-account>
Autentikasi dengan Kunci Bersama
Anda juga dapat menggunakan autentikasi Kunci Bersama untuk masuk ke akun Batch Anda. Metode ini menggunakan kunci akses akun Anda untuk mengautentikasi perintah Azure CLI untuk layanan Batch.
Untuk masuk ke akun Batch Anda dengan autentikasi Kunci Bersama, jalankan az batch login dengan parameter --shared-key-auth. Pastikan untuk menyertakan parameter yang diperlukan untuk nama akun Batch Anda (-n), dan nama grup sumber daya Anda (-g).
az batch account login -g <your-resource-group> -n <your-batch-account> --shared-key-auth
Pelajari perintah Batch
Dokumentasi referensi Azure CLI mencantumkan semua perintah Azure CLI untuk Batch.
Untuk mencantumkan semua perintah Batch di Azure CLI, jalankan az batch -h.
Ada beberapa contoh skrip CLI untuk tugas Batch umum. Contoh-contoh ini menunjukkan cara menggunakan banyak perintah yang tersedia untuk Batch di Azure CLI. Anda dapat mempelajari cara membuat dan mengelola akun, kumpulan, pekerjaan, dan tugas Batch.
Menggunakan perintah ekstensi Batch CLI
Anda dapat menggunakan ekstensi Batch CLI untuk menjalankan tugas Batch tanpa menulis kode. Ekstensi ini menyediakan perintah untuk menggunakan templat JSON untuk membuat kumpulan, pekerjaan, dan tugas dengan Azure CLI. Ekstensi ini juga menyediakan perintah untuk terhubung ke akun Azure Storage yang ditautkan ke akun Batch Anda. Kemudian, Anda dapat mengunggah file input pekerjaan dan mengunduh file input pekerjaan.
Membuat sumber daya dengan JSON
Anda dapat membuat sebagian besar sumber daya Batch hanya menggunakan parameter baris perintah. Beberapa fitur mengharuskan Anda untuk menentukan file konfigurasi JSON sebagai gantinya. File JSON berisi detail konfigurasi untuk sumber daya baru Anda. Misalnya, Anda harus menggunakan file JSON untuk menentukan file sumber untuk tugas awal.
Misalnya, untuk menggunakan file JSON guna mengonfigurasi sumber daya kumpulan Batch baru:
az batch pool <your-batch-pool-configuration>.json
Saat Anda menentukan file JSON untuk sumber daya baru, jangan gunakan parameter lain dalam perintah Anda. Layanan ini hanya menggunakan file JSON untuk mengonfigurasi sumber daya.
Dokumentasi referensi REST API Batch berisi daftar sintaks JSON yang diperlukan untuk membuat sumber daya.
Untuk melihat sintaks JSON yang diperlukan untuk membuat sumber daya, lihat dokumentasi referensi REST API Batch. Buka bagian Contoh di halaman referensi operasi sumber daya. Kemudian, temukan sub bagian berjudul Tambahkan <jenis sumber daya>. Misalnya, Tambahkan tugas dasar. Gunakan contoh kode JSON sebagai templat untuk file konfigurasi Anda.
Untuk sampel skrip yang menentukan file JSON, lihat Menjalankan pekerjaan dan tugas dengan Batch.
Mengkueri sumber daya Batch secara efisien
Anda dapat mengkueri akun Batch Anda dan mencantumkan semua sumber daya menggunakan perintah list. Misalnya, untuk mencantumkan kumpulan di akun dan tugas Anda dalam pekerjaan:
az batch pool list
az batch task list --job-id <your-job-id>
Untuk membatasi jumlah data yang dikembalikan kueri Batch Anda, tentukan klausa OData. Semua pemfilteran terjadi di sisi server, sehingga Anda hanya menerima data yang Anda minta. Gunakan klausa OData ini untuk menghemat bandwidth dan waktu dengan operasi list. Untuk informasi selengkapnya, lihat Mendesain kueri daftar yang efisien untuk sumber daya Batch.
| Klausul | Deskripsi |
|---|---|
--select-clause [select-clause] |
Menampilkan subset properti untuk setiap entitas. |
--filter-clause [filter-clause] |
Menampilkan hanya entitas yang cocok dengan ekspresi OData yang ditentukan. |
--expand-clause [expand-clause] |
Mendapatkan informasi entitas dalam satu panggilan REST yang mendasarinya. Klausul perluas saat ini hanya mendukung properti stats. |
Untuk skrip contoh yang menunjukkan cara menggunakan klausul, lihat Menjalankan pekerjaan dan tugas dengan Batch.
Pemecahan Masalah
Untuk mendapatkan bantuan dengan perintah Batch apa pun, tambahkan -h ke akhir perintah Anda. Jangan tambahkan opsi lain. Contohnya, untuk mendapatkan bantuan dalam membuat akun Batch, jalankan az batch account create -h.
Untuk mengembalikan output perintah verbose, tambahkan -v atau -vv ke akhir perintah Anda. Gunakan pengalih ini untuk menampilkan output kesalahan penuh. Bendera -vv mengembalikan permintaan dan respons REST aktual.
Untuk melihat output perintah dalam format JSON, tambahkan --json ke akhir perintah Anda. Contohnya, untuk menampilkan properti kumpulan bernama pool001, jalankan az batch pool show pool001 --json. Kemudian, salin dan ubah output untuk membuat sumber daya Batch menggunakan file konfigurasi JSON.
Pemecahan masalah Umum Azure CLI
Azure CLI dapat berjalan di beberapa lingkungan shell, tetapi dengan sedikit variasi format. Jika Anda mendapatkan hasil yang tidak diharapkan dengan perintah Azure CLI, lihat Cara berhasil menggunakan Azure CLI.