az k8s-extension

Catatan

Referensi ini adalah bagian dari ekstensi k8s-extension untuk Azure CLI (versi 2.51.0 atau yang lebih tinggi). Ekstensi akan secara otomatis menginstal pertama kali Anda menjalankan perintah az k8s-extension . Pelajari lebih lanjut tentang ekstensi.

Perintah untuk mengelola Ekstensi Kubernetes.

Perintah

Nama Deskripsi Jenis Status
az k8s-extension create

Buat Ekstensi Kluster Kubernetes, termasuk membeli Penawaran ekstensi dari Marketplace Azure (hanya AKS). Silakan lihat contoh di akhir untuk melihat cara membuat ekstensi atau membeli penawaran ekstensi.

Ekstensi GA
az k8s-extension delete

Menghapus Ekstensi Kubernetes.

Ekstensi GA
az k8s-extension extension-types

Perintah untuk menemukan Jenis Ekstensi Kubernetes.

Ekstensi Pratinjau
az k8s-extension extension-types list

Mencantumkan Jenis Ekstensi Kluster yang tersedia untuk kluster yang ada.

Ekstensi Pratinjau dan Tidak Digunakan Lagi
az k8s-extension extension-types list-by-cluster

Mencantumkan Jenis Ekstensi Kluster yang tersedia untuk kluster yang ada. Properti yang digunakan untuk pemfilteran mencakup jenis kluster (terkelola, terhubung, dll), versi kubernetes, lokasi kluster.

Ekstensi Pratinjau
az k8s-extension extension-types list-by-location

Mencantumkan Jenis Ekstensi Kluster yang tersedia di suatu wilayah.

Ekstensi Pratinjau
az k8s-extension extension-types list-versions

Mencantumkan versi yang tersedia untuk Jenis Ekstensi Kluster untuk kluster tertentu.

Ekstensi Pratinjau dan Tidak Digunakan Lagi
az k8s-extension extension-types list-versions-by-cluster

Mencantumkan versi yang tersedia untuk Jenis Ekstensi Kluster untuk kluster tertentu. Properti yang digunakan untuk pemfilteran mencakup jenis kluster (terkelola, terhubung, dll), versi kubernetes, lokasi kluster.

Ekstensi Pratinjau
az k8s-extension extension-types list-versions-by-location

Mencantumkan versi yang tersedia untuk versi Jenis Ekstensi Kluster di suatu wilayah.

Ekstensi Pratinjau
az k8s-extension extension-types show

Mendapatkan properti untuk Jenis Ekstensi Kluster di suatu wilayah.

Ekstensi Pratinjau dan Tidak Digunakan Lagi
az k8s-extension extension-types show-by-cluster

Tampilkan properti untuk Jenis Ekstensi Kluster untuk kluster yang ada. Properti yang digunakan untuk pemfilteran mencakup jenis kluster (terkelola, terhubung, dll), versi kubernetes, lokasi kluster.

Ekstensi Pratinjau
az k8s-extension extension-types show-by-location

Perlihatkan properti untuk Jenis Ekstensi Kluster di suatu wilayah.

Ekstensi Pratinjau
az k8s-extension extension-types show-version-by-cluster

Tampilkan properti yang terkait dengan versi Jenis Ekstensi Kluster untuk kluster yang ada. Properti yang digunakan untuk pemfilteran mencakup jenis kluster (terkelola, terhubung, dll), versi kubernetes, lokasi kluster.

Ekstensi Pratinjau
az k8s-extension extension-types show-version-by-location

Tampilkan properti yang terkait dengan versi Jenis Ekstensi Kluster di suatu wilayah.

Ekstensi Pratinjau
az k8s-extension list

Mencantumkan Ekstensi Kubernetes.

Ekstensi GA
az k8s-extension show

Tampilkan Ekstensi Kubernetes.

Ekstensi GA
az k8s-extension update

Memperbarui properti yang dapat diubah dari Ekstensi Kubernetes.

Ekstensi GA

az k8s-extension create

Buat Ekstensi Kluster Kubernetes, termasuk membeli Penawaran ekstensi dari Marketplace Azure (hanya AKS). Silakan lihat contoh di akhir untuk melihat cara membuat ekstensi atau membeli penawaran ekstensi.

Buat Ekstensi Kubernetes. Output mencakup rahasia yang harus Anda lindungi. Pastikan Anda tidak menyertakan rahasia ini dalam kontrol sumber Anda. Verifikasi juga bahwa tidak ada rahasia yang ada di log perintah atau skrip Anda. Untuk informasi tambahan, lihat http://aka.ms/clisecrets.

