Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# 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/](https://aws.amazon.com/codebuild/pricing/).
**Topics**
+ [Buat armada kapasitas yang dicadangkan](#fleets.how-to)
+ [Praktik terbaik](#fleets.best-practices)
+ [Dapatkah saya berbagi armada kapasitas yang dipesan di beberapa CodeBuild proyek?](#fleets.share)
+ [Bagaimana cara kerja komputasi berbasis atribut?](#fleets.attribute-compute)
+ [Dapatkah saya menentukan instans Amazon EC2 secara manual untuk armada saya?](#fleets.manual-input-compute)
+ [Wilayah mana yang mendukung armada kapasitas cadangan?](#fleets.regions)
+ [Bagaimana cara mengonfigurasi armada macOS kapasitas cadangan?](#fleets.configure-macos)
+ [Bagaimana cara mengonfigurasi Image Mesin Amazon (AMI) khusus untuk armada kapasitas cadangan?](#fleets.custom-ami)
+ [Keterbatasan armada kapasitas cadangan](#fleets.limitations)
+ [Properti armada kapasitas cadangan](fleets.reserved-capacity-fleets.md)
+ [Sampel kapasitas cadangan dengan AWS CodeBuild](reserved-capacity-samples.md)
## 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](https://console.aws.amazon.com/codesuite/codebuild/home).
1. Di panel navigasi, pilih Ar ** mada komputasi**, lalu pilih ** Buat Armada. **
1. Di bidang ** teks ** Komputasi nama armada, masukkan nama untuk armada Anda.
1. Dari menu ** drop-down Sistem ** operasi, pilih sistem operasi.
1. Dari menu ** drop-down ** Arsitektur, pilih arsitektur.
1. (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**.
1. (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](auth-and-access-control-iam-identity-based-access-control.md#customer-managed-policies-example-permission-policy-fleet-service-role).
+ 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](auth-and-access-control-iam-identity-based-access-control.md#customer-managed-policies-example-permission-policy-fleet-service-role).
1. 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.
1. Pilih ** Buat armada ** komputasi.
1. 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 Anda`computeType`, Anda dapat menentukan atribut di bidang baru yang disebut`computeConfiguration`. Atribut ini termasuk vCPU, memori, ruang disk, dan. `machineType` Ini `machineType` adalah salah satu `GENERAL` atau`NVME`. Setelah menentukan satu atau beberapa atribut yang tersedia, CodeBuild akan memilih tipe komputasi dari jenis instans yang didukung yang tersedia sebagai yang diselesaikan`computeConfiguration`.
**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](fleets.reserved-capacity-fleets.md#compute).
## 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](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/).
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](https://console.aws.amazon.com/codesuite/codebuild/home).
1. Di panel navigasi, pilih Ar ** mada komputasi**, lalu pilih ** Buat Armada. **
1. Di bidang ** teks ** Komputasi nama armada, masukkan nama untuk armada Anda.
1. Dari menu ** drop-down Sistem ** operasi, pilih ** macOS**.
1. 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. **
1. Di bidang ** teks ** Kapasitas, masukkan jumlah minimum instance dalam armada.
1. (Opsional) Untuk menggunakan gambar khusus untuk armada Anda, lihat [Bagaimana cara mengonfigurasi Image Mesin Amazon (AMI) khusus untuk armada kapasitas cadangan?](#fleets.custom-ami) untuk memastikan bahwa Amazon Machine Image (AMI) Anda memiliki prasyarat yang diperlukan.
1. (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](auth-and-access-control-iam-identity-based-access-control.md#customer-managed-policies-example-permission-policy-fleet-service-role).
1. Pilih ** Buat armada komput ** asi dan tunggu instans armada diluncurkan. Setelah diluncurkan kapasitasnya akan berada`{{n}}/{{n}}`, di {{n}} mana kapasitas yang disediakan.
1. 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](https://console.aws.amazon.com/codesuite/codebuild/home).
1. Di panel navigasi, pilih Ar ** mada komputasi**, lalu pilih ** Buat Armada. **
1. Di bidang ** teks ** Komputasi nama armada, masukkan nama untuk armada Anda.
1. Pilih Gambar ** kustom ** untuk armada Anda dan pastikan bahwa Amazon Machine Image (AMI) Anda memiliki prasyarat berikut:
+ Jika jenis lingkungan Anda adalah`MAC_ARM`, pastikan bahwa Arsit ** ektur AMI Anda ** adalah 64-bit`Mac-Arm`.
+ Jika jenis lingkungan Anda adalah`LINUX_EC2`, pastikan bahwa Arsit ** ektur AMI Anda ** adalah 64-bit`x86`.
+ Jika jenis lingkungan Anda adalah`ARM_EC2`, pastikan bahwa Arsit ** ektur AMI Anda ** adalah 64-bit`Arm`.
+ Jika jenis lingkungan Anda adalah`WINDOWS_EC2`, pastikan bahwa Arsit ** ektur AMI Anda ** adalah 64-bit`x86`.
+ AMI memungkinkan CodeBuild layanan ** Organisasi ARN**. Untuk daftar ARN Organisasi, lihat[Amazon Machine Images (AMI)](fleets.reserved-capacity-fleets.md#ami).
+ Jika AMI dienkripsi dengan AWS KMS kunci, AWS KMS kunci tersebut juga harus mengizinkan ID ** Organisasi CodeBuild layanan**. Untuk daftar ID Organisasi, lihat[Amazon Machine Images (AMI)](fleets.reserved-capacity-fleets.md#ami). Untuk informasi selengkapnya tentang AWS KMS kunci, lihat Mengiz [ inkan organisasi dan OU menggunakan kunci KMS ](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/share-amis-with-organizations-and-OUs.html#allow-org-ou-to-use-key) 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, lihat[Hitung armada](limits.md#fleet-limits).