Jalankan build pada armada kapasitas yang dicadangkan

CodeBuild menawarkan armada komputasi berikut:

• On-demand armada

• Armada kapasitas cadangan

Dengan armada sesuai permintaan, CodeBuild menyediakan komputasi untuk build Anda. Mesin-mesin hancur ketika pembangunan selesai. On-demand armada dikelola sepenuhnya, dan mencakup kemampuan penskalaan otomatis untuk menangani lonjakan permintaan.

catatan

On-demand armada tidak mendukung macOS.

CodeBuild juga menawarkan armada kapasitas cadangan yang berisi instans yang didukung oleh Amazon EC2 yang dikelola oleh. CodeBuild Dengan armada kapasitas cadangan, Anda mengonfigurasi satu set instans khusus untuk lingkungan build Anda. Mesin-mesin ini tetap diam, siap untuk memproses build atau pengujian segera, dan mengurangi durasi pembuatan. Dengan armada kapasitas cadangan, mesin Anda selalu berjalan dan akan terus mengeluarkan biaya selama disediakan.

penting

Terlepas dari berapa lama Anda menjalankan instance, armada kapasitas cadangan dikenakan biaya awal per instans, setelah itu mungkin ada biaya terkait tambahan. Untuk informasi selengkapnya, lihat https://aws.amazon.com/codebuild/pricing/.

Topik

• Buat armada kapasitas yang dicadangkan

• Praktik terbaik

• Dapatkah saya berbagi armada kapasitas yang dipesan di beberapa CodeBuild proyek?

• Bagaimana cara kerja komputasi berbasis atribut?

• Dapatkah saya menentukan instans Amazon EC2 secara manual untuk armada saya?

• Wilayah mana yang mendukung armada kapasitas cadangan?

• Bagaimana cara mengonfigurasi armada macOS kapasitas cadangan?

• Bagaimana cara mengonfigurasi Image Mesin Amazon (AMI) khusus untuk armada kapasitas cadangan?

• Keterbatasan armada kapasitas cadangan

• Properti armada kapasitas cadangan

• Sampel kapasitas cadangan dengan AWS CodeBuild

Buat armada kapasitas yang dicadangkan

Gunakan petunjuk berikut untuk membuat armada kapasitas cadangan.

Untuk membuat armada kapasitas cadangan

1. Masuk ke Konsol Manajemen AWS dan buka AWS CodeBuild konsol di https://console.aws.amazon.com/codesuite/codebuild/home.

2. Di panel navigasi, pilih Ar mada komputasi, lalu pilih Buat Armada.

3. Di bidang teks Komputasi nama armada, masukkan nama untuk armada Anda.

4. Dari menu drop-down Sistem operasi, pilih sistem operasi.

5. Dari menu drop-down Arsitektur, pilih arsitektur.

6. (Opsional) Pilih Gunakan mode berjalan instans - opsional untuk dijalankan di instans Amazon EC2 secara langsung alih-alih wadah Docker. Kemudian pilih versi Major dan versi Minor.

7. (Opsional) Dalam konfigurasi tambahan lakukan hal berikut:

   • Pilih Konfigurasi VPC - opsional untuk menghubungkan armada Anda ke VPC untuk mengakses sumber daya pribadi selama penggunaan.

     • Dari menu drop-down VPC, pilih VPC yang akan diakses CodeBuild armada Anda.

     • Dari menu drop-down Subnets, pilih subnet yang CodeBuild harus digunakan untuk mengatur konfigurasi VPC Anda.

     • Dari menu tarik -turun Grup keamanan, pilih grup keamanan yang CodeBuild harus digunakan untuk bekerja dengan VPC Anda.

     • Di bidang Peran Layanan Ar mada, pilih peran layanan yang ada.

       catatan

       Pastikan peran armada Anda memiliki izin yang diperlukan. Untuk informasi selengkapnya, lihat Mengizinkan pengguna menambahkan kebijakan izin untuk peran layanan armada.

     • Jika Anda memilih sistem operasi Amazon Linux, pilih T entukan konfigurasi proxy - opsional untuk menerapkan kontrol akses jaringan untuk instans kapasitas cadangan Anda.

     • Untuk Perilaku default, pilih untuk mengizinkan atau menolak lalu lintas keluar ke semua tujuan secara default.

     • Untuk Aturan Proxy, pilih Tambahkan aturan proxy untuk menentukan domain tujuan atau IP untuk mengizinkan atau menolak kontrol akses jaringan.

   • Pilih Konfigurasi AMI kustom - opsional untuk menggunakan Image Mesin Amazon (AMI) kustom.

     • Dari menu tar ik-turun AMI, pilih Amazon Machine Image (AMI) untuk armada Anda.

     • Di bidang Peran Layanan Ar mada, pilih peran layanan yang ada.

       catatan

       Pastikan peran armada Anda memiliki izin yang diperlukan. Untuk informasi selengkapnya, lihat Mengizinkan pengguna menambahkan kebijakan izin untuk peran layanan armada.

