Bagikan melalui


Menggunakan paket dari Crates.io

Azure DevOps

Sumber upstream Azure Artifacts memungkinkan pengembang untuk menggunakan paket dari registri publik seperti Crates.io dan nuget.org. Artikel ini akan memandu Anda menyiapkan proyek Anda dan menggunakan baris perintah untuk menggunakan Crates dari Crates.io.

Artikel ini akan memandu Anda melalui cara:

  • Membuat umpan Artefak Azure
  • Koneksi ke umpan Anda
  • Mengonsumsi peti dari hulu

Prasyarat

Membuat umpan

Azure Artifacts merekomendasikan memiliki umpan khusus untuk mengonsumsi peti dari crates.io dan umpan terpisah secara eksklusif untuk menerbitkan peti internal.

  1. Masuk ke organisasi Azure DevOps Anda, lalu navigasikan ke proyek Anda.

  2. Pilih Artefak, lalu pilih Buat Umpan.

  3. Masukkan Nama untuk umpan Anda, tentukan Visibilitasnya, lalu pilih Cakupan Anda. Pastikan untuk memeriksa kotak centang Sumber upstream untuk menyertakan paket dari registri publik.

  4. Pilih Buat setelah selesai.

    Cuplikan layar yang menunjukkan cara membuat umpan untuk upstream kargo.

Koneksi ke umpan Anda

  1. Masuk ke organisasi Azure DevOps Anda, lalu navigasikan ke proyek Anda.

  2. Pilih Artefak, lalu pilih umpan Anda dari menu dropdown.

  3. Pilih Koneksi untuk umpan, lalu pilih Kargo dari panel navigasi kiri.

  4. Jika ini pertama kalinya menggunakan Cargo dengan Azure Artifacts, pastikan Anda telah menginstal rustup.

  5. Tambahkan cuplikan yang disediakan di bagian Penyiapan proyek ke file .cargo/config.toml Anda di repositori sumber Anda:

    • Umpan cakupan proyek:
    [registries]
    <FEED_NAME> = { index = "sparse+https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/Cargo/index/" }
    
    [source.crates-io]
    replace-with = "<FEED_NAME>"
    
    • Umpan cakupan organisasi:
    [registries]
    <FEED_NAME> = { index = "sparse+https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/Cargo/index/" }
    
    [source.crates-io]
    replace-with = "<FEED_NAME>"
    

Mengonfigurasi penyedia kredensial

Untuk menggunakan Cargo dengan Azure Artifacts, Anda perlu menyiapkan penyedia kredensial. Pengaturan yang disediakan akan mengonfigurasi pembantu kredensial default untuk pengguna saat ini:

Tempelkan cuplikan berikut di %USERPROFILE%.cargo\config.toml:

[registry]
global-credential-providers = ["cargo:token", "cargo:wincred"]

Masuk ke registri Anda

  1. Buat token akses Pribadi dengan Kemasan>Baca & tulis cakupan untuk mengautentikasi dengan umpan Anda.

  2. Jalankan perintah berikut untuk masuk ke registri Anda. Ganti tempat penampung dengan nama umpan Anda, dan tempelkan token akses pribadi yang Anda buat di langkah sebelumnya saat diminta:

    "Basic " + [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes("PAT:" + (Read-Host -MaskInput "Enter PAT"))) | cargo login --registry <FEED_NAME>
    

Simpan paket dari Crates.io

Catatan

Untuk menyimpan paket dari hulu, Anda harus memiliki peran Umpan dan Pembaca Upstream (Kolaborator) atau yang lebih tinggi. Untuk informasi selengkapnya, lihat Izin.

Sekarang setelah kami menyiapkan proyek kami, mengonfigurasi penyedia kredensial, dan masuk ke umpan kami, kita dapat mulai menggunakan paket dari hulu. Azure Artifacts menyimpan salinan paket apa pun yang Anda instal dari hulu ke umpan Anda.

Dalam contoh ini, kami menggunakan peti serde , kerangka kerja serialisasi/deserialisasi:

  1. Jalankan perintah berikut di direktori proyek Anda untuk menambahkan peti ke cargo.toml Anda:

    cargo add serde
    
  2. Jalankan perintah berikut untuk membangun proyek Anda dan menggunakan peti Anda:

    cargo build
    

Setelah paket Anda diinstal, salinan akan disimpan ke umpan Anda. Navigasikan ke umpan Anda untuk memverifikasi keberadaannya. Paket Anda harus tersedia di umpan Anda, seperti yang ditunjukkan di bawah ini:

Cuplikan layar memperlihatkan peti *serde* yang dikonsumsi dari hulu.