مشاركة عبر

تعريف resources.repositories.repository

  • مقالة

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

repositories:
- repository: string # Required as first property. Alias for the repository.
  endpoint: string # ID of the service endpoint connecting to this repository.
  trigger: none | trigger | [ string ] # CI trigger for this repository, no CI trigger if skipped (only works for Azure Repos).
  name: string # repository name (format depends on 'type'; does not accept variables).
  ref: string # ref name to checkout; defaults to 'refs/heads/main'. The branch checked out by default whenever the resource trigger fires.
  type: string # Type of repository: git, github, githubenterprise, and bitbucket.

repositories:
- repository: string # Required as first property. Alias for the repository.
  endpoint: string # ID of the service endpoint connecting to this repository.
  trigger: none | trigger | [ string ] # CI trigger for this repository, no CI trigger if skipped (only works for Azure Repos).
  name: string # repository name (format depends on 'type'; does not accept variables).
  type: string # Type of repository: git, github, githubenterprise, and bitbucket.
  ref: string # ref name to checkout; defaults to 'refs/heads/main'. The branch checked out by default whenever the resource trigger fires. Does not accept variables.

repositories:
- repository: string # Required as first property. Alias for the repository.
  endpoint: string # ID of the service endpoint connecting to this repository.
  name: string # repository name (format depends on 'type'; does not accept variables).
  type: string # Type of repository: git, github, githubenterprise, and bitbucket.
  ref: string # ref name to checkout; defaults to 'refs/heads/main'. The branch checked out by default whenever the resource trigger fires. Does not accept variables.

التعريفات التي تشير إلى هذا التعريف: resources.repositories

الخصائص

repository سلسله. مطلوب كخاصية أولى.
الاسم المستعار للمستودع المحدد. القيم المقبولة: [-_A-Za-z0-9]*.

endpoint سلسله.
معرف نقطة نهاية الخدمة المتصلة بهذا المستودع.

triggerالمشغل.
مشغل CI لهذا المستودع، لا يوجد مشغل CI إذا تم حذفه.

هام

  • يتم دعم مشغلات موارد المستودع فقط لمستودعات Azure Repos Git.
  • لا تدعم batchمشغلات موارد المستودع .

name سلسله.
اسم المستودع. يعتمد التنسيق على "النوع"؛ لا يقبل المتغيرات.

ref سلسله.
ref name to checkout; الإعدادات الافتراضية إلى "refs/heads/main". يتم سحب الفرع بشكل افتراضي كلما تم تشغيل مشغل المورد. يتم دعم تعبيرات القالب.

ref سلسله.
ref name to checkout; الإعدادات الافتراضية إلى "refs/heads/main". يتم سحب الفرع بشكل افتراضي كلما تم تشغيل مشغل المورد. لا يقبل المتغيرات.

type سلسله.
نوع المستودع: git و github و githubenterprise و bitbucket.

الملاحظات

هام

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

يتم دعم تعبيرات القالب للخاصية ref (ولكن ليس الخاصية name ). يتم دعم أحرف البدل في المشغلات.

هام

يتم دعم مشغلات موارد المستودع لمستودعات Azure Repos Git فقط. لمزيد من المعلومات حول trigger بناء الجملة، بما في ذلك دعم أحرف البدلللفروعوالعلامات، راجع تعريف المشغلوإنشاء مستودعات Azure Repos Git أو TFS Git.

هام

batch غير مدعوم في مشغلات موارد المستودع.

إذا كانت البنية الأساسية لبرنامج ربط العمليات التجارية الخاصة بك تحتوي على قوالب في مستودع آخر، فيجب عليك إعلام النظام بهذا المستودع.

إذا كانت البنية الأساسية لبرنامج ربط العمليات التجارية تحتوي على قوالب في مستودع آخر، أو إذا كنت تريد استخدام السحب متعدد المستودع مع مستودع يتطلب اتصال خدمة، فيجب عليك إعلام النظام بهذا المستودع.

الأنواع

