View a markdown version of this page

Contoh Sistem File Amazon Elastic untuk AWS CodeBuild - AWS CodeBuild
Gunakan CodeBuild dengan Amazon EFS

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

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

Topik

Gunakan AWS CodeBuild dengan Amazon Elastic File System

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.

  2. Buat sistem file yang menggunakan VPC ini.

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

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

Langkah 1: Buat VPC menggunakan CloudFormation

Buat VPC Anda dengan CloudFormation template.

  1. Ikuti petunjuk CloudFormation Template VPC 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.

  2. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon VPC di https://console.aws.amazon.com/vpc/.

  3. Pilih VPC yang Anda buat. CloudFormation

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

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

  2. Pilih Buat sistem file.

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

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

  5. Pilih Langkah Selanjutnya.

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

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

  8. Untuk Konfigurasikan akses klien, pilih Langkah Berikutnya.

  9. Pilih Buat Sistem File.

  10. (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

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.

  2. Dari panel navigasi, pilih Bangun proyek, lalu pilih Buat proyek build.

  3. Dalam Nama proyek, masukkan nama untuk proyek Anda.

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

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

  6. Dari gambar Lingkungan, pilih Gambar terkelola.

  7. Dari Sistem operasi, pilih Amazon Linux 2.

  8. Dari Runtime (s), pilih Standar.

  9. Dari Gambar, pilih aws/codebuild /amaz onlinux-x86_64-standard:4.0.

  10. Dari tipe Lingkungan, pilih Linux.

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

  12. Perluas Additional configuration (Konfigurasi tambahan).

  13. 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 di situs Docker Docker dan aktifkan mode istimewa. Selain itu, Windows tidak mendukung mode istimewa.

  14. Dari VPC, pilih ID VPC.

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

  16. Dari Grup Keamanan, pilih grup keamanan default.

  17. 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 memasukkanmy_efs, variabel lingkungan adalahCODEBUILD_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 endasikan di Panduan Pengguna Sistem File Amazon Elastic.

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

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

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

  21. Pilih Mulai membangun.

Langkah 4: Tinjau proyek pembangunan

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 di Panduan Pengguna Sistem File Amazon Elastic.