Parameter lingkungan komputasi

Lingkungan komputasi dibagi menjadi beberapa komponen dasar: nama, jenis, dan status lingkungan komputasi, definisi sumber daya komputasi (jika lingkungan komputasi terkelola), konfigurasi Amazon EKS (jika menggunakan sumber daya Amazon EKS), peran layanan yang digunakan untuk memberikan izin IAM AWS Batch, dan tag untuk lingkungan komputasi.

Nama lingkungan komputasi

computeEnvironmentName

Nama untuk lingkungan komputasi Anda. Nama dapat memiliki panjang hingga 128 karakter. Nama dapat memuat huruf besar dan huruf kecil, angka, tanda hubung (-), dan garis bawah (_).

Tipe: String

Diperlukan: Ya

Tipe

type

Tipe lingkungan komputasi. Pilih MANAGED untuk AWS Batch mengelola sumber daya komputasi EC2 atau Fargate yang Anda tentukan. Untuk informasi selengkapnya, lihat Sumber daya komputasi. Pilih UNMANAGED untuk mengelola sumber daya komputasi EC2 Anda sendiri.

Tipe: String

Nilai yang valid: MANAGED | UNMANAGED

Wajib: Ya

Status

state

Status lingkungan komputasi.

Jika statusnyaENABLED, AWS Batch penjadwal mencoba menempatkan pekerjaan di lingkungan. Tugas ini berasal dari antrean tugas terkait pada sumber daya komputasi. Jika lingkungan komputasi dikelola, instans akan keluar atau masuk secara otomatis berdasarkan permintaan antrian pekerjaan.

Jika statusnyaDISABLED, AWS Batch penjadwal tidak mencoba menempatkan pekerjaan di lingkungan. Pekerjaan yang berada di RUNNING negara bagian STARTING atau terus berkembang secara normal. Lingkungan komputasi terkelola yang berada dalam DISABLED status tidak diskalakan.

catatan

Lingkungan komputasi dalam suatu DISABLED negara bagian mungkin terus dikenakan biaya penagihan. Untuk mencegah biaya tambahan, matikan lalu hapus lingkungan komputasi. Untuk informasi selengkapnya, lihat DeleteComputeEnvironmentdi Referensi AWS Batch API dan Menghindari tagihan tak terduga di Panduan AWS Billing Pengguna.

Ketika sebuah instance menganggur, instance menskalakan ke minvCpus nilainya. Namun, ukuran instance tidak berubah. Misalnya, pertimbangkan c5.8xlarge contoh dengan minvCpus nilai 4 dan desiredvCpus nilai36. Instance ini tidak menurunkan skala ke c5.large instance.

Tipe: String

Nilai yang valid: ENABLED | DISABLED

Wajib: Tidak

Sumber daya komputasi

computeResources

Detail sumber daya komputasi yang dikelola oleh lingkungan komputasi. Untuk informasi selengkapnya, lihat Lingkungan komputasi.

Tipe: Objek ComputeResource

Wajib: Parameter ini wajib untuk lingkungan komputasi terkelola

type

Tipe lingkungan komputasi. Anda dapat memilih untuk menggunakan Instans Sesuai Permintaan EC2 (EC2) dan Instans Spot EC2 (SPOT), atau menggunakan kapasitas Fargate (FARGATE) dan kapasitas Fargate Spot (FARGATE_SPOT) di lingkungan komputasi terkelola Anda. Jika Anda memilih SPOT, Anda juga harus menentukan peran Armada Spot Amazon EC2 dengan parameter spotIamFleetRole. Untuk informasi selengkapnya, lihat Peran armada spot Amazon EC2.

Nilai yang valid: EC2 | SPOT | FARGATE | FARGATE_SPOT

Wajib: Ya

allocationStrategy

Strategi alokasi yang akan digunakan untuk sumber daya komputasi jika tipe instans EC2 yang sesuai tidak cukup untuk dapat dialokasikan. Ini mungkin karena ketersediaan jenis instans di Wilayah AWS atau batas layanan Amazon EC2. Untuk informasi selengkapnya, lihat Strategi alokasi.

catatan

Parameter ini tidak berlaku untuk pekerjaan yang berjalan di sumber daya Fargate.

