Praktik terbaik Azure Artifacts

Layanan Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Azure Artifacts memberi tim satu tempat untuk menerbitkan, menyimpan, berbagi, dan menggunakan paket. Seiring bertambahnya jumlah pakan, paket, dan konsumen Anda, beberapa keputusan awal dapat membuat manajemen paket menjadi mudah atau lebih sulit untuk dipertahankan. Artikel ini merangkum praktik-praktik yang membantu Anda menjaga agar proses pemulihan paket tetap dapat diprediksi, merilis paket dengan kontrol yang lebih baik, dan mengelola umpan paket dengan lebih mudah seiring waktu.

Panduan inti

  • Gunakan satu umpan di setiap file konfigurasi klien, dan aktifkan sumber hulu pada umpan tersebut saat Anda juga memerlukan registri publik atau sumber internal tambahan. Pendekatan ini membuat file konfigurasi lebih sederhana dan membantu umpan Anda memberikan perilaku pemulihan yang lebih dapat diprediksi. Untuk informasi selengkapnya, lihat Apa itu sumber hulu?

  • Perlakukan tampilan umpan sebagai saluran rilis. Terbitkan versi baru ke @local, validasi di sana, lalu promosikan versi yang siap digunakan lebih luas ke @prerelease atau @release. Pendekatan ini membantu Anda memisahkan versi paket yang masih dievaluasi dari versi yang siap dibagikan dengan lebih banyak konsumen. Untuk informasi selengkapnya, lihat Apa itu tampilan umpan?

  • Atur izin feed secara cermat. Tentukan siapa yang dapat menerbitkan paket, siapa yang dapat menyimpan paket dari sumber upstream, dan siapa yang dapat menggunakan paket dari tampilan yang dibagikan. Batas peran yang jelas membantu melindungi umpan dan mengurangi perubahan yang tidak disengaja. Untuk informasi selengkapnya, lihat Peran dan izin umpan.

  • Aktifkan kebijakan retensi sebelum versi paket lama mulai terakumulasi. Versi lama dapat menumpuk dengan cepat, terutama dalam feed yang aktif. Kebijakan retensi membantu mengontrol pertumbuhan penyimpanan dan mengurangi upaya yang diperlukan agar umpan tetap dapat dikelola. Untuk informasi selengkapnya, lihat Menghapus paket secara otomatis dengan kebijakan retensi.

Praktik terbaik untuk penerbit paket

Mengikuti praktik terbaik membantu memastikan konsistensi, keamanan, dan pengalaman pengguna yang lancar. Di bawah ini adalah rekomendasi utama saat menerbitkan paket dengan Azure Artifacts:

Nota

Anda harus menjadi Penerbit Umpan (Kontributor) atau yang lebih tinggi untuk menerbitkan paket ke umpan. Lihat Peran umpan dan izin untuk detail selengkapnya.

  • Gunakan umpan tunggal per repositori:

    Umpan adalah konstruksi organisasi yang dapat menghosting beberapa jenis paket. Meskipun proyek dapat menggunakan beberapa umpan, biasanya lebih baik untuk menjaga repositori tetap terhubung ke satu umpan utama untuk mengurangi konflik dan menyederhanakan manajemen paket. Jika Anda memerlukan paket dari umpan tambahan atau registri publik, gunakan sumber hulu alih-alih menambahkan beberapa umpan langsung ke setiap konfigurasi klien.

  • Menerbitkan paket yang baru dibuat secara otomatis:

    Mengotomatiskan publikasi paket baru membantu memastikan bahwa versi terbaru tersedia untuk tim atau konsumen target Anda tanpa intervensi manual. Saat Anda menerbitkan paket, Azure Artifacts menambahkannya ke @local tampilan umpan Anda. Lihat Apa itu tampilan umpan? untuk informasi lebih lanjut.

  • Aktifkan kebijakan retensi untuk membersihkan versi paket lama secara otomatis:

    Seiring waktu, versi paket lama dapat menumpuk, mengonsumsi penyimpanan, dan membuat umpan lebih sulit dikelola. Kebijakan retensi memungkinkan Anda menghapus versi paket yang lebih lama secara otomatis sambil menyimpan sejumlah versi terbaru yang ditentukan. Proses ini membantu mengontrol pertumbuhan penyimpanan dan menjaga umpan lebih mudah dipertahankan. Lihat Menghapus paket secara otomatis dengan kebijakan retensi untuk detail selengkapnya.

  • Gunakan tampilan umpan untuk merilis paket:

    Tampilan umpan memungkinkan Anda berbagi subset versi paket dengan konsumen. Misalnya, Anda dapat mempromosikan paket ke @prerelease untuk pengadopsi awal, lalu mempromosikannya @release saat siap digunakan secara lebih luas. Paket yang dipromosikan ke tampilan dikecualikan dari kebijakan penyimpanan. Lihat Apa itu tampilan umpan? untuk informasi lebih lanjut.

  • Pastikan izin akses yang tepat untuk tampilan Anda:

    Jika paket Anda digunakan oleh tim eksternal atau di seluruh organisasi, pastikan tampilan @release dan @prerelease memiliki pengaturan visibilitas yang sesuai. Lihat pengaturan tampilan umpan untuk detail selengkapnya.

