Docker@1 - Docker v1 工作

建置、標記、推送或執行 Docker 映射，或執行 Docker 命令。 搭配 Docker 或 Azure Container Registry 使用此工作。

注意

Docker@2 是較新版本的工作，可藉由移除可當做引數傳遞至命令的輸入來簡化工作。

Syntax

# Docker v1
# Build, tag, push, or run Docker images, or run a Docker command.
- task: Docker@1
  inputs:
  # Container Registry
    #containerregistrytype: 'Azure Container Registry' # 'Azure Container Registry' | 'Container Registry'. Required when command != logout. Container registry type. Default: Azure Container Registry.
    #dockerRegistryEndpoint: # string. Optional. Use when containerregistrytype = Container Registry && command != logout. Docker registry service connection. 
    #azureSubscriptionEndpoint: # string. Optional. Use when containerregistrytype = Azure Container Registry && command != logout. Azure subscription. 
    #azureContainerRegistry: # string. Optional. Use when containerregistrytype = Azure Container Registry && command != logout. Azure container registry. 
  # Commands
    #addBaseImageData: true # boolean. Add base image metadata to image(s). Default: true.
    command: 'Build an image' # 'Build an image' | 'Tag image' | 'Push an image' | 'Run an image' | 'login' | 'logout'. Required. Command. Default: Build an image.
    #dockerFile: '**/Dockerfile' # string. Required when command = Build an image || command = build. Dockerfile. Default: **/Dockerfile.
    #arguments: # string. Optional. Use when command != login && command != logout. Arguments. 
    #pushMultipleImages: false # boolean. Optional. Use when command = Push an image || command = push. Push multiple images. Default: false.
    #tagMultipleImages: false # boolean. Optional. Use when command = Tag image || command = tag. Tag multiple images. Default: false.
    #imageName: '$(Build.Repository.Name):$(Build.BuildId)' # string. Required when command = Build an image || command = build || command = Run an image || command = run || pushMultipleImages = false || tagMultipleImages = false. Image name. Default: $(Build.Repository.Name):$(Build.BuildId).
    #imageNamesPath: # string. Required when tagMultipleImages = true || pushMultipleImages = true. Image names path. 
    #qualifyImageName: true # boolean. Optional. Use when command = Build an image || command = build || command = Tag image || command = tag || command = Push an image || command = push || command = Run an image || command = run. Qualify image name. Default: true.
    #qualifySourceImageName: false # boolean. Optional. Use when command = Tag image || command = tag. Qualify source image name. Default: false.
    #includeSourceTags: false # boolean. Optional. Use when command = Build an image || command = build || command = Tag image || command = tag  || command = Push an image || command = push. Include source tags. Default: false.
    #includeLatestTag: false # boolean. Optional. Use when command = Build an image || command = build. Include latest tag. Default: false.
    #addDefaultLabels: true # boolean. Optional. Use when addDefaultLabels = false. Add default labels. Default: true.
    #useDefaultContext: true # boolean. Optional. Use when command = Build an image || command = build. Use default build context. Default: true.
    #buildContext: # string. Optional. Use when useDefaultContext = false. Build context. 
    #imageDigestFile: # string. Optional. Use when command = Push an image || command = push. Image digest file. 
    #containerName: # string. Optional. Use when command = Run an image || command = run. Container name. 
    #ports: # string. Optional. Use when command = Run an image || command = run. Ports. 
    #volumes: # string. Optional. Use when command = Run an image || command = run. Volumes. 
    #envVars: # string. Optional. Use when command = Run an image || command = run. Environment variables. 
    #workingDirectory: # string. Optional. Use when command = Run an image || command = run. Working directory. 
    #entrypointOverride: # string. Optional. Use when command = Run an image || command = run. Entry point override. 
    #containerCommand: # string. Optional. Use when command = Run an image || command = run. Container command. 
    #runInBackground: true # boolean. Optional. Use when command = Run an image || command = run. Run in background. Default: true.
    restartPolicy: 'no' # 'no' | 'onFailure' | 'always' | 'unlessStopped'. Required when runInBackground = true. Restart policy. Default: no.
    #maxRestartRetries: # string. Optional. Use when runInBackground = true && restartPolicy = onFailure. Maximum restart retries. 
  # Advanced Options
    #dockerHostEndpoint: # string. Optional. Use when command != login && command != logout. Docker host service connection. 
    #enforceDockerNamingConvention: true # boolean. Optional. Use when command != login && command != logout. Force image name to follow Docker naming convention. Default: true.
    #memoryLimit: # string. Optional. Use when command != login && command != logout. Memory limit.