BEST_FIT (default)

AWS Batch memilih jenis instance yang paling sesuai dengan kebutuhan pekerjaan dengan preferensi untuk jenis instans biaya terendah. Jika instance tambahan dari jenis instans yang dipilih tidak tersedia, AWS Batch tunggu instance tambahan tersedia. Jika tidak ada cukup instans yang tersedia, atau jika Anda mencapai batas layanan Amazon EC2, pekerjaan tambahan tidak akan berjalan sampai pekerjaan yang sedang berjalan selesai. Strategi alokasi ini membuat biaya lebih rendah tetapi dapat membatasi penskalaan. Jika Anda menggunakan Armada SpotBEST_FIT, Peran IAM Armada Spot harus ditentukan. Sumber daya komputasi yang menggunakan strategi BEST_FIT alokasi tidak mendukung pembaruan infrastruktur dan tidak dapat memperbarui beberapa parameter. Untuk informasi selengkapnya, lihat Memperbarui lingkungan komputasi.

catatan

BEST_FITtidak didukung untuk lingkungan komputasi yang menggunakan sumber daya Amazon EKS.

BEST_FIT_PROGRESSIVE

Gunakan jenis instance tambahan yang cukup besar untuk memenuhi persyaratan pekerjaan dalam antrian. Lebih suka jenis instance dengan biaya lebih rendah untuk setiap unit vCPU. Jika instance tambahan dari jenis instans yang dipilih sebelumnya tidak tersedia, AWS Batch pilih jenis instans baru.

SPOT_CAPACITY_OPTIMIZED

(Hanya tersedia untuk sumber daya komputasi Instans Spot) Gunakan jenis instans tambahan yang cukup besar untuk memenuhi persyaratan pekerjaan dalam antrian. Lebih suka jenis instance yang cenderung tidak terganggu.

SPOT_PRICE_CAPACITY_OPTIMIZED

(Hanya tersedia untuk sumber daya komputasi Instans Spot) Strategi alokasi harga dan kapasitas yang dioptimalkan melihat harga dan kapasitas untuk memilih kumpulan Instans Spot yang paling kecil kemungkinannya untuk terganggu dan memiliki harga serendah mungkin.

catatan

Kami menyarankan Anda menggunakan SPOT_PRICE_CAPACITY_OPTIMIZED daripada SPOT_CAPACITY_OPTIMIZED dalam kebanyakan kasus.

DenganBEST_FIT_PROGRESSIVE,SPOT_CAPACITY_OPTIMIZED, dan SPOT_PRICE_CAPACITY_OPTIMIZED strategi menggunakan Instans Sesuai Permintaan atau Spot dan BEST_FIT strategi menggunakan Instans Spot, AWS Batch mungkin perlu melebihi maxvCpus untuk memenuhi persyaratan kapasitas Anda. Dalam hal ini, AWS Batch tidak pernah melebihi maxvCpus lebih dari satu contoh.

Nilai yang valid: BEST_FIT | BEST_FIT_PROGRESSIVE | SPOT_CAPACITY_OPTIMIZED | SPOT_PRICE_CAPACITY_OPTIMIZED

Wajib: Tidak

minvCpus

Jumlah minimum vCPU yang dipertahankan lingkungan bahkan jika lingkungan komputasi. DISABLED

catatan

Parameter ini tidak berlaku untuk pekerjaan yang berjalan di sumber daya Fargate.

Tipe: Integer

Wajib: Tidak

maxvCpus

Jumlah maksimum vCPU yang dapat didukung oleh AWS Batch lingkungan komputasi.

catatan

DenganBEST_FIT_PROGRESSIVE,SPOT_CAPACITY_OPTIMIZED, dan strategi SPOT_PRICE_CAPACITY_OPTIMIZED alokasi menggunakan Instans Sesuai Permintaan atau Spot dan BEST_FIT strategi menggunakan Instans Spot, AWS Batch mungkin perlu melebihi maxvCpus untuk memenuhi persyaratan kapasitas Anda. Dalam hal ini, AWS Batch tidak pernah melebihi maxvCpus lebih dari satu contoh. Misalnya, AWS Batch menggunakan tidak lebih dari satu instance dari antara yang ditentukan dalam lingkungan komputasi Anda.

