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 polecenia kubectl.

Ta wersja zadania jest przestarzała; użyj Kubernetes@1, aby skorzystać z najnowszych funkcji, takich jak Federacja tożsamości obciążenia.

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

połączenia usługi kubernetesServiceConnection - Kubernetes
Alias wejściowy: kubernetesServiceEndpoint. string.

Wybierz połączenie usługi Kubernetes.

przestrzeni nazw namespace -
string.

Określa przestrzeń nazw dla polecenia kubectl przy użyciu flagi –namespace. Jeśli przestrzeń nazw nie zostanie podana, polecenia będą uruchamiane w domyślnej przestrzeni nazw.

command - polecenia
string. Dozwolone wartości: apply, create, delete, exec, expose, get, logs, run, set, top.

Określa polecenie kubectl do uruchomienia.

useConfigurationFile - Używanie 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.

pliku konfiguracji configuration -
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 polecenia kubectl.

secretType - typ wpisu tajnego
string. To jest 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 wybranego rejestru. 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łu 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 rejestrem kontenerów platformy Azure. Obsługiwane są również inne standardowe rejestry kontenerów.

dockerRegistryConnection - połączenia usługi Rejestru platformy Docker
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ą być uwierzytelniane w rejestrze.

subskrypcji 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 usługę 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 przycisków Add lub Manage.

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

Określa usługę Azure Container Registry, która jest używana do ściągania obrazów kontenerów i wdrażania aplikacji w klastrze Kubernetes. Wymagane w przypadku poleceń, które muszą być uwierzytelniane w rejestrze.

secretName - nazwa wpisu tajnego
string.

Nazwa wpisu tajnego. Tę nazwę wpisu tajnego można użyć w pliku konfiguracji YAML kubernetes.

forceUpdate - wymuszanie wpisu tajnego aktualizacji
boolean. Wartość domyślna: true.

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

configMapName - nazwa ConfigMap
string.

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

forceUpdateConfigMap - wymuszanie mapy konfiguracji aktualizacji
boolean. Wartość domyślna: false.

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

useConfigMapFile - Używanie plików
boolean. Wartość domyślna: false.

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

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

Określ plik lub katalog zawierający configMaps.

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

Określa klucze i wartości literału do wstawienia w 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 - wersji
string. Opcjonalny. Użyj polecenia , gdy versionOrLocation = version. Wartość domyślna: 1.7.0.

Określa specyfikację wersji, która ma być pobierana. Przykłady: 1.7.0, 1.x.0, 4.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.

ścieżka specifyLocation - do Kubectl
string. Wymagane, gdy versionOrLocation = location.

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

katalogu roboczego
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 zadaniami

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

Zmienne wyjściowe

Żaden.

Wymagania

Wymaganie	Opis
Typy potoków	YAML, klasyczna kompilacja, wersja klasyczna
Działa na	Agent, DeploymentGroup
Wymagania	Żaden
możliwości	To zadanie nie spełnia żadnych wymagań dotyczących kolejnych zadań w zadaniu.
ograniczenia poleceń	Jakikolwiek
zmienne ustawiane	Jakikolwiek
Wersja agenta	Wszystkie obsługiwane wersje agentów.
Kategoria zadań	Zastosuj