Kubernetes@0: tarea Kubectl v0

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

Esta versión de la tarea está en desuso; use Kubernetes@1 para aprovechar las características más recientes, como federación de identidades de carga de trabajo.

Sintaxis

# 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

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

Seleccione una conexión de servicio de Kubernetes.

namespace - espacio de nombres
string.

Especifica el espacio de nombres del comando kubectl mediante la marca –namespace. 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, expose, get, logs, run, set, top.

Especifica un comando kubectl 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.

del archivo de configuración de configuration -
string. Obligatorio 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 .

argumentos de
string.

Especifica los argumentos para el comando kubectl especificado.

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

Crea o actualiza un imagepullsecretgenérico o docker. Especifique dockerRegistry para crear o actualizar la imagepullsecret del Registro seleccionado. Un 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.

argumentos de
string. Opcional. Use cuando secretType = generic.

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

tipo containerRegistryType - Container Registry
string. Obligatorio 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 - de conexión del 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. Necesario para los comandos que necesitan autenticarse con un registro.

azureSubscription - de 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 o si desea usar una entidad de servicio existente, puede configurar una conexión de servicio de Azure mediante los botones Add o Manage.

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

Especifica una instancia de Azure Container Registry que se usa para extraer imágenes de contenedor e implementar aplicaciones en el clúster de Kubernetes. Necesario 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 la actualización del secreto
boolean. Valor predeterminado: true.

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

configMapName - nombre configMap
string.

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

forceUpdateConfigMap - Forzar actualización de configmap
boolean. Valor predeterminado: false.

Elimine el mapa de configuración si existe y cree uno nuevo con valores actualizados.

useConfigMapFile - Usar de archivos
boolean. Valor predeterminado: false.

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

del archivo ConfigMap de configMapFile -
string. Obligatorio cuando useConfigMapFile = true.

Especifique un archivo o directorio que contenga los configMaps.

argumentos de
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.

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

ruta de acceso de specifyLocation - a Kubectl
string. Obligatorio cuando versionOrLocation = location.

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

de directorio de trabajo de
Alias de entrada: cwd. string. Valor predeterminado: $(System.DefaultWorkingDirectory).

Directorio de trabajo para el comando Kubectl.

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

Formato de salida.

kubectlOutput - nombre de 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 sus entradas de tarea. Para obtener más información, consulte 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
demandas	Ninguno
funcionalidades de	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos	Cualquiera
variables settable	Cualquiera
Versión del agente	Todas las versiones de agente admitidas.
Categoría de tarea	Desplegar