Tipe: Integer

Wajib: Tidak

desiredvCpus

Jumlah vCPU yang diinginkan di lingkungan komputasi. AWS Batch memodifikasi nilai ini antara nilai minimum dan maksimum berdasarkan permintaan antrian pekerjaan.

catatan

Parameter ini tidak berlaku untuk pekerjaan yang berjalan di sumber daya Fargate.

Tipe: Integer

Wajib: Tidak

instanceTypes

Tipe instans yang dapat diluncurkan. Parameter ini tidak berlaku untuk pekerjaan yang berjalan di sumber daya Fargate. Jangan tentukan itu. Anda dapat menentukan keluarga instans untuk meluncurkan tipe instans apa pun dalam keluarga tersebut (misalnya, c5, c5n, atau p3). Selain itu, Anda dapat menentukan ukuran tertentu dalam suatu keluarga (seperti c5.8xlarge). Perhatikan bahwa tipe instans metal tidak tercakup dalam keluarga instans (misalnya c5 tidak meliputi c5.metal.) Anda juga dapat memilih optimal untuk memilih tipe instans (dari keluarga instans C4, M4, dan R4) yang sesuai dengan permintaan antrean tugas Anda.

catatan

Ketika Anda membuat lingkungan komputasi, tipe instans yang Anda pilih untuk lingkungan komputasi harus berbagi arsitektur yang sama. Misalnya, Anda tidak dapat mencampur instans x86 dan ARM di lingkungan komputasi yang sama.

catatan

Saat ini, optimal menggunakan tipe instans dari keluarga instans C4, M4, dan R4. Dalam Wilayah AWS hal itu tidak memiliki tipe instance dari keluarga instance tersebut, tipe instance dari keluarga instans C5, M5, dan R5 digunakan.

Tipe: Array string

Wajib: ya

imageId

Parameter ini sudah usang.

ID Amazon Machine Image (AMI) digunakan untuk instans yang diluncurkan di lingkungan komputasi. Parameter ini diganti oleh anggota imageIdOverride dari struktur Ec2Configuration.

catatan

Parameter ini tidak berlaku untuk pekerjaan yang berjalan di sumber daya Fargate.

catatan

AMI yang Anda pilih untuk lingkungan komputasi harus cocok dengan arsitektur tipe instance yang ingin Anda gunakan untuk lingkungan komputasi tersebut. Misalnya, jika lingkungan komputasi Anda menggunakan tipe A1 instans, AMI sumber daya komputasi yang Anda pilih harus mendukung Arm instance. Amazon ECS menjual keduanya x86 dan Arm versi Amazon ECS yang dioptimalkan Amazon Linux 2 AMI. Untuk informasi lebih lanjut, lihat AMI Amazon Linux 2 yang dioptimalkan untuk Amazon ECS dalam Panduan Developer Amazon Elastic Container Service.

Tipe: String

Wajib: Tidak

subnets

Subnet VPC yang menjadi tujuan peluncuran sumber daya komputasi. Subnet ini harus berada dalam VPC yang sama. Sumber daya komputasi Fargate dapat berisi maksimum 16 subnet. Untuk informasi lebih lanjut, lihat VPC dan Subnet dalam Panduan Pengguna Amazon VPC.

catatan

AWS Batch di Amazon EC2 dan di AWS Batch Amazon EKS mendukung Local Zones. Untuk informasi selengkapnya, lihat Local Zones di Panduan Pengguna Amazon EC2, Amazon EKS, dan AWS Local Zones di Panduan Pengguna Amazon EKS dan cluster Amazon ECS di Local Zones, Wavelength Zones, dan AWS Outposts di Panduan Pengembang Layanan Kontainer Elastis Amazon.

AWS Batch di Fargate saat ini tidak mendukung Local Zones.

Saat memperbarui lingkungan komputasi, jika Anda memberikan daftar kosong subnet VPC, perilaku yang dihasilkan berbeda antara sumber daya komputasi Fargate dan EC2. Untuk sumber daya komputasi Fargate, menyediakan daftar kosong ditangani seolah-olah parameter ini tidak ditentukan dan tidak ada perubahan yang dibuat. Untuk sumber daya komputasi EC2, menyediakan daftar kosong akan menghapus subnet VPC dari sumber daya komputasi. Jika Anda mengubah subnet VPC, pembaruan infrastruktur lingkungan komputasi diperlukan. Ini adalah kasus untuk sumber daya komputasi Fargate dan EC2. Untuk informasi selengkapnya, lihat Memperbarui lingkungan komputasi.

