Bagikan melalui

Docker@0 - Tugas Docker v0

  • Artikel

Buat, tandai, dorong, jalankan gambar Docker, atau jalankan perintah Docker. Gunakan tugas ini dengan Docker atau registri Azure Container.

Catatan

Docker@2 adalah versi yang lebih baru dari tugas ini yang menyederhanakan tugas dengan menghapus input yang dapat diteruskan sebagai argumen ke perintah.

Sintaks

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

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

# Docker v0
# Build, tag, push, or run Docker images, or run a Docker command. Task can be used with Docker or Azure Container registry.
- 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. 
  # 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.

Input

containerregistrytype - Jenis Container Registry
string. Wajib diisi. Nilai yang diizinkan: Azure Container Registry, Container Registry. Nilai default: Azure Container Registry.

Pilih 'Azure Container Registry' untuk menyambungkannya dengan menggunakan Koneksi Layanan Azure. Pilih 'Registri kontainer' untuk menyambungkan ke Docker Hub atau registri kontainer privat lainnya.


dockerRegistryConnection - Koneksi Layanan Docker Registry
Alias input: dockerRegistryEndpoint. string. Pilihan. Gunakan saat containerregistrytype = Container Registry.

Menentukan koneksi layanan registri Docker. Diperlukan untuk perintah yang perlu mengautentikasi dengan registri.


azureSubscription - Langganan Azure
Alias input: azureSubscriptionEndpoint. string. Opsional. Gunakan saat containerregistrytype = Azure Container Registry.

Menentukan langganan Azure.


azureContainerRegistry - Azure Container Registry
string. Pilihan. Gunakan saat containerregistrytype = Azure Container Registry.

Menentukan Azure Container Registry di Langganan Azure yang dipilih. Gambar kontainer dibangun dan kemudian didorong ke registri kontainer ini.


action - Tindakan
string. Wajib diisi. Nilai yang diizinkan: Build an image, , Tag imagesPush an image, Push images, Run an image, Run a Docker command. Nilai default: Build an image.

Menentukan tindakan Docker.


dockerFile - Docker File
string. Diperlukan saat action = Build an image. Nilai default: **/Dockerfile.

Menentukan jalur ke file Docker. Tugas ini menggunakan file Docker pertama yang ditemukannya untuk membangun gambar.


addBaseImageData - Menambahkan metadata gambar dasar ke gambar
boolean. Nilai default: true.

Nilai default menambahkan data gambar dasar seperti, nama gambar dasar dan hash untuk membantu keterlacakan. Anda dapat memilih keluar dengan mengatur nilai ke false.


buildArguments - Argumen Build
string. Pilihan. Gunakan saat action = Build an image.

Menentukan variabel build-time untuk file Docker. Format setiap name=value pasangan pada baris baru.


defaultContext - Gunakan Konteks Build Default
boolean. Opsional. Gunakan saat action = Build an image. Nilai default: true.

Menentukan konteks build direktori yang berisi file Docker.


context - Konteks Build
string. Pilihan. Gunakan saat action = Build an image && defaultContext = false.

Menentukan jalur ke konteks build.


imageName - Nama Gambar
string. Diperlukan saat action == Build an image || action == Push an image || action == Run an image. Nilai default: $(Build.Repository.Name):$(Build.BuildId).

Menentukan nama gambar Docker untuk membangun, mendorong, atau menjalankan.


imageNamesPath - Jalur Nama Gambar
string. Diperlukan saat action == Tag images || action == Push images.

Menentukan jalur ke file teks yang berisi nama gambar Docker untuk ditandai atau didorong. Mencantumkan setiap nama gambar pada baris terpisah.


qualifyImageName - Nama Gambar yang Memenuhi Syarat
boolean. Pilihan. Gunakan saat action = Build an image || action = Tag images || action = Push an image || action = Push images || action = Run an image. Nilai default: true.

Menentukan nama gambar yang memenuhi syarat dengan nama host koneksi layanan registri Docker.


additionalImageTags - Tag Gambar Tambahan
string. Pilihan. Gunakan saat action = Build an image || action = Tag images || action = Push an image || action = Push images.

Menentukan tag tambahan untuk gambar Docker yang sedang dibangun atau didorong.


includeSourceTags - Sertakan Tag Sumber
boolean. Opsional. Gunakan saat action = Build an image || action = Tag image || action = Push an image || action = Push images. Nilai default: false.

Menentukan apakah akan menyertakan tag Git saat membangun atau mendorong gambar Docker.


includeLatestTag - Sertakan Tag Terbaru
boolean. Pilihan. Gunakan saat action = Build an image || action = Push an image || action = Push images. Nilai default: false.

Menentukan apakah akan menyertakan tag terbaru saat membangun atau mendorong gambar Docker.


imageDigestFile - File Hash Gambar
string. Pilihan. Gunakan saat action = Push an image || action = Push images.