Praktik terbaik untuk konsumen paket

Saat Anda menggunakan paket, usahakan agar proses pemulihan paket dapat diprediksi dan pastikan jelas dari mana paket berasal.

  • Gunakan satu umpan dalam konfigurasi klien Anda:

    Untuk membantu umpan Anda menyediakan pemulihan deterministik, pastikan konfigurasi klien Anda hanya mereferensikan satu umpan dengan sumber hulu diaktifkan. Pendekatan ini membuat file konfigurasi Anda lebih sederhana dan mengurangi kemungkinan hasil resolusi paket yang tidak terduga. Untuk informasi selengkapnya, lihat Apa itu sumber hulu?

  • Gunakan sumber hulu untuk paket eksternal:

    Jika Anda menggunakan paket dari umpan eksternal atau registri publik seperti NuGet.org atau npmjs.com, gunakan sumber hulu alih-alih menambahkan sumber tersebut secara terpisah ke setiap konfigurasi klien. Pendekatan ini memberi tim Anda satu cara yang konsisten untuk memulihkan dependensi internal dan eksternal melalui umpan yang sama. Untuk informasi selengkapnya, lihat Apa itu sumber hulu? dan Menyiapkan sumber hulu.

    Nota

    Anda harus menjadi Umpan dan Pembaca Upstream (Kolaborator) atau yang lebih tinggi untuk menyimpan paket dari sumber hulu. Lihat Peran umpan dan izin untuk detail selengkapnya.

  • Urutkan sumber upstream secara sengaja:

    Umpan memeriksa sumber hulu secara berurutan dan mengembalikan paket dari sumber pertama yang berisinya. Jika Anda menggunakan beberapa sumber hulu, urutkan sehingga umpan menyelesaikan paket dari sumber yang Anda inginkan. Pemesanan ini paling penting ketika Anda menggunakan campuran registri publik dan umpan internal, atau saat organisasi Anda menerbitkan ulang paket sumber terbuka yang disesuaikan secara internal. Untuk informasi selengkapnya, lihat Urutkan sumber upstream Anda secara sengaja dan Urutan penelusuran.

  • Gunakan tampilan umpan untuk mengontrol apa yang dilihat konsumen:

    Jika tim Anda mempromosikan versi paket yang divalidasi melalui tampilan umpan, gunakan tampilan tersebut untuk berbagi hanya versi paket yang ditujukan untuk audiens tertentu. Misalnya, Anda mungkin menyimpan paket yang baru diterbitkan di @local, berbagi build pratinjau melalui @prerelease, dan berbagi paket yang disetujui melalui @release.

  • Gunakan pencari umpan untuk sumber lintas organisasi di penyewa yang sama:

    Jika sumber berada di penyewa Microsoft Entra yang sama tetapi bukan bagian dari organisasi Anda, gunakan pencari umpan. Sintaksnya adalah azure-feed://<organization>/<projectName>/<feed>@<view>.

Konten terkait

  • Last updated on