az k8s-extension create --cluster-name
                        --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                        --extension-type
                        --name
                        --resource-group
                        [--auto-upgrade {false, true}]
                        [--cluster-resource-provider]
                        [--config]
                        [--config-file]
                        [--config-protected]
                        [--config-protected-file]
                        [--config-settings]
                        [--configuration-protected-settings]
                        [--configuration-protected-settings-file]
                        [--configuration-settings-file]
                        [--no-wait]
                        [--plan-name]
                        [--plan-product]
                        [--plan-publisher]
                        [--release-namespace]
                        [--release-train]
                        [--scope {cluster, namespace}]
                        [--target-namespace]
                        [--version]

Contoh

Membuat Ekstensi Kubernetes

az k8s-extension create --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension --extension-type microsoft.openservicemesh --scope cluster --release-train stable

Membuat Ekstensi Marketplace Kubernetes

az k8s-extension create --resource-group my-resource-group --cluster-name mycluster --cluster-type managedClusters --name myextension --extension-type Contoso.AzureVoteKubernetesAppTest --scope cluster --release-train stable --plan-name testplan --plan-product kubernetest_apps_demo_offer --plan-publisher test_test_mix3pptest0011614206850774

Parameter yang Diperlukan

--cluster-name -c

Nama kluster Kubernetes.

--cluster-type -t

Tentukan kluster Arc atau kluster terkelola AKS atau appliance Arc atau provisionedClusters.

nilai yang diterima: appliances, connectedClusters, managedClusters, provisionedClusters
--extension-type

Nama jenis ekstensi.

--name -n

Nama instans ekstensi.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Opsional

--auto-upgrade --auto-upgrade-minor-version

Tingkatkan versi minor instans ekstensi secara otomatis.

nilai yang diterima: false, true
--cluster-resource-provider --cluster-rp

Nama Penyedia Sumber Daya Kluster untuk clusterType ini (Diperlukan untuk provisionedClusters).

--config --configuration-settings

Konfigurasi Pengaturan sebagai pasangan key=value. Ulangi parameter untuk setiap pengaturan. Jangan gunakan ini untuk rahasia, karena nilai ini dikembalikan sebagai respons.

--config-file --config-settings-file

Jalur file JSON untuk pengaturan konfigurasi.

--config-protected --config-protected-settings

Konfigurasi dilindungi Pengaturan sebagai pasangan key=value. Ulangi parameter untuk setiap pengaturan. Hanya kunci yang dikembalikan sebagai respons, nilainya tidak.

--config-protected-file --config-protected-settings-file

Jalur file JSON untuk pengaturan yang dilindungi konfigurasi.

--config-settings
Tidak digunakan lagi

Opsi '--config-settings' tidak digunakan lagi dan akan dihapus dalam rilis mendatang. Gunakan '--configuration-settings' sebagai gantinya.

Konfigurasi Pengaturan sebagai pasangan key=value. Ulangi parameter untuk setiap pengaturan. Jangan gunakan ini untuk rahasia, karena nilai ini dikembalikan sebagai respons.

--configuration-protected-settings
Tidak digunakan lagi

Opsi '--configuration-protected-settings' telah ditolak dan akan dihapus dalam rilis mendatang. Gunakan '--config-protected-settings' sebagai gantinya.

Konfigurasi dilindungi Pengaturan sebagai pasangan key=value. Ulangi parameter untuk setiap pengaturan. Hanya kunci yang dikembalikan sebagai respons, nilainya tidak.

--configuration-protected-settings-file
Tidak digunakan lagi

Opsi '--configuration-protected-settings-file' telah ditolak dan akan dihapus dalam rilis mendatang. Gunakan '--config-protected-file' sebagai gantinya.

Jalur file JSON untuk pengaturan yang dilindungi konfigurasi.

--configuration-settings-file
Tidak digunakan lagi

Opsi '--configuration-settings-file' telah tidak digunakan lagi dan akan dihapus dalam rilis mendatang. Gunakan '--config-settings-file' sebagai gantinya.

Jalur file JSON untuk pengaturan konfigurasi.

--no-wait

Jangan menunggu operasi jangka panjang selesai.

nilai default: False
--plan-name

Nama paket mengacu pada ID Paket ekstensi yang diambil dari portal Marketplace di bawah Informasi Penggunaan + Dukungan.

--plan-product

Produk paket mengacu pada ID Produk ekstensi yang diambil dari portal Marketplace di bawah Informasi Penggunaan + Dukungan. Contohnya adalah nama penawaran ISV yang digunakan.

--plan-publisher

Penerbit paket mengacu pada ID Penerbit ekstensi yang diambil dari portal Marketplace di bawah Informasi Penggunaan + Dukungan.

--release-namespace

Tentukan namespace layanan untuk menginstal rilis ekstensi.

