Menerbitkan dan mengunduh artefak build

Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

Catatan

Sebaiknya gunakan Unduh Artefak Alur dan Terbitkan Artefak Alur untuk performa yang lebih cepat.

Azure Artifacts memungkinkan tim menggunakan umpan dan sumber hulu untuk mengelola dependensi mereka. Anda dapat menggunakan Azure Pipelines untuk menerbitkan dan mengunduh berbagai jenis artefak sebagai bagian dari alur kerja CI/CD Anda.

Menerbitkan artefak

Artefak dapat diterbitkan pada setiap tahap alur Anda. Anda dapat menggunakan YAML atau editor Azure DevOps klasik untuk menerbitkan paket Anda.

YAML

- powershell: gci env:* | sort-object name | Format-Table -AutoSize | Out-File $env:BUILD_ARTIFACTSTAGINGDIRECTORY/environment-variables.txt

- task: CopyFiles@2
  inputs:
    sourceFolder: '$(Build.SourcesDirectory)'
    contents: '**/$(BuildConfiguration)/**/?(*.exe|*.dll|*.pdb)'
    targetFolder: '$(Build.ArtifactStagingDirectory)'
- task: PublishBuildArtifacts@1
  inputs:
    pathToPublish: '$(Build.ArtifactStagingDirectory)'
    artifactName: drop

• pathToPublish: jalur artefak Anda. Ini bisa menjadi jalur absolut atau relatif. Kartubebas tidak didukung.
• artifactName: nama artefak Anda.

Catatan

Pastikan Anda tidak menggunakan salah satu nama folder yang dipesan saat menerbitkan artefak Anda. Lihat Folder Aplikasi untuk detail selengkapnya.

Klasik

Tambahkan tugas Terbitkan Artefak Build ke alur Anda dan isi bidang yang diperlukan. Pastikan file Anda berada di akar repositori Anda.

Contoh: Menggunakan beberapa tugas

YAML

- powershell: gci env:* | sort-object name | Format-Table -AutoSize | Out-File $env:BUILD_ARTIFACTSTAGINGDIRECTORY/environment-variables.txt

- task: CopyFiles@2
  inputs:
    sourceFolder: '$(Build.SourcesDirectory)'
    contents: '**/$(BuildConfiguration)/**/?(*.exe|*.dll|*.pdb)'
    targetFolder: '$(Build.ArtifactStagingDirectory)'
- task: PublishBuildArtifacts@1
  inputs:
    pathToPublish: '$(Build.ArtifactStagingDirectory)'
    artifactName: drop1
- task: PublishBuildArtifacts@1
  inputs:
    pathToPublish: '$(Build.ArtifactStagingDirectory)'
    artifactName: drop2

• pathToPublish: jalur artefak Anda. Ini bisa menjadi jalur absolut atau relatif. Kartubebas tidak didukung.
• artifactName: nama artefak Anda.

Klasik

Anda dapat menambahkan beberapa tugas Terbitkan Artefak Build ke alur Anda. Pastikan file Anda berada di akar repositori Anda.

Contoh: Menyalin dan menerbitkan biner

YAML

- powershell: gci env:* | sort-object name | Format-Table -AutoSize | Out-File $env:BUILD_ARTIFACTSTAGINGDIRECTORY/environment-variables.txt

- task: CopyFiles@2
  inputs:
    sourceFolder: '$(Build.SourcesDirectory)'
    contents: '**/$(BuildConfiguration)/**/?(*.exe|*.dll|*.pdb)'
    targetFolder: '$(Build.ArtifactStagingDirectory)'
- task: PublishBuildArtifacts@1
  inputs:
    pathToPublish: '$(Build.ArtifactStagingDirectory)'
    artifactName: drop

• sourceFolder: folder yang berisi file yang ingin Anda salin. Jika Anda membiarkan ini kosong, penyalinan akan dilakukan dari $(Build.SourcesDirectory).
• konten: Jalur file yang akan disertakan sebagai bagian dari salinan.
• targetFolder: folder tujuan.
• pathToPublish: folder atau jalur file yang akan diterbitkan. Ini bisa menjadi jalur absolut atau relatif. Kartubebas tidak didukung.
• artifactName: nama artefak yang ingin Anda buat.

Catatan

Pastikan untuk tidak menggunakan nama khusus untuk artifactName seperti Bin atau App_Data. Lihat ASP.NET Struktur Folder Proyek Web untuk detail selengkapnya.

Klasik

Utilitas: Salin File

