Docker@0 - Docker v0 작업

Docker 이미지를 빌드, 태그 지정, 푸시, 실행 또는 Docker 명령을 실행합니다. Docker 또는 Azure Container Registry에서 이 작업을 사용합니다.

참고

Docker@2 명령에 인수로 전달할 수 있는 입력을 제거하여 작업을 간소화하는 이 작업의 최신 버전입니다.

Syntax

# Docker v0
# Build, tag, push, or run Docker images, or run a Docker command.
- task: Docker@0
  inputs:
    containerregistrytype: 'Azure Container Registry' # 'Azure Container Registry' | 'Container Registry'. Required. Container Registry Type. Default: Azure Container Registry.
    #dockerRegistryConnection: # string. Alias: dockerRegistryEndpoint. Optional. Use when containerregistrytype = Container Registry. Docker Registry Service Connection. 
    #azureSubscription: # string. Alias: azureSubscriptionEndpoint. Optional. Use when containerregistrytype = Azure Container Registry. Azure subscription. 
    #azureContainerRegistry: # string. Optional. Use when containerregistrytype = Azure Container Registry. Azure Container Registry. 
    action: 'Build an image' # 'Build an image' | 'Tag images' | 'Push an image' | 'Push images' | 'Run an image' | 'Run a Docker command'. Required. Action. Default: Build an image.
    #dockerFile: '**/Dockerfile' # string. Required when action = Build an image. Docker File. Default: **/Dockerfile.
    #buildArguments: # string. Optional. Use when action = Build an image. Build Arguments. 
    #defaultContext: true # boolean. Optional. Use when action = Build an image. Use Default Build Context. Default: true.
    #context: # string. Optional. Use when action = Build an image && defaultContext = false. Build Context. 
    #imageName: '$(Build.Repository.Name):$(Build.BuildId)' # string. Required when action == Build an image || action == Push an image || action == Run an image. Image Name. Default: $(Build.Repository.Name):$(Build.BuildId).
    #imageNamesPath: # string. Required when action == Tag images || action == Push images. Image Names Path. 
    #qualifyImageName: true # boolean. Optional. Use when action = Build an image || action = Tag images || action = Push an image || action = Push images || action = Run an image. Qualify Image Name. Default: true.
    #additionalImageTags: # string. Optional. Use when action = Build an image || action = Tag images || action = Push an image || action = Push images. Additional Image Tags. 
    #includeSourceTags: false # boolean. Optional. Use when action = Build an image || action = Tag image || action = Push an image || action = Push images. Include Source Tags. Default: false.
    #includeLatestTag: false # boolean. Optional. Use when action = Build an image || action = Push an image || action = Push images. Include Latest Tag. Default: false.
    #imageDigestFile: # string. Optional. Use when action = Push an image || action = Push images. Image Digest File. 
    #containerName: # string. Optional. Use when action = Run an image. Container Name. 
    #ports: # string. Optional. Use when action = Run an image. Ports. 
    #volumes: # string. Optional. Use when action = Run an image. Volumes. 
    #envVars: # string. Optional. Use when action = Run an image. Environment Variables. 
    #workDir: # string. Optional. Use when action = Run an image. Working Directory. 
    #entrypoint: # string. Optional. Use when action = Run an image. Entry Point Override. 
    #containerCommand: # string. Optional. Use when action = Run an image. Command. 
    #detached: true # boolean. Optional. Use when action = Run an image. Run In Background. Default: true.
    #restartPolicy: 'no' # 'no' | 'onFailure' | 'always' | 'unlessStopped'. Required when action = Run an image && detached = true. Restart Policy. Default: no.
    #restartMaxRetries: # string. Optional. Use when action = Run an image && detached = true && restartPolicy = onFailure. Maximum Restart Retries. 
    #customCommand: # string. Required when action = Run a Docker command. Command. 
  # commands
    #addBaseImageData: true # boolean. Add base image metadata to image(s). Default: true.
  # Advanced Options
    #dockerHostEndpoint: # string. Docker Host Service Connection. 
    #enforceDockerNamingConvention: true # boolean. Force image name to follow Docker naming convention. Default: true.
    #workingDirectory: '$(System.DefaultWorkingDirectory)' # string. Alias: cwd. Working Directory. Default: $(System.DefaultWorkingDirectory).
    #memory: # string. Memory limit.

입력

containerregistrytype - Container Registry 유형
string. 필수 요소. 허용되는 값: Azure Container Registry, Container Registry. 기본값은 Azure Container Registry입니다.