Menentukan jalur ke file yang dibuat dan diisi dengan hash repositori gambar lengkap dari gambar Docker yang didorong.


containerName - Nama Kontainer
string. Opsional. Gunakan saat action = Run an image.

Menentukan nama kontainer Docker yang akan dijalankan.


ports - Port
string. Pilihan. Gunakan saat action = Run an image.

Menentukan port dalam kontainer Docker untuk diterbitkan ke host. Mencantumkan setiap host-port:container-port pengikatan pada baris baru.


volumes - Volume
string. Pilihan. Gunakan saat action = Run an image.

Menentukan volume yang akan dipasang dari host. Cantumkan masing-masing host-dir:container-dir pada baris baru.


envVars - Variabel Lingkungan
string. Pilihan. Gunakan saat action = Run an image.

Menentukan variabel lingkungan untuk kontainer Docker. Mencantumkan setiap name=value pasangan pada baris baru.


workDir - Direktori Kerja
string. Pilihan. Gunakan saat action = Run an image.

Menentukan direktori kerja untuk kontainer Docker.


entrypoint - Penimpaan Titik Masuk
string. Pilihan. Gunakan saat action = Run an image.

Menentukan penimpaan titik entri default untuk kontainer Docker.


containerCommand - Perintah
string. Pilihan. Gunakan saat action = Run an image.

Menentukan perintah jalankan Docker. Perintah jalankan docker terlebih dahulu membuat lapisan kontainer yang dapat ditulis di atas gambar yang ditentukan, lalu memulainya dengan menggunakan perintah jalankan yang ditentukan. Misalnya, jika gambar berisi aplikasi web Python Flask sederhana, Anda dapat menentukan python app.py untuk meluncurkan aplikasi web.


detached - Jalankan di Latar Belakang
boolean. Pilihan. Gunakan saat action = Run an image. Nilai default: true.

Menentukan apakah akan menjalankan kontainer Docker di latar belakang.


restartPolicy - Kebijakan Hidupkan Ulang
string. Diperlukan saat action = Run an image && detached = true. Nilai yang diizinkan: no, onFailure (Saat gagal), always, unlessStopped (Kecuali dihentikan). Nilai default: no.

Menentukan kebijakan hidupkan ulang.


restartMaxRetries - Percobaan Ulang Ulang Maksimum
string. Pilihan. Gunakan saat action = Run an image && detached = true && restartPolicy = onFailure.

Menentukan jumlah maksimum percobaan ulang hidupkan ulang yang dicoba oleh daemon Docker.


customCommand - Perintah
string. Diperlukan saat action = Run a Docker command.

Menentukan perintah dan argumen Docker untuk dijalankan. Misalnya, rmi -f image-name menghapus gambar.


dockerHostEndpoint - Koneksi Layanan Host Docker
string.

Menentukan koneksi layanan host Docker. Default ke host agen.


enforceDockerNamingConvention - Paksa nama gambar untuk mengikuti konvensi penamaan Docker
boolean. Nilai default: true.

Jika diaktifkan, modifikasi nama gambar Docker sesuai dengan konvensi penamaan Docker. Misalnya, konversi karakter huruf besar menjadi huruf kecil dan hapus spasi.


workingDirectory - Direktori Kerja
Alias input: cwd. string. Nilai default: $(System.DefaultWorkingDirectory).

Menentukan direktori kerja untuk perintah Docker.


memory - Batas memori
string.

Menentukan jumlah maksimum memori yang tersedia untuk kontainer sebagai bilangan bulat dengan akhiran opsional, misalnya 2GB.


Opsi kontrol tugas

Semua tugas memiliki opsi kontrol selain input tugas mereka. Untuk informasi selengkapnya, lihat Opsi kontrol dan properti tugas umum.

Variabel output

Tugas ini menentukan variabel output berikut, yang dapat Anda konsumsi dalam langkah-langkah hilir, pekerjaan, dan tahapan.

DockerOutput
Menyimpan output perintah docker.

DockerOutputPath
Jalur file yang berisi output perintah build.

Tugas ini menentukan variabel output berikut, yang dapat Anda konsumsi dalam langkah-langkah hilir, pekerjaan, dan tahapan.

DockerOutput
Menyimpan output perintah docker

Keterangan

Docker@2 adalah versi yang lebih baru dari tugas ini yang menyederhanakan tugas dengan menghapus input yang dapat diteruskan sebagai argumen ke perintah.

Persyaratan

Persyaratan Deskripsi
Jenis alur YAML, Build klasik, Rilis klasik
Berjalan pada Agen, DeploymentGroup
Permintaan Tidak ada
Kemampuan Tugas ini tidak memenuhi tuntutan untuk tugas berikutnya dalam pekerjaan.
Pembatasan perintah Apa pun
Variabel yang dapat diatur Apa pun
Versi agen Semua versi agen yang didukung.
Kategori tugas Build

Lihat juga