مرجع مخطط YAML ل Azure Pipelines

مرجع مخطط YAML ل Azure Pipelines هو مرجع مفصل لمسارات YAML التي تسرد جميع بناء جملة YAML المدعوم وخياراتها المتاحة.

لإنشاء مسار YAML، ابدأ بتعريف البنية الأساسية لبرنامج ربط العمليات التجارية. لمزيد من المعلومات حول إنشاء مسارات YAML، راجع تخصيص البنية الأساسية لبرنامج ربط العمليات التجارية الخاصة بك.

لا يغطي مرجع مخطط YAML المهام. لمزيد من المعلومات حول المهام، راجع فهرس مهام Azure Pipelines.

التعريفات

البنية الأساسية لبرنامج ربط العمليات التجارية
البنية الأساسية لبرنامج ربط العمليات التجارية هي مرحلة واحدة أو أكثر تصف عملية CI/CD. يحتوي تعريف البنية الأساسية لبرنامج ربط العمليات التجارية على وثائق خصائص مستوى الجذر مثل name.

توسيع
توسيع البنية الأساسية لبرنامج ربط العمليات التجارية باستخدام قالب.

الوظائف
يحدد الوظائف التي تشكل عمل المرحلة.

jobs.deployment
مهمة التوزيع هي نوع خاص من المهام. إنها مجموعة من الخطوات للتشغيل بشكل تسلسلي مقابل البيئة.

jobs.deployment.environment
اسم البيئة الهدف واسم المورد اختياريا لتسجيل محفوظات التوزيع؛ format: environment-name.resource-name.

jobs.deployment.strategy
استراتيجية التنفيذ لهذا النشر.

jobs.deployment.strategy.canary
استراتيجية نشر الكناري.

jobs.deployment.strategy.rolling
استراتيجية Rolling Deployment.

jobs.deployment.strategy.runOnce
استراتيجية نشر RunOnce.

jobs.job
الوظيفة هي مجموعة من الخطوات التي يقوم بتشغيلها عامل أو على خادم.

jobs.job.container
اسم مورد الحاوية.

jobs.job.strategy
استراتيجية التنفيذ لهذه الوظيفة.

jobs.job.uses
أي موارد تتطلبها هذه المهمة لم تتم الإشارة إليها بالفعل.

jobs.template
مجموعة من المهام المعرفة في قالب.

المعلمات
يحدد معلمات وقت التشغيل التي تم تمريرها إلى البنية الأساسية لبرنامج ربط العمليات التجارية.

المعلمات.المعلمة
معلمات قالب البنية الأساسية لبرنامج ربط العمليات التجارية.

تجمع
أي تجمع يجب استخدامه لوظيفة البنية الأساسية لبرنامج ربط العمليات التجارية.

pool.demands
الطلبات (لتجمع خاص).

علاقات عامه
مشغل طلب السحب.

موارد
تحدد Resources البنيات والمستودعات والتدفقات والموارد الأخرى المستخدمة من قبل البنية الأساسية لبرنامج ربط العمليات التجارية.

resources.builds
قائمة بموارد البناء المشار إليها بواسطة البنية الأساسية لبرنامج ربط العمليات التجارية.

resources.builds.build
مورد بناء يستخدم للإشارة إلى البيانات الاصطناعية من عملية تشغيل.

resources.containers
قائمة بصور الحاوية.

resources.containers.container
مورد حاوية يستخدم للإشارة إلى صورة حاوية.

resources.containers.container.trigger
حدد بلا لتعطيل أو صواب لتشغيله على جميع علامات الصور أو استخدم بناء الجملة الكامل كما هو موضح في الأمثلة التالية.

resources.packages
قائمة موارد الحزمة.

resources.packages.package
مورد حزمة يستخدم للإشارة إلى حزمة NuGet أو npm GitHub.

resources.pipelines
قائمة بموارد البنية الأساسية لبرنامج ربط العمليات التجارية.

resources.pipelines.pipeline
مورد البنية الأساسية لبرنامج ربط العمليات التجارية.

resources.pipelines.pipeline.trigger
حدد بلا لتعطيل، أو صواب لتضمين كافة الفروع، أو استخدم بناء الجملة الكامل كما هو موضح في الأمثلة التالية.

resources.pipelines.pipeline.trigger.branches
الفروع لتضمينها أو استبعادها لتشغيل تشغيل.

resources.repositories
قائمة موارد المستودع.

resources.repositories.repository
يتم استخدام مورد مستودع للإشارة إلى مستودع إضافي في البنية الأساسية لبرنامج ربط العمليات التجارية الخاصة بك.

resources.webhooks
قائمة خطافات الويب.

resources.webhooks.webhook
يتيح لك مورد webhook دمج البنية الأساسية لبرنامج ربط العمليات التجارية مع خدمة خارجية لأتمتة سير العمل.

resources.webhooks.webhook.filters
قائمة عوامل تصفية المشغل.

resources.webhooks.webhook.filters.filter
عامل تصفية مشغل مورد Webhook.

جداول
تحدد قائمة الجداول المشغلات المجدولة للبنية الأساسية لبرنامج ربط العمليات التجارية.

schedules.cron
يحدد المشغل المجدول جدولا يتم بناء الفروع عليه.

المراحل
المراحل هي مجموعة من الوظائف ذات الصلة.

stages.stage
المرحلة هي مجموعة من الوظائف ذات الصلة.

stages.template
يمكنك تحديد مجموعة من المراحل في ملف واحد واستخدامها عدة مرات في ملفات أخرى.

