View a markdown version of this page

Mengkonfigurasi dan menggunakan mvn - Amazon CodeCatalyst
Mengambil dependensi dari CodeCatalystMengambil paket dari repositori paket eksternal melalui CodeCatalystMenerbitkan paket ke CodeCatalystMenerbitkan paket pihak ketiga

Amazon CodeCatalyst tidak lagi terbuka untuk pelanggan baru. Pelanggan yang sudah ada dapat terus menggunakan layanan ini seperti biasa. Lihat informasi yang lebih lengkap di Cara bermigrasi dari CodeCatalyst.

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

Mengkonfigurasi dan menggunakan mvn

Anda menggunakan mvn perintah untuk menjalankan build Maven. Anda harus mengonfigurasi mvn untuk menggunakan repositori paket Anda dan menyediakan token akses pribadi (PAT) untuk otentikasi.

Mengambil dependensi dari CodeCatalyst

Untuk mengonfigurasi mvn untuk mengambil dependensi dari CodeCatalyst repositori, Anda harus mengedit file konfigurasi Maven, settings.xml dan secara opsional, file Project Model Object (POM) proyek Anda. File POM berisi informasi tentang proyek dan informasi konfigurasi untuk Maven untuk membangun proyek seperti dependensi, direktori build, direktori sumber, direktori sumber pengujian, plugin, dan tujuan.

Untuk menggunakan mvn untuk mengambil dependensi dari repositori paket Anda CodeCatalyst

  1. Buka CodeCatalyst konsol di https://codecatalyst.aws/.

  2. Pada halaman ikhtisar untuk proyek Anda, pilih Paket.

  3. Pilih repositori paket Anda dari daftar repositori paket.

  4. Pilih Hu bungkan ke repositori.

  5. Di kotak dialog Hubun gkan ke repositori, pilih mvn dari daftar klien manajer paket.

  6. Anda akan memerlukan token akses pribadi (PAT) untuk diautentikasimvn. CodeCatalyst Jika Anda sudah memilikinya, Anda dapat menggunakannya. Jika tidak, Anda dapat membuatnya di sini.

    1. Pilih Buat token.

    2. Pilih Salin untuk menyalin PAT Anda.

      Awas

      Anda tidak akan dapat melihat atau menyalin PAT Anda lagi setelah Anda menutup kotak dialog.

  7. Tambahkan profil yang berisi repositori Anda ke settings.xml file Anda. Ganti nilai-nilai berikut.

    catatan

    Jika menyalin dari instruksi konsol, nilai-nilai berikut harus diperbarui untuk Anda dan tidak boleh diubah.

    • Ganti space_name dengan nama CodeCatalyst ruang Anda.

    • Ganti proj_name dengan nama CodeCatalyst proyek Anda.

    • Ganti repo_name dengan nama repositori CodeCatalyst paket Anda.

    <profiles>
  <profile>
    <id>repo_name</id>
    <activation>
        <activeByDefault>true</activeByDefault>
    </activation>
    <repositories>
        <repository>
          <id>repo_name</id>
          <url>https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/</url>
        </repository>
    </repositories>
  </profile>
</profiles>

  8. Tambahkan server Anda ke daftar server dalam settings.xml file Anda. Ganti nilai-nilai berikut.

    catatan

    Jika menyalin dari instruksi konsol, nilai-nilai berikut harus diperbarui untuk Anda dan tidak boleh diubah.

    • Ganti repo_name dengan nama repositori CodeCatalyst paket Anda.

    • Ganti username dengan nama CodeCatalyst pengguna Anda.

    • Ganti PAT dengan CodeCatalyst PAT Anda.

    <servers>
  <server>
    <id>repo_name</id>
    <username>username</username>
    <password>PAT</password>
  </server>
</servers>

  9. (Opsional) Atur cermin di settings.xml file Anda yang menangkap semua koneksi dan merutekan ke repositori Anda alih-alih repositori gateway.

    catatan

    Jika menyalin dari instruksi konsol, nilai-nilai berikut harus diperbarui untuk Anda dan tidak boleh diubah.

    • Ganti space_name dengan nama CodeCatalyst ruang Anda.

    • Ganti proj_name dengan nama CodeCatalyst proyek Anda.

    • Ganti repo_name dengan nama repositori CodeCatalyst paket Anda.

    <mirrors>
  <mirror>
    <id>repo_name</id>
    <name>repo_name</name>
    <url>https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/</url>
    <mirrorOf>*</mirrorOf>
  </mirror>
</mirrors>
penting

Anda dapat menggunakan nilai apa pun dalam elemen <id>, tetapi harus sama di elemen <server> dan <repository>. Ini memungkinkan kredenSIAL yang ditentukan untuk disertakan dalam permintaan ke CodeCatalyst.

Setelah membuat perubahan konfigurasi ini, Anda dapat membangun proyek.

mvn compile

Mengambil paket dari repositori paket eksternal melalui CodeCatalyst

Anda dapat menginstal paket Maven dari repositori publik melalui CodeCatalyst repositori dengan mengonfigurasinya dengan koneksi upstream ke gateway yang mewakili repositori gateway. Paket yang diinstal dari repositori gateway dicerna dan disimpan di CodeCatalyst repositori Anda.

Saat ini, CodeCatalyst mendukung repositori paket Maven publik berikut.

  • gerbang pusat maven-

  • gerbang google-android

  • gradle-plugins-gateway

  • gerbang commonsware

