eb create - AWS Elastic Beanstalk
DeskripsiSintaksOpsiOutputContoh

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

eb create

Deskripsi

Membuat lingkungan baru dan men-deploy versi aplikasi Anda ke lingkungan baru.

catatan

  • Untuk menggunakan eb create di aplikasi .NET, Anda harus membuat paket deployment seperti yang dijelaskan di Membuat bundel sumber untuk aplikasi NET, kemudian mengatur konfigurasi CLI untuk men-deploy paket sebagai Artifact seperti yang dijelaskan di Men-deploy artifact bukan folder proyek.

  • Membuat lingkungan dengan EB CLI memerlukan peran layanan. Peran layanan dapat dibuat dengan membuat lingkungan di konsol Elastic Beanstalk. Jika Anda tidak memiliki peran layanan, EB CLI mencoba membuatnya saat Anda menjalankan eb create.

Anda dapat men-deploy versi aplikasi dari beberapa sumber:

  • Secara default: Dari kode sumber aplikasi di direktori proyek lokal.

  • Menggunakan opsi --version: Dari versi aplikasi yang sudah ada di aplikasi Anda.

  • Ketika direktori proyek Anda tidak memiliki kode aplikasi, atau ketika menggunakan opsi --sample: Di-deploy dari aplikasi sampel, khusus untuk platform lingkungan Anda.

Sintaks

eb create

eb create environment-name

Nama lingkungan harus antara 4 dan 40 karakter panjangnya. Hanya dapat berisi huruf, angka, dan tanda hubung (-). Nama lingkungan tidak dapat dimulai atau diakhiri dengan tanda hubung.

Jika Anda menyertakan nama lingkungan di perintah, EB CLI tidak meminta Anda untuk membuat pilihan atau membuat peran layanan.

Jika Anda menjalankan perintah tanpa argumen nama lingkungan, ini berjalan di aliran interaktif, dan meminta Anda untuk memasukkan atau memilih nilai untuk beberapa pengaturan. Di aliran interaktif ini, dalam kasus Anda men-deploy aplikasi sampel, EB CLI juga meminta Anda jika Anda ingin mengunduh aplikasi sampel ini ke direktori proyek lokal Anda. Dengan mengunduhnya, Anda dapat menggunakan EB CLI dengan lingkungan baru nanti untuk menjalankan operasi yang memerlukan kode aplikasi, seperti eb deploy.

Beberapa prompt aliran interaktif ditampilkan hanya dalam syarat tertentu. Misalnya, jika Anda memilih untuk menggunakan Application Load Balancer, dan akun Anda memiliki setidaknya satu Application Load Balancer yang dapat dibagikan, Elastic Beanstalk menampilkan prompt yang menanyakan apakah Anda ingin menggunakan penyeimbang beban bersama. Jika tidak ada Application Load Balancer yang dapat dibagikan di akun Anda, prompt ini tidak ditampilkan.

Opsi

Tak satu pun dari opsi ini diperlukan. Jika Anda menjalankan eb create tanpa opsi apa pun, EB CLI meminta Anda untuk memasukkan atau memilih nilai untuk setiap pengaturan.

Nama

Deskripsi

-d

atau

--branch_default

Atur lingkungan sebagai lingkungan default untuk repositori saat ini.

--cfg config-name

Gunakan pengaturan platform dari konfigurasi tersimpan di .elasticbeanstalk/saved_configs/ atau bucket Amazon S3. Tentukan hanya nama file, tanpa ekstensi .cfg.yml.

-c subdomain-name

atau

--cname subdomain-name

Nama subdomain untuk prefiks entri CNAME DNS yang merutekan ke situs web Anda.

Tipe: String

Default: Nama lingkungan

-db

atau

--database

Lampirkan basis data untuk lingkungan. Jika Anda menjalankan eb create dengan opsi --database, tapi tanpa opsi --database.username dan --database.password, EB CLI meminta Anda untuk nama pengguna utama basis data dan kata sandi.

-db.engine engine

atau

--database.engine engine

Tipe mesin basis data. Jika Anda menjalankan eb create dengan opsi ini, maka EB CLI meluncurkan lingkungan dengan basis data yang dilampirkan. Hal ini terjadi bahkan jika Anda tidak menjalankan perintah dengan opsi --database.

Tipe: String

Nilai valid: mysql, oracle-se1, postgres, sqlserver-ex, sqlserver-web, sqlserver-se

-db.i instance_type

atau

--database.instance instance_type

Jenis EC2 instans Amazon yang digunakan untuk database. Jika Anda menjalankan eb create dengan opsi ini, maka EB CLI meluncurkan lingkungan dengan basis data yang dilampirkan. Hal ini terjadi bahkan jika Anda tidak menjalankan perintah dengan opsi --database.

Tipe: String

Nilai valid:

Amazon RDS mendukung seperangkat instans DB standar. Untuk memilih instans DB yang sesuai untuk mesin DB Anda, Anda harus mempertimbangkan beberapa pertimbangan khusus. Untuk informasi selengkapnya, lihat kelas instans DB di Panduan Pengguna Amazon RDS.

-db.pass password

atau

--database.password password

Kata sandi untuk basis data. Jika Anda menjalankan eb create dengan opsi ini, maka EB CLI meluncurkan lingkungan dengan basis data yang dilampirkan. Hal ini terjadi bahkan jika Anda tidak menjalankan perintah dengan opsi --database.

-db.size number_of_gigabytes

atau

--database.size number_of_gigabytes

Jumlah gigabita (GB) untuk mengalokasikan untuk penyimpanan basis data. Jika Anda menjalankan eb create dengan opsi ini, maka EB CLI meluncurkan lingkungan dengan basis data yang dilampirkan. Hal ini terjadi bahkan jika Anda tidak menjalankan perintah dengan opsi --database.

Tipe: Angka

Nilai valid:

  • MySQL – 5 ke 1024. Default-nya adalah 5.

  • Postgres – 5 ke 1024. Default-nya adalah 5.

  • Oracle – 10 ke 1024. Default-nya adalah 10.

  • Microsoft SQL Server Express Edition – 30.

  • Microsoft SQL Server Web Edition – 30.

  • Microsoft SQL Server Standard Edition – 200.

-db.user username

atau

--database.username username

Nama pengguna untuk basis data. Jika Anda menjalankan eb create dengan opsi ini, maka EB CLI meluncurkan lingkungan dengan basis data terlampir meskipun Anda tidak menjalankan perintah dengan opsi --database. Jika Anda menjalankan eb create dengan opsi --database, tapi tanpa opsi --database.username dan --database.password, kemudian EB CLI meminta Anda untuk nama pengguna basis data utama dan kata sandi.

-db.version version

atau

--database.version version

Digunakan untuk menentukan versi mesin basis data. Jika bendera ini hadir, lingkungan akan meluncurkan dengan basis data dengan nomor versi tertentu, bahkan jika bendera --database tidak ada.

--elb-type type

tipe penyeimbang beban.

Tipe: String

Nilai valid: classic, application, network

Default: application

-es

atau

--enable-spot

Aktifkan permintaan Instans Spot untuk lingkungan Anda. Untuk informasi selengkapnya, lihat Grup Auto Scaling.

Tindakan terkait:

  • --instance-types

  • --on-demand-base-capacity

  • --on-demand-above-base-capacity

  • --spot-max-price
--env-group-suffix groupname Nama grup untuk menambahkan nama lingkungan. Hanya untuk digunakan dengan Penyusunan Lingkungan.

--envvars

Properti lingkungan dalam daftar yang dipisahkan koma dengan format name =. value Lihat Mengkonfigurasi properti lingkungan (variabel lingkungan) untuk batas.

-ip profile_name

atau

--instance_profile profile_name

Profil instans dengan peran IAM dengan kredenal keamanan sementara yang dibutuhkan aplikasi Anda untuk mengakses sumber daya. AWS

-it

atau

--instance-types type1[,type2 ...]

Daftar tipe EC2 instans Amazon yang dipisahkan koma yang Anda inginkan untuk digunakan oleh lingkungan Anda. Jika Anda tidak menentukan opsi ini, Elastic Beanstalk menyediakan tipe instans default.

Untuk informasi selengkapnya, lihat EC2 Contoh Amazon dan Grup Auto Scaling.

penting

EB CLI hanya memberlakukan opsi ini untuk Instans Spot. Kecuali opsi ini digunakan dengan opsi --enable-spot, EB CLI mengabaikan itu. Untuk menentukan tipe instans untuk Instans Sesuai Permintaan, gunakan opsi --intance-type (tanpa "s") sebagai gantinya.

-i

atau

--instance_type

Jenis EC2 instans Amazon yang Anda inginkan untuk digunakan oleh lingkungan Anda. Jika Anda tidak menentukan opsi ini, Elastic Beanstalk menyediakan tipe instans default.

Untuk informasi selengkapnya, lihat EC2 Contoh Amazon.

penting

EB CLI hanya memberlakukan opsi ini untuk Instans Sesuai Permintaan. Jangan gunakan opsi ini dengan opsi --enable-spot, karena EB CLI mengabaikannya ketika Anda melakukannya. Untuk menentukan tipe instans untuk Instans Spot, gunakan opsi --intance-types (tanpa "s") sebagai gantinya.

-k key_name

atau

--keyname key_name

Nama EC2 key pair Amazon untuk digunakan dengan klien Secure Shell (SSH) untuk masuk dengan aman ke EC2 instans Amazon yang menjalankan aplikasi Elastic Beanstalk Anda. Jika Anda menyertakan opsi ini dengan perintah eb create, nilai yang Anda berikan menimpa setiap nama kunci yang mungkin telah Anda ditentukan dengan eb init.

Nilai yang valid: Nama kunci yang sudah ada yang terdaftar di Amazon EC2

-im number-of-instances

atau

--min-instances number-of-instances

Jumlah minimum EC2 instance Amazon yang Anda butuhkan untuk dimiliki lingkungan Anda.

Tipe: Nomor (bilangan bulat)

Default: 1

Nilai valid: 1 hingga 10000

-ix number-of-instances

atau

--max-instances number-of-instances

Jumlah maksimum EC2 instans Amazon yang Anda izinkan untuk dimiliki lingkungan Anda.

Tipe: Nomor (bilangan bulat)

Default: 4

Nilai valid: 1 hingga 10000

--modules component-a component-b

 Daftar lingkungan komponen untuk membuat. Hanya untuk digunakan dengan Penyusunan Lingkungan.

-sb

atau

--on-demand-base-capacity

Jumlah minimum Instans Sesuai Permintaan yang disediakan grup Auto Scaling Anda sebelum mempertimbangkan Instans Spot saat lingkungan Anda menaikkan skala.

Opsi ini hanya dapat ditentukan dengan opsi --enable-spot. Untuk informasi selengkapnya, lihat Grup Auto Scaling.

Tipe: Nomor (bilangan bulat)

Default: 0

Nilai valid: 0 hingga --max-instances (ketika tidak ada: opsi MaxSize di namespace aws:autoscaling:asg)

-sp

atau

--on-demand-above-base-capacity

Persentase Instans Sesuai Permintaan sebagai bagian dari kapasitas tambahan yang disediakan grup Auto Scaling lebih dari jumlah instans yang ditentukan oleh opsi --on-demand-base-capacity.

Opsi ini hanya dapat ditentukan dengan opsi --enable-spot. Untuk detail selengkapnya, lihat Grup Auto Scaling.

Tipe: Nomor (bilangan bulat)

Default: 0 untuk lingkungan instans tunggal; 70 untuk lingkungan yang seimbang beban

Nilai valid: 0 hingga 100

-p platform-version

atau

--platform platform-version

Versi platform untuk digunakan. Anda dapat menentukan platform, platform dan versi, cabang platform, nama tumpukan solusi, atau solusi tumpukan ARN. Sebagai contoh:

  • php, PHP, node.js – Versi platform terbaru untuk platform yang ditentukan

  • php-7.2, "PHP 7.2" – Versi platform PHP 7.2 yang direkomendasikan (biasanya terbaru)

  • "PHP 7.2 running on 64bit Amazon Linux" – Versi platform PHP yang direkomendasikan (biasanya terbaru) di cabang platform ini

  • "64bit Amazon Linux 2017.09 v2.6.3 running PHP 7.1" – Versi platform PHP yang ditentukan oleh nama tumpukan solusi ini

  • "arn:aws:elasticbeanstalk:us-east-2::platform/PHP 7.1 running on 64bit Amazon Linux/2.6.3" – Versi platform PHP yang ditentukan oleh tumpukan solusi ARN ini

Gunakan eb platform list untuk mendapatkan daftar konfigurasi yang tersedia.

Jika Anda menentukan opsi --platform, opsi ini menimpa nilai yang diberikan selama eb init.

-pr

atau

--process

Pra-pemrosesan dan validasi manifes lingkungan dan file konfigurasi di paket sumber. Memvalidasi file konfigurasi dapat mengidentifikasi masalah sebelum men-deploy versi aplikasi ke lingkungan.

-r region

atau

--region region

AWS Wilayah tempat Anda ingin menyebarkan aplikasi.

Untuk daftar nilai yang dapat Anda tentukan untuk opsi ini, lihat AWS Elastic Beanstalk Titik akhir dan Kuota di. Referensi Umum AWS

--sample

Deploy aplikasi sampel ke lingkungan baru bukan ke kode di repositori Anda.

--scale number-of-instances

Meluncurkan dengan jumlah instans yang ditentukan
--service-role servicerole Tetapkan peran layanan non-default ke lingkungan.
catatan

Jangan masukkan ARN. Hanya masukkan nama peran. Elastic Beanstalk mengawali nama peran dengan nilai yang benar untuk membuat ARN yang dihasilkan secara internal.

-ls load-balancer

atau

--shared-lb load-balancer

Konfigurasikan lingkungan untuk menggunakan penyeimbang beban bersama. Berikan nama atau ARN dari penyeimbang beban yang dapat dibagikan di akun Anda—Application Load Balancer yang secara eksplisit Anda buat, bukan yang dibuat oleh lingkungan Elastic Beanstalk lainnya. Untuk informasi selengkapnya, lihat Application Load Balancer Bersama.

Contoh parameter:

  • FrontEndLB – Nama penyeimbang beban.

  • arn:aws:elasticloadbalancing:us-east-2:123456789012:loadbalancer/app/FrontEndLB/0dbf78d8ad96abbc – Application Load Balancer ARN.

Anda dapat menentukan opsi ini hanya dengan --elb-type application. Jika Anda menentukan opsi tersebut dan tidak menentukan --shared-lb, Elastic Beanstalk membuat penyeimbang beban khusus untuk lingkungan.

-lp port

atau

--shared-lb-port port

Port listener default penyeimbang beban bersama untuk lingkungan ini. Elastic Beanstalk menambahkan aturan listener yang merutekan semua lalu lintas dari listener ini ke proses default lingkungan. Untuk informasi selengkapnya, lihat Application Load Balancer Bersama.

Tipe: Nomor (bilangan bulat)

Default: 80

Nilai valid: Setiap bilangan bulat yang mewakili port listener dari penyeimbang beban bersama.

--single

Buat lingkungan dengan satu EC2 instans Amazon dan tanpa penyeimbang beban.

Awas

Lingkungan instans tunggal tidak siap produksi. Jika instans menjadi tidak stabil selama deployment, atau Elastic Beanstalk berakhir dan mengulang kembali instans selama pembaruan konfigurasi, aplikasi Anda dapat tidak tersedia untuk jangka waktu tertentu. Gunakan lingkungan instans tunggal untuk pengembangan, pengujian, atau pementasan. Gunakan lingkungan seimbang beban untuk produksi.

-sm

atau

--spot-max-price

Harga maksimum per unit jam, dalam dolar A.S., yang bersedia Anda bayarkan untuk Instans Spot.

Opsi ini hanya dapat ditentukan dengan opsi --enable-spot. Untuk detail selengkapnya, lihat Grup Auto Scaling.

Tipe: Nomor (float)

Default: Harga Sesuai Permintaan, untuk setiap jenis instans. Nilai opsi pada kasus ini adalah null.

Nilai valid: 0.001 hingga 20.0

Untuk rekomendasi tentang opsi harga maksimum untuk Instans Spot, lihat riwayat harga Instans Spot di Panduan EC2 Pengguna Amazon.

--tags key1=value1[,key2=value2 ...]

Tandai sumber daya di lingkungan Anda. Tanda ditentukan sebagai daftar yang dipisahkan koma pasangan key=value.

Untuk informasi selengkapnya, lihat Menandai lingkungan.

-t worker

atau

--tier worker

 Buat lingkungan pekerja. Abaikan opsi ini untuk membuat lingkungan web server.

--timeout minutes

Atur jumlah menit sebelum waktu perintah habis.

--version version_label

Menentukan versi aplikasi yang ingin Anda deploy ke lingkungan bukan kode sumber aplikasi di direktori proyek lokal.

Tipe: String

Nilai valid: Label versi aplikasi yang ada

--vpc

Konfigurasikan VPC untuk lingkungan Anda. Ketika Anda menyertakan opsi ini, EB CLI meminta Anda untuk memasukkan semua pengaturan yang diperlukan sebelum meluncurkan lingkungan.

--vpc.dbsubnets subnet1,subnet2

Menentukan subnet untuk instans basis data di VPC. Diperlukan ketika --vpc.id ditentukan.

--vpc.ec2subnets subnet1,subnet2

Menentukan subnet untuk EC2 instans Amazon dalam VPC. Diperlukan ketika --vpc.id ditentukan.

--vpc.elbpublic

Luncurkan penyeimbang beban Elastic Load Balancing Anda di subnet publik di VPC Anda.

Anda tidak dapat menentukan opsi ini dengan opsi --tier worker atau --single.

--vpc.elbsubnets subnet1,subnet2

Tentukan subnet untuk penyeimbang beban Elastic Load Balancing di VPC.

