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.

1. Unduh templat NF ARM dari Penyimpanan Artefak.
2. Konfirmasikan bahwa roleOverrideValues properti berisi Microsoft.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 dalam roleOverrideValues 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

1. Akses portal Azure dan buka Grup Sumber Daya tempat Anda menyebarkan Site Network Service (SNS)
2. Pilih halaman Penyebaran dari menu Grup Sumber Daya
3. 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

1. Akses portal Azure dan buka Grup Sumber Daya tempat Anda menyebarkan SNS
2. Buka gambaran umum SNS dan klik tautan ke properti Sumber Daya
3. Pilih halaman Penyebaran dari menu Grup Sumber Daya.
4. Pilih tombol detail kesalahan untuk penyebaran yang sesuai dengan penyebaran NF Anda yang gagal

Gunakan portal Azure AOSM untuk melihat parameter penyebaran fungsi jaringan

1. Akses portal Azure dan buka Grup Sumber Daya tempat Anda menyebarkan SNS
2. Buka gambaran umum SNS dan klik tautan ke properti Sumber Daya
3. 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

1. Akses portal Azure dan buka Grup Sumber Daya tempat Anda menyebarkan SNS
2. Buka gambaran umum SNS dan klik tautan ke properti Sumber Daya
3. Buka gambaran umum NF dan navigasikan ke halaman Komponen dari menu sumber daya.
4. 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.