Kubernetes@0 - Kubectl v0 任务

  • 项目

使用此任务通过运行 kubectl 命令在 Azure 容器服务中部署、配置或更新 Kubernetes 群集。

语法

# 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.

# Deploy to Kubernetes 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.

# Deploy to Kubernetes v0
# Deploy, configure, update your 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' # 'apply' | 'create' | 'delete' | 'exec' | 'expose' | 'get' | 'logs' | 'run' | 'set' | 'top'. Required. Command. Default: apply.
    #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.

输入

kubernetesServiceConnection - Kubernetes 服务连接
输入别名： kubernetesServiceEndpoint。 string.

选择 Kubernetes 服务连接。


namespace - 命名 空间
string.

使用 标志指定命令的–namespace命名空间kubectl。 如果未提供命名空间，则命令将在默认命名空间中运行。


command - 命令
string. 允许的值：apply、、create、delete、exec、exposeget、logsrun、set、。 top

指定要 kubectl 运行的命令。


command - 命令
string. 必需。 允许的值：apply、、create、delete、exec、exposeget、logsrun、set、。 top 默认值：apply。

指定要 kubectl 运行的命令。


useConfigurationFile - 使用配置文件
boolean. 默认值：false。

将 Kubernetes 配置文件与 kubectl 命令配合使用。 还可以提供 Kubernetes 配置文件的文件名、目录或 URL。


configuration - 配置文件
string. 当 useConfigurationFile = true 时，需要此选项。

指定用于命令的 kubernetes 配置文件的文件名、目录或 URL。


arguments - 参数
string.

指定指定 kubectl 命令的参数。


secretType - 机密类型
string. 必需。 允许的值：dockerRegistry、generic。 默认值：dockerRegistry。

创建或更新泛型或 docker imagepullsecret。 指定 dockerRegistry 以创建或更新 imagepullsecret 所选注册表的 。 是 imagePullSecret 一种将包含容器注册表密码的机密传递给 Kubelet 的方法，以便它可以代表 Pod 拉取专用映像。


secretArguments - 参数
string. 可选。 在 时 secretType = generic使用 。

指定要在机密中插入的键和文本值。 例如 --from-literal=key1=value1 或 --from-literal=key2="top secret"。


containerRegistryType - 容器注册表类型
string. 当 secretType = dockerRegistry 时，需要此选项。 允许的值：Azure Container Registry、Container Registry。 默认值：Azure Container Registry。

选择容器注册表类型。 该任务可以使用 Azure 订阅详细信息来处理 Azure 容器注册表。 还支持其他标准容器注册表。


dockerRegistryConnection - Docker 注册表服务连接
输入别名： dockerRegistryEndpoint。 string. 可选。 在 时 secretType = dockerRegistry && containerRegistryType = Container Registry使用 。

选择 Docker 注册表服务连接。 所用命令需要使用注册表进行身份验证时必需。


azureSubscription - Azure 订阅
输入别名： azureSubscriptionEndpoint。 string. 可选。 在 时 secretType = dockerRegistry && containerRegistryType = Azure Container Registry使用 。

指定包含Azure 容器注册表的 Azure 资源管理器 订阅。

注意

若要配置新的服务连接，请从列表中选择 Azure 订阅，然后单击 Authorize。 如果未列出订阅，或者想要使用现有的服务主体，可以使用 或 Manage 按钮设置 Azure 服务连接Add。


azureContainerRegistry - Azure 容器注册表
string. 可选。 在 时 secretType = dockerRegistry && containerRegistryType = Azure Container Registry使用 。

指定用于拉取容器映像和将应用程序部署到 Kubernetes 群集的Azure 容器注册表。 所用命令需要使用注册表进行身份验证时必需。


secretName - 机密名称
string.

机密的名称。 可以在 Kubernetes YAML 配置文件中使用此机密名称。


forceUpdate - 强制更新机密
boolean. 默认值：true。

删除机密（如果存在），并使用更新的值创建一个新机密。


configMapName - ConfigMap 名称
string.

ConfigMaps 允许将配置项目与映像内容分离，使容器化应用程序保持可移植性。


forceUpdateConfigMap - 强制更新配置映射
boolean. 默认值：false。

如果 configmap 存在，请将其删除，并创建一个具有更新值的新配置映射。


useConfigMapFile - 使用文件
boolean. 默认值：false。

通过指定目录从单个文件或多个文件创建 ConfigMap。


configMapFile - ConfigMap 文件
string. 当 useConfigMapFile = true 时，需要此选项。

指定包含 configMaps 的文件或目录。


configMapArguments - 参数
string. 可选。 在 时 useConfigMapFile = false使用 。

指定要在 中插入的 configMap 键和文本值。例如， --from-literal=key1=value1 或 --from-literal=key2="top secret"。


versionOrLocation - Kubectl
string. 允许的值： version、 location (指定位置) 。 默认值：version。

kubectl 是一个命令行接口，用于针对 Kubernetes 群集运行命令。


versionSpec - 版本规范
string. 可选。 在 时 versionOrLocation = version使用 。 默认值：1.7.0。

指定要获取的版本的版本规范。 示例： 1.7.0、 1.x.0、 4.x.0、 6.10.0、 >=6.10.0。


checkLatest - 检查最新版本
boolean. 可选。 在 时 versionOrLocation = version使用 。 默认值：false。

始终联机检查满足版本规范的最新可用版本 (stable.txt) 。这通常为 false，除非你有一个始终获取最新的特定方案。 这将导致在可能不需要的情况下产生下载成本，尤其是在托管生成池中。


specifyLocation - Kubectl 的路径
string. 当 versionOrLocation = location 时，需要此选项。

指定文件的完整路径 kubectl.exe 。


workingDirectory - 工作目录
输入别名： cwd。 string. 默认值：$(System.DefaultWorkingDirectory)。

Kubectl 命令的工作目录。


outputFormat - 输出格式
string. 允许的值：json、yaml。 默认值：json。

输出格式。


kubectlOutput - 输出变量名称
string.

应在其中保存命令输出的变量的名称。


任务控制选项

除了任务输入，所有任务都有控制选项。 有关详细信息，请参阅 控制选项和常见任务属性。

输出变量

无。

要求

要求 说明
管道类型 YAML，经典内部版本，经典版本
运行平台 Agent、DeploymentGroup
需求 无
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任意
可设置的变量 任意
代理版本 所有支持的代理版本。
任务类别 部署