Tipe: Array string

Wajib: Ya

securityGroupIds

Grup keamanan Amazon EC2 yang terkait dengan instans yang diluncurkan di lingkungan komputasi. Satu atau beberapa grup keamanan harus ditentukan, baik di securityGroupIds atau menggunakan templat peluncuran yang direferensikan di launchTemplate. Parameter ini diperlukan untuk pekerjaan yang berjalan pada sumber daya Fargate dan harus berisi setidaknya satu grup keamanan. (Fargate tidak mendukung templat peluncuran.) Jika grup keamanan ditentukan menggunakan securityGroupIds dan launchTemplate, nilai di securityGroupIds akan digunakan.

Saat memperbarui lingkungan komputasi, jika Anda memberikan daftar kosong grup keamanan, perilaku yang dihasilkan berbeda antara sumber daya komputasi Fargate dan EC2. Untuk sumber daya komputasi Fargate, menyediakan daftar kosong ditangani seolah-olah parameter ini tidak ditentukan dan tidak ada perubahan yang dibuat. Untuk sumber daya komputasi EC2, menyediakan daftar kosong akan menghapus grup keamanan dari sumber daya komputasi. Jika Anda mengubah grup keamanan, pembaruan infrastruktur lingkungan komputasi diperlukan. Ini adalah kasus untuk sumber daya komputasi Fargate dan EC2. Untuk informasi selengkapnya, lihat Memperbarui lingkungan komputasi.

Tipe: Array string

Wajib: Ya

ec2KeyPair

Pasangan kunci EC2 yang digunakan untuk instans yang diluncurkan di lingkungan komputasi. Anda dapat menggunakan pasangan kunci ini untuk masuk ke instans Anda dengan SSH. Saat memperbarui lingkungan komputasi, jika Anda mengubah key pair EC2, pembaruan infrastruktur lingkungan komputasi diperlukan. Untuk informasi selengkapnya, lihat Memperbarui lingkungan komputasi.

catatan

Parameter ini tidak berlaku untuk pekerjaan yang berjalan di sumber daya Fargate.

Tipe: String

Wajib: Tidak

instanceRole

Profil instans Amazon ECS untuk dilampirkan ke instans Amazon EC2 dalam lingkungan komputasi. Parameter ini tidak berlaku untuk pekerjaan yang berjalan di sumber daya Fargate. Jangan tentukan itu. Anda dapat menentukan nama pendek atau lengkap Amazon Resource Name (ARN) untuk profil instans. Misalnya, ecsInstanceRole atau arn:aws:iam::aws_account_id:instance-profile/ecsInstanceRole. Untuk informasi selengkapnya, lihat Peran instans Amazon ECS.

Saat memperbarui lingkungan komputasi, jika Anda mengubah setelan ini, pembaruan infrastruktur lingkungan komputasi diperlukan. Untuk informasi selengkapnya, lihat Memperbarui lingkungan komputasi.

Tipe: String

Wajib: Tidak

tags

Tanda pasangan kunci-nilai untuk diterapkan ke instans EC2 yang diluncurkan di lingkungan komputasi. Misalnya, Anda dapat menentukan "Name": "AWS Batch Instance - C4OnDemand" sebagai tanda agar setiap instans di lingkungan komputasi Anda memiliki nama tersebut. Ini berguna untuk mengenali AWS Batch instans Anda di konsol Amazon EC2. Tag ini tidak terlihat saat menggunakan operasi AWS BatchListTagsForResourceAPI.

Saat memperbarui lingkungan komputasi, jika Anda mengubah tag EC2, pembaruan infrastruktur lingkungan komputasi diperlukan. Untuk informasi selengkapnya, lihat Memperbarui lingkungan komputasi.

catatan

Parameter ini tidak berlaku untuk pekerjaan yang berjalan di sumber daya Fargate.

Tipe: Peta antar string