تدعم البنية الأساسية لبرنامج ربط العمليات التجارية القيم التالية لنوع المستودع: gitو githubو.bitbucket git يشير النوع إلى مستودعات Azure Repos Git.

  • إذا حددت type: git، name تشير القيمة إلى اسم مستودع Azure Repos Git.

    • إذا كانت البنية الأساسية لبرنامج ربط العمليات التجارية الخاصة بك في نفس مشروع Azure DevOps مثل المستودع، على سبيل المثال مستودع يسمى tools، يمكنك الرجوع إليه باستخدام name: tools.
    • إذا كانت البنية الأساسية لبرنامج ربط العمليات التجارية الخاصة بك في نفس مؤسسة Azure DevOps مثل المستودع، ولكن في مشروع Azure DevOps مختلف، على سبيل المثال مشروع يسمى ToolsProject، يجب عليك تأهيل اسم المستودع باسم المشروع: name: ToolsProject/tools.

  • إذا قمت بتحديد type: github، فإن name القيمة هي الاسم الكامل لمرجع GitHub وتتضمن المستخدم أو المؤسسة. المثال هو name: Microsoft/vscode. تتطلب مستودعات GitHub اتصال خدمة GitHub للتخويل.

  • إذا قمت بتحديد type: bitbucket، فإن name القيمة هي الاسم الكامل لمرجع Bitbucket Cloud وتتضمن المستخدم أو المؤسسة. المثال هو name: MyBitbucket/vscode. تتطلب مستودعات Bitbucket Cloud اتصال خدمة Bitbucket Cloud للتخويل.

لمزيد من المعلومات حول هذه الأنواع، راجع التحقق من مستودعات متعددة في البنية الأساسية لبرنامج ربط العمليات التجارية الخاصة بك - تعريف مورد المستودع.

المتغيرات

في كل تشغيل، تتوفر بيانات التعريف لمورد المستودع لجميع المهام في شكل متغيرات وقت التشغيل. <Alias> هو المعرف الذي أعطيته لمورد المستودع الخاص بك.

resources.repositories.<Alias>.name
resources.repositories.<Alias>.ref
resources.repositories.<Alias>.type
resources.repositories.<Alias>.id
resources.repositories.<Alias>.url
resources.repositories.<Alias>.version

يحتوي المثال التالي على مورد مستودع باسم مستعار ل common، ويتم الوصول إلى متغيرات مورد المستودع باستخدام resources.repositories.common.*.

resources:
  repositories:
    - repository: common
      type: git
      ref: main
      name: Repo

variables:
  ref: $[ resources.repositories.common.ref ]
  name: $[ resources.repositories.common.name ]
  id: $[ resources.repositories.common.id ]
  type: $[ resources.repositories.common.type ]
  url: $[ resources.repositories.common.url ]
  version: $[ resources.repositories.common.version ]

steps:
- bash: |
    echo "name = $(name)"
    echo "ref = $(ref)"
    echo "id = $(id)"
    echo "type = $(type)"
    echo "url = $(url)"
    echo "version = $(version)"

المتغيرات

في كل تشغيل، تتوفر بيانات التعريف لمورد المستودع لجميع المهام في شكل متغيرات وقت التشغيل. <Alias> هو المعرف الذي أعطيته لمورد المستودع الخاص بك.

resources.repositories.<Alias>.name
resources.repositories.<Alias>.ref
resources.repositories.<Alias>.type
resources.repositories.<Alias>.id
resources.repositories.<Alias>.url

يحتوي المثال التالي على مورد مستودع باسم مستعار ل common، ويتم الوصول إلى متغيرات مورد المستودع باستخدام resources.repositories.common.*.

resources:
  repositories:
    - repository: common
      type: git
      ref: main
      name: Repo

variables:
  ref: $[ resources.repositories.common.ref ]
  name: $[ resources.repositories.common.name ]
  id: $[ resources.repositories.common.id ]
  type: $[ resources.repositories.common.type ]
  url: $[ resources.repositories.common.url ]

steps:
- bash: |
    echo "name = $(name)"
    echo "ref = $(ref)"
    echo "id = $(id)"
    echo "type = $(type)"
    echo "url = $(url)"

أمثلة

resources:
  repositories:
  - repository: common
    type: github
    name: Contoso/CommonTools
    endpoint: MyContosoServiceConnection

راجع أيضًا