Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Tutorial ini memandu Anda melalui proses menghasilkan aplikasi Flask dan menyebarkannya ke lingkungan AWS Elastic Beanstalk . Flask adalah kerangka kerja aplikasi web sumber terbuka untuk Python.
Dalam tutorial ini, Anda akan melakukan hal berikut:
Prasyarat
Tutorial ini mengasumsikan Anda memiliki pengetahuan tentang operasi Elastic Beanstalk dasar dan konsol Elastic Beanstalk. Jika belum, ikuti petunjuk di Memulai dengan Elastic Beanstalk untuk meluncurkan lingkungan Elastic Beanstalk pertama Anda.
Untuk mengikuti prosedur di panduan ini, Anda memerlukan terminal atau shell baris perintah untuk menjalankan perintah. Perintah ditampilkan dalam daftar yang diawali dengan simbol prompt ($) dan nama direktori saat ini, bila perlu.
~/eb-project$ this is a command
this is outputDi Linux dan macOS, Anda dapat menggunakan shell dan manajer paket pilihan Anda. Pada Windows Anda dapat menginstal Windows Subsystem untuk Linux untuk
Flask membutuhkan Python 3.7 atau yang lebih baru. Dalam tutorial ini kita menggunakan Python 3.7 dan versi platform Elastic Beanstalk yang sesuai. Pasang Python dengan mengikuti petunjuk di Menyiapkan lingkungan pengembangan Python Anda untuk Elastic Beanstalk.
Kerangka kerja Flask
Tutorial ini juga menggunakan Elastic Beanstalk Command Line Interface (EB CLI). Untuk detail dalam menginstal dan mengonfigurasi EB CLI, lihat Pasang Antarmuka Baris Perintah Elastic Beanstalk dan Mengonfigurasi EB CLI.
Menyiapkan lingkungan virtual Python dengan Flask
Membuat direktori proyek dan lingkungan virtual untuk aplikasi Anda, dan menginstal Flask.
Untuk mempersiapkan lingkungan proyek Anda
-
Buat direktori proyek.
~$mkdir eb-flask~$cd eb-flask -
Buat dan aktifkan lingkungan virtual bernama
virt:~/eb-flask$virtualenv virt~$source virt/bin/activate(virt) ~/eb-flask$Anda akan melihat
(virt)ditambahkan ke prompt perintah Anda, yang menunjukkan bahwa Anda berada di lingkungan virtual. Gunakan lingkungan virtual hingga akhir tutorial ini. -
Pasang Flask dengan
pip install:(virt)~/eb-flask$pip install flask==2.0.3 -
Lihat perpustakaan yang diinstal dengan
pip freeze:(virt)~/eb-flask$pip freezeclick==8.1.1 Flask==2.0.3 itsdangerous==2.1.2 Jinja2==3.1.1 MarkupSafe==2.1.1 Werkzeug==2.1.0Perintah ini mencantumkan semua paket yang diinstal di lingkungan virtual Anda. Berhubung Anda berada di lingkungan virtual, paket yang diinstal secara global seperti EB CLI tidak akan ditampilkan.
-
Simpan output dari
pip freezeke file bernamarequirements.txt.(virt)~/eb-flask$pip freeze > requirements.txtFile ini meminta Elastic Beanstalk untuk menginstal perpustakaan selama deployment. Untuk informasi selengkapnya, lihat Menentukan dependensi menggunakan file persyaratan pada Elastic Beanstalk.
Buat aplikasi Flask
Selanjutnya, buat aplikasi yang akan Anda deploy menggunakan Elastic Beanstalk. Kami akan membuat layanan RESTful web “Hello World”.
Buat file teks dalam direktori ini bernama application.py dengan isi berikut:
contoh ~/eb-flask/application.py
from flask import Flask
# print a nice greeting.
def say_hello(username = "World"):
return '<p>Hello %s!</p>\n' % username
# some bits of text for the page.
header_text = '''
<html>\n<head> <title>EB Flask Test</title> </head>\n<body>'''
instructions = '''
<p><em>Hint</em>: This is a RESTful web service! Append a username
to the URL (for example: <code>/Thelonious</code>) to say hello to
someone specific.</p>\n'''
home_link = '<p><a href="/">Back</a></p>\n'
footer_text = '</body>\n</html>'
# EB looks for an 'application' callable by default.
application = Flask(__name__)
# add a rule for the index page.
application.add_url_rule('/', 'index', (lambda: header_text +
say_hello() + instructions + footer_text))
# add a rule when the page is accessed with a name appended to the site
# URL.
application.add_url_rule('/<username>', 'hello', (lambda username:
header_text + say_hello(username) + home_link + footer_text))
# run the app.
if __name__ == "__main__":
# Setting debug to True enables debug output. This line should be
# removed before deploying a production app.
application.debug = True
application.run()Contoh ini membuat penyesuaian salam pembuka yang bervariasi berdasarkan jalur yang digunakan untuk mengakses layanan.
catatan
Dengan menambahkan application.debug = True sebelum menjalankan aplikasi, output debug diaktifkan jika seandainya ada sesuatu yang tidak beres. Hal ini merupakan penerapan yang baik untuk pengembangan, tetapi Anda harus menghapus pernyataan debug dalam kode produksi, karena output debug dapat mengungkapkan aspek internal aplikasi Anda.
Menggunakan application.py sebagai nama file dan memberikan objek application yang dapat dipanggil (objek Flask, dalam hal ini) mengizinkan Elastic Beanstalk dengan mudah untuk menemukan kode aplikasi Anda.
Jalankan application.py dengan Python:
(virt) ~/eb-flask$ python application.py
* Serving Flask app "application" (lazy loading)
* Environment: production
WARNING: Do not use the development server in a production environment.
Use a production WSGI server instead.
* Debug mode: on
* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)
* Restarting with stat
* Debugger is active!
* Debugger PIN: 313-155-123Buka http://127.0.0.1:5000/ di peramban web Anda. Anda harus melihat aplikasi yang berjalan, menunjukkan halaman indeks:
Periksa log server untuk melihat output dari permintaan Anda. Anda dapat menghentikan server web dan mengembalikan ke lingkungan virtual Anda dengan mengetik Ctrl+C.
Jika Anda justru mendapati output debug, perbaiki kesalahan dan pastikan aplikasi berjalan secara lokal sebelum mengonfigurasinya untuk Elastic Beanstalk.
Men-deploy situs Anda dengan EB CLI
Anda telah menambahkan semua yang dibutuhkan untuk men-deploy aplikasi Anda pada Elastic Beanstalk. Direktori proyek Anda seharusnya sekarang terlihat seperti ini:
~/eb-flask/
|-- virt
|-- application.py
`-- requirements.txtFolder virt, bagaimanapun, tidak diperlukan aplikasi untuk berjalan di Elastic Beanstalk. Ketika Anda men-deploy, Elastic Beanstalk akan membuat lingkungan virtual baru pada instans server dan menginstal perpustakaan yang tercantum dalam requirements.txt. Untuk meminimalkan ukuran paket sumber yang Anda unggah selama deployment, tambahkan file .ebignore yang meminta EB CLI untuk meninggalkan folder virt.
contoh ~/eb-flask/.ebignore
virt
Selanjutnya, Anda akan membuat lingkungan aplikasi dan men-deploy aplikasi Anda yang dikonfigurasi dengan Elastic Beanstalk.
Untuk membuat lingkungan dan men-deploy aplikasi Flask Anda
-
Inisialisasi repositori EB CLI Anda dengan perintah eb init:
~/eb-flask$eb init -p python-3.7 flask-tutorial --region us-east-2Application flask-tutorial has been created.Perintah ini membuat aplikasi baru bernama
flask-tutorialdan mengkonfigurasi repositori lokal Anda untuk membuat lingkungan dengan versi platform Python 3.7 terbaru. -
(opsional) Jalankan eb init lagi untuk mengonfigurasi keypair default sehingga Anda dapat terhubung ke EC2 instance yang menjalankan aplikasi Anda dengan SSH:
~/eb-flask$eb initDo you want to set up SSH for your instances? (y/n):ySelect a keypair. 1) my-keypair 2) [ Create new KeyPair ]Pilih pasangan kunci jika Anda sudah memilikinya, atau ikuti prompt untuk membuat yang baru. Jika Anda tidak melihat prompt atau perlu mengubah pengaturan Anda nanti, jalankan eb init -i.
-
Buat lingkungan dan deploy aplikasi Anda ke dalamnya dengan eb create:
~/eb-flask$eb create flask-env
Pembuatan lingkungan membutuhkan waktu sekitar 5 menit dan membuat 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.
-
AWS CloudFormation stack - Elastic AWS 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 AWS CloudFormation
. -
Nama domain — Nama domain yang merutekan ke aplikasi web Anda dalam formulir
subdomain.region.elasticbeanstalk.com.Keamanan domain
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-Cookiedi Jaringan Pengembang Mozilla.
Semua sumber daya ini dikelola oleh Elastic Beanstalk. Ketika Anda mengakhiri lingkungan, Elastic Beanstalk mengakhiri semua sumber daya yang dimuatnya.
catatan
Bucket Amazon S3 yang dibuat Elastic Beanstalk dibagi antar lingkungan dan tidak dihapus selama pengakhiran lingkungan. Untuk informasi selengkapnya, lihat Menggunakan Elastic Beanstalk dengan Amazon S3.
Ketika proses pembuatan lingkungan selesai, buka situs web Anda dengan eb open:
~/eb-flask$ eb openIni akan membuka jendela peramban menggunakan nama domain yang dibuat untuk aplikasi Anda. Anda akan melihat situs web Flask yang sama seperti yang Anda telah buat dan uji secara lokal.
Jika aplikasi tidak berjalan, atau menerima pesan kesalahan, lihat Pemecahan Masalah Deployment untuk bantuan tentang cara menentukan penyebab kesalahan.
Jika Anda benar-benar melihat aplikasi Anda berjalan, maka selamat, Anda telah men-deploy aplikasi Flask pertama Anda dengan Elastic Beanstalk!
Pembersihan
Jika Anda sudah selesai bekerja dengan Elastic Beanstalk, Anda dapat mengakhiri lingkungan Anda. Elastic Beanstalk AWS menghentikan semua sumber daya yang terkait dengan lingkungan Anda, seperti instans EC2 Amazon, instans database, penyeimbang beban, grup keamanan,dan alarm.
Untuk mengakhiri lingkungan Elastic Beanstalk Anda dari konsol
Buka konsol Elastic Beanstalk, dan di daftar Wilayah, pilih konsol Elastic
Beanstalk. Wilayah AWS -
Di panel navigasi, pilih Lingkungan, dan kemudian pilih nama lingkungan Anda dari daftar.
catatan
Jika Anda memiliki banyak lingkungan, gunakan bar pencarian untuk memfilter daftar lingkungan.
-
Pilih Tindakan, lalu pilih Terminate environment.
-
Gunakan kotak dialog di layar untuk mengonfirmasi pengakhiran lingkungan.
Dengan Elastic Beanstalk, Anda dengan mudah dapat membuat lingkungan baru untuk aplikasi Anda kapan saja.
Atau, dengan EB CLI:
~/eb-flask$ eb terminate flask-envLangkah selanjutnya
Untuk informasi lebih selengkapnya tentang Flask, kunjungi flask.pocoo.org
Jika anda ingin mencoba kerangka kerja web Python lain, lihat Men-deploy aplikasi Django ke Elastic Beanstalk.
