Platform kustom Elastic Beanstalk (pensiun)

Platform khusus adalah kustomisasi yang lebih maju daripada citra kustom dalam beberapa cara. Platform khusus memungkinkan Anda mengembangkan seluruh platform baru dari scratch, menyesuaikan sistem operasi, perangkat lunak tambahan, dan skrip yang dijalankan Elastic Beanstalk pada instans platform. Fleksibilitas ini memungkinkan Anda untuk membangun platform untuk aplikasi yang menggunakan bahasa atau perangkat lunak infrastruktur lainnya, yang Elastic Beanstalk tidak sediakan platform yang terkelola. Bandingkan dengan gambar khusus, tempat Anda memodifikasi Amazon Machine Image (AMI) untuk digunakan dengan platform Elastic Beanstalk yang ada, dan Elastic Beanstalk masih menyediakan skrip platform dan mengontrol tumpukan perangkat lunak platform. Selain itu, dengan platform kustom Anda menggunakan cara otomatis dan skrip untuk membuat dan memelihara kustomisasi Anda, sedangkan dengan gambar kustom Anda membuat perubahan secara manual melalui instans yang sedang berjalan.

Untuk membuat platform khusus, Anda membuat AMI dari salah satu sistem operasi yang didukung—UbuntuRHEL, atau Amazon Linux (lihat flavor entri Format file Platform.yaml untuk nomor versi yang tepat) —dan menambahkan penyesuaian lebih lanjut. Anda membuat platform Elastic Beanstalk Anda sendiri menggunakan Packer, yang merupakan alat sumber terbuka untuk membuat gambar mesin untuk banyak platform, AMIs termasuk untuk digunakan dengan Amazon Elastic Compute Cloud (Amazon). EC2 Platform Elastic Beanstalk AMI terdiri dari konfigurasi untuk menjalankan satu set perangkat lunak yang mendukung aplikasi, dan metadata yang dapat menyertakan opsi konfigurasi khusus dan pengaturan opsi konfigurasi default.

Elastic Beanstalk mengelola Packer sebagai platform built-in yang terpisah, dan Anda tidak perlu khawatir tentang konfigurasi dan versi Packer.

Anda membuat platform dengan menyediakan Elastic Beanstalk dengan template Packer, dan skrip dan file yang dipanggil template untuk membangun. AMI Komponen-komponen ini dikemas dengan file definisi platform, yang menentukan template dan metadata, ke dalam arsip, yang dikenal sebagai ZIP arsip definisi platform.

Ketika Anda membuat platform kustom, Anda meluncurkan satu instans lingkungan tanpa Elastis IP yang menjalankan Packer. Packer kemudian meluncurkan instans lain untuk membangun sebuah gambar. Anda dapat menggunakan kembali lingkungan ini untuk beberapa platform dan beberapa versi dari setiap platform.

Pengguna di akun Anda dapat menggunakan platform khusus Anda dengan menentukan platform ARN selama pembuatan lingkungan. Ini ARNs dikembalikan oleh eb platform create perintah yang Anda gunakan untuk membuat platform khusus.

Setiap kali Anda membangun platform khusus Anda, Elastic Beanstalk menciptakan versi platform baru. Pengguna dapat menentukan platform dengan nama untuk mendapatkan hanya versi terbaru dari platform, atau menyertakan nomor versi untuk mendapatkan versi tertentu.

Misalnya, untuk menerapkan versi terbaru dari platform kustom dengan ARNMyCustomPlatformARN, yang bisa berupa versi 3.0, baris CLI perintah EB Anda akan terlihat seperti ini:

eb create -p MyCustomPlatformARN

Untuk menerapkan versi 2.1 baris CLI perintah EB Anda akan terlihat seperti ini:

eb create -p MyCustomPlatformARN --version 2.1

Anda dapat menerapkan tag ke versi platform kustom saat Anda membuatnya, dan mengedit tag dari versi platform kustom yang ada. Untuk detail selengkapnya, lihat Menandai versi platform khusus.

Membuat platform khusus

Untuk membuat platform kustom, akar aplikasi Anda harus menyertakan file definisi platform, platform.yaml, yang mendefinisikan jenis pembangun yang digunakan untuk membuat platform kustom. Format file ini diterangkan dalam Format file Platform.yaml. Anda dapat membuat platform kustom Anda dari scratch, atau menggunakan salah satu platform khusus sampel sebagai titik awal.

Menggunakan platform khusus sampel

Salah satu alternatif untuk membuat platform kustom Anda sendiri adalah dengan menggunakan salah satu instans arsip definisi platform untuk bootstrap platform kustom Anda. Satu-satunya item yang harus Anda konfigurasikan dalam sampel sebelum Anda dapat menggunakannya adalah sumber AMI dan Wilayah.

Unduh contoh platform definisi arsip: NodePlatform_Ubuntu.zip. File ini berisi file definisi platform, templat Packer, skrip yang dijalankan Packer selama pembuatan gambar, dan skrip dan file konfigurasi yang disalin Packer ke instans pembangun selama pembuatan platform.

