definisi resources.repositories.repository

Kata repository kunci memungkinkan Anda menentukan repositori eksternal. Gunakan sumber daya repositori untuk mereferensikan repositori tambahan di alur Anda.

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.

Definisi yang mereferensikan definisi ini: resources.repositories

Properti

repository String. Diperlukan sebagai properti pertama.
Alias untuk repositori yang ditentukan. Nilai yang dapat diterima: [-_A-Za-z0-9]*.

endpoint String.
ID titik akhir layanan yang terhubung ke repositori ini.

triggerpemicu.
Pemicu CI untuk repositori ini, tidak ada pemicu CI jika dihilangkan.

Penting

• Pemicu sumber daya repositori hanya didukung untuk repositori Azure Repos Git.
• Pemicu sumber daya repositori tidak mendukung batch.

name String.
Nama repositori. Format tergantung pada 'jenis'; tidak menerima variabel.

ref String.
nama ref ke checkout; default ke 'refs/heads/main'. Cabang diperiksa secara default setiap kali pemicu sumber daya diaktifkan. Ekspresi templat didukung.

type String.
Jenis repositori: git, github, githubenterprise, dan bitbucket.

Keterangan

Ekspresi templat didukung untuk ref properti (tetapi bukan name properti ). Wildcard didukung dalam pemicu.

Penting

Pemicu sumber daya repositori hanya didukung untuk repositori Azure Repos Git. Untuk informasi selengkapnya tentang trigger sintaksis, termasuk dukungan kartubebas untuk cabang dan tag, lihat definisi pemicu dan Repositori Git Azure Repos atau TFS Git.

Penting

batch tidak didukung dalam pemicu sumber daya repositori.

Jika alur Anda memiliki templat di repositori lain, atau jika Anda ingin menggunakan checkout multi-repo dengan repositori yang memerlukan koneksi layanan, Anda harus memberi tahu sistem tentang repositori tersebut.

Jenis

Alur mendukung nilai berikut untuk jenis repositori: git, , githubdan bitbucket. Jenisnya git mengacu pada repositori Azure Repos Git.

• Jika Anda menentukan type: git, name nilai mengacu pada nama repositori Azure Repos Git.

  • Jika alur Anda berada dalam proyek Azure DevOps yang sama dengan repositori, misalnya repositori bernama tools, Anda mereferensikannya menggunakan name: tools.
  • Jika alur Anda berada di organisasi Azure DevOps yang sama dengan repositori, tetapi dalam proyek Azure DevOps yang berbeda, misalnya proyek bernama ToolsProject, Anda harus memenuhi syarat nama repositori dengan nama proyek: name: ToolsProject/tools.

• Jika Anda menentukan type: github, name nilainya adalah nama lengkap repositori GitHub dan menyertakan pengguna atau organisasi. Contohnya name: Microsoft/vscode. Repositori GitHub memerlukan koneksi layanan GitHub untuk otorisasi.

• Jika Anda menentukan type: bitbucket, name nilainya adalah nama lengkap repositori Bitbucket Cloud dan menyertakan pengguna atau organisasi. Contohnya name: MyBitbucket/vscode. Repositori Bitbucket Cloud memerlukan koneksi layanan Bitbucket Cloud untuk otorisasi.

Untuk informasi selengkapnya tentang jenis ini, lihat Memeriksa beberapa repositori dalam definisi sumber daya alur - Repositori Anda.

Variabel

Dalam setiap eksekusi, metadata untuk sumber daya repositori tersedia untuk semua pekerjaan dalam bentuk variabel runtime. <Alias> adalah pengidentifikasi yang Anda berikan untuk sumber daya repositori Anda.

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

Contoh berikut memiliki sumber daya repositori dengan alias common, dan variabel sumber daya repositori diakses menggunakan 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)"

Contoh

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

Lihat juga

• Menambahkan sumber daya ke alur