Kubernetes@1 – Kubectl v1 feladat
Kubectl-parancsok futtatásával üzembe helyezhet, konfigurálhatja és frissítheti a Kubernetes-fürtöt az Azure Container Service-ben.
Kubectl-parancsok futtatásával üzembe helyezheti, konfigurálhatja és frissítheti a Kubernetes-fürtöt az Azure Container Service-ben.
Szintaxis
# Kubectl v1
# Deploy, configure, update a Kubernetes cluster in Azure Container Service by running kubectl commands.
- task: Kubernetes@1
inputs:
# Kubernetes Cluster
#connectionType: 'Kubernetes Service Connection' # 'Azure Resource Manager' | 'Kubernetes Service Connection' | 'None'. Required when command != logout. Service connection type. Default: Kubernetes Service Connection.
#kubernetesServiceEndpoint: # string. Required when connectionType = Kubernetes Service Connection && command != logout. Kubernetes service connection.
#azureSubscriptionEndpoint: # string. Required when connectionType = Azure Resource Manager && command != logout. Azure subscription.
#azureResourceGroup: # string. Required when connectionType = Azure Resource Manager && command != logout. Resource group.
#kubernetesCluster: # string. Required when connectionType = Azure Resource Manager && command != logout. Kubernetes cluster.
#useClusterAdmin: false # boolean. Optional. Use when connectionType = Azure Resource Manager && command != logout. Use cluster admin credentials. Default: false.
#namespace: # string. Optional. Use when command != logout. Namespace.
# Commands
#command: # 'apply' | 'create' | 'delete' | 'exec' | 'expose' | 'get' | 'login' | 'logout' | 'logs' | 'run' | 'set' | 'top'. Command.
#useConfigurationFile: false # boolean. Optional. Use when command != login && command != logout. Use configuration. Default: false.
#configurationType: 'configuration' # 'configuration' | 'inline'. Optional. Use when useConfigurationFile = true. Configuration type. Default: configuration.
configuration: # string. Required when configurationType = configuration. File path.
#inline: # string. Required when configurationType = inline. Inline configuration.
#arguments: # string. Optional. Use when command != login && command != logout. Arguments.
# Secrets
#secretType: 'dockerRegistry' # 'dockerRegistry' | 'generic'. Required when command != login && command != logout. Type of secret. Default: dockerRegistry.
#secretArguments: # string. Optional. Use when secretType = generic && command != login && command != logout. Arguments.
#containerRegistryType: 'Azure Container Registry' # 'Azure Container Registry' | 'Container Registry'. Required when secretType = dockerRegistry && command != login && command != logout. Container registry type. Default: Azure Container Registry.
#dockerRegistryEndpoint: # string. Optional. Use when secretType = dockerRegistry && containerRegistryType = Container Registry && command != login && command != logout. Docker registry service connection.
#azureSubscriptionEndpointForSecrets: # string. Optional. Use when secretType = dockerRegistry && containerRegistryType = Azure Container Registry && command != login && command != logout. Azure subscription.
#azureContainerRegistry: # string. Optional. Use when secretType = dockerRegistry && containerRegistryType = Azure Container Registry && command != login && command != logout. Azure container registry.
#secretName: # string. Optional. Use when command != login && command != logout. Secret name.
#forceUpdate: true # boolean. Optional. Use when command != login && command != logout. Force update secret. Default: true.
# ConfigMaps
#configMapName: # string. Optional. Use when command != login && command != logout. ConfigMap name.
#forceUpdateConfigMap: false # boolean. Optional. Use when command != login && command != logout. Force update configmap. Default: false.
#useConfigMapFile: false # boolean. Optional. Use when command != login && command != logout. Use file. Default: false.
#configMapFile: # string. Required when useConfigMapFile = true && command != login && command != logout. ConfigMap file.
#configMapArguments: # string. Optional. Use when useConfigMapFile = false && command != login && command != logout. Arguments.
# Advanced
#versionOrLocation: 'version' # 'version' | 'location'. Kubectl. Default: version.
#versionSpec: '1.13.2' # string. Optional. Use when versionOrLocation = version. Version spec. Default: 1.13.2.
#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).
#outputFormat: 'json' # 'json' | 'yaml' | 'none'. Output format. Default: json.
# Kubectl v1
# Deploy, configure, update a Kubernetes cluster in Azure Container Service by running kubectl commands.
- task: Kubernetes@1
inputs:
# Kubernetes Cluster
#connectionType: 'Kubernetes Service Connection' # 'Azure Resource Manager' | 'Kubernetes Service Connection' | 'None'. Required when command != logout. Service connection type. Default: Kubernetes Service Connection.
#kubernetesServiceEndpoint: # string. Required when connectionType = Kubernetes Service Connection && command != logout. Kubernetes service connection.
#azureSubscriptionEndpoint: # string. Required when connectionType = Azure Resource Manager && command != logout. Azure subscription.
#azureResourceGroup: # string. Required when connectionType = Azure Resource Manager && command != logout. Resource group.
#kubernetesCluster: # string. Required when connectionType = Azure Resource Manager && command != logout. Kubernetes cluster.
#useClusterAdmin: false # boolean. Optional. Use when connectionType = Azure Resource Manager && command != logout. Use cluster admin credentials. Default: false.
#namespace: # string. Optional. Use when command != logout. Namespace.
# Commands
#command: # 'apply' | 'create' | 'delete' | 'exec' | 'expose' | 'get' | 'login' | 'logout' | 'logs' | 'run' | 'set' | 'top'. Command.
#useConfigurationFile: false # boolean. Optional. Use when command != login && command != logout. Use configuration. Default: false.
#configurationType: 'configuration' # 'configuration' | 'inline'. Optional. Use when useConfigurationFile = true. Configuration type. Default: configuration.
configuration: # string. Required when configurationType = configuration. File path.
#inline: # string. Required when configurationType = inline. Inline configuration.
#arguments: # string. Optional. Use when command != login && command != logout. Arguments.
# Secrets
#secretType: 'dockerRegistry' # 'dockerRegistry' | 'generic'. Required when command != login && command != logout. Type of secret. Default: dockerRegistry.
#secretArguments: # string. Optional. Use when secretType = generic && command != login && command != logout. Arguments.
#containerRegistryType: 'Azure Container Registry' # 'Azure Container Registry' | 'Container Registry'. Required when secretType = dockerRegistry && command != login && command != logout. Container registry type. Default: Azure Container Registry.
#dockerRegistryEndpoint: # string. Optional. Use when secretType = dockerRegistry && containerRegistryType = Container Registry && command != login && command != logout. Docker registry service connection.
#azureSubscriptionEndpointForSecrets: # string. Optional. Use when secretType = dockerRegistry && containerRegistryType = Azure Container Registry && command != login && command != logout. Azure subscription.
#azureContainerRegistry: # string. Optional. Use when secretType = dockerRegistry && containerRegistryType = Azure Container Registry && command != login && command != logout. Azure container registry.
#secretName: # string. Optional. Use when command != login && command != logout. Secret name.
#forceUpdate: true # boolean. Optional. Use when command != login && command != logout. Force update secret. Default: true.
# ConfigMaps
#configMapName: # string. Optional. Use when command != login && command != logout. ConfigMap name.
#forceUpdateConfigMap: false # boolean. Optional. Use when command != login && command != logout. Force update configmap. Default: false.
#useConfigMapFile: false # boolean. Optional. Use when command != login && command != logout. Use file. Default: false.
#configMapFile: # string. Required when useConfigMapFile = true && command != login && command != logout. ConfigMap file.
#configMapArguments: # string. Optional. Use when useConfigMapFile = false && command != login && command != logout. Arguments.
# Advanced
#versionOrLocation: 'version' # 'version' | 'location'. Kubectl. Default: version.
#versionSpec: '1.13.2' # string. Optional. Use when versionOrLocation = version. Version spec. Default: 1.13.2.
#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).
#outputFormat: 'json' # 'json' | 'yaml'. Output format. Default: json.
# Deploy to Kubernetes v1
# Deploy, configure, update a Kubernetes cluster in Azure Container Service by running kubectl commands.
- task: Kubernetes@1
inputs:
# Kubernetes Cluster
#connectionType: 'Kubernetes Service Connection' # 'Azure Resource Manager' | 'Kubernetes Service Connection' | 'None'. Required when command != logout. Service connection type. Default: Kubernetes Service Connection.
#kubernetesServiceEndpoint: # string. Required when connectionType = Kubernetes Service Connection && command != logout. Kubernetes service connection.
#azureSubscriptionEndpoint: # string. Required when connectionType = Azure Resource Manager && command != logout. Azure subscription.
#azureResourceGroup: # string. Required when connectionType = Azure Resource Manager && command != logout. Resource group.
#kubernetesCluster: # string. Required when connectionType = Azure Resource Manager && command != logout. Kubernetes cluster.
#useClusterAdmin: false # boolean. Optional. Use when connectionType = Azure Resource Manager && command != logout. Use cluster admin credentials. Default: false.
#namespace: # string. Optional. Use when command != logout. Namespace.
# Commands
#command: # 'apply' | 'create' | 'delete' | 'exec' | 'expose' | 'get' | 'login' | 'logout' | 'logs' | 'run' | 'set' | 'top'. Command.
#useConfigurationFile: false # boolean. Optional. Use when command != login && command != logout. Use configuration. Default: false.
#configurationType: 'configuration' # 'configuration' | 'inline'. Optional. Use when useConfigurationFile = true. Configuration type. Default: configuration.
configuration: # string. Required when configurationType = configuration. File path.
#inline: # string. Required when configurationType = inline. Inline configuration.
#arguments: # string. Optional. Use when command != login && command != logout. Arguments.
# Secrets
#secretType: 'dockerRegistry' # 'dockerRegistry' | 'generic'. Required when command != login && command != logout. Type of secret. Default: dockerRegistry.
#secretArguments: # string. Optional. Use when secretType = generic && command != login && command != logout. Arguments.
#containerRegistryType: 'Azure Container Registry' # 'Azure Container Registry' | 'Container Registry'. Required when secretType = dockerRegistry && command != login && command != logout. Container registry type. Default: Azure Container Registry.
#dockerRegistryEndpoint: # string. Optional. Use when secretType = dockerRegistry && containerRegistryType = Container Registry && command != login && command != logout. Docker registry service connection.
#azureSubscriptionEndpointForSecrets: # string. Optional. Use when secretType = dockerRegistry && containerRegistryType = Azure Container Registry && command != login && command != logout. Azure subscription.
#azureContainerRegistry: # string. Optional. Use when secretType = dockerRegistry && containerRegistryType = Azure Container Registry && command != login && command != logout. Azure container registry.
#secretName: # string. Optional. Use when command != login && command != logout. Secret name.
#forceUpdate: true # boolean. Optional. Use when command != login && command != logout. Force update secret. Default: true.
# ConfigMaps
#configMapName: # string. Optional. Use when command != login && command != logout. ConfigMap name.
#forceUpdateConfigMap: false # boolean. Optional. Use when command != login && command != logout. Force update configmap. Default: false.
#useConfigMapFile: false # boolean. Optional. Use when command != login && command != logout. Use file. Default: false.
#configMapFile: # string. Required when useConfigMapFile = true && command != login && command != logout. ConfigMap file.
#configMapArguments: # string. Optional. Use when useConfigMapFile = false && command != login && command != logout. Arguments.
# Advanced
#versionOrLocation: 'version' # 'version' | 'location'. Kubectl. Default: version.
#versionSpec: '1.13.2' # string. Optional. Use when versionOrLocation = version. Version spec. Default: 1.13.2.
#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).
#outputFormat: 'json' # 'json' | 'yaml'. Output format. Default: json.
# Deploy to Kubernetes v1
# Deploy, configure, update your Kubernetes cluster in Azure Container Service by running kubectl commands.
- task: Kubernetes@1
inputs:
# Kubernetes Cluster
#connectionType: 'Azure Resource Manager' # 'Azure Resource Manager' | 'Kubernetes Service Connection' | 'None'. Required when command != logout. Service connection type. Default: Azure Resource Manager.
#kubernetesServiceEndpoint: # string. Required when connectionType = Kubernetes Service Connection && command != logout. Kubernetes service connection.
#azureSubscriptionEndpoint: # string. Required when connectionType = Azure Resource Manager && command != logout. Azure subscription.
#azureResourceGroup: # string. Required when connectionType = Azure Resource Manager && command != logout. Resource group.
#kubernetesCluster: # string. Required when connectionType = Azure Resource Manager && command != logout. Kubernetes cluster.
#namespace: # string. Optional. Use when command != logout. Namespace.
# Commands
command: 'apply' # 'apply' | 'create' | 'delete' | 'exec' | 'expose' | 'get' | 'login' | 'logout' | 'logs' | 'run' | 'set' | 'top'. Required. Command. Default: apply.
#useConfigurationFile: false # boolean. Optional. Use when command != login && command != logout. Use configuration files. Default: false.
#configuration: # string. Required when useConfigurationFile = true. Configuration file.
#arguments: # string. Optional. Use when command != login && command != logout. Arguments.
# Secrets
#secretType: 'dockerRegistry' # 'dockerRegistry' | 'generic'. Required when command != login && command != logout. Type of secret. Default: dockerRegistry.
#secretArguments: # string. Optional. Use when secretType = generic && command != login && command != logout. Arguments.
#containerRegistryType: 'Azure Container Registry' # 'Azure Container Registry' | 'Container Registry'. Required when secretType = dockerRegistry && command != login && command != logout. Container registry type. Default: Azure Container Registry.
#dockerRegistryEndpoint: # string. Optional. Use when secretType = dockerRegistry && containerRegistryType = Container Registry && command != login && command != logout. Docker registry service connection.
#azureSubscriptionEndpointForSecrets: # string. Optional. Use when secretType = dockerRegistry && containerRegistryType = Azure Container Registry && command != login && command != logout. Azure subscription.
#azureContainerRegistry: # string. Optional. Use when secretType = dockerRegistry && containerRegistryType = Azure Container Registry && command != login && command != logout. Azure container registry.
#secretName: # string. Optional. Use when command != login && command != logout. Secret name.
#forceUpdate: true # boolean. Optional. Use when command != login && command != logout. Force update secret. Default: true.
# ConfigMaps
#configMapName: # string. Optional. Use when command != login && command != logout. ConfigMap name.
#forceUpdateConfigMap: false # boolean. Optional. Use when command != login && command != logout. Force update configmap. Default: false.
#useConfigMapFile: false # boolean. Optional. Use when command != login && command != logout. Use file. Default: false.
#configMapFile: # string. Required when useConfigMapFile = true && command != login && command != logout. ConfigMap file.
#configMapArguments: # string. Optional. Use when useConfigMapFile = false && command != login && command != logout. Arguments.
# Advanced
#versionOrLocation: 'version' # 'version' | 'location'. Optional. Use when command != login && command != logout. Kubectl. Default: version.
#versionSpec: '1.7.0' # string. Optional. Use when versionOrLocation = version && command != login && command != logout. Version spec. Default: 1.7.0.
#checkLatest: false # boolean. Optional. Use when versionOrLocation = version && command != login && command != logout. Check for latest version. Default: false.
#specifyLocation: # string. Required when versionOrLocation = location && command != login && command != logout. Path to kubectl.
#workingDirectory: '$(System.DefaultWorkingDirectory)' # string. Alias: cwd. Optional. Use when command != login && command != logout. Working directory. Default: $(System.DefaultWorkingDirectory).
#outputFormat: 'json' # 'json' | 'yaml'. Optional. Use when command != login && command != logout. Output format. Default: json.
Bemenetek
connectionType
-
szolgáltatáskapcsolat típusa
string
.
command != logout
esetén kötelező. Engedélyezett értékek: Azure Resource Manager
, Kubernetes Service Connection
, None
. Alapértelmezett érték: Kubernetes Service Connection
.
Megadja a szolgáltatáskapcsolat típusát: Azure Resource Manager az Azure Kubernetes Service vagy a Kubernetes Service Connection bármely más fürthöz való használatakor.
-
Kubernetes Service Connection
– Lehetővé teszi KubeConfig-fájl megadását, szolgáltatásfiók megadását vagy AKS-példány importálását az Azure-előfizetés lehetőséggel. Az AKS-példány Azure-előfizetés beállítással történő importálásához Kubernetes-fürthozzáférés szükséges a Szolgáltatáskapcsolat konfigurációs ideje alatt. -
Azure Resource Manager
– Lehetővé teszi egy AKS-példány kiválasztását. Nem fér hozzá a Kubernetes-fürthöz a Szolgáltatáskapcsolat konfigurációs ideje alatt. -
None
– Helyileg tárolt, előre létrehozott Kubernetes-konfiguráció használata.
További információ: Szolgáltatáskapcsolat az alábbi Megjegyzések szakaszban.
connectionType
-
szolgáltatáskapcsolat típusa
string
.
command != logout
esetén kötelező. Engedélyezett értékek: Azure Resource Manager
, Kubernetes Service Connection
, None
. Alapértelmezett érték: Azure Resource Manager
.
Megadja a szolgáltatáskapcsolat típusát: Azure Resource Manager az Azure Kubernetes Service vagy a Kubernetes Service Connection bármely más fürthöz való használatakor.
kubernetesServiceEndpoint
-
Kubernetes szolgáltatáskapcsolati
string
.
connectionType = Kubernetes Service Connection && command != logout
esetén kötelező.
Válasszon egy Kubernetes-szolgáltatáskapcsolatot.
Azure-előfizetés azureSubscriptionEndpoint
-
string
.
connectionType = Azure Resource Manager && command != logout
esetén kötelező.
Megadja az Azure Resource Manager-előfizetést, amely tartalmazza az Azure Container Registryt.
Jegyzet
Új szolgáltatáskapcsolat konfigurálásához adja meg az Azure-előfizetést a listából, és kattintson a Authorize
gombra. Ha az előfizetés nem szerepel a listában, vagy ha meglévő szolgáltatásnevet szeretne használni, az Add
vagy Manage
gombokkal beállíthat egy Azure-szolgáltatáskapcsolatot.
azureResourceGroup
-
erőforráscsoport
string
.
connectionType = Azure Resource Manager && command != logout
esetén kötelező.
Válasszon ki egy Azure-erőforráscsoportot.
kubernetesCluster
-
Kubernetes-fürt
string
.
connectionType = Azure Resource Manager && command != logout
esetén kötelező.
Válasszon ki egy Felügyelt Azure-fürtöt.
useClusterAdmin
-
Fürt rendszergazdai hitelesítő adatainak használata
boolean
. Szabadon választható. Használja a connectionType = Azure Resource Manager && command != logout
. Alapértelmezett érték: false
.
Használjon fürtadminisztrátori hitelesítő adatokat az alapértelmezett fürtfelhasználói hitelesítő adatok helyett.
namespace
-
névtér
string
. Szabadon választható. Használja a command != logout
.
Állítsa be a kubectl parancs névterét a –névtér jelölővel. Ha a névtér nincs megadva, a parancsok az alapértelmezett névtérben futnak.
command
-
parancs
string
. Engedélyezett értékek: apply
, create
, delete
, exec
, expose
, get
, login
, logout
, logs
, run
, set
, top
.
Válassza ki vagy adja meg a futtatni kívánt kubectl-parancsot. Az engedélyezett értékek listája a feladatsegéd használatakor gyakran használható lehetőségeket kínál a könnyű kijelöléshez, de más kubectl-parancsokat is megadhat, például scale
. A arguments
bemenettel további paramétereket adhat meg a megadott kubectl
parancshoz.
command
-
parancs
string
. Szükséges. Engedélyezett értékek: apply
, create
, delete
, exec
, expose
, get
, login
, logout
, logs
, run
, set
, top
. Alapértelmezett érték: apply
.
Válassza ki vagy adja meg a futtatni kívánt kubectl-parancsot.
useConfigurationFile
-
Konfigurációs használata
boolean
. Szabadon választható. Használja a command != login && command != logout
. Alapértelmezett érték: false
.
Megadja az kubectl
paranccsal használni kívánt Kubernetes-konfigurációt. A Kubernetes konfigurációs fájljainak beágyazott szkriptje, fájlneve, könyvtára vagy URL-címe megadható.
useConfigurationFile
-
Konfigurációs fájlok használata
boolean
. Szabadon választható. Használja a command != login && command != logout
. Alapértelmezett érték: false
.
Megadja az kubectl
paranccsal használni kívánt Kubernetes-konfigurációt. A Kubernetes konfigurációs fájljainak beágyazott szkriptje, fájlneve, könyvtára vagy URL-címe megadható.
configurationType
-
Konfiguráció típusa
string
. Szabadon választható. Használja a useConfigurationFile = true
. Engedélyezett értékek: configuration
(Fájl elérési útja), inline
(Beágyazott konfiguráció). Alapértelmezett érték: configuration
.
Megadja a Kubernetes-konfiguráció típusát a kubectl
parancshoz. Ez lehet fájl elérési útja vagy beágyazott szkript.
configuration
-
fájl elérési útja
string
.
configurationType = configuration
esetén kötelező.
Megadja a parancsokkal használt kubernetes-konfigurációs fájlok fájlnevét, könyvtárát vagy URL-címét.
configuration
-
konfigurációs fájl
string
.
useConfigurationFile = true
esetén kötelező.
Megadja a parancsokkal használt kubernetes-konfigurációs fájlok fájlnevét, könyvtárát vagy URL-címét.
inline
-
beágyazott konfigurációs
string
.
configurationType = inline
esetén kötelező.
A kubectl
parancs beágyazott üzembehelyezési konfigurációját adja meg.
arguments
-
argumentumok
string
. Szabadon választható. Használja a command != login && command != logout
.
A megadott kubectl parancs argumentumai.
secretType
-
titkos típusa
string
.
command != login && command != logout
esetén kötelező. Engedélyezett értékek: dockerRegistry
, generic
. Alapértelmezett érték: dockerRegistry
.
Általános vagy docker imagepullsecret létrehozása/frissítése. Válassza a dockerRegistry lehetőséget a kijelölt beállításjegyzék imagepullsecretjének létrehozásához/frissítéséhez. Az imagePullSecret egy olyan titkos kód átadása, amely tárolóregisztrációs adatbázisjelszót tartalmaz a Kubeletnek, így lekérhet egy privát rendszerképet a pod nevében.
secretArguments
-
argumentumok
string
. Szabadon választható. Használja a secretType = generic && command != login && command != logout
.
Megadja a titkos kódba beszúrni kívánt kulcsokat és literális értékeket. Például --from-literal=key1=value1
vagy --from-literal=key2="top secret"
.
containerRegistryType
-
Tárolóregisztrációs adatbázis típusa
string
.
secretType = dockerRegistry && command != login && command != logout
esetén kötelező. Engedélyezett értékek: Azure Container Registry
, Container Registry
. Alapértelmezett érték: Azure Container Registry
.
Válasszon egy tárolóregisztrációs adatbázistípust. A feladat az Azure-előfizetés adatait használhatja az Azure Container Registry használatához. Egyéb szabványos tárolóregisztrációs adatbázisok is támogatottak.
dockerRegistryEndpoint
-
Docker beállításjegyzék-szolgáltatás kapcsolati
string
. Szabadon választható. Használja a secretType = dockerRegistry && containerRegistryType = Container Registry && command != login && command != logout
.
Válasszon egy Docker beállításjegyzék-szolgáltatáskapcsolatot. A beállításjegyzékkel hitelesíteni kívánt parancsokhoz szükséges.
Azure-előfizetés azureSubscriptionEndpointForSecrets
-
string
. Szabadon választható. Használja a secretType = dockerRegistry && containerRegistryType = Azure Container Registry && command != login && command != logout
.
Az Azure Container Registryt tartalmazó Azure Resource Manager-előfizetést adja meg.
Jegyzet
Új szolgáltatáskapcsolat konfigurálásához válassza ki az Azure-előfizetést a listából, és kattintson a Authorize
. Ha az előfizetés nem szerepel a listában, vagy ha meglévő szolgáltatásnevet szeretne használni, az Add
vagy Manage
gombokkal beállíthat egy Azure-szolgáltatáskapcsolatot.
azureContainerRegistry
-
Azure Container Registry-
string
. Szabadon választható. Használja a secretType = dockerRegistry && containerRegistryType = Azure Container Registry && command != login && command != logout
.
Egy Azure Container Registryt határoz meg, amely tárolólemezképek lekérésére és alkalmazások Kubernetes-fürtön való üzembe helyezésére szolgál. A beállításjegyzékkel hitelesíteni kívánt parancsokhoz szükséges.
secretName
-
titkos kódnév
string
. Szabadon választható. Használja a command != login && command != logout
.
A titkos kód neve. Ezt a titkos nevet a Kubernetes YAML konfigurációs fájljában használhatja.
forceUpdate
-
Titkos kód frissítésének kényszerítés
boolean
. Szabadon választható. Használja a command != login && command != logout
. Alapértelmezett érték: true
.
Törölje a titkos kódot, ha létezik, és hozzon létre egy újat frissített értékekkel.
configMapName
-
ConfigMap-név
string
. Szabadon választható. Használja a command != login && command != logout
.
A konfigurációtérképekkel leválaszthatja a konfigurációs összetevőket a képtartalomról, hogy a tárolóalapú alkalmazások hordozhatóak maradjanak.
forceUpdateConfigMap
-
Frissítés konfigurációtérképének kényszerítés
boolean
. Szabadon választható. Használja a command != login && command != logout
. Alapértelmezett érték: false
.
Ha létezik, törölje a konfigurációtérképet, és hozzon létre egy újat frissített értékekkel.
useConfigMapFile
-
Fájl használata
boolean
. Szabadon választható. Használja a command != login && command != logout
. Alapértelmezett érték: false
.
Létrehoz egy ConfigMap
egy adott fájlból vagy több fájlból egy könyvtár megadásával.
configMapFile
-
ConfigMap-fájl
string
.
useConfigMapFile = true && command != login && command != logout
esetén kötelező.
Adja meg a konfigurációtérképeket tartalmazó fájlt vagy könyvtárat.
configMapArguments
-
argumentumok
string
. Szabadon választható. Használja a useConfigMapFile = false && command != login && command != logout
.
Megadja a configMap
beszúrni kívánt kulcsokat és literális értékeket. Például --from-literal=key1=value1
vagy --from-literal=key2="top secret"
.
versionOrLocation
-
Kubectl
string
. Engedélyezett értékek: version
, location
(Hely megadása). Alapértelmezett érték: version
.
A kubectl egy parancssori felület, amely parancsokat futtat a Kubernetes-fürtökön.
versionOrLocation
-
Kubectl
string
. Szabadon választható. Használja a command != login && command != logout
. Engedélyezett értékek: version
, location
(Hely megadása). Alapértelmezett érték: version
.
A kubectl egy parancssori felület, amely parancsokat futtat a Kubernetes-fürtökön.
versionSpec
-
Verzió specifikációs
string
. Szabadon választható. Használja a versionOrLocation = version
. Alapértelmezett érték: 1.13.2
.
Megadja a lekérendő verzió specifikációját. Példák: 1.7.0
, 1.x.0
, 4.x.0
, 6.10.0
, >=6.10.0
.
versionSpec
-
Verzió specifikációs
string
. Szabadon választható. Használja a versionOrLocation = version && command != login && command != logout
. Alapértelmezett érték: 1.7.0
.
-18-2 A lekérendő verzió specifikációját adja meg. Példák: 1.7.0
, 1.x.0
, 4.x.0
, 6.10.0
, >=6.10.0
.
checkLatest
-
Legújabb verzió keresése
boolean
. Szabadon választható. Használja a versionOrLocation = version
. Alapértelmezett érték: false
.
Mindig online ellenőrzi a legújabb elérhető verziót (stable.txt), amely megfelel a verzió specifikációjának. Ez általában hamis, hacsak nem rendelkezik egy adott forgatókönyvvel, amely mindig a legújabb verziót kapja. Emiatt letöltési költségek merülnek fel, ha esetleg nem szükséges, különösen a üzemeltetett buildkészlet esetén.
checkLatest
-
Legújabb verzió keresése
boolean
. Szabadon választható. Használja a versionOrLocation = version && command != login && command != logout
. Alapértelmezett érték: false
.
Mindig online ellenőrzi a legújabb elérhető verziót (stable.txt), amely megfelel a verzió specifikációjának. Ez általában hamis, hacsak nem rendelkezik egy adott forgatókönyvvel, amely mindig a legújabb verziót kapja. Emiatt letöltési költségek merülnek fel, ha esetleg nem szükséges, különösen a üzemeltetett buildkészlet esetén.
specifyLocation
-
kubectl- elérési útja
string
.
versionOrLocation = location
esetén kötelező.
A kubectl.exe
fájl teljes elérési útját adja meg.
specifyLocation
-
kubectl- elérési útja
string
.
versionOrLocation = location && command != login && command != logout
esetén kötelező.
A kubectl.exe
fájl teljes elérési útját adja meg.
workingDirectory
-
Munkakönyvtár
Bemeneti alias: cwd
.
string
. Alapértelmezett érték: $(System.DefaultWorkingDirectory)
.
A Kubectl parancs munkakönyvtára.
workingDirectory
-
Munkakönyvtár
Bemeneti alias: cwd
.
string
. Szabadon választható. Használja a command != login && command != logout
. Alapértelmezett érték: $(System.DefaultWorkingDirectory)
.
A Kubectl parancs munkakönyvtára.
outputFormat
-
Kimeneti formátum
string
. Engedélyezett értékek: json
, yaml
, none
. Alapértelmezett érték: json
.
Kimeneti formátum. Az engedélyezett értékek listája a feladatsegéd használatakor gyakran használható lehetőségeket kínál, de más kimeneti beállításokat is megadhat, például jsonpath={.items[*].spec['initContainers', 'containers'][*].image}
.
outputFormat
-
Kimeneti formátum
string
. Engedélyezett értékek: json
, yaml
. Alapértelmezett érték: json
.
Kimeneti formátum. Az engedélyezett értékek listája a feladatsegéd használatakor gyakran használható lehetőségeket kínál, de más kimeneti beállításokat is megadhat, például jsonpath={.items[*].spec['initContainers', 'containers'][*].image}
.
outputFormat
-
Kimeneti formátum
string
. Szabadon választható. Használja a command != login && command != logout
. Engedélyezett értékek: json
, yaml
. Alapértelmezett érték: json
.
Kimeneti formátum. Az engedélyezett értékek listája a feladatsegéd használatakor gyakran használható lehetőségeket kínál, de más kimeneti beállításokat is megadhat, például jsonpath={.items[*].spec['initContainers', 'containers'][*].image}
.
Tevékenységvezérlési beállítások
Minden tevékenység a tevékenységbemeneteken kívül vezérlési lehetőségekkel is rendelkezik. További információ: Vezérlők és gyakori feladattulajdonságok.
Kimeneti változók
Ez a feladat a következő kimeneti változókat határozza meg, amelyeket az alsóbb rétegbeli lépésekben, feladatokban és szakaszokban használhat fel.
KubectlOutput
A kubectl
parancs kimenetét tárolja.
Megjegyzések
Az 1.0-s verzió újdonságai.
- Új szolgáltatáskapcsolattípus-bemenetet adott hozzá az Azure AKS-fürtök egyszerű kiválasztásához.
- A kimeneti változó bemenetét egy kimeneti változókra vonatkozó szakaszra cseréltük, amelyet az összes tevékenységhez hozzáadtunk.
Ezzel a feladattal kubectl-parancsok futtatásával helyezhet üzembe, konfigurálhat vagy frissíthet Kubernetes-fürtöt.
Szolgáltatáskapcsolat
A feladat két szolgáltatáskapcsolattípussal működik: Azure Resource Manager és Kubernetes Service Connection, az alábbiakban leírtak szerint.
Azure Resource Manager
Állítsa connectionType
Azure Resource Manager
, és adjon meg egy azureSubscriptionEndpoint
az Azure Resource Manager szolgáltatáskapcsolat használatához.
Ez a YAML-példa bemutatja, hogyan hivatkozik az Azure Resource Manager a Kubernetes-fürtre. Ezt a kubectl parancsok egyikével és a parancs által igényelt megfelelő értékekkel kell használni.
variables:
azureSubscriptionEndpoint: Contoso
azureContainerRegistry: contoso.azurecr.io
azureResourceGroup: Contoso
kubernetesCluster: Contoso
useClusterAdmin: false
steps:
- task: Kubernetes@1
displayName: kubectl apply
inputs:
connectionType: Azure Resource Manager
azureSubscriptionEndpoint: $(azureSubscriptionEndpoint)
azureResourceGroup: $(azureResourceGroup)
kubernetesCluster: $(kubernetesCluster)
useClusterAdmin: $(useClusterAdmin)
Kubernetes-szolgáltatáskapcsolat
Állítsa connectionType
Kubernetes Service Connection
, és adjon meg egy kubernetesServiceEndpoint
a Kubernetes-szolgáltatáskapcsolat használatához.
Ez a YAML-példa bemutatja, hogyan hivatkozik a Kubernetes-fürtre egy Kubernetes-szolgáltatáskapcsolat. Ezt a kubectl parancsok egyikével és a parancs által igényelt megfelelő értékekkel kell használni.
- task: Kubernetes@1
displayName: kubectl apply
inputs:
connectionType: Kubernetes Service Connection
kubernetesServiceEndpoint: Contoso
Kubernetes-szolgáltatáskapcsolati szempontok az AKS elérésekor
Kubernetes-szolgáltatáskapcsolatot az alábbi lehetőségek bármelyikével hozhat létre.
- KubeConfig
- Szolgáltatásfiók
- Azure-előfizetés
Az Azure-előfizetés beállítás kiválasztásakor a Kubernetesnek elérhetőnek kell lennie az Azure DevOps számára a szolgáltatáskapcsolat konfigurációs ideje alatt. Előfordulhat, hogy a szolgáltatáskapcsolat nem hozható létre, például privát fürtöt, vagy a fürt helyi fiók le van tiltva. Ezekben az esetekben az Azure DevOps nem tud csatlakozni a fürthöz a szolgáltatáskapcsolat konfigurációs ideje alatt, és elakadt a névterek betöltése képernyőn.
A Kubernetes 1.24-től kezdve a hosszú élettartamú jogkivonatok már nem jönnek létre alapértelmezés szerint. A Kubernetes azt javasolja, hogy ne használjuk a hosszú élettartamú jogkivonatokat. Ennek eredményeképpen a Azure-előfizetési beállítással létrehozott Kubernetes-szolgáltatáskapcsolatot használó feladatok nem rendelkeznek hozzáféréssel a hitelesítéshez szükséges állandó jogkivonathoz, és nem férnek hozzá a Kubernetes-fürthöz. Ez azt is eredményezi, hogy a befagyasztott A névterek betöltése párbeszédpanelen.
Az Azure Resource Manager szolgáltatáskapcsolat használata az AKS eléréséhez
Az AKS-ügyfelek számára az Azure Resource Manager szolgáltatás kapcsolattípusa biztosítja a legjobb módszert egy privát fürthöz vagy egy helyi fiókokat letiltó fürthöz való csatlakozáshoz. Ez a módszer nem függ a fürtkapcsolattól a szolgáltatáskapcsolat létrehozásakor. Az AKS-hez való hozzáférés a folyamat futtatókörnyezetére halasztható, amelynek az alábbi előnyei vannak:
- A (privát) AKS-fürthöz való hozzáférés egy saját üzemeltetésű vagy méretezési csoport ügynökéből, a fürt felé irányuló látóvonallal végezhető el.
- A rendszer létrehoz egy jogkivonatot minden olyan feladathoz, amely Azure Resource Manager-szolgáltatáskapcsolatot használ. Ez biztosítja, hogy rövid élettartamú jogkivonattal csatlakozzon a Kuberneteshez, amely Kubernetes-javaslat.
- Az AKS akkor is elérhető, ha a helyi fiókok le vannak tiltva.
Szolgáltatáskapcsolat – gyakori kérdések
A következő hibaüzenet jelenik meg: Nem található a szolgáltatásfiókhoz társított titkos kód. Mi történik?
A Kubernetes szolgáltatáskapcsolatot az Azure-előfizetés lehetőséggel használja. Ezt a módszert úgy frissítjük, hogy hosszú élettartamú jogkivonatokat hozzon létre. Ez várhatóan május közepén lesz elérhető. Javasoljuk azonban, hogy az Azure-szolgáltatás kapcsolattípusát használja, és ne használjon hosszú élettartamú jogkivonatokat Kubernetes-útmutató.
AKS-t használok, és nem szeretnék semmit módosítani, használhatom továbbra is a feladatokat a Kubernetes szolgáltatáskapcsolattal?
Ezt a módszert úgy frissítjük, hogy hosszú élettartamú jogkivonatokat hozzon létre. Ez várhatóan május közepén lesz elérhető. Ne feledje azonban, hogy ez a megközelítés nem Kubernetes-útmutató.
A Kubernetes-feladatokat és a Kubernetes-szolgáltatáskapcsolatot használom, de az AKS-t nem. Aggódnom kell?
A tevékenységek a korábbiakhoz hasonlóan fognak működni.
Eltávolítja a Kubernetes szolgáltatás kapcsolattípusát?
A Kubernetes-feladatok bármilyen Kubernetes-fürttel működnek, függetlenül attól, hogy hol futnak. A Kubernetes szolgáltatáskapcsolat továbbra is fennáll.
AKS-ügyfél vagyok, és minden rendben van, cselekednem kell?
Semmit sem kell megváltoztatni. Ha a Kubernetes szolgáltatáskapcsolatot használja, és a létrehozás során kiválasztotta az Azure-előfizetést, ismernie kell a hosszú élettartamú jogkivonatok Kubernetes-útmutatót.
Létrehozok egy Kubernetes-környezetet, és nincs lehetőségem szolgáltatáskapcsolatok használatára
Ha nem fér hozzá az AKS-hez a környezet létrehozása során, üres környezetet használhat, és beállíthatja a connectionType
bemenetet egy Azure Resource Manager-szolgáltatáskapcsolatra.
Az AKS az Azure Active Directory RBAC-vel van konfigurálva, és a folyamat nem működik. Ezek a frissítések megoldják ezt?
Az AAD RBAC engedélyezésekor a Kubernetes elérése nem kapcsolódik a jogkivonatok létrehozásához. Az interaktív kérések megakadályozása érdekében egy későbbi frissítésben támogatni fogjuk kubelogin.
Parancsok
A parancs bemenete elfogadja kubectl-parancsokat.
Ez a YAML-példa a parancs alkalmazásának szemlélteti:
- task: Kubernetes@1
displayName: kubectl apply using arguments
inputs:
connectionType: Azure Resource Manager
azureSubscriptionEndpoint: $(azureSubscriptionEndpoint)
azureResourceGroup: $(azureResourceGroup)
kubernetesCluster: $(kubernetesCluster)
command: apply
arguments: -f mhc-aks.yaml
Ez a YAML-példa egy konfigurációs fájl használatát mutatja be a parancs alkalmazásával:
- task: Kubernetes@1
displayName: kubectl apply using configFile
inputs:
connectionType: Azure Resource Manager
azureSubscriptionEndpoint: $(azureSubscriptionEndpoint)
azureResourceGroup: $(azureResourceGroup)
kubernetesCluster: $(kubernetesCluster)
command: apply
useConfigurationFile: true
configuration: mhc-aks.yaml
Ez a YAML-példa bemutatja, hogyan használhatja a skálázási parancsot az üzembe helyezés replikáinak számának 0-ra való csökkentéséhez.
- task: Kubernetes@1
displayName: 'Scale down deployment $(k8sDeployment) to 0'
inputs:
connectionType: 'Kubernetes Service Connection'
kubernetesServiceEndpoint: $(kubernetesServiceConnection)
command: 'scale'
arguments: 'deployment/$(k8sDeployment) --replicas=0'
namespace: $(namespace)
Titkok
Az titkos típusú Kubernetes-objektumok bizalmas információkat, például jelszavakat, OAuth-jogkivonatokat és ssh-kulcsokat tárolnak. Az információk titkos kódba helyezése biztonságosabb és rugalmasabb, mint a poddefiníciókban vagy Docker-rendszerképekben való szó szerinti elhelyezés. Az Azure Pipelines leegyszerűsíti a ImagePullSecrets
szolgáltatásfiókhoz való hozzáadását, vagy az általános titkos kódok beállítását az alábbiak szerint.
ImagePullSecret
Ez a YAML-példa bemutatja az ImagePullSecrets beállítását:
- task: Kubernetes@1
displayName: kubectl apply for secretType dockerRegistry
inputs:
azureSubscriptionEndpoint: $(azureSubscriptionEndpoint)
azureResourceGroup: $(azureResourceGroup)
kubernetesCluster: $(kubernetesCluster)
command: apply
arguments: -f mhc-aks.yaml
secretType: dockerRegistry
containerRegistryType: Azure Container Registry
azureSubscriptionEndpointForSecrets: $(azureSubscriptionEndpoint)
azureContainerRegistry: $(azureContainerRegistry)
secretName: mysecretkey2
forceUpdate: true
Általános titkos kódok
Ez a YAML-példa általános titkos kulcsokat hoz létre a secretArguments bemenethez megadott literális értékekből:
- task: Kubernetes@1
displayName: secretType generic with literal values
inputs:
azureSubscriptionEndpoint: $(azureSubscriptionEndpoint)
azureResourceGroup: $(azureResourceGroup)
kubernetesCluster: $(kubernetesCluster)
command: apply
arguments: -f mhc-aks.yaml
secretType: generic
secretArguments: --from-literal=contoso=5678
secretName: mysecretkey
A folyamatváltozók a literális értékek megadására szolgáló argumentumok átadására használhatók, ahogy az itt látható:
- task: Kubernetes@1
displayName: secretType generic with pipeline variables
inputs:
azureSubscriptionEndpoint: $(azureSubscriptionEndpoint)
azureResourceGroup: $(azureResourceGroup)
kubernetesCluster: $(kubernetesCluster)
command: apply
arguments: -f mhc-aks.yaml
secretType: generic
secretArguments: --from-literal=contoso=$(contosovalue)
secretName: mysecretkey
ConfigMap
A ConfigMaps lehetővé teszi a konfigurációs összetevők leválasztását a képtartalomtól a tárolóalapú alkalmazások hordozhatóságának fenntartása érdekében.
Ez a YAML-példa egy ConfigMap-fájlra mutató konfigurációtérképet hoz létre:
- task: Kubernetes@1
displayName: kubectl apply
inputs:
configMapName: myconfig
useConfigMapFile: true
configMapFile: src/configmap
Ez a YAML-példa létrehoz egy konfigurációtérképet úgy, hogy a konstans értékeket közvetlenül a configMapArguments bemenetként adja meg, és a kényszeríti az igaz értékre állítását:
- task: Kubernetes@1
displayName: configMap with literal values
inputs:
azureSubscriptionEndpoint: $(azureSubscriptionEndpoint)
azureResourceGroup: $(azureResourceGroup)
kubernetesCluster: $(kubernetesCluster)
command: apply
arguments: -f mhc-aks.yaml
secretType: generic
secretArguments: --from-literal=contoso=$(contosovalue)
secretName: mysecretkey4
configMapName: myconfig
forceUpdateConfigMap: true
configMapArguments: --from-literal=myname=contoso
A folyamatváltozók használatával konstansértékeket adhat át a ConfigMap létrehozásakor, ahogy az itt látható:
- task: Kubernetes@1
displayName: configMap with pipeline variables
inputs:
azureSubscriptionEndpoint: $(azureSubscriptionEndpoint)
azureResourceGroup: $(azureResourceGroup)
kubernetesCluster: $(kubernetesCluster)
command: apply
arguments: -f mhc-aks.yaml
secretType: generic
secretArguments: --from-literal=contoso=$(contosovalue)
secretName: mysecretkey4
configMapName: myconfig
forceUpdateConfigMap: true
configMapArguments: --from-literal=myname=$(contosovalue)
Hibaelhárítás
A Kubernetes-fürt egy tűzfal mögött található, és üzemeltetett ügynököket használok. Hogyan helyezhetem üzembe ezt a fürtöt?
A üzemeltetett ügynököknek a tűzfalon keresztüli hozzáférést úgy biztosíthat, hogy engedélyezi az üzemeltetett ügynökök IP-címeit. További részletekért lásd ügynök IP-címtartományait
Követelmények
Követelmény | Leírás |
---|---|
Folyamattípusok | YAML, klasszikus build, klasszikus kiadás |
Futtatás bekapcsolva | Ügynök, DeploymentGroup |
Követelmények | Egyik sem |
képességek | Ez a tevékenység nem felel meg a feladat későbbi tevékenységeire vonatkozó követelményeknek. |
parancskorlátozások | Bármely |
Változók beállítása | Bármely |
Ügynök verziója | Minden támogatott ügynökverzió. |
Tevékenységkategória | Felfejlődik |