輸入

containerregistrytype - 容器登錄類型
string. 當 command != logout 時為必要。 允許值：Azure Container Registry 和 Container Registry。 預設值：Azure Container Registry。

指定要使用 Azure 服務連線進行連線的Azure Container Registry。 選取Azure Container Registry以連線到Docker Hub或任何其他私人容器登錄。

addBaseImageData - 將基底映射中繼資料新增至映射 ()
boolean. 預設值：true。

預設值會新增基底映射資料，例如基底映射名稱和摘要，以協助追蹤。 您可以將此值設定為 false ，以退出宣告此預設行為。

dockerRegistryEndpoint - Docker 登錄服務連線
string. 選擇性。 使用 時機 containerregistrytype = Container Registry && command != logout 。

指定 Docker 登錄服務連線。 使用登錄進行驗證的命令需要 。

azureSubscriptionEndpoint - Azure 訂用帳戶
string. 選擇性。 使用 時機 containerregistrytype = Azure Container Registry && command != logout 。

指定 Azure 訂用帳戶。

azureContainerRegistry - Azure Container Registry
string. 選擇性。 使用 時機 containerregistrytype = Azure Container Registry && command != logout 。

指定所選 Azure 訂用帳戶中的Azure Container Registry。 容器映射已建置並推送至此容器登錄。

command - 命令
string. 必要。 允許的值： Build an image (建置) 、 Tag image (標籤) 、 (推送) 、 Run an imagePush an image (執行) 、、 loginlogout 。 預設值：Build an image。

指定要執行的 docker 命令。

dockerFile - Dockerfile
string. 當 command = Build an image || command = build 時為必要。 預設值：**/Dockerfile。

指定 Docker 檔案的路徑。 工作會使用它找到的第一個 Docker 檔案來建置映射。

arguments - 參數
string. 選擇性。 使用 時機 command != login && command != logout 。

指定要傳遞至 Docker 用戶端的其他引數。 在命令參數中使用 值 buildAndPush 會忽略 arguments 屬性。

pushMultipleImages - 推送多個影像
boolean. 選擇性。 使用 時機 command = Push an image || command = push 。 預設值：false。

指定要推送之 Docker 映射文字檔中的清單。 以個別行的格式 Imagename1:tag1 列出每個影像名稱。 列出不含標籤的映射名稱，例如 Imagename2 ，會推送容器中的所有 Imagename2 標籤。

tagMultipleImages - 標記多個影像
boolean. 選擇性。 使用 時機 command = Tag image || command = tag 。 預設值：false。

指定要在文字檔中標記的多個映射標籤和 Docker 映射清單。 以個別行的格式 Imagename1:tag1 列出每個影像名稱。 未列出標記的 Imagename2 影像預設會標記為 最新 。

imageName - 映射名稱
string. 當 command = Build an image || command = build || command = Run an image || command = run || pushMultipleImages = false || tagMultipleImages = false 時為必要。 預設值：$(Build.Repository.Name):$(Build.BuildId)。

指定要建置、推送或執行之 Docker 映射的名稱。

imageNamesPath - 映射名稱路徑
string. 當 tagMultipleImages = true || pushMultipleImages = true 時為必要。

指定要標記或推送之 Docker 映射名稱的文字檔路徑。 列出每一行上的每個影像名稱。

qualifyImageName - 限定影像名稱
boolean. 選擇性。 使用 時機 command = Build an image || command = build || command = Tag image || command = tag || command = Push an image || command = push || command = Run an image || command = run 。 預設值：true。

使用 Docker 登錄服務連線的主機名稱來指定限定映射名稱。

qualifySourceImageName - 限定來源映射名稱
boolean. 選擇性。 使用 時機 command = Tag image || command = tag 。 預設值：false。

使用 Docker 登錄服務連線的主機名稱來指定限定映射名稱。

includeSourceTags - 包含來源標籤
boolean. 選擇性。 使用 時機 command = Build an image || command = build || command = Tag image || command = tag || command = Push an image || command = push 。 預設值：false。

指定建置或推送 Docker 映射時要包含的 Git 標籤。

includeLatestTag - 包含最新的標籤
boolean. 選擇性。 使用 時機 command = Build an image || command = build 。 預設值：false。