Wajib: Tidak

placementGroup

Grup penempatan Amazon EC2 yang akan dikaitkan dengan sumber daya komputasi Anda. Parameter ini tidak berlaku untuk pekerjaan yang berjalan di sumber daya Fargate. Jangan tentukan itu. Jika Anda ingin mengirimkan pekerjaan paralel multi-node ke lingkungan komputasi Anda, pertimbangkan untuk membuat grup penempatan klaster dan mengaitkannya dengan sumber daya komputasi Anda. Hal ini membuat pekerjaan paralel multi-simpul Anda pada pengelompokan logis instans dalam Availability Zone tunggal dengan potensi aliran jaringan tinggi. Untuk informasi lebih lanjut, lihat Grup Penempatan di Panduan Pengguna Amazon EC2 untuk Instans Linux.

catatan

Parameter ini tidak berlaku untuk pekerjaan yang berjalan di sumber daya Fargate.

Tipe: String

Wajib: Tidak

bidPercentage

Persentase maksimum yang dapat dicapai harga Instans Spot EC2 saat dibandingkan dengan harga Sesuai Permintaan untuk tipe instans tersebut sebelum instans diluncurkan. Misalnya, jika persentase maksimum Anda adalah 20%, harga Spot harus kurang dari 20% dari harga On-Demand saat ini untuk instans EC2 tersebut. Anda selalu membayar harga terendah (pasar) dan tidak pernah lebih dari persentase maksimum Anda. Jika Anda membiarkan bidang ini kosong, nilai default adalah 100% dari harga Sesuai Permintaan. Untuk sebagian besar kasus penggunaan, sebaiknya biarkan bidang ini kosong.

Saat memperbarui lingkungan komputasi, jika Anda mengubah persentase tawaran, pembaruan infrastruktur lingkungan komputasi diperlukan. Untuk informasi selengkapnya, lihat Memperbarui lingkungan komputasi.

catatan

Parameter ini tidak berlaku untuk pekerjaan yang berjalan di sumber daya Fargate.

Wajib: Tidak

spotIamFleetRole

Amazon Resource Name (ARN) dari IAM role Armada Spot Amazon EC2 diterapkan ke lingkungan komputasi SPOT. Peran ini wajib jika strategi alokasi diatur ke BEST_FIT atau jika strategi alokasi tidak ditentukan. Untuk informasi selengkapnya, lihat Peran armada spot Amazon EC2.

catatan

Parameter ini tidak berlaku untuk pekerjaan yang berjalan di sumber daya Fargate.

penting

Untuk menandai Instans Spot Anda saat pembuatan, peran IAM Armada Spot yang ditentukan di sini harus menggunakan kebijakan terkelola SpotFleetTaggingRoleAmazonEC2 yang lebih baru. Kebijakan terkelola SpotFleetPeran Amazonec2 yang direkomendasikan sebelumnya tidak memiliki izin yang diperlukan untuk menandai Instans Spot. Untuk informasi selengkapnya, lihat Instans Spot tidak ditandai pada pembuatan.

Tipe: String

Wajib: Parameter ini wajib untuk lingkungan komputasi SPOT.

launchTemplate

Templat peluncuran opsional untuk dikaitkan dengan sumber daya komputasi Anda. Parameter ini tidak berlaku untuk pekerjaan yang berjalan di sumber daya Fargate. Jangan tentukan itu. Parameter sumber daya komputasi lainnya yang Anda tentukan dalam operasi CreateComputeEnvironmentatau UpdateComputeEnvironmentAPI akan menimpa parameter yang sama dalam template peluncuran. Untuk menggunakan templat peluncuran, Anda harus menentukan ID templat peluncuran atau nama templat peluncuran dalam permintaan, tetapi tidak keduanya. Untuk informasi selengkapnya, lihat Luncurkan dukungan templat.

Saat memperbarui lingkungan komputasi, untuk menghapus templat peluncuran kustom dan menggunakan templat peluncuran default, atur launchTemplateId atau launchTemplateName anggota spesifikasi templat peluncuran ke string kosong. Menghapus template peluncuran dari lingkungan komputasi tidak menghapus AMI yang ditentukan dalam template peluncuran, jika itu yang digunakan. Untuk memperbarui AMI yang dipilih dari template peluncuran, updateToLatestImageVersion parameter harus disetel ketrue. Saat memperbarui lingkungan komputasi, jika Anda mengubah template peluncuran, pembaruan infrastruktur lingkungan komputasi diperlukan. Untuk informasi selengkapnya, lihat Memperbarui lingkungan komputasi.