'Azure Container Registry'을 선택하여 Azure 서비스 연결을 사용하여 연결합니다. '컨테이너 레지스트리'를 선택하여 Docker Hub 또는 다른 프라이빗 컨테이너 레지스트리에 연결합니다.

dockerRegistryConnection - Docker 레지스트리 서비스 연결
입력 별칭: dockerRegistryEndpoint. string. 선택 사항입니다. 를 사용하는 경우 containerregistrytype = Container Registry를 사용합니다.

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

azureSubscription - Azure 구독
입력 별칭: azureSubscriptionEndpoint. string. 선택 사항입니다. 를 사용하는 경우 containerregistrytype = Azure Container Registry를 사용합니다.

Azure 구독을 지정합니다.

azureContainerRegistry - Azure Container Registry
string. 선택 사항입니다. 를 사용하는 경우 containerregistrytype = Azure Container Registry를 사용합니다.

선택한 Azure 구독의 Azure Container Registry 지정합니다. 컨테이너 이미지가 빌드된 다음 이 컨테이너 레지스트리에 푸시됩니다.

action - 작업
string. 필수 요소. 허용되는 값: Build an image, Tag images, Push an image, Push images, Run an image, . Run a Docker command 기본값은 Build an image입니다.

Docker 작업을 지정합니다.

dockerFile - Docker 파일
string. 필요한 경우 action = Build an image입니다. 기본값은 **/Dockerfile입니다.

Docker 파일의 경로를 지정합니다. 작업은 이미지를 빌드하기 위해 찾은 첫 번째 Docker 파일을 사용합니다.

addBaseImageData - 이미지에 기본 이미지 메타데이터 추가
boolean. 기본값은 true입니다.

기본값은 추적 가능성을 돕기 위해 기본 이미지 이름 및 다이제스트와 같은 기본 이미지 데이터를 추가합니다. 값을 로 설정하여 옵트아웃할 false수 있습니다.

buildArguments - 빌드 인수
string. 선택 사항입니다. 를 사용하는 경우 action = Build an image를 사용합니다.

Docker 파일의 빌드 시간 변수를 지정합니다. 새 줄에서 각 name=value 쌍의 서식을 지정합니다.

defaultContext - 기본 빌드 컨텍스트 사용
boolean. 선택 사항입니다. 를 사용하는 경우 action = Build an image를 사용합니다. 기본값은 true입니다.

Docker 파일이 포함된 디렉터리의 빌드 컨텍스트를 지정합니다.

context - 빌드 컨텍스트
string. 선택 사항입니다. 를 사용하는 경우 action = Build an image && defaultContext = false를 사용합니다.

빌드 컨텍스트의 경로를 지정합니다.

imageName - 이미지 이름
string. 필요한 경우 action == Build an image || action == Push an image || action == Run an image입니다. 기본값은 $(Build.Repository.Name):$(Build.BuildId)입니다.

빌드, 푸시 또는 실행할 Docker 이미지의 이름을 지정합니다.

imageNamesPath - 이미지 이름 경로
string. 필요한 경우 action == Tag images || action == Push images입니다.

태그를 지정하거나 푸시할 Docker 이미지의 이름이 포함된 텍스트 파일의 경로를 지정합니다. 각 이미지 이름을 별도의 줄에 나열합니다.

qualifyImageName - 이미지 이름 한정
boolean. 선택 사항입니다. 를 사용하는 경우 action = Build an image || action = Tag images || action = Push an image || action = Push images || action = Run an image를 사용합니다. 기본값은 true입니다.

Docker 레지스트리 서비스 연결의 호스트 이름을 사용하여 정규화된 이미지 이름을 지정합니다.

additionalImageTags - 추가 이미지 태그
string. 선택 사항입니다. 를 사용하는 경우 action = Build an image || action = Tag images || action = Push an image || action = Push images를 사용합니다.

빌드되거나 푸시되는 Docker 이미지에 대한 추가 태그를 지정합니다.

includeSourceTags - 원본 태그 포함
boolean. 선택 사항입니다. 를 사용하는 경우 action = Build an image || action = Tag image || action = Push an image || action = Push images를 사용합니다. 기본값은 false입니다.

Docker 이미지를 빌드하거나 푸시할 때 Git 태그를 포함할지 여부를 지정합니다.

includeLatestTag - 최신 태그 포함
boolean. 선택 사항입니다. 를 사용하는 경우 action = Build an image || action = Push an image || action = Push images를 사용합니다. 기본값은 false입니다.

Docker 이미지를 빌드하거나 푸시할 때 최신 태그를 포함할지 여부를 지정합니다.

