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

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

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

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

التعريفات

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

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

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

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

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

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

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

jobs.deployment.strategy.rolling
استراتيجية التوزيع المتداول.

jobs.deployment.strategy.runOnce
استراتيجية توزيع RunOnce.

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

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

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

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

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

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

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

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

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

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

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

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
يمكنك مورد خطاف الويب من دمج البنية الأساسية لبرنامج ربط العمليات التجارية الخاصة بك مع خدمة خارجية لأتمتة سير العمل.

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
تعريف المتغيرات في قالب.

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

ملاحظة

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

راجع أيضًا

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