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 lebih lanjut, 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 FarmMenginstal plugin Jenkins CI](#jenkins-ci-installing-the-plugin).
Bagian ini berisi serangkaian prosedur untuk menyiapkan dan menggunakan plugin Jenkins CI dengan AWS Device Farm.
Gambar-gambar berikut menunjukkan fitur plugin Jenkins CI.
![\[Integrasi dengan aplikasi Jenkins CI Hello World\]](http://docs.aws.amazon.com/id_id/devicefarm/latest/developerguide/images/aws-device-farm-jenkins-plugin-continuous-integration-project-hello-world-app.png)
![\[Integrasi dengan tindakan pasca-build Jenkins CI\]](http://docs.aws.amazon.com/id_id/devicefarm/latest/developerguide/images/aws-device-farm-jenkins-plugin-continuous-integration-post-build-actions.png)
Plugin ini juga dapat menarik semua artefak pengujian (log, tangkapan layar, dll.) Secara lokal:
![\[Integrasi dengan artefak uji Jenkins CI\]](http://docs.aws.amazon.com/id_id/devicefarm/latest/developerguide/images/aws-device-farm-jenkins-plugin-continuous-integration-test-artifacts.png)
**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: Mengonfigurasi 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 yang 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 **Kelola Jenkins**, **Kelola Plugin**, dan kemudian pilih Tersedia.**
1. Cari **aws-device-farm**.
1. Instal plugin AWS Device Farm.
1. Pastikan plugin tersebut dimiliki oleh `Jenkins` pengguna.
1. Mulai ulang Jenkins.
### Unduh pluginnya
1. Unduh `hpi` file langsung dari [http://updates.jenkins-ci. org/latest/aws-perangkat-farm.hpi](http://updates.jenkins-ci.org/latest/aws-device-farm.hpi).
1. Pastikan plugin tersebut dimiliki oleh `Jenkins` pengguna.
1. Instal plugin menggunakan salah satu opsi berikut:
+ Upload plugin dengan memilih **Manage Jenkins**, **Manage Plugins**, **Advanced**, dan kemudian pilih **Upload** plugin.
+ Tempatkan `hpi` 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 baru AWS Identity and Access Management (IAM) (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 kredensi keamanan pengguna. Anda akan membutuhkan kredensialnya nanti.
### Berikan izin kepada pengguna IAM untuk mengakses Device Farm
Untuk memberikan izin kepada 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**, ketikkan nama untuk kebijakan (misalnya,**AWSDeviceFarmAccessPolicy**).
1. Untuk **Deskripsi**, ketikkan 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 kepada siapa Anda akan menetapkan kebijakan akses.
1. Di area **Izin**, untuk **Kebijakan Terkelola**, pilih **Lampirkan Kebijakan**.
1. Pilih kebijakan yang baru saja Anda buat (misalnya, **AWSDeviceFarmAccessPolicy**).
1. Pilih **Lampirkan Kebijakan**.
## Langkah 3: Mengonfigurasi 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 **Kelola** Jenkins.
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 **Jalankan 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 yang dikompilasi Anda.
1. Pilih tes yang ingin Anda jalankan dan isi semua bidang yang diperlukan.
1. Pilih **Simpan**.