8. Di Konfigur asi Kapasitas, dari mode pemilihan Compute, pilih salah satu dari berikut ini:

   • Jika Anda memilih Pilihan terpandu, lakukan hal berikut:

     • Untuk Compute, pilih jenis instans yang disertakan dalam armada ini.

     • Di bidang teks Kapasitas, masukkan jumlah minimum instance dalam armada.

     • (Opsional) Dalam konfigurasi tambahan lakukan hal berikut:

       • Pilih Konfigurasi penskalaan - opsional untuk menskalakan armada Anda secara otomatis berdasarkan konfigurasi ini. Dari mode pen skalaan - menu drop-down opsional, pilih perilaku ketika permintaan melebihi kapasitas armada.

   • Jika Anda memilih Instans kustom, lakukan hal berikut:

     • Dari menu drop-down tipe instance Compute, pilih jenis instans yang disertakan dalam armada ini.

     • Di bidang Ukuran volume EBS Tambahan - teks opsional, masukkan volume tambahan ke ruang disk 64GB yang disediakan.

     • Di bidang teks Kapasitas, masukkan jumlah minimum instance dalam armada.

     • (Opsional) Dalam konfigurasi tambahan lakukan hal berikut:

       • Pilih Konfigurasi penskalaan - opsional untuk menskalakan armada Anda secara otomatis berdasarkan konfigurasi ini. Dari mode pen skalaan - menu drop-down opsional, pilih perilaku ketika permintaan melebihi kapasitas armada.

9. Pilih Buat armada komputasi.

10. Setelah armada komputasi dibuat, buat CodeBuild proyek baru atau edit yang sudah ada. Dari Lingkungan, pilih Kapasitas Cadangan di bawah Model Penyediaan, lalu pilih armada yang ditentukan di bawah Nama Armada.

Praktik terbaik

Saat menggunakan armada kapasitas cadangan, kami sarankan Anda mengikuti praktik terbaik ini.

• Sebaiknya gunakan mode cache sumber untuk membantu meningkatkan kinerja build dengan menyimpan sumber dalam cache.

• Sebaiknya gunakan caching lapisan Docker untuk membantu meningkatkan kinerja build dengan men-cache lapisan Docker yang ada.

Dapatkah saya berbagi armada kapasitas yang dipesan di beberapa CodeBuild proyek?

Ya, Anda dapat memaksimalkan pemanfaatan kapasitas armada dengan menggunakannya di beberapa proyek.

penting

Saat menggunakan fitur kapasitas cadangan, data yang di-cache pada instance armada, termasuk file sumber, lapisan Docker, dan direktori cache yang ditentukan dalam buildspec, dapat diakses oleh proyek lain dalam akun yang sama. Ini berdasarkan desain dan memungkinkan proyek dalam akun yang sama untuk berbagi instance armada.

Bagaimana cara kerja komputasi berbasis atribut?

Jika Anda memilih ATTRIBUTE_BASED_COMPUTE sebagai armada AndacomputeType, Anda dapat menentukan atribut di bidang baru yang disebutcomputeConfiguration. Atribut ini termasuk vCPU, memori, ruang disk, dan. machineType Ini machineType adalah salah satu GENERAL atauNVME. Setelah menentukan satu atau beberapa atribut yang tersedia, CodeBuild akan memilih tipe komputasi dari jenis instans yang didukung yang tersedia sebagai yang diselesaikancomputeConfiguration.

catatan

CodeBuild akan memilih instance termurah yang cocok dengan semua persyaratan input. Memori instans yang dipilih, vCPU, dan ruang disk semuanya akan lebih besar dari atau sama dengan persyaratan input. Anda dapat memeriksa yang diselesaikan computeConfiguration di armada yang dibuat atau diperbarui.

Jika Anda memasukkan a computeConfiguration yang tidak mungkin dipenuhi CodeBuild, Anda akan menerima pengecualian validasi. Perhatikan juga bahwa perilaku luapan armada sesuai permintaan akan diganti ke perilaku antrian jika tidak computeConfiguration tersedia untuk sesuai permintaan.

Dapatkah saya menentukan instans Amazon EC2 secara manual untuk armada saya?

Ya, Anda dapat langsung memasukkan instans Amazon EC2 yang Anda inginkan di konsol dengan memilih Instans khusus atau dengan mengonfigurasi parameter API,InstanceType. Bidang ini digunakan dalam API berikut: CreateFleet, UpdateFleet, CreateProject, UpdateProject dan StartBuild. Untuk informasi selengkapnya, lihat Compute instance type.

Wilayah mana yang mendukung armada kapasitas cadangan?

Kapasitas cadangan armada Amazon Linux dan Windows didukung di Wilayah AWS: AS Timur (Virginia Utara), AS Timur (Ohio), AS Barat (Oregon), Asia Pasifik (Mumbai), Asia Pasifik (Singapura), Asia Pasifik (Sydney), Asia Pasifik (Tokyo), Eropa (Frankfurt), Eropa (Irlandia), dan Amerika Selatan (São Paulo). Untuk informasi selengkapnya tentang Wilayah AWS tempat CodeBuild tersedia, lihat AWS Layanan berdasarkan Wilayah.

Armada macOS Medium kapasitas cadangan didukung di Wilayah AWS: AS Timur (Virginia Utara), AS Timur (Ohio), AS Barat (Oregon), Asia Pasifik (Sydney), dan Eropa (Frankfurt). Kapasitas cadangan macOS Armada besar didukung di Wilayah AWS: AS Timur (Virginia Utara), AS Timur (Ohio), AS Barat (Oregon), dan Asia Pasifik (Sydney).

Bagaimana cara mengonfigurasi armada macOS kapasitas cadangan?

Untuk mengonfigurasi armada macOS kapasitas cadangan

1. Masuk ke Konsol Manajemen AWS dan buka AWS CodeBuild konsol di https://console.aws.amazon.com/codesuite/codebuild/home.

2. Di panel navigasi, pilih Ar mada komputasi, lalu pilih Buat Armada.

3. Di bidang teks Komputasi nama armada, masukkan nama untuk armada Anda.

4. Dari menu drop-down Sistem operasi, pilih macOS.

5. Di bidang Komputasi, pilih salah satu jenis mesin komputasi berikut: Apple M2, memori 24 GB, 8 vCPU atau Apple M2, memori 32 GB, 12 vCPU.

6. Di bidang teks Kapasitas, masukkan jumlah minimum instance dalam armada.

7. (Opsional) Untuk menggunakan gambar khusus untuk armada Anda, lihat Bagaimana cara mengonfigurasi Image Mesin Amazon (AMI) khusus untuk armada kapasitas cadangan? untuk memastikan bahwa Amazon Machine Image (AMI) Anda memiliki prasyarat yang diperlukan.

8. (Opsional) Untuk mengonfigurasi VPC dengan armada Anda, di Konfigurasi tambahan lakukan hal berikut:

   • Dari menu drop-down VPC - opsional, pilih VPC yang akan diakses CodeBuild armada Anda.

   • Dari menu drop-down Subnets, pilih subnet yang CodeBuild harus digunakan untuk mengatur konfigurasi VPC Anda.

   • Dari menu tarik -turun Grup keamanan, pilih grup keamanan yang CodeBuild harus digunakan untuk bekerja dengan VPC Anda.

   • Di bidang Peran layanan Ar mada, pilih peran layanan yang ada.

     catatan

     Pastikan peran armada Anda memiliki izin yang diperlukan. Untuk informasi selengkapnya, lihat Mengizinkan pengguna menambahkan kebijakan izin untuk peran layanan armada.

