Kubernetes@0 — zadanie Kubectl v0

To zadanie służy do wdrażania, konfigurowania lub aktualizowania klastra Kubernetes w usłudze Azure Container Service, uruchamiając kubectl polecenia.

Składnia

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

Dane wejściowe

kubernetesServiceConnection - Połączenie usługi Kubernetes
Alias wejściowy: kubernetesServiceEndpoint. string.

Wybierz połączenie usługi Kubernetes.

namespace - Obszaru nazw
string.

Określa przestrzeń nazw dla kubectl polecenia za pomocą flagi –namespace . Jeśli przestrzeń nazw nie zostanie podana, polecenia zostaną uruchomione w domyślnej przestrzeni nazw.

command - Polecenia
string. Dozwolone wartości: apply, creategetexecdeletelogsrunexpose, , set, . top

Określa kubectl polecenie do uruchomienia.

useConfigurationFile - Korzystanie z plików konfiguracji
boolean. Wartość domyślna: false.

Użyj pliku konfiguracji kubernetes z poleceniem kubectl. Można również podać nazwę pliku, katalog lub adres URL do plików konfiguracji platformy Kubernetes.

configuration - Plik konfiguracji
string. Wymagane, gdy useConfigurationFile = true.

Określa nazwę pliku, katalog lub adres URL do plików konfiguracji kubernetes używanych z poleceniami.

arguments - Argumenty
string.

Określa argumenty określonego kubectl polecenia.

secretType - Typ wpisu tajnego
string. Wymagane. Dozwolone wartości: dockerRegistry, generic. Wartość domyślna: dockerRegistry.

Tworzy lub aktualizuje ogólny lub docker imagepullsecret. Określ dockerRegistry , aby utworzyć lub zaktualizować imagepullsecret wybrany rejestr. Element imagePullSecret to sposób przekazania wpisu tajnego zawierającego hasło rejestru kontenerów do rozwiązania Kubelet, dzięki czemu może ściągnąć prywatny obraz w imieniu zasobnika.

secretArguments - Argumenty
string. Opcjonalny. Użyj polecenia , gdy secretType = generic.

Określa klucze i wartości literałów do wstawienia w kluczu tajnym. Na przykład: --from-literal=key1=value1 lub --from-literal=key2="top secret".

containerRegistryType - Typ rejestru kontenerów
string. Wymagane, gdy secretType = dockerRegistry. Dozwolone wartości: Azure Container Registry, Container Registry. Wartość domyślna: Azure Container Registry.

Wybierz typ rejestru kontenerów. Zadanie może używać szczegółów subskrypcji platformy Azure do pracy z usługą Azure Container Registry. Obsługiwane są również inne standardowe rejestry kontenerów.

dockerRegistryConnection - Połączenie usługi Docker Registry
Alias wejściowy: dockerRegistryEndpoint. string. Opcjonalny. Użyj polecenia , gdy secretType = dockerRegistry && containerRegistryType = Container Registry.

Wybierz połączenie usługi rejestru platformy Docker. Wymagane w przypadku poleceń, które muszą uwierzytelniać się w rejestrze.

azureSubscription - Subskrypcja platformy Azure
Alias wejściowy: azureSubscriptionEndpoint. string. Opcjonalny. Użyj polecenia , gdy secretType = dockerRegistry && containerRegistryType = Azure Container Registry.

Określa subskrypcję usługi Azure Resource Manager, która zawiera Azure Container Registry.

Uwaga

Aby skonfigurować nowe połączenie z usługą, wybierz subskrypcję platformy Azure z listy i kliknij pozycję Authorize. Jeśli twoja subskrypcja nie znajduje się na liście lub jeśli chcesz użyć istniejącej jednostki usługi, możesz skonfigurować połączenie usługi platformy Azure przy użyciu Add przycisków lub Manage .

azureContainerRegistry - Azure Container Registry
string. Opcjonalny. Użyj polecenia , gdy secretType = dockerRegistry && containerRegistryType = Azure Container Registry.

