Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mengintegrasikan Device Farm dengan server Jenkins CI
Plugin Jenkins CI menyediakan fungsionalitas AWS Device Farm dari server integrasi berkelanjutan (CI) Jenkins Anda sendiri. Untuk informasi selengkapnya, lihat [ Jenkins (perangkat lunak)](https://en.wikipedia.org/wiki/Jenkins_%28software%29).
**catatan**
Untuk mengunduh plugin Jenkins, buka [ GitHub ](https://github.com/awslabs/aws-device-farm-jenkins-plugin) dan ikuti instruksi di[Langkah 1: Menginstal plugin Jenkins CI untuk AWS Device Farm](#jenkins-ci-installing-the-plugin).
Bagian ini berisi serangkaian prosedur untuk mengatur dan menggunakan plugin Jenkins CI dengan AWS Device Farm.
Gambar berikut menunjukkan fitur plugin Jenkins CI.
Plugin juga dapat menurunkan semua artefak pengujian (log, tangkapan layar, dll.) Secara lokal:
**Topics**
+ [Dependensi](#jenkins-plugin-dependencies)
+ [Langkah 1: Menginstal plugin Jenkins CI untuk AWS Device Farm](#jenkins-ci-installing-the-plugin)
+ [Langkah 2: Membuat AWS Identity and Access Management pengguna untuk Plugin Jenkins CI Anda untuk AWS Device Farm](#jenkins-ci-set-up-iam-user)
+ [Langkah 3: Mengkonfigurasi plugin Jenkins CI untuk pertama kalinya di AWS Device Farm](#jenkins-ci-first-time-configuration-instructions)
+ [Langkah 4: Menggunakan plugin dalam pekerjaan Jenkins](#jenkins-ci-using-plugin-jenkins-job)
## Dependensi
Plugin Jenkins CI memerlukan AWS Mobile SDK 1.10.5 atau yang lebih baru. Untuk informasi selengkapnya dan untuk menginstal SDK, lihat [ AWS Mobile SDK](https://aws.amazon.com/mobile/sdk/).
## Langkah 1: Menginstal plugin Jenkins CI untuk AWS Device Farm
Ada dua opsi untuk menginstal plugin Jenkins Continuous Integration (CI) untuk AWS Device Farm. Anda dapat mencari plugin dari dalam ** dialog Plugin ** Tersedia di UI Web Jenkins, atau Anda dapat mengunduh `hpi` file dan menginstalnya dari dalam Jenkins.
### Instal dari dalam UI Jenkins
1. Temukan plugin dalam UI Jenkins dengan memilih Kel ** ola Jenkins**, Kel ** ola Plugin**, lalu pilih ** Tersedia. **
1. Cari ** aws- ** device-farm.
1. Instal plugin AWS Device Farm.
1. Pastikan plugin dimiliki oleh `Jenkins` pengguna.
1. Mulai ulang Jenkins.
### Unduh plugin
1. Unduh `hpi` file langsung dari [ http://updates.jenkins-ci.org/latest/aws-device-farm.hpi](http://updates.jenkins-ci.org/latest/aws-device-farm.hpi).
1. Pastikan plugin dimiliki oleh `Jenkins` pengguna.
1. Instal plugin menggunakan salah satu opsi berikut:
+ Unggah plugin dengan memilih ** Kelola Jenkins**, ** Kelola Plugin**, L ** anjutan**, lalu pilih ** Unggah plugin**.
+ Tempat `hpi` kan file di direktori plugin Jenkins (biasanya`/var/lib/jenkins/plugins`).
1. Mulai ulang Jenkins.
## Langkah 2: Membuat AWS Identity and Access Management pengguna untuk Plugin Jenkins CI Anda untuk AWS Device Farm
Kami menyarankan Anda untuk tidak menggunakan akun AWS root Anda untuk mengakses Device Farm. Sebagai gantinya, buat pengguna AWS Identity and Access Management (IAM) baru (atau gunakan pengguna IAM yang sudah ada) di AWS akun Anda, lalu akses Device Farm dengan pengguna IAM tersebut.
Untuk membuat pengguna IAM baru, lihat [ Membuat Pengguna IAM ()Konsol Manajemen AWS. ](https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_SettingUpUser.html#Using_CreateUser_console) Pastikan untuk membuat kunci akses untuk setiap pengguna dan mengunduh atau menyimpan kredenSIAL keamanan pengguna. Anda akan membutuhkan kredensialnya nanti.
### Berikan izin pengguna IAM untuk mengakses Device Farm
Untuk memberikan izin pengguna IAM untuk mengakses Device Farm, buat kebijakan akses baru di IAM, lalu tetapkan kebijakan akses ke pengguna IAM sebagai berikut.
**catatan**
Akun AWS root atau pengguna IAM yang Anda gunakan untuk menyelesaikan langkah-langkah berikut harus memiliki izin untuk membuat kebijakan IAM berikut dan melampirkannya ke pengguna IAM. Untuk informasi selengkapnya, lihat [ Bekerja dengan Kebijakan ](https://docs.aws.amazon.com/IAM/latest/UserGuide/policies_manage.html)
**Untuk membuat kebijakan akses di IAM**
1. Buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Pilih **Policies** (Kebijakan).
1. Pilih **Buat Kebijakan**. (Jika tombol **Memulai** muncul, pilihlah, lalu pilih **Buat Kebijakan**.)
1. Di sebelah **Buat Kebijakan Anda Sendiri**, pilih **Pilih**.
1. Untuk Nama ** Kebijakan**, ketik nama untuk kebijakan (misalnya,**AWSDeviceFarmAccessPolicy**).
1. Untuk ** Deskripsi**, ketik deskripsi yang membantu Anda mengaitkan pengguna IAM ini dengan proyek Jenkins Anda.
1. Untuk ** Dokumen Kebijakan**, ketik pernyataan berikut:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "DeviceFarmAll",
"Effect": "Allow",
"Action": [ "devicefarm:*" ],
"Resource": [ "*" ]
}
]
}
```
------
1. Pilih **Buat Kebijakan**.
**Untuk menetapkan kebijakan akses ke pengguna IAM**
1. Buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Pilih **Pengguna**.
1. Pilih pengguna IAM yang akan Anda tetapkan kebijakan akses.
1. Di ** area ** Izin, untuk Kebijakan Ter ** kelola**, pilih ** Lampirkan Kebijakan**.
1. Pilih kebijakan yang baru saja Anda buat (misalnya, ** AWSDeviceFarmAccessPolicy**).
1. Pilih **Lampirkan Kebijakan**.
## Langkah 3: Mengkonfigurasi plugin Jenkins CI untuk pertama kalinya di AWS Device Farm
Pertama kali Anda menjalankan server Jenkins Anda, Anda perlu mengkonfigurasi sistem sebagai berikut.
**catatan**
Jika Anda menggunakan slot [ perangkat](how-to-purchase-device-slots.md), fitur slot perangkat dinonaktifkan secara default.
1. Masuk ke antarmuka pengguna Web Jenkins Anda.
1. Di sisi kiri layar, pilih Kel ** ola Jen ** kins.
1. Pilih ** Konfigurasi Sistem**.
1. Gulir ke bawah ke ** header ** AWS Device Farm.
1. Salin kredensi keamanan Anda dari [Membuat pengguna IAM untuk Plugin Jenkins CI Anda](#jenkins-ci-set-up-iam-user) dan tempel ID Kunci Akses dan Kunci Akses Rahasia Anda ke dalam kotak masing-masing.
1. Pilih **Simpan**.
## Langkah 4: Menggunakan plugin dalam pekerjaan Jenkins
Setelah Anda menginstal plugin Jenkins, ikuti petunjuk ini untuk menggunakan plugin dalam pekerjaan Jenkins.
1. Masuk ke UI web Jenkins Anda.
1. Klik pekerjaan yang ingin Anda edit.
1. Di sisi kiri layar, pilih ** Konfigurasi**.
1. Gulir ke bawah ke ** header ** Post-build Actions.
1. Klik ** Tambahkan tindakan pasca-pembuatan ** dan pilih J ** alankan Pengujian di AWS Device Farm**.
1. Pilih proyek yang ingin Anda gunakan.
1. Pilih kumpulan perangkat yang ingin Anda gunakan.
1. Pilih apakah Anda ingin artefak pengujian (seperti log dan tangkapan layar) diarsipkan secara lokal.
1. Di ** Aplikasi**, isi jalur ke aplikasi Anda yang dikompilasi.
1. Pilih tes yang ingin Anda jalankan dan isi semua bidang yang diperlukan.
1. Pilih **Simpan**.