

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

# Contoh Sistem File Amazon Elastic untuk AWS CodeBuild
<a name="sample-efs"></a>

 Anda mungkin ingin membuat AWS CodeBuild build di Amazon Elastic File System, layanan file bersama yang dapat diskalakan untuk instans Amazon EC2. Kapasitas penyimpanan dengan Amazon EFS elastis, sehingga tumbuh atau menyusut saat file ditambahkan dan dihapus. Ini memiliki antarmuka layanan web sederhana yang dapat Anda gunakan untuk membuat dan mengkonfigurasi sistem file. Ini juga mengelola semua infrastruktur penyimpanan file untuk Anda, sehingga Anda tidak perlu khawatir tentang penerapan, menambal, atau memelihara konfigurasi sistem file. Untuk informasi selengkapnya, lihat [ Apa itu Amazon Elastic File System? ](https://docs.aws.amazon.com/efs/latest/ug/whatisefs.html)dalam Panduan Pengguna Sistem File * Amazon Elastic*. 

 Contoh ini menunjukkan cara mengkonfigurasi CodeBuild proyek sehingga dipasang dan kemudian membangun aplikasi Java ke sistem file Amazon EFS. Sebelum memulai, Anda harus memiliki aplikasi Java yang siap untuk dibangun yang diunggah ke bucket input S3 atau AWS CodeCommit,, GitHub Enterprise Server GitHub, atau repositori Bitbucket. 

Data yang sedang transit untuk sistem file Anda dienkripsi. Untuk mengenkripsi data dalam transit menggunakan gambar yang berbeda, lihat Men [ genkripsi data dalam transit](https://docs.aws.amazon.com/efs/latest/ug/encryption-in-transit.html). 

**Topics**
+ [Gunakan AWS CodeBuild dengan Amazon Elastic File System](#sample-efs-high-level-steps)
+ [Memecahkan masalah integrasi Amazon EFS](sample-efs-troubleshooting.md)

## Gunakan AWS CodeBuild dengan Amazon Elastic File System
<a name="sample-efs-high-level-steps"></a>

Sampel mencakup empat langkah tingkat tinggi yang diperlukan untuk menggunakan Amazon EFS dengan AWS CodeBuild. File tersebut adalah: 

1. Buat cloud pribadi virtual (VPC) di AWS akun Anda. 

1. Buat sistem file yang menggunakan VPC ini. 

1. Membuat dan membangun CodeBuild proyek yang menggunakan VPC. CodeBuild Proyek ini menggunakan yang berikut untuk mengidentifikasi sistem file:
   +  Pengidentifikasi sistem file yang unik. Anda memilih pengidentifikasi ketika Anda menentukan sistem file dalam proyek build Anda.
   + ID sistem file. ID ditampilkan saat Anda melihat sistem file Anda di konsol Amazon EFS.
   +  Titik pemasangan. Ini adalah direktori di wadah Docker Anda yang memasang sistem file. 
   + Opsi pemasangan. Ini termasuk detail tentang cara memasang sistem file.

1. Tinjau proyek build untuk memastikan bahwa file dan variabel proyek yang benar telah dihasilkan.

**catatan**  
 Sistem file yang dibuat di Amazon EFS hanya didukung pada platform Linux. 

 

**Topics**
+ [Langkah 1: Buat VPC menggunakan CloudFormation](#sample-efs-create-vpc)
+ [Langkah 2: Buat sistem file Amazon Elastic File System dengan VPC Anda](#sample-efs-create-efs)
+ [Langkah 3: Buat CodeBuild proyek untuk digunakan dengan Amazon EFS](#sample-efs-create-acb)
+ [Langkah 4: Tinjau proyek pembangunan](#sample-efs-summary)

### Langkah 1: Buat VPC menggunakan CloudFormation
<a name="sample-efs-create-vpc"></a>

 Buat VPC Anda dengan CloudFormation template. 

1.  Ikuti petunjuk [CloudFormation Template VPC](cloudformation-vpc-template.md) untuk digunakan CloudFormation untuk membuat VPC. 
**catatan**  
 VPC yang dibuat oleh CloudFormation template ini memiliki dua subnet pribadi dan dua subnet publik. Anda hanya boleh menggunakan subnet pribadi saat Anda menggunakannya AWS CodeBuild untuk memasang sistem file yang Anda buat di Amazon EFS. Jika Anda menggunakan salah satu subnet publik, build gagal. 

1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon VPC di [ https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/).

1.  Pilih VPC yang Anda buat. CloudFormation

1. Pada ** tab ** Deskripsi, catat nama VPC Anda dan ID-nya. Keduanya diperlukan saat Anda membuat AWS CodeBuild proyek Anda nanti dalam sampel ini. 

### Langkah 2: Buat sistem file Amazon Elastic File System dengan VPC Anda
<a name="sample-efs-create-efs"></a>

 Buat sistem file Amazon EFS sederhana untuk sampel ini menggunakan VPC yang Anda buat sebelumnya. 

1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon EFS di [ https://console.aws.amazon.com/efs/](https://console.aws.amazon.com/efs/).

1.  Pilih **Buat sistem file**. 

1.  Dari ** VPC**, pilih nama VPC yang Anda catat sebelumnya dalam sampel ini. 

1.  Biarkan Zona Ketersediaan yang terkait dengan subnet Anda dipilih. 

1.  Pilih **Langkah Selanjutnya.** 

1.  Di ** Tambah tag**, untuk ** kunci ** Nama default, di ** Nilai**, masukkan nama sistem file Amazon EFS Anda. 

1.  Tet ** ap pilih Bursting ** dan Tujuan ** ** Umum sebagai mode kinerja dan throughput default Anda, lalu pilih Langkah ** Ber ** ikutnya. 

1. Untuk ** Konfigurasikan akses klien**, pilih Langkah ** Berikutnya**.

1.  Pilih ** Buat Sistem File**. 

1.  (Opsional) Sebaiknya tambahkan kebijakan ke sistem file Amazon EFS Anda yang memberlakukan enkripsi data yang sedang transit. Di konsol Amazon EFS, pilih Kebijakan sistem ** file**, pilih ** Edit**, pilih kotak berlabel Ber ** laku enkripsi dalam transit untuk semua klien**, lalu pilih S ** impan**.

### Langkah 3: Buat CodeBuild proyek untuk digunakan dengan Amazon EFS
<a name="sample-efs-create-acb"></a>

 Buat AWS CodeBuild proyek yang menggunakan VPC yang Anda buat sebelumnya dalam sampel ini. Saat build dijalankan, itu memasang sistem file Amazon EFS yang dibuat sebelumnya. Selanjutnya, ia menyimpan file.jar yang dibuat oleh aplikasi Java Anda di direktori titik pemasangan sistem file Anda.

1. Buka AWS CodeBuild konsol di [ https://console.aws.amazon.com/codesuite/codebuild/home](https://console.aws.amazon.com/codesuite/codebuild/home).

1.  Dari panel navigasi, pilih ** Bangun proyek**, lalu pilih ** Buat proyek build**. 

1.  Dalam **Nama proyek**, masukkan nama untuk proyek Anda. 

1.  Dari penyedia ** Sumber**, pilih repositori yang berisi aplikasi Java yang ingin Anda buat. 

1.  Masukkan informasi, seperti URL repositori, yang CodeBuild digunakan untuk menemukan aplikasi Anda. Pilihannya berbeda untuk setiap penyedia sumber. Untuk informasi selengkapnya, lihat [Choose source provider](create-project.md#create-project-source-provider). 

1.  Dari gambar ** Lingkungan**, pilih Gambar ** terkelola**. 

1.  Dari Sistem ** operasi**, pilih ** Amazon Linux 2**. 

1. Dari ** Runtime (s)**, pilih ** Standar**. 

1.  Dari ** Gambar**, pilih ** aws/codebuild /amaz ** onlinux-x86\_64-standard:4.0. 

1.  Dari tipe ** Lingkungan**, pilih ** Linux**. 

1.  Di bawah ** Peran layanan**, pilih ** Peran layanan baru**. Di Nama ** peran**, masukkan nama untuk peran yang CodeBuild dibuat untuk Anda. 

1. Perluas **Additional configuration** (Konfigurasi tambahan).

1.  Pilih ** Aktifkan tanda ini jika Anda ingin membuat gambar Docker atau ingin build Anda mendapatkan hak istimewa ** yang ditingkatkan.
**catatan**  
Secara default, daemon Docker diaktifkan untuk build non-VPC. Jika Anda ingin menggunakan wadah Docker untuk build VPC, lihat [ Runtime Privilege dan Kapabilitas Linux ](https://docs.docker.com/engine/reference/run/#runtime-privilege-and-linux-capabilities) di situs Docker Docker dan aktifkan mode istimewa. Selain itu, Windows tidak mendukung mode istimewa.

1.  Dari ** VPC**, pilih ID VPC. 

1.  Dari ** Subnets**, pilih satu atau beberapa subnet pribadi yang terkait dengan VPC Anda. Anda harus menggunakan subnet pribadi dalam build yang memasang sistem file Amazon EFS. Jika Anda menggunakan subnet publik, build gagal. 

1.  Dari Grup ** Keamanan**, pilih grup keamanan default.

1.  Dalam ** Sistem file**, masukkan informasi berikut:
   + Untuk ** Identifier**, masukkan pengenal sistem file yang unik. Itu harus kurang dari 129 karakter dan hanya berisi karakter alfanumerik dan garis bawah. CodeBuild menggunakan pengenal ini untuk membuat variabel lingkungan yang mengidentifikasi sistem file elastis. Format variabel lingkungan `CODEBUILD_{{<file_system_identifier>}}` dalam huruf kapital. Misalnya, jika Anda memasukkan`my_efs`, variabel lingkungan adalah`CODEBUILD_MY_EFS`. 
   + Untuk ** ID**, pilih ID sistem file. 
   + (Opsional) Masukkan direktori dalam sistem file. CodeBuild memasang direktori ini. Jika Anda membiarkan jalur ** direktori ** kosong CodeBuild, pasang seluruh sistem file. Jalur ini relatif terhadap root sistem file. 
   + Untuk ** Mount point**, masukkan jalur absolut direktori di wadah build Anda tempat sistem file dipasang. Jika direktori ini tidak ada CodeBuild , buat selama build. 
   + (Opsional) Masukkan opsi pemasangan. Jika Anda membiarkan opsi ** Mount ** kosong, gunakan CodeBuild opsi pemasangan defaultnya:

     ```
     nfsvers=4.1
     rsize=1048576
     wsize=1048576
     hard
     timeo=600
     retrans=2
     ```

     Untuk informasi selengkapnya, lihat [ Opsi Pemasangan NFS yang Direkom ](https://docs.aws.amazon.com/efs/latest/ug/mounting-fs-nfs-mount-settings.html) endasikan di Panduan * Pengguna Sistem File * Amazon Elastic. 

1.  Untuk Spesifikasi ** Build**, pilih ** Sisipkan perintah build**, lalu pilih ** Beralih ke editor**. 

1.  Masukkan perintah buildspec berikut ke dalam editor. Ganti `{{<file_system_identifier>}}` dengan pengenal yang Anda masukkan pada langkah 17. Gunakan huruf kapital (misalnya,`CODEBUILD_MY_EFS`).

   ```
   version: 0.2
   phases:
     install:
       runtime-versions:
         java: corretto11    
     build:
       commands:
         - mvn compile -Dgpg.skip=true -Dmaven.repo.local=$CODEBUILD_{{<file_system_identifier>}}
   ```

1.  Gunakan nilai default untuk semua pengaturan lainnya, lalu pilih ** Buat proyek build**. Ketika build Anda selesai, halaman konsol untuk proyek Anda ditampilkan. 

1.  Pilih ** Mulai membangun**. 

### Langkah 4: Tinjau proyek pembangunan
<a name="sample-efs-summary"></a>



 Setelah AWS CodeBuild proyek Anda dibangun: 
+  Anda memiliki file.jar yang dibuat oleh aplikasi Java Anda yang dibuat untuk sistem file Amazon EFS Anda di bawah direktori titik pemasangan Anda. 
+  Variabel lingkungan yang mengidentifikasi sistem file Anda dibuat menggunakan pengidentifikasi sistem file yang Anda masukkan saat Anda membuat proyek. 

 Untuk informasi selengkapnya, lihat [ Memasang sistem file ](https://docs.aws.amazon.com/efs/latest/ug/mounting-fs.html) di Panduan Pengguna Sistem File * Amazon Elastic*. 