Tipe: LaunchTemplateSpecification

object

Wajib: Tidak

launchTemplateId

ID templat peluncuran.

Tipe: String

Wajib: Tidak

launchTemplateName

Nama templat peluncuran.

Tipe: String

Wajib: Tidak

version

Nomor versi templat peluncuran, $Latest, atau $Default.

Jika nilainya $Latest, versi terbaru dari templat peluncuran yang digunakan. Jika nilainya $Default, versi default dari templat peluncuran yang digunakan. Selama pembaruan infrastruktur, jika salah satu $Latest atau $Default ditentukan untuk lingkungan komputasi, AWS Batch evaluasi ulang versi template peluncuran dan mungkin menggunakan versi template peluncuran yang berbeda. Ini bahkan jika template peluncuran tidak ditentukan dalam pembaruan.

Default: $Default.

Tipe: String

Wajib: Tidak

ec2Configuration

Memberikan informasi yang digunakan untuk memilih Amazon Machine Images (AMI) untuk instans di lingkungan komputasi EC2. Jika Ec2Configuration tidak ditentukan, defaultnya adalah Amazon Linux 2 (ECS_AL2). Sebelum 31 Maret 2021, default ini adalah Amazon Linux (ECS_AL1) untuk instans non-GPU, non AWS Graviton.

Saat memperbarui lingkungan komputasi, jika Anda mengubah parameter ini, pembaruan infrastruktur lingkungan komputasi diperlukan. Untuk informasi selengkapnya, lihat Memperbarui lingkungan komputasi.

catatan

Parameter ini tidak berlaku untuk pekerjaan yang berjalan di sumber daya Fargate.

Tipe: Array objek Ec2Configuration

Wajib: Tidak

imageIdOverride

ID AMI yang digunakan untuk instance yang diluncurkan di lingkungan komputasi yang cocok dengan jenis gambar. Pengaturan ini akan menggantikan imageId yang diatur dalam objek computeResource.

Tipe: String

Wajib: Tidak

imageKubernetesVersion

KubernetesVersi untuk lingkungan komputasi. Jika Anda tidak menentukan nilai, versi terbaru yang AWS Batch mendukung akan digunakan.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.

Wajib: Tidak

imageType

Jenis citra untuk dicocokkan dengan tipe instans untuk memilih AMI. Nilai yang didukung berbeda untuk ECS dan EKS sumber daya.

ECS

Jika imageIdOverride parameter tidak ditentukan, maka Amazon Linux 2 AMI (ECS_AL2) yang dioptimalkan Amazon ECS terbaru akan digunakan. Jika jenis gambar baru ditentukan dalam pembaruan, tetapi tidak ada parameter imageId atau imageIdOverride parameter yang ditentukan, maka Amazon ECS terbaru yang dioptimalkan AMI untuk jenis gambar yang didukung oleh AWS Batch digunakan.

ECS_AL2

Amazon Linux 2: Default untuk semua keluarga instans non-GPU.

ECS_AL2_NVIDIA

Amazon Linux 2 (GPU): Default untuk semua keluarga instans GPU (misalnya P4 danG4) dan dapat digunakan untuk semua jenis instans berbasis AWS Graviton.

ECS_AL1

Amazon Linux. Amazon Linux telah mencapai dukungan standar. end-of-life Untuk informasi lebih lanjut, lihat Amazon Linux AMI.

EKS

Jika imageIdOverride parameter tidak ditentukan, maka Amazon Linux AMI (EKS_AL2) yang dioptimalkan Amazon EKS terbaru akan digunakan. Jika jenis gambar baru ditentukan dalam pembaruan, tetapi tidak ada parameter imageId atau imageIdOverride parameter yang ditentukan, maka Amazon EKS terbaru yang dioptimalkan AMI untuk jenis gambar yang AWS Batch mendukung digunakan.

EKS_AL2

