resources.repositories.repository tanımı

  • Makale

repository anahtar sözcüğü bir dış depo belirtmenize olanak tanır. İşlem hattınızdaki ek bir depoya başvurmak için bir depo kaynağı kullanın.

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.

Bu tanıma başvuran tanımlar: resources.repositories

Özellikler

repository Dize. İlk özellik olarak gereklidir.
Belirtilen deponun diğer adı. Kabul edilebilir değerler: [-_A-Za-z0-9]*.

endpoint Dize.
Bu depoya bağlanan hizmet uç noktasının kimliği.

triggertetikleyiciyi seçin.
Bu depo için CI tetikleyicisi, atlanırsa CI tetikleyicisi yok.

Önemli

  • Depo kaynak tetikleyicileri yalnızca Azure Repos Git depoları için desteklenir.
  • Depo kaynak tetikleyicileri desteklemez batch.

name Dize.
Depo adı. Biçim 'türe' bağlıdır; değişkenleri kabul etmez.

ref Dize.
kullanıma almak için başvuru adı; varsayılan olarak 'refs/heads/main' olarak ayarlanır. Kaynak tetikleyicisi her tetiklendiğinde dal varsayılan olarak kullanıma alınmış. Şablon ifadeleri desteklenir.

ref Dize.
kullanıma almak için başvuru adı; varsayılan olarak 'refs/heads/main' olarak ayarlanır. Kaynak tetikleyicisi her tetiklendiğinde dal varsayılan olarak kullanıma alınmış. Değişkenleri kabul etmez.

type Dize.
Depo türü: git, github, githubenterprise ve bitbucket.

Açıklamalar

Önemli

Depo kaynağı ve refiçinde name işlem hattı değişkenlerine izin vermiyor. Joker karakterler tetikleyicilerde desteklenir.

Şablon ifadeleri özelliği için ref desteklenir (ancak özellik için name desteklenmez). Joker karakterler tetikleyicilerde desteklenir.

Önemli

Depo kaynak tetikleyicileri yalnızca Azure Repos Git depoları için desteklenir. Dallar ve etiketler için joker karakter desteği de dahil olmak üzere söz dizimi hakkında trigger daha fazla bilgi için bkz. tetikleyici tanımı ve Git veya TFS Git depoları Azure Repos derleme.

Önemli

batch depo kaynak tetikleyicilerinde desteklenmez.

İşlem hattınızda başka bir depoda şablonlar varsa, sisteme bu depo hakkında bilgi vermelisiniz.

İşlem hattınızın başka bir depoda şablonları varsa veya hizmet bağlantısı gerektiren bir depoyla çok depolu kullanıma alma kullanmak istiyorsanız, bu depoyu sisteme bildirmeniz gerekir.

Türler

İşlem hatları, depo türü için aşağıdaki değerleri destekler: git, githubve bitbucket. Türgit, Azure Repos Git depolarına başvurur.

  • belirtirseniztype: gitname, değer bir Azure Repos Git deposunun adına başvurur.

    • İşlem hattınız depoyla aynı Azure DevOps projesindeyse ( örneğin adlı toolsbir depo) kullanarak name: toolsbuna başvurursunuz.
    • İşlem hattınız depoyla aynı Azure DevOps kuruluşunda, ancak farklı bir Azure DevOps projesinde, örneğin adlı ToolsProjectbir projedeyse, depo adını şu proje adıyla nitelemeniz gerekir: name: ToolsProject/tools.

  • belirtirseniztype: githubname, değer GitHub deposunun tam adıdır ve kullanıcı veya kuruluşu içerir. name: Microsoft/vscode bunun bir örneğidir. GitHub depoları yetkilendirme için GitHub hizmet bağlantısı gerektirir.

  • belirtirseniztype: bitbucketname, değer Bitbucket Cloud deposunun tam adıdır ve kullanıcı veya kuruluşu içerir. name: MyBitbucket/vscode bunun bir örneğidir. Bitbucket Cloud depoları yetkilendirme için Bitbucket Bulut hizmeti bağlantısı gerektirir.

Bu türler hakkında daha fazla bilgi için bkz. İşlem hattınızdaki birden çok depo - Depo kaynak tanımına göz atın.

Değişkenler

Her çalıştırmada, bir depo kaynağının meta verileri çalışma zamanı değişkenleri biçimindeki tüm işler için kullanılabilir. <Alias>, depo kaynağınız için verdiğiniz tanımlayıcıdır.

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

Aşağıdaki örnekte diğer adı commonolan bir depo kaynağı vardır ve depo kaynak değişkenlerine kullanılarak resources.repositories.common.*erişilir.

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)"

Değişkenler

Her çalıştırmada, bir depo kaynağının meta verileri çalışma zamanı değişkenleri biçimindeki tüm işler için kullanılabilir. <Alias>, depo kaynağınız için verdiğiniz tanımlayıcıdır.

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

Aşağıdaki örnekte diğer adı commonolan bir depo kaynağı vardır ve depo kaynak değişkenlerine kullanılarak resources.repositories.common.*erişilir.

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)"

Örnekler

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

Ayrıca bkz.