View a markdown version of this page

Kompatibilitas Bundler - CodeArtifact
Kompatibilitas Bundler

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Kompatibilitas Bundler

Panduan ini berisi informasi tentang CodeArtifact kompatibilitas dengan Bundler.

Kompatibilitas Bundler

AWS CodeArtifact merekomendasikan Bundler 2.4.11 atau lebih tinggi. Jika Anda mengalami masalah dengan instalasi, perbarui CLI Bundler ke versi terbaru.

Dukungan versi Bundler

Dalam versi Bundler yang lebih rendah dari 2.4.11, ada batas 500 dependensi yang dapat didefinisikan dalam Gemfile sebelum Bundler memutuskan untuk menanyakan indeks penuh,. specs.4.8.gz Karena CodeArtifact tidak mendukung indeks penuh, menentukan lebih dari 500 dependensi tidak akan berfungsi CodeArtifact saat menggunakan versi Bundler yang lebih rendah dari 2.4.11.

Untuk menentukan lebih dari 500 dependensi di Gemfile Anda CodeArtifact, perbarui Bundler ke versi 2.4.11 atau lebih tinggi.

Dukungan operasi Bundler

Bundler menyelesaikan dependensi permata Ruby menggunakan salah satu dari dua protokol: Compact Index API atau Dependencies API. CodeArtifact mendukung keduanya. Bundler 2.4.11 dan yang lebih baru lebih memilih Compact Index API dan kembali ke API Dependensi jika tidak tersedia; versi sebelumnya hanya menggunakan API Dependensi. RubyGems 3.5.19 dan yang lebih baru gunakan Compact Index API secara langsung saat menjalankan. gem install

CodeArtifact mendukung titik akhir Compact Index berikut:

  • GET /versions: Mengembalikan setiap permata di repositori dengan daftar versi lengkapnya. Bundler dan RubyGems gunakan titik akhir ini sebagai titik masuk untuk resolusi ketergantungan.

  • GET /names: Mengembalikan setiap nama permata dalam repositori, diurutkan menurut abjad.

  • GET /info/gem-name: Mengembalikan versi, ketergantungan, dan diperlukan- Ruby-version informasi untuk permata tunggal.

Endpoint /versions dan /names endpoint mendukung repositori yang berisi hingga 5.000 permata. Permintaan terhadap repositori yang berisi lebih dari 5.000 permata mengembalikan kesalahan HTTP 400.

CodeArtifact juga mendukung Bundler Dependencies API di. /api/v1/dependencies Satu permintaan dapat menyertakan beberapa nama permata; untuk detail tentang bagaimana permintaan multi-permata ditimbang terhadap kuota Read request per detik akun Anda, lihat. Kuota di AWS CodeArtifact

Karena /versions dan /names mengembalikan data untuk setiap permata di repositori, CodeArtifact juga menimbang permintaan ini dengan jumlah permata yang dikembalikan. CI/CDlingkungan yang berjalan bersamaan bundle install atau gem install operasi dapat dibatasi bahkan ketika tingkat permintaan HTTP tampak rendah. Jika Anda mengalami pembatasan selama resolusi permata Ruby, mintalah peningkatan kuota untuk permintaan Baca per detik dari satu akun. AWS

Jika sebelumnya Anda menyematkan RubyGems ke versi di bawah 3.5.19 sebagai solusi untuk CodeArtifact kompatibilitas, Anda sekarang dapat menghapus pin itu dan meningkatkan ke versi terbaru.

CodeArtifact tidak mendukung indeks RubyGems spesifikasi lama, termasukspecs.4.8.gz,, dan. latest_specs.4.8.gz prerelease_specs.4.8.gz Ini digantikan oleh Compact Index API.

Menguji dukungan Compact Index

Untuk memverifikasi bahwa resolusi Compact Index berfungsi dengan benar dengan CodeArtifact repositori Anda:

  1. Jika sebelumnya Anda menyematkan RubyGems ke versi di bawah 3.5.19, hapus pin:

    gem update --system

  2. Verifikasi versi Anda RubyGems dan Bundler:

    gem --version    # Should be 3.5.19 or higher
bundle --version # Should be 2.4.11 or higher

  3. Uji gem install terhadap CodeArtifact repositori Anda:

    gem install <gem-name> --source https://<domain>-<account-id>.d.codeartifact.<region>.amazonaws.com/ruby/<repo>/

  4. Uji bundle install dengan keluaran verbose untuk mengonfirmasi Compact Index sedang digunakan:

    bundle install --verbose 2>&1 | grep -i "compact\|/versions\|/info"

    Anda harus melihat permintaan ke /versions dan /info/<gem-name> bukan/api/v1/dependencies.