Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Gunakan tugas ini untuk menyebarkan, mengonfigurasi, atau memperbarui kluster Kubernetes di Azure Container Service dengan menjalankan perintah kubectl
.
Versi tugas ini tidak digunakan lagi; gunakan Kubernetes@1 untuk memanfaatkan fitur terbaru seperti federasi identitas beban kerja .
Gunakan tugas ini untuk menyebarkan, mengonfigurasi, atau memperbarui kluster Kubernetes di Azure Container Service dengan menjalankan perintah kubectl
.
Sintaksis
# Kubectl v0
# Deploy, configure, update a Kubernetes cluster in Azure Container Service by running kubectl commands.
- task: Kubernetes@0
inputs:
#kubernetesServiceConnection: # string. Alias: kubernetesServiceEndpoint. Kubernetes service connection.
#namespace: # string. Namespace.
# Commands
#command: # 'apply' | 'create' | 'delete' | 'exec' | 'expose' | 'get' | 'logs' | 'run' | 'set' | 'top'. Command.
#useConfigurationFile: false # boolean. Use Configuration files. Default: false.
#configuration: # string. Required when useConfigurationFile = true. Configuration file.
#arguments: # string. Arguments.
# Secrets
secretType: 'dockerRegistry' # 'dockerRegistry' | 'generic'. Required. Type of secret. Default: dockerRegistry.
#secretArguments: # string. Optional. Use when secretType = generic. Arguments.
containerRegistryType: 'Azure Container Registry' # 'Azure Container Registry' | 'Container Registry'. Required when secretType = dockerRegistry. Container Registry type. Default: Azure Container Registry.
#dockerRegistryConnection: # string. Alias: dockerRegistryEndpoint. Optional. Use when secretType = dockerRegistry && containerRegistryType = Container Registry. Docker Registry service connection.
#azureSubscription: # string. Alias: azureSubscriptionEndpoint. Optional. Use when secretType = dockerRegistry && containerRegistryType = Azure Container Registry. Azure subscription.
#azureContainerRegistry: # string. Optional. Use when secretType = dockerRegistry && containerRegistryType = Azure Container Registry. Azure Container Registry.
#secretName: # string. Secret name.
#forceUpdate: true # boolean. Force update secret. Default: true.
# ConfigMaps
#configMapName: # string. ConfigMap name.
#forceUpdateConfigMap: false # boolean. Force update configmap. Default: false.
#useConfigMapFile: false # boolean. Use file. Default: false.
#configMapFile: # string. Required when useConfigMapFile = true. ConfigMap file.
#configMapArguments: # string. Optional. Use when useConfigMapFile = false. Arguments.
# Advanced
#versionOrLocation: 'version' # 'version' | 'location'. Kubectl. Default: version.
#versionSpec: '1.7.0' # string. Optional. Use when versionOrLocation = version. Version spec. Default: 1.7.0.
#checkLatest: false # boolean. Optional. Use when versionOrLocation = version. Check for latest version. Default: false.
#specifyLocation: # string. Required when versionOrLocation = location. Path to Kubectl.
#workingDirectory: '$(System.DefaultWorkingDirectory)' # string. Alias: cwd. Working directory. Default: $(System.DefaultWorkingDirectory).
# Output
#outputFormat: 'json' # 'json' | 'yaml'. Output format. Default: json.
#kubectlOutput: # string. Output variable name.
Masukan
kubernetesServiceConnection
-
koneksi layanan Kubernetes
Alias input: kubernetesServiceEndpoint
.
string
.
Pilih koneksi layanan Kubernetes.
namespace
-
Namespace
string
.
Menentukan namespace untuk perintah kubectl
dengan menggunakan bendera –namespace
. Jika namespace tidak disediakan, perintah akan berjalan di namespace default.
Perintah
string
. Nilai yang diizinkan: apply
, create
, delete
, exec
, expose
, get
, logs
, run
, set
, top
.
Menentukan perintah kubectl
untuk dijalankan.
useConfigurationFile
-
Menggunakan file Konfigurasi
boolean
. Nilai default: false
.
Gunakan file konfigurasi Kubernetes dengan perintah kubectl. Nama file, direktori, atau URL ke file konfigurasi Kubernetes juga dapat disediakan.
file Konfigurasi configuration
-
string
. Diperlukan saat useConfigurationFile = true
.
Menentukan nama file, direktori, atau URL ke file konfigurasi kubernetes yang digunakan dengan perintah .
Argumen
string
.
Menentukan argumen ke perintah kubectl
yang ditentukan.
secretType
-
Jenis rahasia
string
. Dibutuhkan. Nilai yang diizinkan: dockerRegistry
, generic
. Nilai default: dockerRegistry
.
Membuat atau memperbarui imagepullsecret
generik atau docker . Tentukan dockerRegistry
untuk membuat atau memperbarui imagepullsecret
registri yang dipilih.
imagePullSecret
adalah cara untuk meneruskan rahasia yang berisi kata sandi registri kontainer ke Kubelet, sehingga dapat menarik gambar privat atas nama Pod Anda.
Argumen
string
. Fakultatif. Gunakan saat secretType = generic
.
Menentukan kunci dan nilai harfiah untuk disisipkan secara rahasia. Misalnya, --from-literal=key1=value1
atau --from-literal=key2="top secret"
.
jenis Container Registry containerRegistryType
-
string
. Diperlukan saat secretType = dockerRegistry
. Nilai yang diizinkan: Azure Container Registry
, Container Registry
. Nilai default: Azure Container Registry
.
Pilih Jenis registri kontainer. Tugas ini dapat menggunakan detail Langganan Azure untuk bekerja dengan registri Azure Container. Registri Kontainer standar lainnya juga didukung.
koneksi layanan Docker Registry dockerRegistryConnection
-
Alias input: dockerRegistryEndpoint
.
string
. Fakultatif. Gunakan saat secretType = dockerRegistry && containerRegistryType = Container Registry
.
Pilih koneksi layanan registri Docker. Diperlukan untuk perintah yang perlu diautentikasi dengan registri.
langganan Azure
Alias input: azureSubscriptionEndpoint
.
string
. Fakultatif. Gunakan saat secretType = dockerRegistry && containerRegistryType = Azure Container Registry
.
Menentukan langganan Azure Resource Manager, yang berisi Azure Container Registry.
Nota
Untuk mengonfigurasi koneksi layanan baru, pilih langganan Azure dari daftar dan klik Authorize
. Jika langganan Anda tidak tercantum atau jika Anda ingin menggunakan Perwakilan Layanan yang ada, Anda dapat menyiapkan koneksi layanan Azure menggunakan tombol Add
atau Manage
.
azureContainerRegistry
-
Registri Kontainer Azure
string
. Fakultatif. Gunakan saat secretType = dockerRegistry && containerRegistryType = Azure Container Registry
.
Menentukan Azure Container Registry yang digunakan untuk menarik gambar kontainer dan menyebarkan aplikasi ke kluster Kubernetes. Diperlukan untuk perintah yang perlu diautentikasi dengan registri.
Nama rahasia secretName
-
string
.
Nama rahasia. Anda dapat menggunakan nama rahasia ini dalam file konfigurasi YAML Kubernetes.
forceUpdate
-
Force memperbarui rahasia
boolean
. Nilai default: true
.
Hapus rahasia jika ada dan buat yang baru dengan nilai yang diperbarui.
nama ConfigMap configMapName
-
string
.
ConfigMaps memungkinkan Anda memisahkan artefak konfigurasi dari konten gambar untuk menjaga aplikasi kontainer tetap portabel.
forceUpdateConfigMap
-
Paksa configmap pembaruan
boolean
. Nilai default: false
.
Hapus peta konfigurasi jika ada dan buat yang baru dengan nilai yang diperbarui.
useConfigMapFile
-
Menggunakan file
boolean
. Nilai default: false
.
Buat ConfigMap dari file individual, atau dari beberapa file dengan menentukan direktori.
file configMapFile
- ConfigMap
string
. Diperlukan saat useConfigMapFile = true
.
Tentukan file atau direktori yang berisi configMaps.
Argumen
string
. Fakultatif. Gunakan saat useConfigMapFile = false
.
Menentukan kunci dan nilai harfiah untuk disisipkan dalam configMap
. Misalnya, --from-literal=key1=value1
atau --from-literal=key2="top secret"
.
Kubectl versionOrLocation
-
string
. Nilai yang diizinkan: version
, location
(Tentukan lokasi). Nilai default: version
.
kubectl adalah antarmuka baris perintah untuk menjalankan perintah terhadap kluster Kubernetes.
spesifikasi Versi versionSpec
-
string
. Fakultatif. Gunakan saat versionOrLocation = version
. Nilai default: 1.7.0
.
Menentukan Spesifikasi Versi versi yang akan didapatkan. Contoh: 1.7.0
, 1.x.0
, 4.x.0
, 6.10.0
, >=6.10.0
.
checkLatest
-
Periksa versi terbaru
boolean
. Fakultatif. Gunakan saat versionOrLocation = version
. Nilai default: false
.
Selalu periksa secara online untuk versi terbaru yang tersedia (stable.txt) yang memenuhi spesifikasi versi. Ini biasanya salah kecuali Anda memiliki skenario tertentu untuk selalu mendapatkan yang terbaru. Ini akan menyebabkannya dikenakan biaya unduhan ketika berpotensi tidak diperlukan, terutama dengan kumpulan build yang dihosting.
Jalur specifyLocation
- ke Kubectl
string
. Diperlukan saat versionOrLocation = location
.
Menentukan jalur lengkap ke file kubectl.exe
.
Direktori kerja
Alias input: cwd
.
string
. Nilai default: $(System.DefaultWorkingDirectory)
.
Direktori kerja untuk perintah Kubectl.
format Output outputFormat
-
string
. Nilai yang diizinkan: json
, yaml
. Nilai default: json
.
Format output.
nama variabel output kubectlOutput
-
string
.
Nama variabel tempat output perintah harus disimpan.
Opsi kontrol tugas
Semua tugas memiliki opsi kontrol selain input tugasnya. Untuk informasi selengkapnya, lihat opsi Kontrol dan properti tugas umum.
Variabel output
Tidak ada.
Persyaratan
Persyaratan | Deskripsi |
---|---|
Jenis alur | YAML, Build klasik, Rilis klasik |
Berjalan pada | Agen, DeploymentGroup |
Permintaan |
Tidak |
Kemampuan |
Tugas ini tidak memenuhi tuntutan apa pun untuk tugas berikutnya dalam pekerjaan. |
pembatasan Perintah |
Apapun |
variabel yang Dapat Diatur |
Apapun |
Versi agen | Semua versi agen yang didukung. |
Kategori tugas | Terapkan |