Teknik untuk memecahkan masalah kegagalan penginstalan helm selama penyebaran fungsi jaringan kontainer (CNF) Azure Operator Service Manager (AOSM)
CNF bisa sesering paket helm tunggal dengan sejumlah kecil parameter konfigurasi, atau serumit puluhan paket helm dengan ribuan parameter konfigurasi. Artikel ini menjelaskan serangkaian langkah pemecahan masalah umum untuk men-debug kegagalan penginstalan helm.
Konfirmasikan paket helm diinstal dengan benar menggunakan perintah helm langsung
AOSM tidak dapat menginstal CNF yang dibangun dari bagan helm yang salah atau file yang salah dikonfigurasi values.yaml
. Ada dua prasyarat mendasar:
- Setiap bagan helm yang disertakan dalam CNF harus diteruskan
helm template
saat disediakan dengan sekumpulan nilai yang digunakan untuk menyebarkan bagan helm install
harus berhasil saat berjalan langsung di kluster Kubernetes yang terhubung dengan Azure Arc
Uji bahwa bagan helm Anda memenuhi prasyarat ini. Pastikan Anda menguji dengan nilai helm yang sama dengan yang ingin Anda gunakan saat menyebarkan melalui AOSM.
- Anda dapat terhubung ke kluster Azure Operator Nexus Kubernetes menggunakan koneksi kluster dan menggunakan penginstalan helm untuk menginstal bagan helm Anda.
Konfirmasikan bahwa Templat ARM fungsi jaringan (NF) Anda telah --atomic
diatur ke false
Secara default, AOSM menghapus penginstalan yang gagal dari kluster untuk mengurangi penggunaan sumber daya. Ini mencegah penelusuran kesalahan terperinci dalam skenario kegagalan. Templat ARM NF mendukung pengesampingan perilaku ini. Gunakan panduan Cara ini untuk mengonfigurasi AOSM agar penginstalan gagal diberlakukan.
Konfirmasikan bahwa templat fungsi jaringan (NF) Azure Resource Manager (ARM) Anda menggunakan injeksi penyimpanan artefak
AOSM mendukung onboarding nol sentuhan bagan helm. Fitur ini dikonfigurasi dalam templat NF ARM dan diaktifkan secara otomatis jika Anda melakukan onboarding CNF menggunakan ekstensi Az CLI AOSM.
- Unduh templat NF ARM dari Penyimpanan Artefak.
- Konfirmasikan bahwa
roleOverrideValues
properti berisiMicrosoft.HybridNetwork/networkFunctions
cuplikan berikut. Cuplikan ini menggunakan CNF Contoso fiktif yang dibangun dari tiga bagan helm independen. Bagan helm ini dimodelkan sebagai tiga aplikasi fungsi jaringan dalam versi definisi fungsi jaringan (NFDV). Templat ARM Anda harus memiliki satu elemen dalamroleOverrideValues
array untuk setiap aplikasi fungsi jaringan di NFDV.
roleOverrideValues: ["{\"name\": \"Contoso-one\", \"deployParametersMappingRuleProfile\": {\"applicationEnablement\": \"Enabled\", \"helmMappingRuleProfile\": {\"options\": {\"installOptions\": {\"injectArtifactStoreDetails\":\"true\"}},{\"upgradeOptions\": {\"injectArtifactStoreDetails\":\"true\"}}}}},{\"name\": \"Contoso-two\", \"deployParametersMappingRuleProfile\": {\"applicationEnablement\": \"Enabled\", \"helmMappingRuleProfile\": {\"options\": {\"installOptions\": {\"injectArtifactStoreDetails\":\"true\"}},{\"upgradeOptions\": {\"injectArtifactStoreDetails\":\"true\"}}}}},{\"name\": \"Contoso-three\", \"deployParametersMappingRuleProfile\": {\"applicationEnablement\": \"Enabled\", \"helmMappingRuleProfile\": {\"options\": {\"installOptions\": {\"injectArtifactStoreDetails\":\"true\"}},{\"upgradeOptions\": {\"injectArtifactStoreDetails\":\"true\"}}}}}"]
Jika templat ARM tidak berisi \"injectArtifactStoreDetails\":\"true\"
pengaturan untuk setiap aplikasi fungsi jaringan, edit templat ARM untuk menyertakan pengaturan untuk setiap aplikasi fungsi jaringan di NFDV Anda dan unggah templat ARM ke Penyimpanan Artefak.
Gunakan portal Azure AOSM untuk melihat kesalahan penyebaran SNS
- Akses portal Azure dan buka Grup Sumber Daya tempat Anda menyebarkan Site Network Service (SNS)
- Pilih halaman Penyebaran dari menu Grup Sumber Daya
- Buka halaman penyebaran untuk penyebaran yang sesuai dengan penyebaran SNS Anda yang gagal dan pilih tombol detail kesalahan
Gunakan portal Azure AOSM untuk melihat kesalahan penyebaran NF
- Akses portal Azure dan buka Grup Sumber Daya tempat Anda menyebarkan SNS
- Buka gambaran umum SNS dan klik tautan ke properti Sumber Daya
- Pilih halaman Penyebaran dari menu Grup Sumber Daya.
- Pilih tombol detail kesalahan untuk penyebaran yang sesuai dengan penyebaran NF Anda yang gagal
Gunakan portal Azure AOSM untuk melihat parameter penyebaran fungsi jaringan
- Akses portal Azure dan buka Grup Sumber Daya tempat Anda menyebarkan SNS
- Buka gambaran umum SNS dan klik tautan ke properti Sumber Daya
- Buka gambaran umum NF dan klik tombol Buka tampilan sebagai JSON untuk properti Nilai penyebaran
Tampilan ini memperlihatkan kepada Anda nilai yang telah diteruskan ke operasi penyebaran NF. Nilai-nilai ini disertakan dalam perintah yang helm install
digunakan untuk menyebarkan NF. Nilai yang salah dikonfigurasi, tidak terduga, hilang, atau salah diformat dapat menyebabkan helm install
perintah gagal.
Gunakan portal Azure AOSM untuk melihat parameter penyebaran komponen fungsi jaringan
- Akses portal Azure dan buka Grup Sumber Daya tempat Anda menyebarkan SNS
- Buka gambaran umum SNS dan klik tautan ke properti Sumber Daya
- Buka gambaran umum NF dan navigasikan ke halaman Komponen dari menu sumber daya.
- Tekan Buka Tampilan sebagai JSON untuk komponen yang menarik.
Tampilan ini memperlihatkan nilai yang diteruskan ke bagan helm pada helm install
perintah. Setiap nilai diteruskan ke helm install
perintah menggunakan --set
. Nilai yang salah dikonfigurasi, tidak terduga, hilang, atau salah diformat dapat menyebabkan helm install
perintah gagal.
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk