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

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 mengkonfigurasi 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 () proyek Anda. POM POMFile 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 digunakan 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 Connect to repository.

  5. Di kotak dialog Connect to repository, pilih mvn dari daftar klien manajer paket.

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

    1. Pilih Buat token.

    2. Pilih Salin untuk menyalinPAT.

      Awas

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

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

    catatan

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

    • Ganti space_name dengan nama CodeCatalyst spasi 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 di settings.xml file Anda. Ganti nilai-nilai berikut.

    catatan

    Jika menyalin dari instruksi konsol, 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 Anda CodeCatalystPAT.

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

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

    catatan

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

    • Ganti space_name dengan nama CodeCatalyst spasi 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>. Hal ini memungkinkan kredensi yang ditentukan untuk dimasukkan dalam permintaan untuk. 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 repositori dengan mengonfigurasinya dengan koneksi upstream ke gateway yang mewakili CodeCatalyst repositori gateway. Paket yang diinstal dari repositori gateway dicerna dan disimpan di repositori Anda. CodeCatalyst

Saat ini, CodeCatalyst mendukung repositori paket Maven publik berikut.

  • maven-central-gateway

  • google-android-gateway

  • 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 di. Mengambil 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 menambahkan repositori gateway sebagai sumber hulu, ikuti instruksi di. Menambahkan repositori upstream

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

Menerbitkan paket ke CodeCatalyst

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

Untuk digunakan mvn untuk mempublikasikan paket ke CodeCatalyst repositori 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 Connect to repository.

  5. Di kotak dialog Connect to repository, pilih mvn dari daftar klien manajer paket.

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

    1. Pilih Buat token.

    2. Pilih Salin untuk menyalinPAT.

      Awas

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

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

    export CODECATALYST_ARTIFACTS_TOKEN=your_PAT

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

    <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 diterbitkan.

Menerbitkan paket pihak ketiga

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

mvn deploy:deploy-filePerintah akan menghasilkan POM file berdasarkan informasi yang diteruskan di baris perintah.

Pertama, buat a PAT jika Anda tidak memilikinya.

Untuk membuat token akses pribadi (PAT)

  1. Di bilah menu atas, pilih lencana profil Anda, lalu pilih Pengaturan 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. Dalam PATnama, masukkan nama deskriptif untuk nama AndaPAT.

  3. Di Tanggal kedaluwarsa, tinggalkan tanggal default atau pilih ikon kalender untuk memilih tanggal kustom. Tanggal kedaluwarsa default menjadi satu tahun dari tanggal saat ini.

  4. Pilih Buat.

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

  5. Simpan PAT rahasia di lokasi yang aman.

    penting

    PATRahasianya hanya ditampilkan sekali. Anda tidak dapat mengambilnya setelah Anda menutup jendela.

Untuk mempublikasikan 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 diterbitkan. commons-cli 1.4 Ubah argumengroupId, ArtifactID, versi, dan file untuk mempublikasikan yang berbeda. JAR

Instruksi ini didasarkan pada contoh dalam Panduan untuk menyebarkan pihak JARs ke-3 ke repositori jarak jauh dari dokumentasi Apache Maven.

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