الخطوات
الخطوات هي تسلسل خطي للعمليات التي تشكل وظيفة.

steps.bash
تشغيل برنامج نصي في Bash على Windows وmacOS وLinux.

steps.checkout
تكوين كيفية فحص البنية الأساسية لبرنامج ربط العمليات التجارية للتعليمات البرمجية المصدر.

steps.download
تنزيل البيانات الاصطناعية المقترنة بالتشغيل الحالي أو من Azure Pipeline آخر مقترن كمورد مسار.

steps.downloadBuild
تنزيلات إنشاء البيانات الاصطناعية.

steps.getPackage
تنزيل حزمة من موجز إدارة الحزمة في Azure Artifacts أو Azure DevOps Server.

steps.powershell
تشغيل برنامج نصي باستخدام إما Windows PowerShell (على Windows) أو pwsh (Linux وmacOS).

steps.publish
نشر (تحميل) ملف أو مجلد كأداة مسار يمكن أن تستهلكها الوظائف والتدفقات الأخرى.

steps.pwsh
تشغيل برنامج نصي في PowerShell Core على Windows وmacOS وLinux.

steps.reviewApp
تنشئ التنزيلات موردا ديناميكيا ضمن موفر مرحلة التوزيع.

steps.script
تشغيل برنامج نصي باستخدام cmd.exe على Windows وBash على الأنظمة الأساسية الأخرى.

steps.task
تشغيل مهمة.

steps.template
تعريف مجموعة من الخطوات في ملف واحد واستخدامها عدة مرات في ملف آخر.

الهدف
يتم تشغيل المهام في سياق تنفيذ، وهو إما مضيف العامل أو حاوية.

target.settableVariables
القيود على المتغيرات التي يمكن تعيينها.

مشغل
مشغل التكامل المستمر (الدفع).

المتغيرات
تعريف المتغيرات باستخدام أزواج الاسم/القيمة.

variables.group
المتغيرات المرجعية من مجموعة متغيرات.

variables.name
تعريف المتغيرات باستخدام الاسم وبناء الجملة الكامل.

variables.template
تعريف المتغيرات في قالب.

التعريفات الداعمة

إشعار

التعريفات الداعمة غير مخصصة للاستخدام مباشرة في البنية الأساسية لبرنامج ربط العمليات التجارية. يتم استخدام التعريفات الداعمة فقط كجزء من تعريفات أخرى، ويتم تضمينها هنا للرجوع إليها.

نشر خطاف
يستخدم لتشغيل الخطوات التي تنشر التطبيق الخاص بك.

includeExcludeFilters
قوائم العناصر المراد تضمينها أو استبعادها.

includeExcludeStringFilters
العناصر المراد تضمينها أو استبعادها.

mountReadOnly
وحدات التخزين لتحميل للقراءة فقط، تكون القيمة الافتراضية كلها خاطئة.

onFailureHook
يستخدم لتشغيل خطوات إجراءات التراجع أو التنظيف.

onSuccessHook
يستخدم لتشغيل خطوات إجراءات التراجع أو التنظيف.

onSuccessOrFailureHook
يستخدم لتشغيل خطوات إجراءات التراجع أو التنظيف.

ما بعدRouteTrafficHook
يستخدم لتشغيل الخطوات بعد توجيه حركة المرور. عادة ما تراقب هذه المهام صحة الإصدار المحدث للفاصل الزمني المحدد.

preDeployHook
يستخدم لتشغيل الخطوات التي تهيئ الموارد قبل بدء نشر التطبيق.

routeTrafficHook
يستخدم لتشغيل الخطوات التي تخدم نسبة استخدام الشبكة إلى الإصدار المحدث.

مساحة عمل
خيارات مساحة العمل على العامل.

اصطلاحات وثائق مخطط YAML

مرجع مخطط YAML هو دليل مرجعي مفصل لخطوط أنابيب Azure YAML. يتضمن كتالوج لكافة قدرات YAML المدعومة والخيارات المتاحة.

فيما يلي اصطلاحات بناء الجملة المستخدمة في مرجع مخطط YAML.

  • إلى يسار : عبارة عن كلمة أساسية حرفية تستخدم في تعريفات البنية الأساسية لبرنامج ربط العمليات التجارية.
  • يوجد نوع بيانات على يمين :. يمكن أن يكون نوع البيانات نوعا بدائيا مثل سلسلة أو مرجعا إلى بنية غنية معرفة في مكان آخر في هذا المرجع.
  • يشير[إلى صفيف من نوع التعريف المذكور. على سبيل المثال، [ string ] هو صفيف من السلاسل.
  • يشير {نوع البيانات:نوع البيانات} إلى تعيين نوع بيانات إلى آخر. على سبيل المثال، { string: string } هو تعيين سلاسل إلى سلاسل.
  • يشير الرمز | إلى وجود أنواع بيانات متعددة متوفرة للكلمة الأساسية. على سبيل المثال، يعني job | template إما السماح بتعريف وظيفة أو مرجع قالب.

الإصدارات السابقة

راجع أيضًا

يغطي هذا المرجع مخطط ملف YAML ل Azure Pipelines. لمعرفة أساسيات YAML، راجع Learn YAML في Y Minutes. لا تدعم Azure Pipelines جميع ميزات YAML. تتضمن الميزات غير المدعومة نقاط الارتساء والمفاتيح المعقدة والمجموعات. أيضا، على عكس YAML القياسي، تعتمد Azure Pipelines على رؤية stageأو jobأو taskأو اختصار مهمة مثل script كمفتاح أول في التعيين.

  • Last updated on