使用此任务通过运行 kubectl
命令在 Azure 容器服务中部署、配置或更新 Kubernetes 群集。
此版本的任务已弃用;使用 Kubernetes@1 来利用 工作负荷标识联合身份验证等最新功能。
使用此任务通过运行 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.
输入
kubernetesServiceConnection
-
Kubernetes 服务连接
输入别名: kubernetesServiceEndpoint
.
string
。
选择 Kubernetes 服务连接。
namespace
-
命名空间
string
。
使用 kubectl
标志指定 –namespace
命令的命名空间。 如果未提供命名空间,命令将在默认命名空间中运行。
command
-
命令
string
。 允许的值:apply
、create
、delete
、exec
、expose
、get
、logs
、run
、set
、top
。
指定要运行的 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
。 如果订阅未列出,或者想要使用现有服务主体,则可以使用 Add
或 Manage
按钮设置 Azure 服务连接。
azureContainerRegistry
-
Azure 容器注册表
string
。 可选。 当 secretType = dockerRegistry && containerRegistryType = Azure Container Registry
时使用。
指定一个 Azure 容器注册表,用于拉取容器映像并将应用程序部署到 Kubernetes 群集。 需要使用注册表进行身份验证的命令。
secretName
-
机密名称
string
。
机密的名称。 可以在 Kubernetes YAML 配置文件中使用此机密名称。
forceUpdate
-
强制更新机密
boolean
。 默认值:true
。
如果机密存在,请将其删除,并创建一个具有更新值的新机密。
configMapName
-
ConfigMap 名称
string
。
ConfigMaps 允许将配置项目与映像内容分离,使容器化应用程序保持可移植性。
forceUpdateConfigMap
-
强制更新 configmap
boolean
。 默认值:false
。
删除 configmap(如果存在)并创建包含更新值的新配置映射。
useConfigMapFile
-
使用文件
boolean
。 默认值:false
。
通过指定目录,从单个文件或从多个文件创建 ConfigMap。
configMapFile
-
ConfigMap 文件
string
。
useConfigMapFile = true
时是必需的。
指定包含 configMap 的文件或目录。
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,除非你有一个特定方案来始终获取最新情况。 这将导致在可能不需要时产生下载成本,尤其是托管生成池。
Kubectl的 specifyLocation
- 路径
string
。
versionOrLocation = ___location
时是必需的。
指定 kubectl.exe
文件的完整路径。
outputFormat
-
输出格式
string
。 允许的值:json
、yaml
。 默认值:json
。
输出格式。
kubectlOutput
-
输出变量名称
string
。
应在其中保存命令输出的变量的名称。
任务控制选项
除任务输入之外,所有任务都具有控制选项。 有关详细信息,请参阅 控件选项和常见任务属性。
输出变量
没有。