Kubernetes@0 - Attività Kubectl v0

Usare questa attività per distribuire, configurare o aggiornare un cluster Kubernetes nel servizio Azure Container eseguendo kubectl comandi.

Sintassi

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

Input

kubernetesServiceConnection - Connessione al servizio Kubernetes
Alias di input: kubernetesServiceEndpoint. string.

Selezionare una connessione al servizio Kubernetes.

namespace - Namespace
string.

Specifica lo spazio dei nomi per il kubectl comando usando il –namespace flag. Se lo spazio dei nomi non viene specificato, i comandi verranno eseguiti nello spazio dei nomi predefinito.

command - Comando
string. Valori consentiti: applydeleteexposeexeccreatelogsrungetset, . top

Specifica un kubectl comando da eseguire.

useConfigurationFile - Usare i file di configurazione
boolean. Valore predefinito: false.

Usare il file di configurazione kubernetes con il comando kubectl. È possibile specificare anche file di file di configurazione, directory o URL per Kubernetes.

configuration - File di configurazione
string. Obbligatorio quando useConfigurationFile = true.

Specifica il nome file, la directory o l'URL per i file di configurazione kubernetes usati con i comandi.

arguments - Argomenti
string.

Specifica gli argomenti al comando specificato kubectl .

secretType - Tipo di segreto
string. Obbligatorio. Valori consentiti: dockerRegistry, generic. Valore predefinito: dockerRegistry.

Crea o aggiorna un oggetto generico o docker imagepullsecret. Specificare per creare o aggiornare dockerRegistry l'oggetto imagepullsecret del Registro di sistema selezionato. Un imagePullSecret è un modo per passare un segreto che contiene una password del Registro contenitori a Kubelet, in modo che possa eseguire il pull di un'immagine privata per conto del pod.

secretArguments - Argomenti
string. facoltativo. Usare quando secretType = generic.

Specifica le chiavi e i valori letterali da inserire nel segreto. Ad esempio, --from-literal=key1=value1 o --from-literal=key2="top secret".

containerRegistryType - Tipo di Registro contenitori
string. Obbligatorio quando secretType = dockerRegistry. Valori consentiti: Azure Container Registry, Container Registry. Valore predefinito: Azure Container Registry.

Selezionare un tipo di Registro Contenitori. L'attività può usare i dettagli della sottoscrizione di Azure per usare un Registro Azure Container. Sono supportati anche altri registri contenitori standard.

dockerRegistryConnection - Connessione del servizio Registro di sistema Docker
Alias di input: dockerRegistryEndpoint. string. facoltativo. Usare quando secretType = dockerRegistry && containerRegistryType = Container Registry.

Selezionare una connessione al servizio del Registro di sistema Docker. Obbligatorio per i comandi che devono eseguire l'autenticazione con un Registro di sistema.

azureSubscription - Sottoscrizione di Azure
Alias di input: azureSubscriptionEndpoint. string. facoltativo. Usare quando secretType = dockerRegistry && containerRegistryType = Azure Container Registry.

Specifica la sottoscrizione di Azure Resource Manager, che contiene Registro Azure Container.

Nota

Per configurare una nuova connessione al servizio, selezionare la sottoscrizione di Azure dall'elenco e fare clic su Authorize. Se la sottoscrizione non è elencata o se si vuole usare un'entità servizio esistente, è possibile configurare una connessione al servizio di Azure usando i Add pulsanti o Manage .

azureContainerRegistry - Registro Azure Container
string. facoltativo. Usare quando secretType = dockerRegistry && containerRegistryType = Azure Container Registry.

Specifica un Registro Azure Container utilizzato per il pull delle immagini del contenitore e la distribuzione di applicazioni nel cluster Kubernetes. Obbligatorio per i comandi che devono eseguire l'autenticazione con un Registro di sistema.

secretName - Nome segreto
string.

Nome del segreto. È possibile usare questo nome segreto nel file di configurazione YAML kubernetes.

forceUpdate - Forzare il segreto di aggiornamento
boolean. Valore predefinito: true.

Eliminare il segreto se esiste e crearne uno nuovo con valori aggiornati.

configMapName - Nome ConfigMap
string.

ConfigMaps consente di separare gli artefatti di configurazione dal contenuto dell'immagine per mantenere le applicazioni in contenitori portabili.

forceUpdateConfigMap - Forzare la configurazione dell'aggiornamento
boolean. Valore predefinito: false.

Eliminare la mappa di configurazione se esiste e crearne una nuova con valori aggiornati.

useConfigMapFile - Usare il file
boolean. Valore predefinito: false.

Creare un file ConfigMap da un singolo file o da più file specificando una directory.

configMapFile - File ConfigMap
string. Obbligatorio quando useConfigMapFile = true.

Specificare un file o una directory che contiene le configurazioniMap.

configMapArguments - Argomenti
string. facoltativo. Usare quando useConfigMapFile = false.

Specifica le chiavi e i valori letterali da inserire in configMap . Ad esempio, --from-literal=key1=value1 o --from-literal=key2="top secret".

versionOrLocation - Kubectl
string. Valori consentiti: version, location (specificare la posizione). Valore predefinito: version.

kubectl è un'interfaccia della riga di comando per l'esecuzione di comandi nei cluster Kubernetes.

versionSpec - Specifica versione
string. facoltativo. Usare quando versionOrLocation = version. Valore predefinito: 1.7.0.

Specifica la specifica della versione da ottenere. Esempi: 1.7.0, 1.x.0, 4.x.06.10.0, >=6.10.0.

checkLatest - Verificare la versione più recente
boolean. facoltativo. Usare quando versionOrLocation = version. Valore predefinito: false.

Controlla sempre online la versione più recente disponibile (stable.txt) che soddisfa la specifica di versione. Si tratta in genere di false, a meno che non si disponga di uno scenario specifico per ottenere sempre la versione più recente. Ciò comporterà l'addebito di costi di download quando potenzialmente non è necessario, in particolare con il pool di compilazioni ospitata.

specifyLocation - Percorso di Kubectl
string. Obbligatorio quando versionOrLocation = location.

Specifica il percorso completo del kubectl.exe file.

workingDirectory - Directory di lavoro
Alias di input: cwd. string. Valore predefinito: $(System.DefaultWorkingDirectory).

Directory di lavoro per il comando Kubectl.

outputFormat - Formato di output
string. Valori consentiti: json, yaml. Valore predefinito: json.

Formato di output.

kubectlOutput - Nome della variabile di output
string.

Nome della variabile in cui deve essere salvato l'output del comando.

Opzioni di controllo delle attività

Tutte le attività dispongono di opzioni di controllo oltre ai relativi input attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Requisiti

Requisito	Descrizione
Tipi di pipeline	YAML, build classica, versione classica
Viene eseguito in	Agente, DeploymentGroup
Richieste	Nessuno
Capabilities	Questa attività non soddisfa le richieste per le attività successive nel processo.
Restrizioni dei comandi	Qualsiasi
Variabili impostabili	Qualsiasi
Versione agente	Tutte le versioni dell'agente supportate.
Categoria attività	Distribuire