指定在建置 Docker 映射時是否要使用 最新的 標籤。

addDefaultLabels - 新增預設標籤
boolean. 選擇性。 使用 時機 addDefaultLabels = false 。 預設值：true。

指定是否要使用 Docker 標籤將 CI/CD 中繼資料新增至容器映射，例如存放庫、認可、建置和發行資訊。

useDefaultContext - 使用預設組建內容
boolean. 選擇性。 使用 時 command = Build an image || command = build 。 預設值：true。

指定將組建內容新增或移除至包含 Docker 檔案的目錄。

buildContext - 建置內容
string. 選擇性。 使用 時 useDefaultContext = false 。

指定組建內容的路徑。

imageDigestFile - 影像摘要檔案
string. 選擇性。 使用 時 command = Push an image || command = push 。

指定建立並填入已推送之 Docker 映射的完整映射存放庫摘要的檔案路徑。

containerName - 容器名稱
string. 選擇性。 使用 時 command = Run an image || command = run 。

指定要執行的 Docker 容器名稱。

ports - 港口
string. 選擇性。 使用 時 command = Run an image || command = run 。

指定要發佈至主機之 Docker 容器中的埠。 列出個別行上的每個 host-port:container-port 系結。

volumes - 卷
string. 選擇性。 使用 時 command = Run an image || command = run 。

指定要從主機掛接的磁片區。 列出每 host-dir:container-dir 一行。

envVars - 環境變數
string. 選擇性。 使用 時 command = Run an image || command = run 。

指定 Docker 容器的環境變數。 列出個別行上的每 name=value 一組。

workingDirectory - 工作目錄
string. 選擇性。 使用 時 command = Run an image || command = run 。

指定 Docker 容器的工作目錄。

entrypointOverride - 進入點覆寫
string. 選擇性。 使用 時 command = Run an image || command = run 。

指定是否覆寫 Docker 容器的預設進入點。

containerCommand - 容器命令
string. 選擇性。 使用 時 command = Run an image || command = run 。

指定 Docker 執行命令。 docker run 命令會先在指定的映射上建立可寫入的容器層，然後使用指定的執行命令加以啟動。 例如，如果映射包含簡單的 Python Flask Web 應用程式，您可以指定 python app.py 來啟動 Web 應用程式。

runInBackground - 在背景中執行
boolean. 選擇性。 使用 時 command = Run an image || command = run 。 預設值：true。

指定是否要在背景中執行 Docker 容器。

restartPolicy - 重新開機原則
string. 當 runInBackground = true 時為必要。 允許的值： no 、 onFailure (在失敗) 、、 alwaysunlessStopped (除非停止) 。 預設值：no。

指定何時執行重新開機原則。

maxRestartRetries - 重新開機重試次數上限
string. 選擇性。 使用 時 runInBackground = true && restartPolicy = onFailure 。

指定 Docker 精靈嘗試的重新開機重試次數上限。

dockerHostEndpoint - Docker 主機服務連線
string. 選擇性。 使用 時 command != login && command != logout 。

指定 Docker 主機服務連線。 預設為代理程式的主機。

enforceDockerNamingConvention - 強制映射名稱遵循 Docker 命名慣例
boolean. 選擇性。 使用 時 command != login && command != logout 。 預設值：true。

預設值會根據 Docker 命名慣例修改 Docker 映射名稱。 例如，將大寫字元轉換成小寫，並移除空格。

memoryLimit - 記憶體限制
string. 選擇性。 使用 時 command != login && command != logout 。

指定容器可用的記憶體數量上限，做為具有選擇性尾碼的整數，例如 2GB 。

工作控制選項

除了工作輸入之外，所有工作都有控制選項。 如需詳細資訊，請參閱 控制選項和一般工作屬性。

輸出變數

此工作會定義下列 輸出變數，您可以在下游步驟、作業和階段中使用。

DockerOutput
儲存 docker 命令的輸出

DockerOutputPath
包含建置命令輸出的檔案路徑。

備註

Docker@2 是這個工作的較新版本，可藉由移除可當做引數傳遞至命令的輸入來簡化工作。

規格需求

需求	描述
管線類型	YAML、傳統組建、傳統版本
在 上執行	Agent、DeploymentGroup
要求	無
Capabilities	此工作不符合作業中後續工作的任何需求。
命令限制	任何
可設定變數	任何
代理程式版本	所有支援的代理程式版本。
工作類別	建置

另請參閱

• Docker@2