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](migration.md).

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

# Mengkonfigurasi dan menggunakan mvn
<a name="packages-maven-mvn"></a>

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.

**Contents**
+ [Mengambil dependensi dari CodeCatalyst](#mvn-fetch-dependencies)
+ [Mengambil paket dari repositori paket eksternal melalui CodeCatalyst](#mvn-install-public)
+ [Menerbitkan paket ke CodeCatalyst](#mvn-publish-packages)
+ [Menerbitkan paket pihak ketiga](#publishing-third-party-packages)

## Mengambil dependensi dari CodeCatalyst
<a name="mvn-fetch-dependencies"></a>

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 digunakan `mvn` untuk mengambil dependensi dari repositori paket Anda CodeCatalyst**

1. Buka CodeCatalyst konsol di [https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Pada halaman ikhtisar untuk proyek Anda, pilih **Paket**.

1. Pilih repositori paket Anda dari daftar repositori paket.

1. Pilih **Connect to repository**.

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

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

   1. Pilih **Buat token**.

   1. Pilih **Salin** untuk menyalin PAT Anda.
**Awas**  
Anda tidak akan dapat melihat atau menyalin PAT Anda lagi setelah Anda menutup kotak dialog.

1. Tambahkan profil yang berisi repositori Anda ke file Anda`settings.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>
   ```

1. 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 CodeCatalyst PAT Anda.

   ```
   <servers>
     <server>
       <id>{{repo_name}}</id>
       <username>{{username}}</username>
       <password>{{PAT}}</password>
     </server>
   </servers>
   ```

1. (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
<a name="mvn-install-public"></a>

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](#mvn-fetch-dependencies)

1. 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 hulu](packages-upstream-repositories-add.md)

Untuk informasi selengkapnya tentang meminta paket dari repositori upstream, lihat. [Meminta versi paket dengan repositori hulu](packages-upstream-repositories-request.md)

## Menerbitkan paket ke CodeCatalyst
<a name="mvn-publish-packages"></a>

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/](https://codecatalyst.aws/).

1. Pada halaman ikhtisar untuk proyek Anda, pilih **Paket**.

1. Pilih repositori paket Anda dari daftar repositori paket.

1. Pilih **Connect to repository**.

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

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

   1. Pilih **Buat token**.

   1. Pilih **Salin** untuk menyalin PAT Anda.
**Awas**  
Anda tidak akan dapat melihat atau menyalin PAT Anda lagi setelah Anda menutup kotak dialog.

1. 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}}
   ```

1. Tambahkan bagian `<servers>` ke `settings.xml`dengan 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>
   ```

1. 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
<a name="publishing-third-party-packages"></a>

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

1. Dalam **nama PAT**, masukkan nama deskriptif untuk PAT Anda.

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

1. Pilih **Buat**.

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

1. Simpan rahasia PAT di lokasi yang aman. 
**penting**  
Rahasia PAT 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>
   ```

1. 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 groupId, artifactID, versi, dan file argumen untuk memublikasikan JAR yang berbeda.

Instruksi ini didasarkan pada contoh dalam [Panduan untuk menyebarkan pihak JARs ke-3 ke repositori jarak jauh](https://maven.apache.org/guides/mini/guide-3rd-party-jars-remote.html) dari dokumentasi *Apache* Maven. 

 Untuk informasi selengkapnya, lihat topik tersebut di situs web Apache Maven Project:
+  [Menyiapkan Beberapa Repositori](https://maven.apache.org/guides/mini/guide-multiple-repositories.html) 
+  [Pengaturan Referensi](https://maven.apache.org/settings.html) 
+  [Manajemen Distribusi](https://maven.apache.org/pom.html#Distribution_Management) 
+  [Profil](https://maven.apache.org/pom.html#Profiles)