Tutorial: Cara menggunakan sumber upstream

Artikel
04/04/2024

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

Menggunakan sumber upstream di umpan memungkinkan Anda mengelola dependensi aplikasi dari satu umpan. Menggunakan sumber hulu memudahkan penggunaan paket dari registri publik sambil memiliki perlindungan terhadap pemadaman atau paket yang disusupi. Anda juga dapat menerbitkan paket Anda sendiri ke umpan yang sama dan mengelola semua dependensi Anda di satu lokasi.

Tutorial ini akan memandu Anda melalui cara mengaktifkan sumber hulu pada umpan Anda dan menggunakan paket dari registri publik seperti NuGet.org atau npmjs.com.

Dalam tutorial ini, Anda akan:

Buat umpan baru dan aktifkan sumber hulu.
Siapkan file konfigurasi Anda.
Jalankan pemulihan paket awal untuk mengisi umpan Anda.
Periksa umpan Anda untuk melihat salinan paket yang disimpan yang Anda gunakan dari registri publik.

Membuat umpan dan mengaktifkan sumber hulu

Masuk ke organisasi Azure DevOps Anda, lalu navigasikan ke proyek Anda.
Pilih Artefak, lalu pilih Buat Umpan untuk membuat umpan baru.
Berikan nama untuk umpan Anda, dan pilih visibilitasnya. Pastikan Anda mencentang kotak Sertakan paket dari sumber publik umum untuk mengaktifkan sumber hulu, lalu pilih Buat setelah selesai.

Menyiapkan file konfigurasi

Sekarang setelah kita membuat umpan, kita perlu memperbarui file konfigurasi untuk menunjuk ke umpan kita. Untuk melakukan ini, kita harus:

Mendapatkan URL sumber
Memperberbarui file konfigurasi

Pilih Artefak, lalu pilih Koneksi untuk disalurkan.
Di sisi kiri halaman, pilih tab npm .
Ikuti instruksi di bagian Penyiapan proyek untuk menyiapkan file konfigurasi Anda.

Jika Anda belum memiliki file .npmrc, buat file baru di akar proyek Anda (di folder yang sama dengan package.json Anda). Buka file .npmrc baru Anda dan tempel cuplikan yang baru saja Anda salin di langkah sebelumnya.

Pilih Artefak, lalu pilih umpan Anda dari daftar dropdown.
Pilih Koneksi untuk umpan, lalu pilih pip di bawah bagian Python.
Buat lingkungan virtual jika Anda belum melakukannya.
Tambahkan file pip.ini (Windows) atau pip.conf (Mac/Linux) ke virtualenv Anda dan tempel cuplikan berikut:
```
[global]
index-url=https://pkgs.dev.azure.com/ORGANIZATION-NAME/_packaging/FEED-NAME/pypi/simple/
```

Pilih Artefak, lalu pilih umpan Anda dari daftar dropdown.
Pilih Koneksi untuk umpan, lalu pilih Maven.

Tambahkan cuplikan berikut ke bagian <repositories> dan <distributionManagement> di pom.xml Anda:

<repository>
  <id>[FEED-NAME]</id>
  <url>https://pkgs.dev.azure.com/[ORGANIZATION-NAME]/_packaging/[FEED-NAME]/maven/v1</url>
  <releases>
    <enabled>true</enabled>
  </releases>
  <snapshots>
    <enabled>true</enabled>
  </snapshots>
</repository>

<server> Tambahkan ke file settings.xml Anda:

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                              https://maven.apache.org/xsd/settings-1.0.0.xsd">
  <servers>
    <server>
      <id>[FEED-NAME]</id>
      <username>[ORGANIZATION-NAME]</username>
      <password>[PERSONAL_ACCESS_TOKEN]</password>
    </server>
  </servers>
</settings>

Buat token akses pribadi dengan Kemasan>Baca & tulis cakupan dan tempelkan token akses pribadi Anda ke <password> tag dalam file settings.xml Anda.

Pilih Artefak, lalu pilih umpan Anda dari daftar dropdown.
Pilih Koneksi untuk memberi umpan, lalu pilih Gradle.

Tambahkan cuplikan berikut ke bagian repositori dan penerbitan di file build.gradle Anda:

maven {
    url 'https://pkgs.dev.azure.com/[ORGANIZATION-NAME]/_packaging/[FEED-NAME]/maven/v1'
    name '[FEED-NAME]'
    authentication {
        basic(BasicAuthentication)
    }
}

<server> Tambahkan ke file settings.xml Anda:

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0
                              https://maven.apache.org/xsd/settings-1.0.0.xsd">
  <servers>
    <server>
      <id>[FEED-NAME]</id>
      <username>[ORGANIZATION-NAME]</username>
      <password>[PERSONAL_ACCESS_TOKEN]</password>
    </server>
  </servers>
</settings>

Buat token akses pribadi dengan Cakupan Baca &tulis Kemasan>. Tempelkan token akses pribadi Anda ke <password> dalam tag di file settings.xml Anda.

Memulihkan paket

Sekarang setelah Anda mengaktifkan sumber upstream dan menyiapkan file konfigurasi Anda, kita dapat menjalankan perintah pemulihan paket untuk mengkueri sumber upstream dan mengambil paket upstram.

Hapus folder node_modules dari proyek Anda dan jalankan perintah berikut di jendela prompt perintah yang ditingkatkan:

npm install --force

Catatan

Argumen --force akan memaksa penarikan jarak jauh bahkan jika ada salinan lokal.