다음을 통해 공유

Kubernetes@0 - Kubectl v0 작업

  • 아티클

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

Syntax

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

# Deploy to Kubernetes 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.

# Deploy to Kubernetes v0
# Deploy, configure, update your 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' # 'apply' | 'create' | 'delete' | 'exec' | 'expose' | 'get' | 'logs' | 'run' | 'set' | 'top'. Required. Command. Default: apply.
    #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.

입력

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

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


namespace - 네임 스페이스
string.

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


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

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


command - 명령
string. 필수 요소. 허용되는 값: apply, , create, delete, execexpose, get, , logs, run, set, . top 기본값은 apply입니다.

실행할 명령을 지정합니다 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로 작업할 수 있습니다. 다른 표준 컨테이너 레지스트리도 지원됩니다.


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

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


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

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

참고

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


azureContainerRegistry - Azure Container Registry
string. 선택 사항입니다. 을 사용할 때 secretType = dockerRegistry && containerRegistryType = Azure Container Registry사용합니다.

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


secretName - 비밀 이름
string.

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


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

비밀이 있는 경우 삭제하고 업데이트된 값으로 새 비밀을 만듭니다.


configMapName - ConfigMap 이름
string.

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


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

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


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

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


configMapFile - ConfigMap 파일
string. 필요한 경우 useConfigMapFile = true입니다.

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


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

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


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

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


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

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


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

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


specifyLocation - Kubectl 경로
string. 필요한 경우 versionOrLocation = location입니다.

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


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

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


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

출력 형식입니다.


kubectlOutput - 출력 변수 이름
string.

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


작업 제어 옵션

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

출력 변수

없음

요구 사항

요구 사항 Description
파이프라인 유형 YAML, 클래식 빌드, 클래식 릴리스
실행 중 에이전트, DeploymentGroup
요청 없음
Capabilities 이 작업은 작업의 후속 작업에 대한 요구를 충족하지 않습니다.
명령 제한 사항 모두
설정 가능한 변수 모두
에이전트 버전 지원되는 모든 에이전트 버전.
작업 범주 배포