|-- builder                 Contains files used by Packer to create the custom platform
|-- custom_platform.json    Packer template
|-- platform.yaml           Platform definition file
|-- ReadMe.txt              Briefly describes the sample

File definisi platform, platform.yaml, memberitahu Elastic Beanstalk nama templat Packer, custom_platform.json.

version: "1.0"

provisioner:
  type: packer
  template: custom_platform.json
  flavor: ubuntu1604

Template Packer memberi tahu Packer bagaimana membangun platform, menggunakan Ubuntu AMI sebagai dasar untuk image platform untuk tipe HVM instance. AMIs Bagian provisioners memberitahu Packer untuk menyalin semua file di folder builder dalam arsip untuk instans, dan untuk menjalankan skrip builder.sh pada instans. Setelah skrip selesai, Packer membuat gambar dari instans yang dimodifikasi.

Elastic Beanstalk menciptakan tiga variabel lingkungan yang dapat digunakan untuk menandai di Packer: AMIs

Sampel file custom_platform.json menggunakan variabel-variabel ini untuk menentukan nilai-nilai berikut yang digunakan dalam skrip:

File custom_platform.json berisi dua properti yang Anda harus berikan nilai untuk: source_ami dan region. Untuk detail tentang memilih nilai yang tepat AMI dan Region, lihat Memperbarui template Packer di eb-custom-platforms-samples GitHub repositori.

{
  "variables": {
    "platform_name": "{{env `AWS_EB_PLATFORM_NAME`}}",
    "platform_version": "{{env `AWS_EB_PLATFORM_VERSION`}}",
    "platform_arn": "{{env `AWS_EB_PLATFORM_ARN`}}"
  },
  "builders": [
    {
      ...
      "region": "",
      "source_ami": "",
      ...
    }
  ],
  "provisioners": [
    {...},
    {
      "type": "shell",
      "execute_command": "chmod +x {{ .Path }}; {{ .Vars }} sudo {{ .Path }}",
      "scripts": [
        "builder/builder.sh"
      ]
    }
  ]
}

Skrip dan file lain yang Anda sertakan dalam arsip definisi platform Anda akan sangat bervariasi tergantung pada modifikasi yang ingin Anda buat untuk instans. Instans platform mencakup skrip berikut:

Gunakan EB CLI untuk membuat platform kustom pertama Anda dengan arsip definisi platform sampel.

Ketika operasi selesai, Anda memiliki platform yang dapat Anda gunakan untuk meluncurkan lingkungan Elastic Beanstalk.

Anda dapat menggunakan platform khusus saat membuat lingkungan dari konsol. Lihat Wizard pembuatan lingkungan baru.

Konten arsip definisi platform

Arsip definisi platform adalah platform yang setara dengan paket sumber aplikasi. Arsip definisi platform adalah ZIP file yang berisi file definisi platform, template Packer, dan skrip dan file yang digunakan oleh template Packer untuk membuat platform Anda.

File definisi platform adalah file YAML berformat -yang harus diberi nama platform.yaml dan berada di root arsip definisi platform Anda. Lihat Membuat platform khusus untuk daftar kunci yang diperlukan dan opsional yang didukung dalam file definisi platform.

Anda tidak perlu menamai templat Packer dengan cara tertentu, tetapi nama file harus sesuai dengan templat penyedia yang ditentukan dalam file definisi platform. Lihat dokumentasi Packer yang resmi untuk petunjuk tentang cara membuat templat Packer.

File lain dalam arsip definisi platform Anda adalah skrip dan file yang digunakan oleh template untuk menyesuaikan instance sebelum membuat file. AMI

Hook platform khusus

Elastic Beanstalk menggunakan struktur direktori standar untuk hook pada platform khusus. Ini adalah skrip yang dijalankan selama peristiwa siklus hidup dan dalam menanggapi operasi manajemen: ketika instans di lingkungan Anda diluncurkan, atau ketika pengguna memulai deployment atau menggunakan fitur server aplikasi restart.

Letakkan skrip yang Anda inginkan hook untuk memicu di salah satu subfolder dari folder /opt/elasticbeanstalk/hooks/.

Hook diatur ke dalam folder berikut:

appdeploy, configdeploy, dan restartappserver berisi folder pre, enact, dan subfolder post. Dalam setiap fase operasi, semua skrip di folder pre dijalankan dalam urutan abjad, kemudian mereka dalam folder enact, dan kemudian di folder post.

Ketika sebuah instans diluncurkan, Elastic Beanstalk berjalan preinit, appdeploy, dan postinit, dalam urutan ini. Pada deployment berikutnya untuk instans berjalan, Elastic Beanstalk menjalankan hook appdeploy. hook configdeploy dijalankan ketika pengguna memperbarui pengaturan konfigurasi perangkat lunak instans. hook restartappserver dijalankan hanya ketika pengguna memulai restart server aplikasi.

