File konfigurasi (.ebextensions)Konfigurasi tersimpan Dokumen JSON Konfigurasi EB CLI

Menetapkan opsi konfigurasi sebelum pembuatan lingkungan

AWS Elastic Beanstalk mendukung sejumlah besar opsi konfigurasi yang memungkinkan Anda mengubah pengaturan yang diterapkan ke sumber daya di lingkungan Anda. Beberapa opsi ini memiliki nilai default yang dapat diganti untuk menyesuaikan lingkungan Anda. Opsi lain dapat dikonfigurasi untuk mengaktifkan fitur tambahan.

Elastic Beanstalk mendukung dua metode penyimpanan pengaturan opsi konfigurasi. File konfigurasi dalam format YAML atau JSON dapat disertakan dalam kode sumber aplikasi Anda pada direktori bernama .ebextensions dan di-deploy sebagai bagian dari paket sumber aplikasi Anda. Anda membuat dan mengelola file konfigurasi lokal.

Konfigurasi tersimpan adalah templat yang Anda buat dari lingkungan berjalan atau file opsi JSON dan simpan di Elastic Beanstalk. Konfigurasi tersimpan yang sudah ada juga dapat diperpanjang untuk membuat konfigurasi baru.

catatan

Pengaturan yang ditentukan dalam file konfigurasi dan konfigurasi tersimpan memiliki prioritas lebih rendah daripada pengaturan yang dikonfigurasi selama atau setelah pembuatan lingkungan, termasuk nilai yang direkomendasikan yang diterapkan oleh konsol Elastic Beanstalk dan EB CLI. Lihat Precedence untuk rincian selengkapnya.

Opsi juga dapat ditentukan dalam dokumen JSON dan diberikan langsung ke Elastic Beanstalk ketika Anda membuat atau memperbarui lingkungan dengan EB CLI atau AWS CLI. Opsi yang diberikan langsung ke Elastic Beanstalk dengan cara ini mengganti semua metode lainnya.

Untuk daftar lengkap opsi yang tersedia, lihat Opsi konfigurasi.

File konfigurasi (`.ebextensions`)

Gunakan .ebextensions untuk mengonfigurasi opsi yang diperlukan untuk membuat aplikasi Anda berfungsi, dan memberikan nilai default untuk opsi lain yang dapat diganti pada tingkat prioritasyang lebih tinggi. Opsi yang ditentukan di .ebextensions memiliki tingkat prioritas terendah dan diganti oleh pengaturan pada tingkat lainnya.

Untuk menggunakan file konfigurasi, buat folder dengan nama .ebextensions di tingkat atas kode sumber proyek Anda. Tambahkan file dengan ekstensi .config dan tentukan opsi dengan cara berikut:


option_settings:
  - namespace:  namespace
    option_name:  option name
    value:  option value
  - namespace:  namespace
    option_name:  option name
    value:  option value

Sebagai contoh, file konfigurasi berikut menetapkan url pemeriksaan kondisi aplikasi ke /health:

healthcheckurl.config


option_settings:
  - namespace:  aws:elasticbeanstalk:application
    option_name:  Application Healthcheck URL
    value:  /health

Di JSON:


{
 "option_settings" :
    [
      {
        "namespace" : "aws:elasticbeanstalk:application",
        "option_name" : "Application Healthcheck URL",
        "value" : "/health"
      }
    ]
}

Ini mengonfigurasi penyeimbang beban Elastic Load Balancing di lingkungan Elastic Beanstalk Anda untuk membuat permintaan HTTP ke jalur /health untuk setiap instans EC2 untuk menentukan apakah itu sehat atau tidak.

catatan

YAML bergantung pada indentasi yang konsisten. Cocokkan tingkat indentasi saat mengganti konten dalam file konfigurasi contoh dan pastikan bahwa editor teks Anda menggunakan spasi, bukan karakter tab, untuk indentasi.

Sertakan direktori .ebextensions di Paket Sumber Aplikasi Anda dan terapkan paket tersebut ke lingkungan Elastic Beanstalk baru atau yang sudah ada.

File konfigurasi mendukung beberapa bagian selain option_settings untuk menyesuaikan perangkat lunak dan file yang berjalan di server di lingkungan Anda. Untuk informasi selengkapnya, lihat .Ebextensions.

Konfigurasi tersimpan

Buat konfigurasi tersimpan untuk menyimpan pengaturan yang telah diterapkan ke lingkungan yang ada selama atau setelah pembuatan lingkungan dengan menggunakan konsol Elastic Beanstalk, EB CLI, atau AWS CLI. Konfigurasi tersimpan adalah milik aplikasi dan dapat diterapkan ke lingkungan baru atau yang sudah ada untuk aplikasi itu.

Klien

Konsol Elastic Beanstalk
EB CLI
AWS CLI

Konsol Elastic Beanstalk

Untuk membuat konfigurasi tersimpan (konsol Elastic Beanstalk)

