Jalankan skrip di mesin virtual Linux Anda dengan menggunakan tindakan Run Command

Berlaku untuk: ✔️ Mesin Virtual Linux ✔️ Set skala fleksibel

Fitur Run Command menggunakan agen komputer virtual (VM) untuk menjalankan skrip shell dalam Azure Linux VM. Anda dapat menggunakan skrip ini untuk manajemen komputer atau aplikasi umum. Skrip tersebut dapat membantu Anda dengan cepat mendiagnosis dan memulihkan akses komputer virtual dan masalah jaringan, dan membuat komputer virtual kembali ke kondisi yang baik.

Keuntungan

Anda dapat mengakses komputer virtual Anda dengan berbagai cara. Run Command dapat menjalankan skrip pada komputer virtual Anda dari jarak jauh dengan menggunakan agen komputer virtual. Anda menggunakan Run Command melalui portal Azure, REST API, atau Azure CLI untuk komputer virtual Linux.

Kemampuan ini berguna dalam semua skenario di mana Anda ingin menjalankan skrip di dalam komputer virtual. Ini adalah satu-satunya cara untuk memecahkan masalah dan memulihkan mesin virtual yang tidak membuka port RDP atau SSH karena konfigurasi pengguna jaringan atau administratif.

Prasyarat

Linux Distro didukung

Batasan

Batasan berikut berlaku saat Anda menggunakan Run Command:

• Output dibatasi hingga 4.096 byte terakhir.
• Waktu minimum untuk menjalankan skrip adalah sekitar 20 detik.
• Skrip berjalan secara default sebagai pengguna yang ditinggikan di Linux.
• Anda dapat menjalankan satu skrip saat ini.
• Skrip yang meminta informasi (mode interaktif) tidak didukung.
• Anda tidak dapat membatalkan skrip yang sedang berjalan.
• Waktu maksimum yang dapat dijalankan skrip adalah 90 menit. Setelah itu, skrip akan kehabisan waktu.
• Konektivitas keluar dari VM diperlukan untuk mengembalikan hasil skrip.

Perintah yang tersedia

Tabel ini menunjukkan daftar perintah yang tersedia untuk komputer virtual Linux. Anda dapat menggunakan perintah RunShellScript untuk menjalankan skrip kustom apa pun yang Anda inginkan. Saat Anda menggunakan Azure CLI atau PowerShell untuk menjalankan perintah, nilai yang Anda berikan untuk parameter --command-id atau -CommandId harus salah satu dari nilai yang tercantum berikut ini. Saat Anda menentukan nilai yang bukan perintah yang tersedia, Anda menerima kesalahan ini:

The entity was not found in this Azure location

Azure CLI

Contoh berikut menggunakan perintah az vm run-command untuk menjalankan skrip shell pada komputer virtual Azure Linux.

az vm run-command invoke -g myResourceGroup -n myVm --command-id RunShellScript --scripts "apt-get update && apt-get install -y nginx"

Portal Azure

Buka VM di portal Azure dan pilih Jalankan perintah di menu sebelah kiri, pada bagian Operasi. Anda melihat daftar perintah yang tersedia untuk dijalankan pada komputer virtual.

Pilih perintah untuk dijalankan. Beberapa perintah mungkin memiliki parameter input opsional atau wajib. Untuk perintah tersebut, parameter disajikan sebagai bidang teks bagi Anda untuk memberikan nilai input. Untuk setiap perintah, Anda dapat melihat skrip yang sedang dijalankan dengan memperluas Lihat skrip. RunShellScript berbeda dari perintah lainnya, karena memungkinkan Anda untuk menyediakan skrip khusus Anda sendiri.

Setelah Anda memilih perintah, pilih Jalankan untuk menjalankan skrip. Setelah skrip selesai, ia mengembalikan output dan kesalahan apa pun di jendela output. Tangkapan layar berikut menunjukkan contoh output dari menjalankan perintah ifconfig.

PowerShell

Contoh berikut menggunakan cmdlet Invoke-AzVMRunCommand untuk menjalankan skrip PowerShell di komputer virtual Azure. Cmdlet meminta skrip yang direferensikan dalam parameter -ScriptPath menjadi lokal di mana cmdlet dijalankan.

Invoke-AzVMRunCommand -ResourceGroupName '<myResourceGroup>' -Name '<myVMName>' -CommandId 'RunShellScript' -ScriptPath '<pathToScript>' -Parameter @{"arg1" = "var1";"arg2" = "var2"}

Membatasi akses ke Run Command

Mencantumkan perintah jalankan atau memperlihatkan detail perintah memerlukan Microsoft.Compute/locations/runCommands/read izin pada tingkat Langganan. Peran Pembaca bawaan dan tingkat yang lebih tinggi memiliki izin ini.

Menjalankan perintah memerlukan izin Microsoft.Compute/virtualMachines/runCommands/write. Peran Kontributor Komputer Virtual dan tingkat yang lebih tinggi memiliki izin ini.

Anda dapat menggunakan salah satu peran bawaan atau membuat peran kustom untuk menggunakan Run Command.

Pemecahan masalah Action Run Command Linux

Saat memecahkan masalah perintah eksekusi tindakan untuk lingkungan Linux, lihat file log handler yang biasanya terletak di direktori berikut: /var/log/azure/run-command-handler/handler.log untuk detail lebih lanjut.

Masalah umum

Log perintah eksekusi tindakan Linux memiliki beberapa perbedaan penting dibandingkan dengan perintah eksekusi tindakan log Windows:

• Nomor urut dilaporkan dengan setiap baris log sebagai 'seq=#'
• Tidak akan ada baris yang berisi Awaiting completion... karena ini akan dalam tindakan menjalankan perintah Windows saja.
• Baris Command existed with code: # ini juga hanya ada dalam perintah eksekusi tindakan pengelogan Windows.

Penghapusan Perintah Eksekusi Tindakan

Jika perlu menghapus ekstensi Linux perintah eksekusi tindakan Anda, lihat langkah-langkah di bawah ini untuk Azure PowerShell dan CLI:

Ganti rgname dan vmname dengan nama grup sumber daya dan nama komputer virtual yang relevan dalam contoh penghapusan berikut.

 Invoke-AzVMRunCommand -ResourceGroupName 'rgname' -VMName 'vmname' -CommandId 'RemoveRunCommandLinuxExtension'

az vm run-command invoke  --command-id RemoveRunCommandLinuxExtension --name vmname -g rgname

Langkah berikutnya

Untuk mempelajari tentang cara lain menjalankan skrip dan perintah dari jarak jauh di komputer virtual Anda, lihat Menjalankan skrip di komputer virtual Linux Anda.