다음을 통해 공유


Kubernetes@0 - Kubectl v0 작업

이 작업을 사용하여 kubectl 명령을 실행하여 Azure Container Service에서 Kubernetes 클러스터를 배포, 구성 또는 업데이트합니다.

이 버전의 작업은 더 이상 사용되지 않습니다. Kubernetes@1 사용하여 워크로드 ID 페더레이션같은 최신 기능을 활용합니다.

이 작업을 사용하여 kubectl 명령을 실행하여 Azure Container Service에서 Kubernetes 클러스터를 배포, 구성 또는 업데이트합니다.

구문론

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

입력

Kubernetes 서비스 연결kubernetesServiceConnection -
입력 별칭: kubernetesServiceEndpoint. string;

Kubernetes 서비스 연결을 선택합니다.


namespace - 네임스페이스
string;

–namespace 플래그를 사용하여 kubectl 명령의 네임스페이스를 지정합니다. 네임스페이스가 제공되지 않으면 명령이 기본 네임스페이스에서 실행됩니다.


command - 명령
string; 허용되는 값: apply, create, delete, exec, expose, get, logs, run, set, top.

실행할 kubectl 명령을 지정합니다.


구성 파일useConfigurationFile - 사용
boolean; 기본값은 false입니다.

kubectl 명령과 함께 Kubernetes 구성 파일을 사용합니다. Kubernetes 구성 파일에 대한 파일 이름, 디렉터리 또는 URL도 제공할 수 있습니다.


configuration - 구성 파일
string; useConfigurationFile = true때 필요합니다.

명령과 함께 사용되는 kubernetes 구성 파일에 대한 파일 이름, 디렉터리 또는 URL을 지정합니다.


arguments - 인수
string;

지정된 kubectl 명령에 대한 인수를 지정합니다.


secretType - 비밀 유형
string; 필수 사항입니다. 허용되는 값: dockerRegistry, generic. 기본값은 dockerRegistry입니다.

제네릭 또는 docker imagepullsecret만들거나 업데이트합니다. 선택한 레지스트리의 imagepullsecret 만들거나 업데이트할 dockerRegistry 지정합니다. imagePullSecret 컨테이너 레지스트리 암호가 포함된 비밀을 Kubelet에 전달하는 방법이므로 Pod를 대신하여 프라이빗 이미지를 끌어올 수 있습니다.


secretArguments - 인수
string; 선택 사항. secretType = generic때 사용합니다.

비밀로 삽입할 키와 리터럴 값을 지정합니다. 예를 들어 --from-literal=key1=value1 또는 --from-literal=key2="top secret".


containerRegistryType - Container Registry 형식
string; secretType = dockerRegistry때 필요합니다. 허용되는 값: Azure Container Registry, Container Registry. 기본값은 Azure Container Registry입니다.

컨테이너 레지스트리 유형을 선택합니다. 이 작업은 Azure 구독 세부 정보를 사용하여 Azure Container Registry로 작업할 수 있습니다. 다른 표준 컨테이너 레지스트리도 지원됩니다.


Docker 레지스트리 서비스 연결dockerRegistryConnection -
입력 별칭: dockerRegistryEndpoint. string; 선택 사항. secretType = dockerRegistry && containerRegistryType = Container Registry때 사용합니다.

Docker 레지스트리 서비스 연결을 선택합니다. 레지스트리를 사용하여 인증해야 하는 명령에 필요합니다.


Azure 구독
입력 별칭: azureSubscriptionEndpoint. string; 선택 사항. secretType = dockerRegistry && containerRegistryType = Azure Container Registry때 사용합니다.

Azure Container Registry를 포함하는 Azure Resource Manager 구독을 지정합니다.

비고

새 서비스 연결을 구성하려면 목록에서 Azure 구독을 선택하고 Authorize클릭합니다. 구독이 나열되지 않았거나 기존 서비스 주체를 사용하려는 경우 Add 또는 Manage 단추를 사용하여 Azure 서비스 연결을 설정할 수 있습니다.


Azure Container RegistryazureContainerRegistry -
string; 선택 사항. secretType = dockerRegistry && containerRegistryType = Azure Container Registry때 사용합니다.

