Kubernetes@0: tarea de Kubectl v0

Use esta tarea para implementar, configurar o actualizar un clúster de Kubernetes en Azure Container Service mediante la ejecución kubectl de comandos.

Syntax

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

Entradas

kubernetesServiceConnection - Conexión del servicio Kubernetes
Alias de entrada: kubernetesServiceEndpoint. string.

Seleccione una conexión de servicio de Kubernetes.

namespace - Nombres
string.

Especifica el espacio de nombres para el kubectl comando mediante la –namespace marca . Si no se proporciona el espacio de nombres, los comandos se ejecutarán en el espacio de nombres predeterminado.

command - Comando
string. Valores permitidos: apply, create, delete, exec, getexposerunlogs, set, . top

Especifica un kubectl comando que se va a ejecutar.

useConfigurationFile - Usar archivos de configuración
boolean. Valor predeterminado: false.

Use el archivo de configuración de Kubernetes con el comando kubectl. También se pueden proporcionar archivos de configuración de nombre de archivo, directorio o dirección URL a Kubernetes.

configuration - Archivo de configuración
string. Necesario cuando useConfigurationFile = true.

Especifica el nombre de archivo, el directorio o la dirección URL de los archivos de configuración de Kubernetes que se usan con los comandos .

arguments - Argumentos
string.

Especifica los argumentos para el comando especificado kubectl .

secretType - Tipo de secreto
string. Obligatorio. Valores permitidos: dockerRegistry, generic. Valor predeterminado: dockerRegistry.

Crea o actualiza un elemento genérico o docker imagepullsecret. Especifique dockerRegistry para crear o actualizar el imagepullsecret del registro seleccionado. Una imagePullSecret es una manera de pasar un secreto que contiene una contraseña del registro de contenedor a Kubelet, por lo que puede extraer una imagen privada en nombre del pod.

secretArguments - Argumentos
string. Opcional. Use cuando secretType = generic.

Especifica claves y valores literales que se van a insertar en secreto. Por ejemplo, --from-literal=key1=value1 o --from-literal=key2="top secret".

containerRegistryType - Tipo de Registro de contenedor
string. Necesario cuando secretType = dockerRegistry. Valores permitidos: Azure Container Registry, Container Registry. Valor predeterminado: Azure Container Registry.

Seleccione un tipo de registro de contenedor. La tarea puede usar los detalles de la suscripción de Azure para trabajar con una instancia de Azure Container Registry. También se admiten otros registros de contenedor estándar.

dockerRegistryConnection - Conexión de servicio del Registro de Docker
Alias de entrada: dockerRegistryEndpoint. string. Opcional. Use cuando secretType = dockerRegistry && containerRegistryType = Container Registry.

Seleccione una conexión de servicio del registro de Docker. Obligatorio para los comandos que necesitan autenticarse con un registro.

azureSubscription - Suscripción de Azure
Alias de entrada: azureSubscriptionEndpoint. string. Opcional. Use cuando secretType = dockerRegistry && containerRegistryType = Azure Container Registry.

Especifica la suscripción de Azure Resource Manager, que contiene Azure Container Registry.

Nota

Para configurar una nueva conexión de servicio, seleccione la suscripción de Azure de la lista y haga clic en Authorize. Si la suscripción no aparece en la lista o si desea usar una entidad de servicio existente, puede configurar una conexión de servicio de Azure mediante los Add botones o Manage .

azureContainerRegistry - Azure Container Registry
string. Opcional. Use cuando secretType = dockerRegistry && containerRegistryType = Azure Container Registry.

Especifica un Azure Container Registry que se usa para extraer imágenes de contenedor e implementar aplicaciones en el clúster de Kubernetes. Obligatorio para los comandos que necesitan autenticarse con un registro.

secretName - Nombre del secreto
string.

Nombre del secreto. Puede usar este nombre secreto en el archivo de configuración de YAML de Kubernetes.

forceUpdate - Forzar el secreto de actualización
boolean. Valor predeterminado: true.

Elimine el secreto si existe y cree uno nuevo con valores actualizados.

configMapName - Nombre de ConfigMap
string.

ConfigMaps permite desacoplar los artefactos de configuración del contenido de la imagen para mantener portátiles las aplicaciones en contenedor.

forceUpdateConfigMap - Forzar el mapa de configuración de actualización
boolean. Valor predeterminado: false.

Elimine el configmap si existe y cree uno nuevo con valores actualizados.

useConfigMapFile - Usar archivo
boolean. Valor predeterminado: false.

Cree un objeto ConfigMap a partir de un archivo individual o desde varios archivos especificando un directorio.

configMapFile - Archivo ConfigMap
string. Necesario cuando useConfigMapFile = true.

Especifique un archivo o directorio que contenga configMaps.

configMapArguments - Argumentos
string. Opcional. Use cuando useConfigMapFile = false.

Especifica claves y valores literales que se van a insertar en configMap . Por ejemplo, --from-literal=key1=value1 o --from-literal=key2="top secret".

versionOrLocation - Kubectl
string. Valores permitidos: version, location (Especificar ubicación). Valor predeterminado: version.

kubectl es una interfaz de línea de comandos para ejecutar comandos en clústeres de Kubernetes.

versionSpec - Especificación de versión
string. Opcional. Use cuando versionOrLocation = version. Valor predeterminado: 1.7.0.

Especifica la especificación de versión de la versión que se va a obtener. Ejemplos: 1.7.0, 1.x.0, 4.x.0, 6.10.0, . >=6.10.0

checkLatest - Comprobación de la versión más reciente
boolean. Opcional. Use cuando versionOrLocation = version. Valor predeterminado: false.

Compruebe siempre en línea la versión más reciente disponible (stable.txt) que cumpla la especificación de versión. Esto suele ser falso a menos que tenga un escenario específico para obtener siempre la versión más reciente. Esto hará que incurra en costos de descarga cuando no sea necesario, especialmente con el grupo de compilación hospedado.

specifyLocation - Ruta de acceso a Kubectl
string. Necesario cuando versionOrLocation = location.

Especifica la ruta de acceso completa al kubectl.exe archivo.

workingDirectory - Directorio de trabajo
Alias de entrada: cwd. string. Valor predeterminado: $(System.DefaultWorkingDirectory).

Directorio de trabajo para el comando Kubectl.

outputFormat - Formato de salida
string. Valores permitidos: json, yaml. Valor predeterminado: json.

Formato de salida.

kubectlOutput - Nombre de la variable de salida
string.

Nombre de la variable en la que se debe guardar la salida del comando.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de las entradas de tareas. Para obtener más información, vea Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente, DeploymentGroup
Peticiones	None
Capabilities	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos	Any
Variables que se pueden establecer	Any
Versión del agente	Todas las versiones de agente admitidas.
Categoría de la tarea:	Implementación