Mulai menggunakan paket Maven di Azure Artifacts

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

Azure Artifacts memungkinkan pengembang mengelola dependensi mereka dari satu umpan sambil memberikan kontrol atas berbagi paket. Dengan umpan Azure Artifacts, Anda dapat menerbitkan dan memulihkan paket Maven, dan menyiapkan sumber upstream untuk menggunakan paket dari registri publik seperti Maven Central, Google Maven Repository, Gradle Plugins, dan JitPack. Artikel ini akan memandu Anda menyiapkan proyek Maven, menyambungkan ke umpan Artefak Azure, serta menerbitkan dan memulihkan paket Maven Anda.

Prasyarat

• Buat organisasi Azure DevOps dan proyek jika Anda belum melakukannya.

• Unduh dan Instal Apache Maven.

Membuat umpan

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

2. Pilih Artefak, lalu pilih Buat Umpan.

3. Untuk Nama, masukkan nama deskriptif untuk umpan Anda.

   Untuk Visibilitas, pilih opsi untuk menunjukkan siapa yang dapat melihat paket dalam umpan.

   Jika Anda ingin menyertakan paket dari sumber publik, pilih kotak centang di bawah Sumber upstream.

   Untuk Cakupan, tentukan apakah cakupan umpan Anda adalah proyek atau organisasi.

4. Pilih Buat setelah selesai.

   

Catatan

Secara default, umpan yang baru dibuat memiliki nilai Build Service proyek mereka yang diatur ke Umpan dan Pembaca Upstream (Kolaborator).

Menyambungkan ke umpan

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

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

3. Pilih Sambungkan ke umpan, lalu pilih Maven dari area navigasi kiri.

4. Jika ini pertama kalinya Anda menggunakan Azure Artifacts dengan Maven, pastikan Anda telah menginstal prasyarat. Jika tidak, pilih Dapatkan alat di sudut kanan atas untuk menginstalnya.

5. Ikuti instruksi di bagian Penyiapan proyek untuk menyiapkan file pom.xml dan settings.xml Anda. File Anda harus menyerupai contoh berikut:

   • pom.xml:

       <repositories>
         <repository>
           <id>MavenDemo</id>
           <url>https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/maven/v1</url>
           <releases>
             <enabled>true</enabled>
           </releases>
           <snapshots>
             <enabled>true</enabled>
           </snapshots>
         </repository>
       </repositories>
       <distributionManagement>
         <repository>
           <id>MavenDemo</id>
           <url>https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/maven/v1</url>
           <releases>
             <enabled>true</enabled>
           </releases>
           <snapshots>
             <enabled>true</enabled>
           </snapshots>
         </repository>
       </distributionManagement>
     

   • settings.xml:

       <servers>
         <server>
           <id>MavenDemo</id>
           <username><ORGANIZATION_NAME></username>
           <password>[PERSONAL_ACCESS_TOKEN]</password>
         </server>
       </servers>
     

6. Buat Token Akses Pribadi dengan Cakupan Baca &tulis Kemasan>, lalu tempelkan ke <password> tag.

Menerbitkan paket

1. Buka jendela prompt perintah dan navigasikan ke direktori proyek tempat file pom.xml Anda berada, lalu jalankan perintah berikut untuk mengemas proyek Anda. Perintah ini mengkompilasi kode Anda, menjalankan pengujian yang disertakan, dan mengemas proyek Anda ke dalam format yang dapat didistribusikan (seperti file JAR).

   mvn package
   

2. Jalankan perintah berikut dari direktori proyek Anda untuk menerbitkan paket Anda ke umpan Anda:

   mvn deploy
   

3. Setelah berhasil menyebarkan paket Anda, paket tersebut akan segera tersedia di umpan Anda.

   

Catatan

Jika organisasi Anda menggunakan firewall atau server proksi, pastikan Anda mengizinkan URL dan alamat IP Domain Artefak Azure.

Memulihkan paket

1. Navigasi ke Artefak di proyek Azure DevOps Anda, pilih umpan Anda dari menu dropdown, lalu pilih paket yang ingin Anda instal.

2. Navigasi ke Maven Gambaran Umum>, lalu salin cuplikan dependensi.

3. Buka file pom.xml Anda dan tempelkan cuplikan di <dependencies> dalam tag.

4. Jalankan perintah berikut dari direktori tempat file pom.xml Anda berada untuk memulihkan paket Anda:

   mvn install
   

Artikel terkait

• Menerbitkan artefak Maven dengan Azure Pipelines
• Menggunakan paket dari Maven Central
• Menggunakan sumber upstram dalam umpan publik