Memecahkan masalah penginstalan Bicep

Artikel ini menjelaskan cara mengatasi potensi kesalahan dalam penginstalan Bicep Anda.

Kesalahan runtime bahasa umum .NET

Saat menginstal ekstensi Bisep untuk Visual Studio Code, Anda dapat menjalankan pesan kesalahan berikut:

Failed to install .NET runtime v5.0

Failed to download .NET 5.0.x ....... Error!

Peringatan

Ini adalah solusi resor terakhir yang dapat menyebabkan masalah saat memperbarui versi.

Untuk mengatasi masalah, Anda dapat menginstal .NET secara manual dari situs web .NET, kemudian mengonfigurasi Visual Studio Code untuk menggunakan kembali penginstalan .NET yang ada dengan pengaturan berikut:

Windows

"dotnetAcquisitionExtension.existingDotnetPath": [
  {
    "extensionId": "ms-azuretools.vscode-bicep",
    "path": "C:\\Program Files\\dotnet\\dotnet.exe"
  }
]

macOS

Jika Anda memerlukan penginstalan x64, gunakan:

"dotnetAcquisitionExtension.existingDotnetPath": [
  {
    "extensionId": "ms-azuretools.vscode-bicep",
    "path": "/usr/local/share/dotnet/x64/dotnet"
  }
]

Untuk instalasi macOS lainnya, gunakan:

"dotnetAcquisitionExtension.existingDotnetPath": [
  {
    "extensionId": "ms-azuretools.vscode-bicep",
    "path": "/usr/local/share/dotnet/dotnet"
  }
]

Lihat Pengaturan Pengguna dan Ruang Kerja untuk mengonfigurasi pengaturan Visual Studio Code.

Kesalahan Visual Studio Code

Jika Anda melihat popup pesan kesalahan berikut di Visual Studio Code:

The Bicep server crashed 5 times in the last 3 minutes. The server will not be restarted.

Dari Visual Studio Code, buka tampilan Output di panel di bagian bawah layar, lalu pilih Bicep:

Jika Anda melihat output berikut di panel, dan Anda menggunakan Bicep CLI versi 0.4.1124 atau yang lebih baru, periksa apakah Anda telah menambahkan dotnetAcquisitionExtension.existingDotnetPath opsi konfigurasi ke Visual Studio Code. Lihat Kesalahan runtime bahasa umum .NET. Jika opsi konfigurasi ini ada, hapus dan mulai ulang Visual Studio Code.

It was not possible to find any compatible framework version.

Jika tidak, ajukan masalah di repositori Bicep, dan sertakan pesan output.

Beberapa versi Bicep CLI terpasang

Jika menginstal Bicep CLI secara manual ke lebih dari satu lokasi, Anda mungkin melihat perilaku yang tidak diharapkan, misalnya Bicep CLI tidak diperbarui ketika Anda menjalankan perintah peningkatan. Atau, Anda mungkin melihat bahwa menjalankan az bicep version mengembalikan satu versi, tetapi bicep --version mengembalikan versi yang berbeda.

Untuk mengatasi masalah ini, Anda bisa memperbarui semua lokasi, atau memilih satu lokasi untuk dipertahankan dan menghapus lokasi lainnya.

Pertama, buka perintah (bukan PowerShell), dan jalankan where bicep. Perintah ini mengembalikan lokasi penginstalan Bicep Anda. Jika menggunakan instans Bicep CLI yang dikelola oleh Azure CLI, Anda tidak akan melihat penginstalan ini karena penginstalan tersebut tidak ditambahkan ke PATH. Jika where bicep hanya mengembalikan satu lokasi, mungkin versi yang berkonflik yang Anda lihat adalah antara penginstalan manual dan penginstalan Azure CLI.

Untuk mempertahankan semua lokasi instalasi, gunakan metode yang sama seperti yang Anda gunakan sebelumnya untuk menginstal secara manual Bicep CLI untuk semua lokasi yang ingin Anda pertahankan. Jika Anda menggunakan Azure CLI, jalankan az bicep upgrade untuk memperbarui versi tersebut.

Untuk menyimpan hanya satu lokasi penginstalan, gunakan langkah-langkah berikut:

1. Hapus file untuk instalasi yang tidak ingin Anda simpan.
2. Hapus lokasi tersebut dari variabel lingkungan PATH Anda.

Jika memiliki penginstalan manual dan instans yang dikelola oleh Azure CLI, Anda dapat menggabungkan penggunaan ke satu instans.

1. Hapus lokasi penginstalan manual.
2. Tambahkan lokasi Bicep CLI yang dipasang oleh Azure CLI ke variabel PATH. Misalnya Windows, lokasi yang dikelola oleh Azure CLI adalah %USERPROFILE%\.Azure\bin.

Setelah menambahkan instans Azure CLI ke PATH, Anda dapat menggunakan versi tersebut dengan az bicep atau bicep.

Langkah berikutnya

Untuk informasi selengkapnya tentang penggunaan Visual Studio Code dan ekstensi Bicep, lihat Mulai Cepat: Membuat file Bicep dengan Visual Studio Code.