Amazon Linux 2: Default untuk semua keluarga instans non-GPU.

EKS_AL2_NVIDIA

Amazon Linux 2 (dipercepat): Default untuk semua keluarga instans GPU (misalnya, P4 danG4) dan dapat digunakan untuk semua jenis instans AWS berbasis Graviton.

Jenis: String

Batasan Panjang: Panjang minimum 1. Panjang maksimum 256.

Wajib: Ya

Konfigurasi Amazon EKS

Konfigurasi untuk klaster Amazon EKS yang mendukung lingkungan AWS Batch komputasi. Cluster harus ada sebelum lingkungan komputasi dapat dibuat.

eksClusterArn

Nama Sumber Daya Amazon (ARN) dari cluster Amazon EKS. Contohnya adalah arn:aws:eks:us-east-1:123456789012:cluster/ClusterForBatch.

Tipe: String

Diperlukan: Ya

kubernetesNamespace

Namespace dari cluster Amazon EKS. AWS Batch mengelola pod di namespace ini. Nilai tidak dapat dibiarkan kosong atau null. Panjangnya harus kurang dari 64 karakter, tidak dapat diatur kedefault, tidak dapat dimulai dengan “kube-,” dan harus cocok dengan ekspresi reguler ini:^[a-z0-9]([-a-z0-9]*[a-z0-9])?$. Untuk informasi selengkapnya, lihat Ruang nama dalam dokumentasi. Kubernetes

Tipe: String

Diperlukan: Ya

Jenis: EksConfigurationObjek

Wajib: Tidak

Peran layanan

serviceRole

Nama Sumber Daya Amazon (ARN) lengkap dari peran IAM yang memungkinkan AWS Batch untuk melakukan panggilan ke AWS layanan lain atas nama Anda. Untuk informasi selengkapnya, lihat Menggunakan peran terkait layanan untuk AWS Batch. Kami menyarankan agar Anda tidak menentukan peran layanan. Dengan cara ini, AWS Batch menggunakan peran AWSServiceRoleForBatchterkait layanan.

penting

Jika akun Anda telah membuat peran AWS Batch terkait layanan (AWSServiceRoleForBatch), peran tersebut akan digunakan secara default untuk lingkungan komputasi kecuali Anda menentukan peran di sini. Jika peran AWS Batch terkait layanan tidak ada di akun Anda, dan tidak ada peran yang ditentukan di sini, layanan akan mencoba membuat peran AWS Batch terkait layanan di akun Anda. Untuk informasi selengkapnya tentang peran AWSServiceRoleForBatchterkait layanan, lihat. Izin peran terkait layanan untuk AWS Batch

Jika lingkungan komputasi dibuat menggunakan peran AWSServiceRoleForBatchterkait layanan, itu tidak dapat diubah untuk menggunakan peran IAM biasa. Demikian juga, jika lingkungan komputasi dibuat dengan peran IAM biasa, itu tidak dapat diubah untuk menggunakan peran terkait AWSServiceRoleForBatchlayanan. Untuk memperbarui parameter lingkungan komputasi yang memerlukan pembaruan infrastruktur untuk berubah, peran AWSServiceRoleForBatchterkait layanan harus digunakan. Untuk informasi selengkapnya, lihat Memperbarui lingkungan komputasi.

Jika peran yang Anda tentukan memiliki jalur selain/, pastikan untuk menentukan ARN peran lengkap (disarankan) atau awalan nama peran dengan jalur tersebut.

catatan

Bergantung pada cara Anda membuat peran AWS Batch layanan, Nama Sumber Daya Amazon (ARN) mungkin berisi awalan service-role jalur. Jika Anda hanya menentukan nama peran layanan, AWS Batch asumsikan bahwa ARN Anda tidak menggunakan awalan jalurservice-role. Karena itu, kami sarankan Anda menentukan ARN lengkap dari peran layanan Anda ketika membuat lingkungan komputasi.

Tipe: String

Wajib: Tidak

Tanda

tags

Tanda pasangan kunci-nilai untuk dikaitkan dengan lingkungan komputasi. Untuk informasi selengkapnya, lihat Menandai sumber daya AWS Batch Anda.

Tipe: Peta antar string

Wajib: Tidak