Docker@0 - مهمة Docker v0

إنشاء صور Docker أو وضع علامة عليها أو دفعها أو تشغيلها أو تشغيل أمر Docker. استخدم هذه المهمة مع Docker أو سجل حاوية Azure.

ملاحظة

Docker@2 هو إصدار أحدث من هذه المهمة يبسط المهمة عن طريق إزالة المدخلات التي يمكن تمريرها كوسيطات إلى الأمر .

بناء الجملة

# 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 - نوع سجل الحاوية
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 Container Registry في اشتراك Azure المحدد. يتم إنشاء صورة الحاوية ثم دفعها إلى سجل الحاوية هذا.

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.

يحدد ما إذا كان يجب تضمين علامات Git عند إنشاء صورة Docker أو دفعها.

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 أولا طبقة حاوية قابلة للكتابة فوق الصورة المحددة، ثم يبدأها باستخدام أمر التشغيل المحدد. على سبيل المثال، إذا كانت الصورة تحتوي على تطبيق ويب 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 هو إصدار أحدث من هذه المهمة يبسط المهمة عن طريق إزالة المدخلات التي يمكن تمريرها كوسيطات إلى الأمر .

المتطلبات

المتطلبات	الوصف
أنواع البنية الأساسية لبرنامج ربط العمليات التجارية	YAML، الإصدار الكلاسيكي، الإصدار الكلاسيكي
يعمل على	Agent, DeploymentGroup
المطالب	بلا
القدرات	لا تفي هذه المهمة بأي طلبات للمهام اللاحقة في الوظيفة.
قيود الأوامر	أي
متغيرات Settable	أي
إصدار الوكيل	جميع إصدارات العامل المدعومة.
فئة المهمة	البنية

راجع أيضًا

• Docker@2