• Folder sumber: $(Build.SourcesDirectory)

• Konten: /$(BuildConfiguration)//? (.exe|. dll|*.pdb)

• Folder target: $(Build.ArtifactStagingDirectory)

Utilitas: Menerbitkan Artefak Build

• Jalur untuk menerbitkan: $(Build.ArtifactStagingDirectory)

• Nama artefak: hilangkan

Catatan

Build.ArtifactStagingDirectory jalur dibersihkan setelah setiap build. Jika Anda menggunakan jalur ini untuk menerbitkan artefak Anda, pastikan Anda menyalin konten yang ingin Anda terbitkan ke direktori ini sebelum langkah penerbitan.

Mengunduh artefak

YAML

- powershell: gci env:* | sort-object name | Format-Table -AutoSize | Out-File $env:BUILD_ARTIFACTSTAGINGDIRECTORY/environment-variables.txt

- task: DownloadBuildArtifacts@0
  inputs:
    buildType: 'current'
    downloadType: 'single'
    artifactName: 'drop'
    downloadPath: '$(System.ArtifactsDirectory)'

• buildType: tentukan artefak build mana yang akan diunduh: current (nilai default) atau dari build tertentu.
• downloadType: pilih apakah akan mengunduh satu artefak atau semua artefak dari build tertentu.
• artifactName: nama artefak yang akan diunduh.
• downloadPath: jalur pada mesin agen tempat artefak akan diunduh.

Klasik

Utilitas: Unduh Artefak Build

• Unduh artefak yang diproduksi oleh: Build saat ini

• Jenis unduhan: Artefak tertentu

• Nama artefak: hilangkan

• Direktori tujuan: $(System.ArtifactsDirectory)

Catatan

Jika Anda menggunakan tugas penyebaran, Anda dapat mereferensikan artefak build menggunakan $(Agent.BuildDirectory). Lihat Variabel agen untuk detail selengkapnya.

Saat eksekusi alur Anda selesai, navigasikan ke Ringkasan untuk menjelajahi atau mengunduh artefak Anda.

Mengunduh artefak tertentu

YAML

steps:
- task: DownloadBuildArtifacts@1
  displayName: 'Download Build Artifacts'
  inputs:
    buildType: specific
    project: 'xxxxxxxxxx-xxxx-xxxx-xxxxxxxxxxx'
    pipeline: 20
    buildVersionToDownload: specific
    buildId: 128
    artifactName: drop
    extractTars: false

Klasik

Tambahkan tugas Unduh Artefak Build ke definisi alur Anda dan konfigurasikan sebagai berikut:

• Unduh artefak yang diproduksi oleh: Build tertentu.

• Proyek: pilih proyek Anda dari menu dropdown.

• Alur build: pilih alur build Anda.

• Versi build untuk diunduh: pilih versi tertentu.

• Build: pilih build Anda dari menu dropdown.

• Jenis unduhan: artefak tertentu.

• Nama artefak: pilih artefak Anda dari menu dropdown.

• Direktori tujuan: default $(System.ArtifactsDirectory).

Tips

• Nonaktifkan Autentikasi Dasar IIS jika Anda menggunakan Azure DevOps Server untuk mengizinkan autentikasi dengan Token Akses Pribadi Anda. Lihat Autentikasi Dasar dan PAT IIS untuk detail selengkapnya.

• Gunakan garis miring di argumen jalur file. Garis miring terbelakang tidak berfungsi di agen macOS/Linux.

• Artefak build disimpan pada sistem file Windows, yang menyebabkan semua izin UNIX hilang, termasuk bit eksekusi. Anda mungkin perlu memulihkan izin UNIX yang benar setelah mengunduh artefak Anda dari Azure Pipelines.

• Build.ArtifactStagingDirectory dan Build.StagingDirectory dapat dipertukarkan.

• Build.ArtifactStagingDirectory jalur dibersihkan setelah setiap build.

• Menghapus build yang terkait dengan paket yang diterbitkan ke berbagi file akan mengakibatkan penghapusan semua Artefak di jalur UNC tersebut.

• Jika Anda menerbitkan paket ke berbagi file, pastikan Anda menyediakan akses ke agen build.

• Pastikan Anda mengizinkan URL dan alamat IP Domain Artefak Azure jika organisasi Anda menggunakan firewall.

Artikel terkait

• Menerbitkan dan mengunduh artefak di Azure Pipelines
• Tentukan alur klasik multi-tahap Anda
• Cara mengurangi risiko saat menggunakan umpan paket privat