--release-train

Tentukan pelatihan rilis untuk jenis ekstensi.

--scope

Tentukan cakupan ekstensi.

nilai yang diterima: cluster, namespace
--target-namespace

Tentukan namespace layanan target yang akan diinstal untuk instans ekstensi. Parameter ini diperlukan jika cakupan ekstensi diatur ke 'namespace'.

--version

Tentukan versi yang akan diinstal untuk instans ekstensi jika --auto-upgrade-minor-version tidak diaktifkan.

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az k8s-extension delete

Menghapus Ekstensi Kubernetes.

az k8s-extension delete --cluster-name
                        --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                        --name
                        --resource-group
                        [--cluster-resource-provider]
                        [--force]
                        [--no-wait]
                        [--yes]

Contoh

Menghapus Ekstensi Kubernetes yang ada

az k8s-extension delete --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension

Parameter yang Diperlukan

--cluster-name -c

Nama kluster Kubernetes.

--cluster-type -t

Tentukan kluster Arc atau kluster terkelola AKS atau appliance Arc atau provisionedClusters.

nilai yang diterima: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

Nama instans ekstensi.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Opsional

--cluster-resource-provider --cluster-rp

Nama Penyedia Sumber Daya Kluster untuk clusterType ini (Diperlukan untuk provisionedClusters).

--force

Tentukan apakah akan memaksa penghapusan ekstensi dari kluster.

nilai default: False
--no-wait

Jangan menunggu operasi jangka panjang selesai.

nilai default: False
--yes -y

Abaikan perintah konfirmasi.

nilai default: False
Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az k8s-extension list

Mencantumkan Ekstensi Kubernetes.

Cantumkan semua Ekstensi Kubernetes dalam kluster, termasuk propertinya. Output mencakup rahasia yang harus Anda lindungi. Pastikan Anda tidak menyertakan rahasia ini dalam kontrol sumber Anda. Verifikasi juga bahwa tidak ada rahasia yang ada di log perintah atau skrip Anda. Untuk informasi tambahan, lihat http://aka.ms/clisecrets.

az k8s-extension list --cluster-name
                      --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                      --resource-group
                      [--cluster-resource-provider]

Contoh

Mencantumkan semua Ekstensi Kubernetes pada kluster

az k8s-extension list --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters

Parameter yang Diperlukan

--cluster-name -c

Nama kluster Kubernetes.

--cluster-type -t

Tentukan kluster Arc atau kluster terkelola AKS atau appliance Arc atau provisionedClusters.

nilai yang diterima: appliances, connectedClusters, managedClusters, provisionedClusters
--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Opsional

--cluster-resource-provider --cluster-rp

Nama Penyedia Sumber Daya Kluster untuk clusterType ini (Diperlukan untuk provisionedClusters).

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az k8s-extension show

Tampilkan Ekstensi Kubernetes.

Tampilkan Ekstensi Kubernetes termasuk propertinya. Output mencakup rahasia yang harus Anda lindungi. Pastikan Anda tidak menyertakan rahasia ini dalam kontrol sumber Anda. Verifikasi juga bahwa tidak ada rahasia yang ada di log perintah atau skrip Anda. Untuk informasi tambahan, lihat http://aka.ms/clisecrets.

az k8s-extension show --cluster-name
                      --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                      --name
                      --resource-group
                      [--cluster-resource-provider]

Contoh

Menampilkan detail Ekstensi Kubernetes

az k8s-extension show --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension

Parameter yang Diperlukan

--cluster-name -c

Nama kluster Kubernetes.

--cluster-type -t

Tentukan kluster Arc atau kluster terkelola AKS atau appliance Arc atau provisionedClusters.

nilai yang diterima: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

Nama instans ekstensi.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Opsional

--cluster-resource-provider --cluster-rp

Nama Penyedia Sumber Daya Kluster untuk clusterType ini (Diperlukan untuk provisionedClusters).

Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.

az k8s-extension update

Memperbarui properti yang dapat diubah dari Ekstensi Kubernetes.

Untuk pembaruan ke Config Pengaturan dan ConfigProtected Pengaturan, silakan lihat dokumentasi layanan ekstensi kluster untuk memeriksa pembaruan ke properti ini didukung sebelum memperbarui properti ini. Output mencakup rahasia yang harus Anda lindungi. Pastikan Anda tidak menyertakan rahasia ini dalam kontrol sumber Anda. Verifikasi juga bahwa tidak ada rahasia yang ada di log perintah atau skrip Anda. Untuk informasi tambahan, lihat http://aka.ms/clisecrets.

