Megosztás a következőn keresztül:


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 != logouteseté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 != logouteseté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 != logoutesetén kötelező.

Válasszon egy Kubernetes-szolgáltatáskapcsolatot.


Azure-előfizetés azureSubscriptionEndpoint -
string. connectionType = Azure Resource Manager && command != logouteseté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 Authorizegombra. 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 != logoutesetén kötelező.

Válasszon ki egy Azure-erőforráscsoportot.


kubernetesCluster - Kubernetes-fürt
string. connectionType = Azure Resource Manager && command != logouteseté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 = configurationeseté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 = trueeseté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 = inlineeseté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 != logouteseté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=value1vagy --from-literal=key2="top secret".


containerRegistryType - Tárolóregisztrációs adatbázis típusa
string. secretType = dockerRegistry && command != login && command != logouteseté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 != logouteseté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 configMapbeszú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 = locationeseté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 != logouteseté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 connectionTypeAzure 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 connectionTypeKubernetes 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

Képernyőkép a Kubernetes-szolgáltatás kapcsolat-hitelesítési módszerének kiválasztásáról.

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.

Képernyőkép a Kubernetes szolgáltatás kapcsolathitelesítési párbeszédpaneljének kiválasztásáról, amely elakadt a névterek betöltésekor.

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