컨테이너 이미지를 끌어와 Kubernetes 클러스터에 애플리케이션을 배포하는 데 사용되는 Azure Container Registry를 지정합니다. 레지스트리를 사용하여 인증해야 하는 명령에 필요합니다.


secretName - 비밀 이름
string;

비밀의 이름입니다. Kubernetes YAML 구성 파일에서 이 비밀 이름을 사용할 수 있습니다.


forceUpdate - 강제 업데이트 비밀
boolean; 기본값은 true입니다.

비밀이 있으면 삭제하고 업데이트된 값을 사용하여 새 암호를 만듭니다.


configMap 이름configMapName -
string;

ConfigMaps를 사용하면 이미지 콘텐츠에서 구성 아티팩트 분리를 통해 컨테이너화된 애플리케이션을 이식 가능한 상태로 유지할 수 있습니다.


forceUpdateConfigMap - 강제 업데이트 구성맵
boolean; 기본값은 false입니다.

configmap이 있는 경우 삭제하고 업데이트된 값을 사용하여 새 구성 맵을 만듭니다.


useConfigMapFile - 파일 사용
boolean; 기본값은 false입니다.

디렉터리를 지정하여 개별 파일 또는 여러 파일에서 ConfigMap을 만듭니다.


configMap 파일configMapFile -
string; useConfigMapFile = true때 필요합니다.

configMaps를 포함하는 파일 또는 디렉터리를 지정합니다.


configMapArguments - 인수
string; 선택 사항. useConfigMapFile = false때 사용합니다.

configMap 삽입할 키와 리터럴 값을 지정합니다. 예를 들어 --from-literal=key1=value1 또는 --from-literal=key2="top secret".


kubectlversionOrLocation -
string; 허용되는 값: version, location(위치 지정). 기본값은 version입니다.

kubectl은 Kubernetes 클러스터에 대한 명령을 실행하기 위한 명령줄 인터페이스입니다.


versionSpec - 버전 사양
string; 선택 사항. versionOrLocation = version때 사용합니다. 기본값은 1.7.0입니다.

가져올 버전의 버전 사양을 지정합니다. 예: 1.7.0, 1.x.0, 4.x.0, 6.10.0, >=6.10.0.


checkLatest - 최신 버전 확인
boolean; 선택 사항. versionOrLocation = version때 사용합니다. 기본값은 false입니다.

항상 온라인에서 버전 사양을 충족하는 사용 가능한 최신 버전(stable.txt)을 확인합니다. 항상 최신 정보를 얻을 수 있는 특정 시나리오가 없는 한 일반적으로 false입니다. 이로 인해 잠재적으로 필요하지 않은 경우, 특히 호스트된 빌드 풀에서 다운로드 비용이 발생합니다.


Kubectl대한 specifyLocation - 경로
string; versionOrLocation = location때 필요합니다.

kubectl.exe 파일의 전체 경로를 지정합니다.


workingDirectory - 작업 디렉터리
입력 별칭: cwd. string; 기본값은 $(System.DefaultWorkingDirectory)입니다.

Kubectl 명령에 대한 작업 디렉터리입니다.


outputFormat - 출력 형식
string; 허용되는 값: json, yaml. 기본값은 json입니다.

출력 형식


kubectlOutput - 출력 변수 이름
string;

명령의 출력을 저장할 변수의 이름입니다.


작업 제어 옵션

모든 작업에는 작업 입력 외에 제어 옵션이 있습니다. 자세한 내용은 컨트롤 옵션 및 일반적인 작업 속성참조하세요.

출력 변수

없음.

요구 사항

요구 사항 설명
파이프라인 유형 YAML, 클래식 빌드, 클래식 릴리스
다음에서 실행 에이전트, DeploymentGroup
요구 없음
기능 이 작업은 작업의 후속 작업에 대한 요구 사항을 충족하지 않습니다.
명령 제한 어느 것이든
settable 변수 어느 것이든
에이전트 버전 지원되는 모든 에이전트 버전입니다.
작업 범주 배치하다