Określa Azure Container Registry, który jest używany do ściągania obrazów kontenerów i wdrażania aplikacji w klastrze Kubernetes. Wymagane w przypadku poleceń, które muszą uwierzytelniać się w rejestrze.

secretName - Nazwa wpisu tajnego
string.

Nazwa wpisu tajnego. Tej nazwy wpisu tajnego można użyć w pliku konfiguracji YAML kubernetes.

forceUpdate - Wymuś aktualizację wpisu tajnego
boolean. Wartość domyślna: true.

Usuń wpis tajny, jeśli istnieje i utwórz nowy z zaktualizowanymi wartościami.

configMapName - Nazwa obiektu ConfigMap
string.

Obiekty ConfigMap umożliwiają oddzielenie artefaktów konfiguracji z zawartości obrazu w celu przenoszenia konteneryzowanych aplikacji.

forceUpdateConfigMap - Wymuś aktualizację configmap
boolean. Wartość domyślna: false.

Usuń configmap, jeśli istnieje i utwórz nową z zaktualizowanymi wartościami.

useConfigMapFile - Korzystanie z pliku
boolean. Wartość domyślna: false.

Utwórz obiekt ConfigMap na podstawie pojedynczego pliku lub z wielu plików, określając katalog.

configMapFile - Plik ConfigMap
string. Wymagane, gdy useConfigMapFile = true.

Określ plik lub katalog zawierający obiekty configMap.

configMapArguments - Argumenty
string. Opcjonalny. Użyj polecenia , gdy useConfigMapFile = false.

Określa klucze i wartości literałów do wstawienia w pliku configMap . Na przykład --from-literal=key1=value1 lub --from-literal=key2="top secret".

versionOrLocation - Kubectl
string. Dozwolone wartości: version, location (Określ lokalizację). Wartość domyślna: version.

kubectl to interfejs wiersza polecenia do uruchamiania poleceń w klastrach Kubernetes.

versionSpec - Specyfikacja wersji
string. Opcjonalny. Użyj polecenia , gdy versionOrLocation = version. Wartość domyślna: 1.7.0.

Określa specyfikację wersji wersji, która ma być pobierana. Przykłady: 1.7.0, , 4.x.01.x.0, 6.10.0, . >=6.10.0

checkLatest - Sprawdzanie najnowszej wersji
boolean. Opcjonalny. Użyj polecenia , gdy versionOrLocation = version. Wartość domyślna: false.

Zawsze sprawdza w trybie online najnowszą dostępną wersję (stable.txt), która spełnia specyfikację wersji. Zazwyczaj jest to fałsz, chyba że masz określony scenariusz, aby zawsze uzyskiwać najnowsze informacje. Spowoduje to naliczenie kosztów pobierania, jeśli potencjalnie nie jest to konieczne, zwłaszcza w przypadku hostowanej puli kompilacji.

specifyLocation - Ścieżka do rozwiązania Kubectl
string. Wymagane, gdy versionOrLocation = location.

Określa pełną ścieżkę kubectl.exe do pliku.

workingDirectory - Katalog roboczy
Alias wejściowy: cwd. string. Wartość domyślna: $(System.DefaultWorkingDirectory).

Katalog roboczy polecenia Kubectl.

outputFormat - Format danych wyjściowych
string. Dozwolone wartości: json, yaml. Wartość domyślna: json.

Format danych wyjściowych.

kubectlOutput - Nazwa zmiennej wyjściowej
string.

Nazwa zmiennej, w której należy zapisać dane wyjściowe polecenia.

Opcje sterowania zadania

Wszystkie zadania mają opcje sterowania oprócz danych wejściowych zadań. Aby uzyskać więcej informacji, zobacz Opcje sterowania i typowe właściwości zadań.

Zmienne wyjściowe

Brak.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, kompilacja klasyczna, wersja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Brak
Możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
Ograniczenia poleceń	Dowolne
Zmienne w formie tabeli settable	Dowolne
Wersja agenta	Wszystkie obsługiwane wersje agentów.
Kategoria zadania	Wdrażanie