Ketika skrip Anda mengalami kesalahan, mereka dapat keluar dengan status bukan nol dan menulis ke stderr untuk menggagalkan operasi. Pesan yang Anda tulis di stderr akan muncul dalam acara yang output ketika operasi gagal. Elastic Beanstalk juga menangkap informasi ini dalam file log /var/log/eb-activity.log Jika Anda tidak ingin gagal operasi, kembalikan 0 (nol). Pesan yang Anda tulis ke stderr atau stdout muncul di log deployment, tetapi tidak akan muncul dalam aliran kejadian kecuali operasi gagal.

Pembersihan instans Packer

Dalam keadaan tertentu, seperti menghentikan proses pembangun Packer sebelum selesai, instans yang diluncurkan oleh Packer tidak dibersihkan. Contoh ini bukan bagian dari lingkungan Elastic Beanstalk dan dapat dilihat dan dihentikan hanya dengan menggunakan layanan Amazon. EC2

Format file Platform.yaml

File platform.yaml tersebut berisi format berikut.

version: "version-number"

provisioner:
   type: provisioner-type
   template: provisioner-template
   flavor: provisioner-flavor
        
metadata:
   maintainer: metadata-maintainer
   description: metadata-description
   operating_system_name: metadata-operating_system_name
   operating_system_version: metadata-operating_system_version
   programming_language_name: metadata-programming_language_name
   programming_language_version: metadata-programming_language_version
   framework_name: metadata-framework_name
   framework_version: metadata-framework_version

option_definitions:
   - namespace: option-def-namespace
     option_name: option-def-option_name
     description: option-def-description
     default_value: option-def-default_value

option_settings:
   - namespace: "option-setting-namespace"
     option_name: "option-setting-option_name"
     value: "option-setting-value"

Ganti placeholder dengan nilai-nilai ini:

Menandai versi platform khusus

Anda dapat menerapkan tag ke versi platform AWS Elastic Beanstalk khusus Anda. Tag adalah pasangan nilai kunci yang terkait dengan AWS sumber daya. Untuk informasi tentang penandaan sumber daya Elastic Beanstalk, penggunaan kasus, kunci tag dan batasan nilai, dan jenis sumber daya yang didukung, lihat Pelabelan sumber daya aplikasi Elastic Beanstalk.

Anda dapat menentukan tag saat membuat versi platform khusus. Dalam versi platform khusus yang ada, Anda dapat menambahkan atau menghapus tag, dan memperbarui nilai tag yang ada. Anda dapat menambahkan hingga 50 tag ke setiap versi platform khusus.

Menambahkan tag selama pembuatan versi platform khusus

Jika Anda menggunakan EB CLI untuk membuat versi platform khusus Anda, gunakan --tags opsi eb platform create untuk menambahkan tag.

~/workspace/my-app$ eb platform create --tags mytag1=value1,mytag2=value2

Dengan AWS CLI atau klien API berbasis lainnya, tambahkan tag dengan menggunakan --tags parameter pada create-platform-version perintah.

$ aws elasticbeanstalk create-platform-version \
      --tags Key=mytag1,Value=value1 Key=mytag2,Value=value2 \
      --platform-name my-platform --platform-version 1.0.0 --platform-definition-bundle S3Bucket=amzn-s3-demo-bucket,S3Key=sample.zip

Mengelola tag dari versi platform khusus yang ada

Anda dapat menambahkan, memperbarui, dan menghapus tag dalam versi platform khusus Elastic Beanstalk yang ada.

Jika Anda menggunakan EB CLI untuk memperbarui versi platform kustom Anda, gunakan eb tags untuk menambah, memperbarui, menghapus, atau mencantumkan tag.

Misalnya, perintah berikut mencantumkan tag dalam versi platform khusus.

~/workspace/my-app$ eb tags --list --resource "arn:aws:elasticbeanstalk:us-east-2:my-account-id:platform/my-platform/1.0.0"

Perintah berikut update tag mytag1 dan menghapus tag mytag2.

~/workspace/my-app$ eb tags --update mytag1=newvalue --delete mytag2 \
      --resource "arn:aws:elasticbeanstalk:us-east-2:my-account-id:platform/my-platform/1.0.0"

Untuk daftar lengkap opsi dan contoh lainnya, lihat eb tags.

Dengan AWS CLI atau klien API berbasis lainnya, gunakan list-tags-for-resource perintah untuk membuat daftar tag versi platform khusus.

$ aws elasticbeanstalk list-tags-for-resource --resource-arn "arn:aws:elasticbeanstalk:us-east-2:my-account-id:platform/my-platform/1.0.0"

Gunakan perintah update-tags-for-resource untuk menambahkan, memperbarui, atau menghapus tag dalam versi platform khusus.

$ aws elasticbeanstalk update-tags-for-resource \
      --tags-to-add Key=mytag1,Value=newvalue --tags-to-remove mytag2 \
      --resource-arn "arn:aws:elasticbeanstalk:us-east-2:my-account-id:platform/my-platform/1.0.0"

Tentukan kedua tag untuk menambahkan dan tag untuk memperbarui dalam parameter --tags-to-add dari update-tags-for-resource. Tag yang tidak ada ditambahkan, dan nilai tag yang ada diperbarui.

$ aws elasticbeanstalk list-platform-versions