Untuk menginstal paket dari repositori paket Maven publik

  1. Jika Anda belum melakukannya, konfigurasikan mvn dengan repositori CodeCatalyst paket Anda dengan mengikuti langkah-langkah diMengambil dependensi dari CodeCatalyst.

  2. Pastikan repositori Anda telah menambahkan repositori gateway yang ingin Anda instal sebagai koneksi hulu. Untuk memeriksa sumber hulu mana yang ditambahkan atau untuk menambahkan repositori gateway sebagai sumber hulu, ikuti instruksi di. Menambahkan repositori hulu

Untuk informasi selengkapnya tentang meminta paket dari repositori hulu, lihat. Meminta versi paket dengan repositori hulu

Menerbitkan paket ke CodeCatalyst

Untuk menerbitkan paket Maven mvn dengan CodeCatalyst repositori, Anda juga harus mengedit ~/.m2/settings.xml dan proyek POM.

Untuk menggunakan mvn untuk menerbitkan paket ke repositori CodeCatalyst paket Anda

  1. Buka CodeCatalyst konsol di https://codecatalyst.aws/.

  2. Pada halaman ikhtisar untuk proyek Anda, pilih Paket.

  3. Pilih repositori paket Anda dari daftar repositori paket.

  4. Pilih Hu bungkan ke repositori.

  5. Di kotak dialog Hubun gkan ke repositori, pilih mvn dari daftar klien manajer paket.

  6. Anda akan memerlukan token akses pribadi (PAT) untuk diautentikasimvn. CodeCatalyst Jika Anda sudah memilikinya, Anda dapat menggunakannya. Jika tidak, Anda dapat membuatnya di sini.

    1. Pilih Buat token.

    2. Pilih Salin untuk menyalin PAT Anda.

      Awas

      Anda tidak akan dapat melihat atau menyalin PAT Anda lagi setelah Anda menutup kotak dialog.

  7. Konfigurasikan variabel lingkungan pada mesin lokal Anda dengan PAT Anda. Anda akan menggunakan variabel lingkungan ini dalam setting.xml file Anda.

    export CODECATALYST_ARTIFACTS_TOKEN=your_PAT

  8. Tambahkan bagian <servers> ke settings.xmldengan referensi ke variabel lingkungan CodeCatalyst_ARTIFACTS_TOKEN sehingga Maven meneruskan token dalam permintaan HTTP.

    <settings>
...
    <servers>
        <server>
            <id>repo-name</id>
            <username>username</username>
            <password>${env.CodeCatalyst_ARTIFACTS_TOKEN}</password>
        </server>
    </servers>
...
</settings>

  9. Tambahkan bagian <distributionManagement> ke pom.xml.

    <project>
...
     <distributionManagement>
         <repository>
             <id>repo_name</id>
             <name>repo_name</name>
             <url>https://packages.region.codecatalyst.aws/maven/space_name/proj_name/repo_name/</url>
         </repository>
     </distributionManagement>
...
</project>

Setelah membuat perubahan konfigurasi ini, Anda dapat membangun proyek dan memublikasikannya ke repositori yang ditentukan.

mvn deploy

Anda dapat menavigasi ke repositori paket Anda di CodeCatalyst konsol untuk memeriksa apakah paket berhasil dipublikasikan.

Menerbitkan paket pihak ketiga

Anda dapat menerbitkan paket Maven pihak ketiga ke CodeCatalyst repositori denganmvn deploy:deploy-file. Ini dapat membantu pengguna yang ingin menerbitkan paket dan hanya memiliki file JAR dan tidak memiliki akses ke kode sumber paket atau file POM.

Perintah mvn deploy:deploy-file akan menghasilkan file POM berdasarkan informasi yang dikirimkan pada baris perintah.

Pertama, buat PAT jika Anda tidak memilikinya.

Untuk membuat token akses pribadi (PAT)

  1. Di bilah menu atas, pilih lencana profil Anda, lalu pilih Peng aturan saya.

    Tip

    Anda juga dapat menemukan profil pengguna Anda dengan membuka halaman anggota untuk proyek atau ruang dan memilih nama Anda dari daftar anggota.

  2. Di nama PAT, masukkan nama deskriptif untuk PAT Anda.

  3. Di Tanggal ked aluwarsa, tinggalkan tanggal default atau pilih ikon kalender untuk memilih tanggal khusus. Tanggal kedaluwarsa default adalah satu tahun dari tanggal saat ini.

  4. Pilih Buat.

    Anda juga dapat membuat token ini ketika Anda memilih repositori Clone untuk repositori sumber.

  5. Simpan rahasia PAT di lokasi yang aman.

    penting

    Rahasia PAT hanya ditampilkan sekali. Anda tidak dapat mengambilnya setelah Anda menutup jendela.

Untuk menerbitkan paket Maven pihak ketiga

  1. Buat file ~/.m2/settings.xml dengan konten berikut ini:

    
<settings>
    <servers>
        <server>
            <id>repo_name</id>
            <username>username</username>
            <password>PAT}</password>
        </server>
    </servers>
</settings>

  2. Jalankan perintah mvn deploy:deploy-file:

    mvn deploy:deploy-file -DgroupId=commons-cli          \
-DartifactId=commons-cli       \
-Dversion=1.4                  \
-Dfile=./commons-cli-1.4.jar   \
-Dpackaging=jar                \
-DrepositoryId=repo-name      \
-Durl=https://packages.region.codecatalyst.aws/maven/space-name/proj-name/repo-name/
    catatan

    Contoh sebelumnya menerbitkancommons-cli 1.4. Ubah groupId, artifactID, versi, dan file argumen untuk memublikasikan JAR yang berbeda.

Instruksi ini didasarkan pada contoh dalam Panduan men-deploy JAR pihak ketiga ke repositori jarak jauh dari Dokumentasi Apache Maven.

Untuk informasi selengkapnya, lihat topik tersebut di situs web Apache Maven Project: