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
、expose
get
、logs
run
、set
、。 top
指定要 kubectl
运行的命令。
command
- 命令
string
. 必需。 允许的值:apply
、、create
、delete
、exec
、expose
get
、logs
run
、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
.
应在其中保存命令输出的变量的名称。
任务控制选项
除了任务输入,所有任务都有控制选项。 有关详细信息,请参阅 控制选项和常见任务属性。
输出变量
无。