Buka Konsol Elastic Beanstalk, dan di daftar Wilayah, pilih AndaWilayah AWS.
Di panel navigasi, pilih Lingkungan, dan kemudian pilih nama lingkungan Anda dari daftar.

catatan
Jika Anda memiliki banyak lingkungan, gunakan bilah pencarian untuk memfilter daftar lingkungan.
Pilih Tindakan, lalu pilih Simpan konfigurasi.
Gunakan kotak dialog pada layar untuk menyelesaikan tindakan.

Konfigurasi tersimpan yang disimpan di bucket Elastic Beanstalk S3 dalam folder yang dinamai berdasarkan aplikasi Anda. Sebagai contoh, konfigurasi untuk aplikasi yang dinamai my-app di wilayah us-barat-2 untuk nomor akun 123456789012 dapat ditemukan di s3://elasticbeanstalk-us-west-2-123456789012/resources/templates/my-app.

EB CLI

EB CLI juga menyediakan sub perintah untuk berinteraksi dengan konfigurasi tersimpan di bawah eb config:

Untuk membuat konfigurasi tersimpan (EB CLI)

Simpan konfigurasi lingkungan yang terlampir saat ini:
```
~/project$ eb config save --cfg my-app-v1
```
EB CLI menyimpan konfigurasi untuk ~/project/.elasticbeanstalk/saved_configs/my-app-v1.cfg.yml
Ubah konfigurasi tersimpan secara lokal jika diperlukan.
Muat konfigurasi tersimpan ke S3:
```
~/project$ eb config put my-app-v1
```

AWS CLI

Buat konfigurasi tersimpan dari lingkungan berjalan dengan aws elasticbeanstalk create-configuration-template

Untuk membuat konfigurasi tersimpan (AWS CLI)

Identifikasi ID lingkungan Elastic Beanstalk lingkungan Anda dengan describe-environments:


$ aws elasticbeanstalk describe-environments --environment-name my-env
{
    "Environments": [
        {
            "ApplicationName": "my-env",
            "EnvironmentName": "my-env",
            "VersionLabel": "89df",
            "Status": "Ready",
            "Description": "Environment created from the EB CLI using \"eb create\"",
            "EnvironmentId": "e-vcghmm2zwk",
            "EndpointURL": "awseb-e-v-AWSEBLoa-1JUM8159RA11M-43V6ZI1194.us-west-2.elb.amazonaws.com",
            "SolutionStackName": "64bit Amazon Linux 2015.03 v2.0.2 running Multi-container Docker 1.7.1 (Generic)",
            "CNAME": "my-env-nfptuqaper.elasticbeanstalk.com",
            "Health": "Green",
            "AbortableOperationInProgress": false,
            "Tier": {
                "Version": " ",
                "Type": "Standard",
                "Name": "WebServer"
            },
            "HealthStatus": "Ok",
            "DateUpdated": "2015-10-01T00:24:04.045Z",
            "DateCreated": "2015-09-30T23:27:55.768Z"
        }
    ]
}

Simpan konfigurasi lingkungan saat ini dengan create-configuration-template:


$ aws elasticbeanstalk create-configuration-template --environment-id e-vcghmm2zwk --application-name my-app --template-name v1

Elastic Beanstalk menyimpan konfigurasi ke bucket Elastic Beanstalk Anda di Amazon S3.

Dokumen JSON

Jika Anda menggunakan AWS CLI untuk membuat dan memperbarui lingkungan, Anda juga dapat memberikan opsi konfigurasi dalam format JSON. Perpustakaan file konfigurasi di JSON berguna jika Anda menggunakan AWS CLI untuk membuat dan mengelola lingkungan.

Sebagai contoh, dokumen JSON berikut menetapkan url pemeriksaan kondisi aplikasi untuk /health:

~/ebconfigs/healthcheckurl.json


[
  {
    "Namespace": "aws:elasticbeanstalk:application",
    "OptionName": "Application Healthcheck URL",
    "Value": "/health"
  }
]

Konfigurasi EB CLI

Selain mendukung konfigurasi tersimpan dan konfigurasi lingkungan langsung dengan perintah eb config, EB CLI memiliki file konfigurasi dengan opsi bernama default_ec2_keyname yang dapat Anda gunakan untuk menentukan pasangan kunci Amazon EC2 untuk akses SSH ke instans di lingkungan Anda. EB CLI menggunakan opsi ini untuk mengatur opsi konfigurasi EC2KeyName di namespace aws:autoscaling:launchconfiguration.

~/ruang kerja/my-app/.elasticbeanstalk/config.yml~


branch-defaults:
  master:
    environment: my-env
  develop:
    environment: my-env-dev
deploy:
  artifact: ROOT.war
global:
  application_name: my-app
  default_ec2_keyname: my-keypair
  default_platform: Tomcat 8 Java 8
  default_region: us-west-2
  profile: null
  sc: git

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Opsi konfigurasi

Selama pembuatan