WebAppTemplate FARM

Templat Aplikasi Web Tumpukan Penuh - FARM Stack

Repositori ini berisi templat aplikasi web tumpukan penuh yang berjalan pada tumpukan solusi FARM, yang merupakan singkatan dari:

• Terakhir , kerangka web backend Python .
• Layanan Web mazon, layanan cloud yang dapat menghosting perangkat lunak.
• R eact, kerangka web JavaScript frontend.
• M ySQL, sistem manajemen basis data relasional.

Apa itu PERTANIAN?

Tumpukan FARM kurang lebih merupakan perpanjangan dari tumpukan LAMP dengan perubahan penting berikut:

• Kerangka kerja middleware bersifat eksplisit (Flask)
• Seperti tumpukan MEAN, ini mencakup lapisan presentasi aplikasi (React)
• Lingkungan tempat perangkat lunak dijalankan digantikan oleh layanan komputasi awan (AWS) PaaS/IaaS
• Tidak ada pendapat tentang sistem operasi mana yang akan digunakan

Labu

Flask digunakan untuk menulis API web/middleware yang dapat berkomunikasi antara UI web dan backend web/database. Ini adalah inti dari keseluruhan aplikasi yang merekatkan potongan-potongan aplikasi tumpukan penuh menjadi satu.

Perhatikan bahwa templat khusus ini tidak menggunakan ORM, melainkan menggunakan modul pymysql . Ini berarti pengembang perlu menulis kueri SQL, namun dapat memaksimalkan kompleksitas kueri yang mereka perlukan untuk dijalankan di database.

Layanan Web Amazon

AWS adalah layanan cloud tempat aplikasi dapat dihosting. Kami dapat menghosting seluruh tumpukan perangkat lunak pada layanan berikut:

• AWS Lambda untuk menghosting aplikasi kami pada infrastruktur tanpa server. Kami juga dapat memilih untuk menghosting Flask API kami melalui Zappa, sehingga penerapan ke produksi menjadi sangat mudah.
• AWS RDS untuk menghosting database kami.
• AWS S3 untuk menyimpan segala macam objek lain seperti gambar dan file.

Artinya, pengembang dapat menyimpan semuanya dalam satu platform dan meminimalkan pekerjaan DevOps/TI.

Bereaksi

React adalah kerangka kerja yang menjalankan UI web. Aplikasi React juga dapat dijalankan di AWS Lambda dengan NodeJS.

Template ini menggunakan JavaScript/JSX, tetapi TypeScript juga dapat digunakan.

MySQL

MySQL adalah database relasional yang digunakan backend web. Ini juga dapat dihosting di AWS melalui layanan RDS-nya.

Cara Menjalankan Secara Lokal

Untuk menjalankan aplikasi web ini, hal-hal berikut perlu dilakukan:

1. Siapkan instance MySQL lokal menggunakan skema di db/
2. Instal modul untuk API dan UI
3. Jalankan API dan UI secara lokal

Pengaturan Basis Data

Untuk menyiapkan instans MySQL, ikuti langkah-langkah berikut:

1. Membuat dan menyambungkan ke instans database MySQL. Cara paling umum untuk melakukan ini adalah dengan MySQL Workbench atau mysql pada antarmuka baris perintah Linux.
2. Jalankan sample.sql dalam instance. Ini akan membuat skema yang disebut SampleInventory dan kemudian menginisialisasi tabel yang disebut Inventory .

Pengaturan API

Basis kode untuk Flask API dapat ditemukan di direktori api/ .

Pengaturan Pertama Kali (macOS)

1. Buat lingkungan virtual Python dengan virtualenv farm-stack setelah menavigasi ke direktori itu.
2. Aktifkan dengan source farm-stack/bin/activate
3. Navigasikan ke api/ dan jalankan pip3 install -r requirements.txt untuk menginstal semua modul Python yang diperlukan untuk API.
4. Buka dbcreds.py di direktori api/ dan edit kredensial database sesuai kebutuhan.

Menjalankan API

1. Aktifkan lingkungan virtual dari atas.
2. Jalankan python3 app.py untuk menjalankan API di http://localhost:8080 .

Pengaturan UI

Basis kode untuk React UI dapat ditemukan di direktori ui/ . Templat ini menggunakan yarn sebagai pengelola paketnya; sangat penting bagi pengembang untuk tidak mencampuradukkan pengelola paket lain seperti npm saat menambahkan modul baru.

Perhatikan bahwa paket seperti react-bootstrap tidak ada di template ini.

Pengaturan Pertama Kali (macOS)

1. Jalankan yarn install untuk menginstal semua dependensi yang diperlukan.

Menjalankan UI

1. Jalankan yarn start berjalan dalam mode pengembangan.
2. Arahkan ke http://localhost:3000 di browser.