Anda tidak dapat menentukan opsi ini dengan opsi --tier worker atau --single.

--vpc.id ID

Luncurkan lingkungan Anda di VPC yang ditentukan.

--vpc.publicip

Meluncurkan EC2 instans Amazon Anda di subnet publik di VPC Anda.

Anda tidak dapat menentukan opsi ini dengan opsi --tier worker.

--vpc.securitygroups securitygroup1,securitygroup2

Menentukan kelompok IDs keamanan. Diperlukan ketika --vpc.id ditentukan.

Opsi umum

Output

Jika berhasil, perintah meminta Anda dengan pertanyaan dan kemudian mengembalikan status operasi pembuatan. Jika ada masalah selama peluncuran, Anda dapat menggunakan operasi eb events untuk mendapatkan detail selengkapnya.

Jika Anda mengaktifkan CodeBuild dukungan dalam aplikasi Anda, eb create menampilkan informasi dari CodeBuild saat kode Anda dibuat. Untuk informasi tentang CodeBuild dukungan di Elastic Beanstalk, lihat. Menggunakan EB CLI dengan AWS CodeBuild

Contoh

Contoh berikut membuat lingkungan dalam mode interaktif.

$ eb create
Enter Environment Name
(default is tmp-dev): ENTER
Enter DNS CNAME prefix
(default is tmp-dev): ENTER
Select a load balancer type
1) classic
2) application
3) network
(default is 2): ENTER
Environment details for: tmp-dev
  Application name: tmp
  Region: us-east-2
  Deployed Version: app-141029_145448
  Environment ID: e-um3yfrzq22
  Platform: 64bit Amazon Linux 2014.09 v1.0.9 running PHP 5.5
  Tier: WebServer-Standard-1.0
  CNAME: tmp-dev.elasticbeanstalk.com
  Updated: 2014-10-29 21:54:51.063000+00:00
Printing Status:
...

Contoh berikut juga membuat lingkungan dalam mode interaktif. Di contoh ini, direktori proyek Anda tidak memiliki kode aplikasi. Perintah men-deploy aplikasi sampel dan mengunduhnya ke direktori proyek lokal Anda.

$ eb create
Enter Environment Name
(default is tmp-dev): ENTER
Enter DNS CNAME prefix
(default is tmp-dev): ENTER
Select a load balancer type
1) classic
2) application
3) network
(default is 2): ENTER
NOTE: The current directory does not contain any source code. Elastic Beanstalk is launching the sample application instead.
Do you want to download the sample application into the current directory?
(Y/n): ENTER
INFO: Downloading sample application to the current directory.
INFO: Download complete.
Environment details for: tmp-dev
  Application name: tmp
  Region: us-east-2
  Deployed Version: Sample Application
  Environment ID: e-um3yfrzq22
  Platform: 64bit Amazon Linux 2014.09 v1.0.9 running PHP 5.5
  Tier: WebServer-Standard-1.0
  CNAME: tmp-dev.elasticbeanstalk.com
  Updated: 2017-11-08 21:54:51.063000+00:00
Printing Status:
...

Perintah berikut membuat lingkungan tanpa menampilkan permintaanya.

$ eb create dev-env
Creating application version archive "app-160312_014028".
Uploading test/app-160312_014028.zip to S3. This may take a while.
Upload Complete.
Application test has been created.
Environment details for: dev-env
  Application name: test
  Region: us-east-2
  Deployed Version: app-160312_014028
  Environment ID: e-6fgpkjxyyi
  Platform: 64bit Amazon Linux 2015.09 v2.0.8 running PHP 5.6
  Tier: WebServer-Standard
  CNAME: UNKNOWN
  Updated: 2016-03-12 01:40:33.614000+00:00
Printing Status:
...

Perintah berikut membuat lingkungan di VPC khusus.

$ eb create dev-vpc --vpc.id vpc-0ce8dd99 --vpc.elbsubnets subnet-b356d7c6,subnet-02f74b0c --vpc.ec2subnets subnet-0bb7f0cd,subnet-3b6697c1 --vpc.securitygroup sg-70cff265
Creating application version archive "app-160312_014309".
Uploading test/app-160312_014309.zip to S3. This may take a while.
Upload Complete.
Environment details for: dev-vpc
  Application name: test
  Region: us-east-2
  Deployed Version: app-160312_014309
  Environment ID: e-pqkcip3mns
  Platform: 64bit Amazon Linux 2015.09 v2.0.8 running Java 8
  Tier: WebServer-Standard
  CNAME: UNKNOWN
  Updated: 2016-03-12 01:43:14.057000+00:00
Printing Status:
...