Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Men-deploy aplikasi Node.js dengan DynamoDB ke Elastic Beanstalk
Tutorial ini dan contoh [nodejs-example-dynamoaplikasi.zip](samples/nodejs-example-dynamo.zip) memandu Anda melalui proses penerapan aplikasi Node.js yang menggunakan AWS SDK untuk JavaScript di Node.js untuk berinteraksi dengan layanan Amazon DynamoDB. Anda akan membuat tabel DynamoDB yang ada di database yang dipisahkan, atau eksternal, dari lingkungan. AWS Elastic Beanstalk Anda juga akan mengonfigurasi aplikasi untuk menggunakan database terpisah. Dalam lingkungan produksi, praktik terbaik adalah menggunakan database yang dipisahkan dari lingkungan Elastic Beanstalk sehingga independen dari siklus hidup lingkungan. Praktek ini juga memungkinkan Anda untuk melakukan penyebaran [biru/hijau](using-features.CNAMESwap.md).
Contoh aplikasi menggambarkan hal berikut:
+ Tabel DynamoDB yang menyimpan data teks yang disediakan pengguna.
+ [File konfigurasi](ebextensions.md) untuk membuat tabel.
+ Topik Layanan Pemberitahuan Sederhana Amazon.
+ Penggunaan [file package.json](nodejs-platform-dependencies.md#nodejs-platform-packagejson) untuk menginstal paket selama penerapan.
**Topics**
+ [Prasyarat](#nodejs-dynamodb-tutorial-prereqs)
+ [Membuat lingkungan Elastic Beanstalk](#nodejs-dynamodb-tutorial-launch)
+ [Menambahkan izin ke instans lingkungan Anda](#nodejs-dynamodb-tutorial-role)
+ [Menyebarkan contoh aplikasi](#nodejs-dynamodb-tutorial-deploy)
+ [Buat tabel DynamoDB](#nodejs-dynamodb-tutorial-database)
+ [Perbarui file konfigurasi aplikasi](#nodejs-dynamodb-tutorial-update)
+ [Konfigurasikan lingkungan Anda untuk ketersediaan yang tinggi](#nodejs-dynamodb-tutorial-configure)
+ [Pembersihan](#nodejs-dynamodb-tutorial-cleanup)
+ [Langkah selanjutnya](#nodejs-dynamodb-tutorial-nextsteps)
## Prasyarat
Tutorial ini membutuhkan prasyarat berikut:
+ Runtime Node.js
+ Perangkat lunak pengelola paket Node.js default, npm
+ Generator baris perintah Express
+ Antarmuka Baris Perintah Elastic Beanstalk (EB CLI)
Untuk detail tentang menginstal tiga komponen pertama yang terdaftar dan menyiapkan lingkungan pengembangan lokal Anda, lihat[Menyiapkan lingkungan pengembangan Node.js Anda untuk Elastic Beanstalk](nodejs-devenv.md). Untuk tutorial ini, Anda tidak perlu menginstal AWS SDK untuk Node.js, yang juga disebutkan dalam topik yang direferensikan.
Untuk detail tentang menginstal dan mengonfigurasi CLI EB, lihat dan. [Instal EB CLI dengan skrip pengaturan (disarankan)](eb-cli3.md#eb-cli3-install) [Mengonfigurasi EB CLI](eb-cli3-configuration.md)
## Membuat lingkungan Elastic Beanstalk
**Direktori aplikasi Anda**
Tutorial ini menggunakan direktori yang disebut `nodejs-example-dynamo` untuk bundel sumber aplikasi. Buat `nodejs-example-dynamo` direktori untuk tutorial ini.
```
~$ mkdir nodejs-example-dynamo
```
**catatan**
Setiap tutorial dalam chapter ini menggunakan direktorinya sendiri untuk bundel sumber aplikasi. Nama direktori cocok dengan nama aplikasi sampel yang digunakan oleh tutorial.
Ubah direktori kerja Anda saat ini menjadi`nodejs-example-dynamo`.
```
~$ cd nodejs-example-dynamo
```
Sekarang, mari kita mengatur lingkungan Elastic Beanstalk yang menjalankan platform Node.js dan aplikasi sampel. Kita akan menggunakan antarmuka baris perintah Elastic Beanstalk (EB CLI).
**Untuk mengonfigurasi repositori EB CLI untuk aplikasi Anda dan membuat lingkungan Elastic Beanstalk yang menjalankan platform Node.js**
1. Buat repositori dengan perintah **[**eb init**](eb3-init.md)**.
```
~/nodejs-example-dynamo$ eb init --platform node.js --region
```
Perintah ini membuat file konfigurasi dalam folder bernama `.elasticbeanstalk` yang menentukan pengaturan dalam membuat lingkungan untuk aplikasi Anda, dan membuat sebuah aplikasi Elastic Beanstalk yang diambil dari nama folder saat ini.
1. Buat lingkungan yang menjalankan aplikasi sampel dengan perintah **[**eb create**](eb3-create.md)**.
```
~/nodejs-example-dynamo$ eb create --sample nodejs-example-dynamo
```
Perintah ini membuat lingkungan yang seimbang beban dengan pengaturan default untuk platform Node.js dan sumber daya berikut:
+ **EC2 instance** — Mesin virtual Amazon Elastic Compute Cloud (Amazon EC2) yang dikonfigurasi untuk menjalankan aplikasi web pada platform yang Anda pilih.
Setiap platform menjalankan satu set perangkat lunak, file konfigurasi dan penulisan tertentu untuk mendukung versi bahasa, kerangka kerja, kontainer web tertentu, atau kombinasi dari semua ini. Sebagian besar platform menggunakan Apache atau NGINX sebagai proksi terbalik yang ada di depan aplikasi web Anda, meneruskan permintaan ke aplikasi web, menyajikan aset statis, dan menghasilkan log akses dan kesalahan.
+ **Grup keamanan instans — Grup** EC2 keamanan Amazon yang dikonfigurasi untuk memungkinkan lalu lintas masuk pada port 80. Sumber daya ini memungkinkan lalu lintas HTTP dari penyeimbang beban mencapai EC2 instance yang menjalankan aplikasi web Anda. Secara default, lalu lintas tidak diizinkan di port lain.
+ **Penyeimbang beban** – Penyeimbang beban Elastic Load Balancing yang dikonfigurasi untuk mendistribusikan permintaan ke instans yang menjalankan aplikasi Anda. Penyeimbang beban juga menghilangkan kebutuhan untuk mengekspos instans Anda langsung ke internet.
+ **Grup keamanan penyeimbang beban - Grup** EC2 keamanan Amazon yang dikonfigurasi untuk memungkinkan lalu lintas masuk di port 80. Sumber daya ini memungkinkan lalu lintas HTTP dari internet mencapai penyeimbang beban. Secara default, lalu lintas tidak diizinkan di port lain.
+ **Grup Auto Scaling** – Grup Auto Scaling yang dikonfigurasi untuk menggantikan instans jika diakhiri atau menjadi tidak tersedia.
+ **Bucket Amazon S3** – Lokasi penyimpanan untuk kode sumber, log, dan artifact lainnya yang dibuat saat Anda menggunakan Elastic Beanstalk.
+ ** CloudWatch Alarm Amazon** — Dua CloudWatch alarm yang memantau beban pada instans di lingkungan Anda dan yang dipicu jika beban terlalu tinggi atau terlalu rendah. Saat alarm terpicu, grup Auto Scaling Anda akan menaikkan atau menurunkan skala sebagai respons.
+ **CloudFormation stack** - Elastic CloudFormation Beanstalk digunakan untuk meluncurkan sumber daya di lingkungan Anda dan menyebarkan perubahan konfigurasi. Sumber daya ditentukan di sebuah templat yang dapat Anda lihat di [Konsol CloudFormation](https://console.aws.amazon.com/cloudformation).
+ **Nama domain — Nama** domain yang merutekan ke aplikasi web Anda dalam formulir **subdomain*. *region*.elasticbeanstalk.com*.
**Keamanan domain**
[Untuk meningkatkan keamanan aplikasi Elastic Beanstalk Anda, domain elasticbeanstalk.com terdaftar di *Daftar* Akhiran Publik (PSL).](https://publicsuffix.org/)
Jika Anda perlu mengatur cookie sensitif di nama domain default untuk aplikasi Elastic Beanstalk Anda, kami sarankan Anda menggunakan cookie `__Host-` dengan awalan untuk meningkatkan keamanan. Praktik ini melindungi domain Anda dari upaya pemalsuan permintaan lintas situs (CSRF). Untuk informasi selengkapnya, lihat halaman [Set-Cookie](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie#cookie_prefixes) di Jaringan Pengembang Mozilla.
1. Ketika pembuatan lingkungan selesai, gunakan perintah [**eb open**](eb3-open.md) untuk membuka URL lingkungan di browser default.
```
~/nodejs-example-dynamo$ eb open
```
Anda sekarang telah membuat lingkungan Elastic Beanstalk Node.js dengan aplikasi sampel. Anda dapat memperbaruinya dengan aplikasi Anda sendiri. Selanjutnya, kami memperbarui aplikasi sampel untuk menggunakan kerangka kerja Express.
## Menambahkan izin ke instans lingkungan Anda
Aplikasi Anda berjalan pada satu atau beberapa EC2 instance di belakang penyeimbang beban, yang melayani permintaan HTTP dari Internet. Ketika menerima permintaan yang mengharuskannya untuk menggunakan AWS layanan, aplikasi menggunakan izin dari instance yang dijalankannya untuk mengakses layanan tersebut.
Aplikasi contoh menggunakan izin instance untuk menulis data ke tabel DynamoDB, dan mengirim notifikasi ke topik Amazon SNS dengan SDK untuk di Node.js. JavaScript Tambahkan kebijakan terkelola berikut ke [profil instans](concepts-roles-instance.md) default untuk memberikan izin EC2 instans di lingkungan Anda untuk mengakses DynamoDB dan Amazon SNS:
+ **AmazonDynamoDBFullAkses**
+ **SNSFullAkses Amazon**
**Untuk menambahkan kebijakan ke profil instans default**
1. Buka [Halaman peran](https://console.aws.amazon.com/iam/home#roles) di konsol IAM.
1. Pilih **aws-elasticbeanstalk-ec2-peran**.
1. Di tab **Izin**, pilih **Lampirkan kebijakan**.
1. Pilih kebijakan terkelola untuk layanan tambahan yang digunakan aplikasi Anda. Untuk tutorial ini, pilih `AmazonSNSFullAccess` dan`AmazonDynamoDBFullAccess`.
1. Memilih **Lampirkan kebijakan**.
Lihat [Mengelola profil instans Elastic Beanstalk](iam-instanceprofile.md) untuk selengkapnya tentang mengelola profil instans.
## Menyebarkan contoh aplikasi
Sekarang lingkungan Anda siap untuk Anda gunakan dan jalankan contoh aplikasi untuk tutorial ini: [nodejs-example-dynamo.zip.](samples/nodejs-example-dynamo.zip)
**Untuk menyebarkan dan menjalankan aplikasi contoh tutorial**
1. Ubah direktori kerja Anda saat ini ke direktori aplikasi`nodejs-example-dynamo`.
```
~$ cd nodejs-example-dynamo
```
1. Unduh dan ekstrak isi contoh bundel sumber aplikasi [nodejs-example-dynamo.zip](samples/nodejs-example-dynamo.zip) ke direktori `nodejs-example-dynamo` aplikasi.
1. Terapkan aplikasi contoh ke lingkungan Elastic Beanstalk Anda dengan perintah. [**eb deploy**](eb3-deploy.md)
```
~/nodejs-example-dynamo$ eb deploy
```
**catatan**
Secara default, `eb deploy` perintah membuat file ZIP dari folder proyek Anda. Anda dapat mengonfigurasi EB CLI untuk men-deploy Artifact dari proses membangun Anda bukan membuat file ZIP folder proyek Anda. Untuk informasi selengkapnya, lihat [Men-deploy artifact bukan folder proyek](eb-cli3-configuration.md#eb-cli3-artifact).
1. Ketika pembuatan lingkungan selesai, gunakan perintah [**eb open**](eb3-open.md) untuk membuka URL lingkungan di browser default.
```
~/nodejs-example-dynamo$ eb open
```
Situs mengumpulkan informasi kontak pengguna dan menggunakan tabel DynamoDB untuk menyimpan data. Untuk menambahkan entri, pilih **Daftar hari ini**, masukkan nama dan alamat email, lalu pilih **Daftar\$1**. Aplikasi web menulis isi formulir ke tabel dan memicu notifikasi email Amazon SNS.
![\[Startup landing page with teaser message and sign-up button for upcoming product launch.\]](http://docs.aws.amazon.com/id_id/elasticbeanstalk/latest/dg/images/nodejs-dynamodb-tutorial-app.png)
Sekarang, topik Amazon SNS dikonfigurasi dengan email placeholder untuk pemberitahuan. Anda akan memperbarui konfigurasi segera, tetapi sementara itu Anda dapat memverifikasi tabel DynamoDB dan topik Amazon SNS di Konsol Manajemen AWS.
**Untuk melihat tabel**
1. Buka [halaman Tabel](https://console.aws.amazon.com/dynamodb/home?#tables:) di konsol DynamoDB.
1. Temukan tabel yang dibuat aplikasi. Nama dimulai dengan **awseb dan berisi**. **StartupSignupsTable**
1. Pilih tabel, memilih **Item**, lalu pilih **Mulai pencarian** untuk menampilkan semua item dalam tabel.
Tabel berisi entri untuk setiap alamat email yang dikirimkan pada situs pendaftaran. Selain menulis ke tabel, aplikasi mengirim pesan ke topik Amazon SNS yang memiliki dua langganan, satu untuk pemberitahuan email kepada Anda, dan satu lagi untuk antrean Amazon Simple Queue Service yang dapat dibaca aplikasi pekerja untuk memproses permintaan dan mengirim email ke pelanggan yang tertarik.
**Untuk melihat topik**
1. Buka [halaman Topik](https://console.aws.amazon.com/sns/v2/home?#/topics) di konsol Amazon SNS.
1. Temukan topik yang dibuat oleh aplikasi. Nama dimulai dengan **awseb dan berisi**. **NewSignupTopic**
1. Pilih topik untuk melihat langganannya.
Aplikasi (`[app.js](https://github.com/awslabs/eb-node-express-sample/blob/master/app.js)`) mendefinisikan dua rute. Root path (`/`) mengembalikan halaman web yang dirender dari template Embedded JavaScript (EJS) dengan formulir yang diisi pengguna untuk mendaftarkan nama dan alamat email mereka. Dengan mengirim formulir maka akan mengirimkan permintaan POST dengan data formulir ke rute `/signup`, yang menulis entri ke tabel DynamoDB dan menerbitkan pesan ke topik Amazon SNS untuk memberitahu pemilik pendaftaran.
Aplikasi sampel menyertakan [file konfigurasi](ebextensions.md) yang membuat tabel DynamoDB, topik Amazon SNS, dan antrean Amazon SQS yang digunakan oleh aplikasi. Hal ini memungkinkan Anda membuat lingkungan baru dan menguji fungsionalitasnya dengan segera, tetapi memiliki kelemahan mengikat tabel DynamoDB ke lingkungan. Untuk lingkungan produksi, Anda harus membuat tabel DynamoDB di luar lingkungan untuk menghindari kehilangan itu ketika Anda mengakhiri lingkungan atau memperbarui konfigurasinya.
## Buat tabel DynamoDB
Untuk menggunakan tabel DynamoDB eksternal dengan aplikasi yang berjalan di Elastic Beanstalk, pertama buat tabel di DynamoDB. Ketika Anda membuat tabel di luar Elastic Beanstalk, tabel tersebut sepenuhnya independen dari Elastic Beanstalk dan lingkungan Elastic Beanstalk Anda, dan tidak akan diakhiri oleh Elastic Beanstalk.
Buat tabel dengan pengaturan berikut:
+ **Nama tabel** – **nodejs-tutorial**
+ **Kunci utama** – **email**
+ Tipe kunci primer – **String**
**Untuk membuat tabel DynamoDB**
1. Buka [Halaman tabel](https://console.aws.amazon.com/dynamodb/home?#tables:) di konsol manajemen DynamoDB.
1. Pilih **Buat tabel**.
1. Ketik **Nama tabel** dan **Kunci utama**.
1. Pilih tipe kunci primer.
1. Pilih **Buat**.
## Perbarui file konfigurasi aplikasi
Perbarui [file konfigurasi](ebextensions.md) di sumber aplikasi untuk menggunakan tabel **nodejs-tutorial** daripada membuat yang baru.
**Untuk memperbarui aplikasi contoh untuk penggunaan produksi**
1. Ubah direktori kerja Anda saat ini ke direktori aplikasi`nodejs-example-dynamo`.
```
~$ cd nodejs-example-dynamo
```
1. Buka `.ebextensions/options.config` dan ubah nilai pengaturan berikut:
+ **NewSignupEmail**— Alamat email Anda.
+ **STARTUP\$1SIGNUP\$1TABLE** – **nodejs-tutorial**
**Example .ebextensions/options.config**
```
option_settings:
aws:elasticbeanstalk:customoption:
NewSignupEmail: you@example.com
aws:elasticbeanstalk:application:environment:
THEME: "flatly"
AWS_REGION: '`{"Ref" : "AWS::Region"}`'
STARTUP_SIGNUP_TABLE: nodejs-tutorial
NEW_SIGNUP_TOPIC: '`{"Ref" : "NewSignupTopic"}`'
aws:elasticbeanstalk:container:nodejs:
ProxyServer: nginx
aws:elasticbeanstalk:container:nodejs:staticfiles:
/static: /static
aws:autoscaling:asg:
Cooldown: "120"
aws:autoscaling:trigger:
Unit: "Percent"
Period: "1"
BreachDuration: "2"
UpperThreshold: "75"
LowerThreshold: "30"
MeasureName: "CPUUtilization"
```
Ini berlaku konfigurasi berikut untuk aplikasi:
+ Alamat email yang digunakan topik Amazon SNS untuk notifikasi diatur ke alamat Anda, atau alamat yang Anda masukkan dalam file. `options.config`
+ Tabel **nodejs-tutorial** akan digunakan sebagai pengganti yang dibuat oleh. `.ebextensions/create-dynamodb-table.config`
1. Hapus `.ebextensions/create-dynamodb-table.config`.
```
~/nodejs-tutorial$ rm .ebextensions/create-dynamodb-table.config
```
Lain kali Anda men-deploy aplikasi, tabel yang dibuat oleh file konfigurasi ini akan dihapus.
1. Terapkan aplikasi yang diperbarui ke lingkungan Elastic Beanstalk Anda dengan perintah. [**eb deploy**](eb3-deploy.md)
```
~/nodejs-example-dynamo$ eb deploy
```
1. Ketika pembuatan lingkungan selesai, gunakan perintah [**eb open**](eb3-open.md) untuk membuka URL lingkungan di browser default.
```
~/nodejs-example-dynamo$ eb open
```
Ketika Anda men-deploy, Elastic Beanstalk memperbarui konfigurasi topik Amazon SNS dan menghapus tabel DynamoDB yang dibuat ketika Anda men-deploy versi pertama aplikasi.
Sekarang, ketika Anda mengakhiri lingkungan, tabel **nodejs-tutorial** tidak akan dihapus. Hal ini memungkinkan Anda melakukan deployment biru/hijau, memodifikasi file konfigurasi, atau menghapus situs web Anda tanpa risiko kehilangan data.
Buka situs Anda di peramban dan verifikasi apakah formulir tersebut bekerja seperti yang diharapkan. Membuat beberapa entri, dan kemudian periksa konsol DynamoDB untuk memverifikasi tabel.
**Untuk melihat tabel**
1. Buka [Halaman tabel](https://console.aws.amazon.com/dynamodb/home?#tables:) di konsol DynamoDB.
1. Temukan tabel **nodejs-tutorial**.
1. Pilih tabel, memilih **Item**, lalu pilih **Melai pencarian** untuk menampilkan semua item dalam tabel.
Anda juga dapat melihat bahwa Elastic Beanstalk menghapus tabel yang dibuat sebelumnya.
## Konfigurasikan lingkungan Anda untuk ketersediaan yang tinggi
Terakhir, konfigurasikan grup Auto Scaling lingkungan Anda dengan jumlah instans minimum yang lebih tinggi. Jalankan setidaknya dua instans setiap saat untuk mencegah terjadinya kegagalan di satu titik server web di lingkungan Anda, dan mengizinkan Anda untuk men-deploy perubahan tanpa membuat situs Anda keluar dari layanan.
**Mengonfigurasi grup Auto Scaling lingkungan Anda untuk ketersediaan yang tinggi**
1. **Buka konsol [Elastic Beanstalk, dan di daftar Wilayah, pilih konsol Elastic](https://console.aws.amazon.com/elasticbeanstalk) Beanstalk.** Wilayah AWS
1. Di panel navigasi, pilih **Lingkungan**, dan kemudian pilih nama lingkungan Anda dari daftar.
1. Pada panel navigasi, pilih **Konfigurasi**.
1. Pada kategori konfigurasi **Kapasitas**, pilih **Edit**.
1. Pada bagian **Grup Auto Scaling**, set **Instans minimum** ke **2**.
1. Untuk menyimpan perubahan pilih **Terapkan** di bagian bawah halaman.
## Pembersihan
Setelah Anda selesai bekerja dengan kode demo, Anda dapat mengakhiri lingkungan Anda. [Elastic Beanstalk menghapus semua sumber daya AWS terkait, [seperti instans EC2 Amazon](using-features.managing.ec2.md)[, instans database, penyeimbang beban, grup keamanan,](using-features.managing.db.md)[dan](using-features.managing.elb.md) alarm.](using-features.alarms.md#using-features.alarms.title)
Menghapus sumber daya tidak menghapus aplikasi Elastic Beanstalk, sehingga Anda dapat membuat lingkungan baru untuk aplikasi Anda kapan saja.
**Untuk mengakhiri lingkungan Elastic Beanstalk Anda dari konsol**
1. **Buka konsol [Elastic Beanstalk, dan di daftar Wilayah, pilih konsol Elastic](https://console.aws.amazon.com/elasticbeanstalk) Beanstalk.** Wilayah AWS
1. Di panel navigasi, pilih **Lingkungan**, dan kemudian pilih nama lingkungan Anda dari daftar.
1. Pilih **Tindakan**, lalu pilih **Terminate environment**.
1. Gunakan kotak dialog di layar untuk mengonfirmasi pengakhiran lingkungan.
Anda juga dapat menghapus tabel DynamoDB eksternal yang Anda buat.
**Untuk menghapus tabel DynamoDB**
1. Buka [Halaman tabel](https://console.aws.amazon.com/dynamodb/home?#tables:) di konsol DynamoDB.
1. Pilih tabel.
1. Pilih **Tindakan**, dan lalu **Hapus tabel**.
1. Pilih **Hapus**.
## Langkah selanjutnya
Contoh aplikasi menggunakan file konfigurasi untuk mengonfigurasi pengaturan perangkat lunak dan membuat AWS sumber daya sebagai bagian dari lingkungan Anda. Lihat [Penyesuaian lingkungan lanjutan dengan file konfigurasi (`.ebextensions`)](ebextensions.md) untuk informasi selengkapnya tentang file konfigurasi dan penggunaannya.
Contoh aplikasi untuk tutorial ini menggunakan kerangka web Express untuk Node.js. Untuk informasi selengkapnya tentang Express, lihat dokumentasi resmi di [expressjs.com](https://expressjs.com).
Terakhir, jika Anda berencana menggunakan aplikasi dalam lingkungan produksi, [konfigurasikan nama domain khusus](customdomains.md) untuk lingkungan Anda dan [aktifkan HTTPS](configuring-https.md) untuk koneksi yang aman.