imageDigestFile - 이미지 다이제스트 파일
string. 선택 사항입니다. 를 사용하는 경우 action = Push an image || action = Push images를 사용합니다.

푸시된 Docker 이미지의 전체 이미지 리포지토리 다이제스트로 만들어지고 채워진 파일의 경로를 지정합니다.

containerName - 컨테이너 이름
string. 선택 사항입니다. 를 사용하는 경우 action = Run an image를 사용합니다.

실행할 Docker 컨테이너의 이름을 지정합니다.

ports - 포트
string. 선택 사항입니다. 를 사용하는 경우 action = Run an image를 사용합니다.

호스트에 게시할 Docker 컨테이너의 포트를 지정합니다. 새 줄에 각 host-port:container-port 바인딩을 나열합니다.

volumes - 볼륨
string. 선택 사항입니다. 를 사용하는 경우 action = Run an image를 사용합니다.

호스트에서 탑재할 볼륨을 지정합니다. 새 줄에 각각 host-dir:container-dir 나열합니다.

envVars - 환경 변수
string. 선택 사항입니다. 를 사용하는 경우 action = Run an image를 사용합니다.

Docker 컨테이너의 환경 변수를 지정합니다. 새 줄에 각 name=value 쌍을 나열합니다.

workDir - 작업 디렉터리
string. 선택 사항입니다. 를 사용하는 경우 action = Run an image를 사용합니다.

Docker 컨테이너의 작업 디렉터리를 지정합니다.

entrypoint - 진입점 재정의
string. 선택 사항입니다. 를 사용하는 경우 action = Run an image를 사용합니다.

Docker 컨테이너의 기본 진입점 재정의를 지정합니다.

containerCommand - 명령
string. 선택 사항입니다. 를 사용하는 경우 action = Run an image를 사용합니다.

Docker 실행 명령을 지정합니다. docker run 명령은 먼저 지정된 이미지 위에 쓰기 가능한 컨테이너 계층을 만든 다음 지정된 실행 명령을 사용하여 시작합니다. 예를 들어 이미지에 간단한 Python Flask 웹 애플리케이션이 포함된 경우 웹 애플리케이션을 시작하도록 지정할 python app.py 수 있습니다.

detached - 백그라운드에서 실행
boolean. 선택 사항입니다. 를 사용하는 경우 action = Run an image를 사용합니다. 기본값은 true입니다.

백그라운드에서 Docker 컨테이너를 실행할지 여부를 지정합니다.

restartPolicy - 정책 다시 시작
string. 필요한 경우 action = Run an image && detached = true입니다. 허용되는 값: no, onFailure (실패 시), always, unlessStopped (중지되지 않는 한). 기본값은 no입니다.

다시 시작 정책을 지정합니다.

restartMaxRetries - 최대 다시 시작 다시 시도
string. 선택 사항입니다. 를 사용하는 경우 action = Run an image && detached = true && restartPolicy = onFailure를 사용합니다.

Docker 디먼이 시도하는 최대 다시 시작 다시 시도 횟수를 지정합니다.

customCommand - 명령
string. 필요한 경우 action = Run a Docker command입니다.

실행할 Docker 명령 및 인수를 지정합니다. 예를 들어 는 rmi -f image-name 이미지를 제거합니다.

dockerHostEndpoint - Docker 호스트 서비스 연결
string.

Docker 호스트 서비스 연결을 지정합니다. 기본값은 에이전트의 호스트입니다.

enforceDockerNamingConvention - Docker 명명 규칙을 따르도록 이미지 이름 강제 적용
boolean. 기본값은 true입니다.

사용하도록 설정된 경우 Docker 명명 규칙에 따라 Docker 이미지 이름을 수정합니다. 예를 들어 대문자를 소문자로 변환하고 공백을 제거합니다.

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

Docker 명령에 대한 작업 디렉터리를 지정합니다.

memory - 메모리 제한
string.

옵션 접미사가 있는 정수로 컨테이너에 사용할 수 있는 최대 메모리 양(예 2GB: )을 지정합니다.

작업 제어 옵션

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

출력 변수

이 작업은 다운스트림 단계, 작업 및 단계에서 사용할 수 있는 다음 출력 변수를 정의합니다.

DockerOutput
docker 명령의 출력을 저장합니다.

DockerOutputPath
빌드 명령의 출력을 포함하는 파일의 경로입니다.

설명

Docker@2 명령에 인수로 전달할 수 있는 입력을 제거하여 작업을 간소화하는 이 작업의 최신 버전입니다.

요구 사항

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

추가 정보

• Docker@2