9. Pilih Buat armada komput asi dan tunggu instans armada diluncurkan. Setelah diluncurkan kapasitasnya akan beradan/n, di n mana kapasitas yang disediakan.

10. Setelah armada komputasi diluncurkan, buat CodeBuild proyek baru atau edit yang sudah ada. Dari Lingkungan, pilih Kapasitas Cadangan di bawah Model Penyediaan, lalu pilih armada yang ditentukan di bawah Nama Armada.

Bagaimana cara mengonfigurasi Image Mesin Amazon (AMI) khusus untuk armada kapasitas cadangan?

Cara mengonfigurasi Image Mesin Amazon (AMI) khusus untuk armada kapasitas cadangan

1. Masuk ke Konsol Manajemen AWS dan buka AWS CodeBuild konsol di https://console.aws.amazon.com/codesuite/codebuild/home.

2. Di panel navigasi, pilih Ar mada komputasi, lalu pilih Buat Armada.

3. Di bidang teks Komputasi nama armada, masukkan nama untuk armada Anda.

4. Pilih Gambar kustom untuk armada Anda dan pastikan bahwa Amazon Machine Image (AMI) Anda memiliki prasyarat berikut:

   • Jika jenis lingkungan Anda adalahMAC_ARM, pastikan bahwa Arsit ektur AMI Anda adalah 64-bitMac-Arm.

   • Jika jenis lingkungan Anda adalahLINUX_EC2, pastikan bahwa Arsit ektur AMI Anda adalah 64-bitx86.

   • Jika jenis lingkungan Anda adalahARM_EC2, pastikan bahwa Arsit ektur AMI Anda adalah 64-bitArm.

   • Jika jenis lingkungan Anda adalahWINDOWS_EC2, pastikan bahwa Arsit ektur AMI Anda adalah 64-bitx86.

   • AMI memungkinkan CodeBuild layanan Organisasi ARN. Untuk daftar ARN Organisasi, lihatAmazon Machine Images (AMI).

   • Jika AMI dienkripsi dengan AWS KMS kunci, AWS KMS kunci tersebut juga harus mengizinkan ID Organisasi CodeBuild layanan. Untuk daftar ID Organisasi, lihatAmazon Machine Images (AMI). Untuk informasi selengkapnya tentang AWS KMS kunci, lihat Mengiz inkan organisasi dan OU menggunakan kunci KMS di Panduan Pengguna Amazon EC2. Untuk memberikan izin CodeBuild organisasi untuk menggunakan kunci KMS, tambahkan pernyataan berikut ke kebijakan kunci:

     {
         "Sid": "Allow access for organization root",
         "Effect": "Allow",
         "Principal": "*",
         "Action": [
             "kms:Describe*",
             "kms:List*",
             "kms:Get*",
             "kms:Encrypt",
             "kms:Decrypt",
             "kms:ReEncrypt*",
             "kms:GenerateDataKey*",
             "kms:CreateGrant"
         ],
         "Resource": "*",
         "Condition": {
             "StringEquals": {
                 "aws:PrincipalOrgID": "o-123example"
             }
         }
     }

   • Di bidang peran layanan Ar mada, berikan izin Amazon EC2 berikut:

     JSON

     {
         "Version":"2012-10-17",
         "Statement": [
             {
                 "Effect": "Allow",
                 "Action": [
                    "ec2:DescribeImages",
                    "ec2:DescribeSnapshots"
                 ],
                 "Resource": "*"
             }
         ]
     }
     

Keterbatasan armada kapasitas cadangan

Ada beberapa kasus penggunaan yang tidak didukung oleh armada kapasitas cadangan, dan jika hal itu berdampak pada Anda, gunakan armada sesuai permintaan sebagai gantinya:

• Armada kapasitas cadangan tidak mendukung metrik pemanfaatan build.

• Armada macOS kapasitas cadangan tidak mendukung sesi debug.

Untuk informasi lebih lanjut tentang batas dan kuota, lihatHitung armada.