WebAppTemplate FARM

全端 Web 應用程式範本 - FARM Stack

該儲存庫包含一個在 FARM 解決方案堆疊上運行的全堆疊 Web 應用程式模板，它代表：

• Flask ，一個後端Python Web 框架。
• Mazon Web服務，一種可以託管軟體的雲端服務。
• React ，一個前端JavaScript Web 框架。
• MySQL ，一個關聯式資料庫管理系統。

什麼是農場？

FARM 堆疊或多或少是 LAMP 堆疊的擴展，具有以下顯著變化：

• 中介軟體框架是明確的（Flask）
• 與 MEAN 堆疊一樣，它包括應用程式表示層 (React)
• 軟體運作環境被PaaS/IaaS雲端運算服務（AWS）取代
• 對於使用哪個作業系統沒有意見

燒瓶

Flask 用於編寫可以在 Web UI 和 Web 後端/資料庫之間進行通訊的 Web API/中介軟體。這是整個應用程式的核心，它將全端應用程式的各個部分黏合在一起。

請注意，此特定模板不使用 ORM，而是使用pymysql模組。這意味著開發人員需要編寫 SQL 查詢，但可以最大限度地提高在資料庫上執行所需的查詢的複雜性。

亞馬遜網路服務

AWS 是可以託管應用程式的雲端服務。我們可以在以下服務上託管整個軟體堆疊：

• AWS Lambda用於在無伺服器基礎架構上託管我們的應用程式。我們還可以選擇透過 Zappa 託管 Flask API，這使得部署到生產環境變得非常容易。
• AWS RDS用於託管我們的資料庫。
• AWS S3用於儲存各種其他對象，例如映像和檔案。

這意味著開發人員可以將所有內容保留在一個平台上，並最大限度地減少 DevOps/IT 工作。

反應

React 是 Web UI 運作的框架。 React 應用程式也可以使用 NodeJS 在 AWS Lambda 上運行。

該模板使用 JavaScript / JSX，但也可以使用 TypeScript。

MySQL

MySQL是Web後端使用的關聯式資料庫。這也可以透過其 RDS 服務託管在 AWS 上。

如何在本地運行

要執行此 Web 應用程序，需要完成以下操作：

1. 使用db/中的架構設定本機 MySQL 實例
2. 安裝 API 和 UI 模組
3. 本機運行 API 和 UI

資料庫設定

若要設定 MySQL 實例，請執行下列步驟：

1. 建立並連接到 MySQL 資料庫實例。最常見的方法是使用 MySQL Workbench 或 Linux 命令列介面上的mysql 。
2. 在實例中執行sample.sql 。它將建立一個名為SampleInventory的模式，然後初始化一個名為Inventory表。

API設定

Flask API 的程式碼庫可以在api/目錄中找到。

首次設定 (macOS)

1. 導覽至該目錄後，使用virtualenv farm-stack建立一個 Python 虛擬環境。
2. 使用source farm-stack/bin/activate啟動它
3. 導覽至api/並執行pip3 install -r requirements.txt以安裝 API 所需的所有 Python 模組。
4. 開啟api/目錄中的dbcreds.py並根據需要編輯資料庫憑證。

運行 API

1. 從上面啟動虛擬環境。
2. 執行python3 app.py以在http://localhost:8080上執行 API。

使用者介面設定

React UI 的程式碼庫可以在ui/目錄中找到。該模板使用yarn作為其套件管理器；開發人員在新增模組時不要混合使用npm等其他套件管理器，這一點至關重要。

請注意，此模板中缺少像react-bootstrap這樣的套件。

首次設定 (macOS)

1. 執行yarn install以安裝所需的所有相依性。

運行使用者介面

1. 運行yarn start以開發模式運作。
2. 在瀏覽器上導航至http://localhost:3000 。