az k8s-extension update --cluster-name
                        --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                        --name
                        --resource-group
                        [--auto-upgrade {false, true}]
                        [--cluster-resource-provider]
                        [--config]
                        [--config-file]
                        [--config-protected]
                        [--config-protected-file]
                        [--config-settings]
                        [--configuration-protected-settings]
                        [--configuration-protected-settings-file]
                        [--configuration-settings-file]
                        [--no-wait]
                        [--release-train]
                        [--version]
                        [--yes]

Contoh

Memperbarui Ekstensi Kubernetes

az k8s-extension update --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension --auto-upgrade true/false --version extension-version --release-train stable --configuration-settings settings-key=settings-value --config-protected-settings protected-settings-key=protected-value --config-settings-file=config-settings-file --config-protected-file=protected-settings-file

Parameter yang Diperlukan

--cluster-name -c

Nama kluster Kubernetes.

--cluster-type -t

Tentukan kluster Arc atau kluster terkelola AKS atau appliance Arc atau provisionedClusters.

nilai yang diterima: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

Nama instans ekstensi.

--resource-group -g

Nama grup sumber daya. Anda dapat mengonfigurasi grup default menggunakan az configure --defaults group=<name>.

Parameter Opsional

--auto-upgrade --auto-upgrade-minor-version

Tingkatkan versi minor instans ekstensi secara otomatis.

nilai yang diterima: false, true
--cluster-resource-provider --cluster-rp

Nama Penyedia Sumber Daya Kluster untuk clusterType ini (Diperlukan untuk provisionedClusters).

--config --configuration-settings

Konfigurasi Pengaturan sebagai pasangan key=value. Ulangi parameter untuk setiap pengaturan. Jangan gunakan ini untuk rahasia, karena nilai ini dikembalikan sebagai respons.

--config-file --config-settings-file

Jalur file JSON untuk pengaturan konfigurasi.

--config-protected --config-protected-settings

Konfigurasi dilindungi Pengaturan sebagai pasangan key=value. Ulangi parameter untuk setiap pengaturan. Hanya kunci yang dikembalikan sebagai respons, nilainya tidak.

--config-protected-file --config-protected-settings-file

Jalur file JSON untuk pengaturan yang dilindungi konfigurasi.

--config-settings
Tidak digunakan lagi

Opsi '--config-settings' tidak digunakan lagi dan akan dihapus dalam rilis mendatang. Gunakan '--configuration-settings' sebagai gantinya.

Konfigurasi Pengaturan sebagai pasangan key=value. Ulangi parameter untuk setiap pengaturan. Jangan gunakan ini untuk rahasia, karena nilai ini dikembalikan sebagai respons.

--configuration-protected-settings
Tidak digunakan lagi

Opsi '--configuration-protected-settings' telah ditolak dan akan dihapus dalam rilis mendatang. Gunakan '--config-protected-settings' sebagai gantinya.

Konfigurasi dilindungi Pengaturan sebagai pasangan key=value. Ulangi parameter untuk setiap pengaturan. Hanya kunci yang dikembalikan sebagai respons, nilainya tidak.

--configuration-protected-settings-file
Tidak digunakan lagi

Opsi '--configuration-protected-settings-file' telah ditolak dan akan dihapus dalam rilis mendatang. Gunakan '--config-protected-file' sebagai gantinya.

Jalur file JSON untuk pengaturan yang dilindungi konfigurasi.

--configuration-settings-file
Tidak digunakan lagi

Opsi '--configuration-settings-file' telah tidak digunakan lagi dan akan dihapus dalam rilis mendatang. Gunakan '--config-settings-file' sebagai gantinya.

Jalur file JSON untuk pengaturan konfigurasi.

--no-wait

Jangan menunggu operasi jangka panjang selesai.

nilai default: False
--release-train

Tentukan pelatihan rilis untuk jenis ekstensi.

--version

Tentukan versi yang akan diinstal untuk instans ekstensi jika --auto-upgrade-minor-version tidak diaktifkan.

--yes -y

Abaikan perintah konfirmasi.

nilai default: False
Parameter Global
--debug

Meningkatkan verbositas pengelogan untuk menampilkan semua log debug.

--help -h

Menampilkan pesan bantuan ini dan keluar.

--only-show-errors

Hanya menampilkan kesalahan, menyembunyikan peringatan.

--output -o

Format output.

nilai yang diterima: json, jsonc, none, table, tsv, yaml, yamlc
nilai default: json
--query

String kueri JMESPath. Lihat http://jmespath.org/ untuk informasi selengkapnya beserta contohnya.

--subscription

Nama atau ID langganan. Anda dapat mengonfigurasi langganan default menggunakan az account set -s NAME_OR_ID.

--verbose

Meningkatkan verbositas pengelogan. Gunakan --debug untuk log waktu lengkap.