Flask Dashboard แบบโอเพ่นซอร์สที่สร้างโดย AppSeed
ด้านบนของการออกแบบที่ทันสมัย AdminKit เป็นแพ็คเกจระดับมืออาชีพที่มาพร้อมกับองค์ประกอบ UI, แบบฟอร์ม, ตาราง, แผนภูมิ, หน้าและไอคอนนับร้อย - สร้างขึ้นบน Bootstrap 5
คุณสมบัติ
$ # Get the code
$ git clone https://github.com/app-generator/flask-adminkit.git
$ cd flask-adminkit
$
$ # Virtualenv modules installation (Unix based systems)
$ virtualenv env
$ source env/bin/activate
$
$ # Virtualenv modules installation (Windows based systems)
$ # virtualenv env
$ # .envScriptsactivate
$
$ # Install modules - SQLite Database
$ pip3 install -r requirements.txt
$
$ # OR with PostgreSQL connector
$ # pip install -r requirements-pgsql.txt
$
$ # Set the FLASK_APP environment variable
$ (Unix/Mac) export FLASK_APP=run.py
$ (Windows) set FLASK_APP=run.py
$ (Powershell) $env :FLASK_APP = " .run.py "
$
$ # Set up the DEBUG environment
$ # (Unix/Mac) export FLASK_ENV=development
$ # (Windows) set FLASK_ENV=development
$ # (Powershell) $env:FLASK_ENV = "development"
$
$ # Start the application (development mode)
$ # --host=0.0.0.0 - expose the app on all network interfaces (default 127.0.0.1)
$ # --port=5000 - specify the app port (default 5000)
$ flask run --host=0.0.0.0 --port=5000
$
$ # Access the dashboard in browser: http://127.0.0.1:5000/
หมายเหตุ: หากต้องการใช้แอป โปรดเข้าสู่หน้าลงทะเบียนและสร้างผู้ใช้ใหม่ หลังจากการตรวจสอบสิทธิ์ แอปจะปลดล็อกหน้าส่วนตัว
โปรเจ็กต์นี้เขียนโค้ดโดยใช้พิมพ์เขียว รูปแบบโรงงานแอป โปรไฟล์การกำหนดค่าแบบคู่ (การพัฒนาและการผลิต) และโครงสร้างที่ใช้งานง่ายดังต่อไปนี้:
เวอร์ชันย่อ
< PROJECT ROOT >
|
| -- app/ # Implements app logic
| | -- base/ # Base Blueprint - handles the authentication
| | -- home/ # Home Blueprint - serve UI Kit pages
| |
| __init__.py # Initialize the app
|
| -- requirements.txt # Development modules - SQLite storage
| -- requirements-mysql.txt # Production modules - Mysql DMBS
| -- requirements-pqsql.txt # Production modules - PostgreSql DMBS
|
| -- .env # Inject Configuration via Environment
| -- config.py # Set up the app
| -- run.py # Start the app - WSGI gateway
|
| -- ************************************************************************
กระแสบูตสแตรป
run.py
โหลดไฟล์ .env
create_app
ที่กำหนดไว้ใน app/ init .pyพิมพ์เขียวของแอป/ฐาน
พิมพ์เขียว ฐาน จัดการการรับรองความถูกต้อง (เส้นทางและแบบฟอร์ม) และการจัดการสินทรัพย์ โครงสร้างแสดงไว้ด้านล่าง:
< PROJECT ROOT >
|
| -- app/
| | -- home/ # Home Blueprint - serve app pages (private area)
| | -- base/ # Base Blueprint - handles the authentication
| | -- static/
| | | -- < css, JS, images > # CSS files, Javascripts files
| |
| | -- templates/ # Templates used to render pages
| |
| | -- includes/ #
| | | -- navigation.html # Top menu component
| | | -- sidebar.html # Sidebar component
| | | -- footer.html # App Footer
| | | -- scripts.html # Scripts common to all pages
| |
| | -- layouts/ # Master pages
| | | -- base-fullscreen.html # Used by Authentication pages
| | | -- base.html # Used by common pages
| |
| | -- accounts/ # Authentication pages
| | -- login.html # Login page
| | -- register.html # Registration page
|
| -- requirements.txt # Development modules - SQLite storage
| -- requirements-mysql.txt # Production modules - Mysql DMBS
| -- requirements-pqsql.txt # Production modules - PostgreSql DMBS
|
| -- .env # Inject Configuration via Environment
| -- config.py # Set up the app
| -- run.py # Start the app - WSGI gateway
|
| -- ************************************************************************
พิมพ์เขียวของแอพ/โฮม
พิมพ์เขียว หน้าแรก จัดการหน้า UI Kit สำหรับผู้ใช้ที่ได้รับการรับรองความถูกต้อง นี่คือโซนส่วนตัวของแอป - โครงสร้างแสดงไว้ด้านล่าง:
< PROJECT ROOT >
|
| -- app/
| | -- base/ # Base Blueprint - handles the authentication
| | -- home/ # Home Blueprint - serve app pages (private area)
| |
| | -- templates/ # UI Kit Pages
| |
| | -- index.html # Default page
| | -- page-404.html # Error 404 - mandatory page
| | -- page-500.html # Error 500 - mandatory page
| | -- page-403.html # Error 403 - mandatory page
| | -- * .html # All other HTML pages
|
| -- requirements.txt # Development modules - SQLite storage
| -- requirements-mysql.txt # Production modules - Mysql DMBS
| -- requirements-pqsql.txt # Production modules - PostgreSql DMBS
|
| -- .env # Inject Configuration via Environment
| -- config.py # Set up the app
| -- run.py # Start the app - WSGI gateway
|
| -- ************************************************************************
แอปนี้มีการกำหนดค่าพื้นฐานให้ดำเนินการใน Docker, Heroku, Gunicorn และ Waitress
แอปพลิเคชันสามารถดำเนินการได้อย่างง่ายดายในคอนเทนเนอร์นักเทียบท่า ขั้นตอน:
รับรหัส
$ git clone https://github.com/app-generator/flask-adminkit.git
$ cd flask-adminkit
เริ่มแอปใน Docker
$ sudo docker-compose pull && sudo docker-compose build && sudo docker-compose up -d
ไปที่ http://localhost:5005
ในเบราว์เซอร์ของคุณ แอปควรเปิดใช้งานและทำงานอยู่
ขั้นตอนในการปรับใช้บน Heroku
heroku login
$ # Clone the source code:
$ git clone https://github.com/app-generator/flask-adminkit.git
$ cd flask-adminkit
$
$ # Check Heroku CLI is installed
$ heroku -v
heroku/7.25.0 win32-x64 node-v12.13.0 # <-- All good
$
$ # Check Heroku CLI is installed
$ heroku login
$ # this commaond will open a browser window - click the login button (in browser)
$
$ # Create the Heroku project
$ heroku create
$
$ # Trigger the LIVE deploy
$ git push heroku master
$
$ # Open the LIVE app in browser
$ heroku open
Gunicorn 'Green Unicorn' เป็นเซิร์ฟเวอร์ Python WSGI HTTP สำหรับ UNIX
ติดตั้งโดยใช้ pip
$ pip install gunicorn
เริ่มแอปโดยใช้ไบนารี gunicorn
$ gunicorn --bind 0.0.0.0:8001 run:app
Serving on http://localhost:8001
ไปที่ http://localhost:8001
ในเบราว์เซอร์ของคุณ แอปควรเปิดใช้งานและทำงานอยู่
Waitress (เทียบเท่ากับ Gunicorn สำหรับ Windows) มีวัตถุประสงค์เพื่อเป็นเซิร์ฟเวอร์ WSGI บริสุทธิ์ของ Python คุณภาพการผลิตพร้อมประสิทธิภาพที่เป็นที่ยอมรับอย่างมาก ไม่มีการขึ้นต่อกันยกเว้นที่อยู่ในไลบรารีมาตรฐาน Python
ติดตั้งโดยใช้ pip
$ pip install waitress
เริ่มแอปโดยใช้พนักงานเสิร์ฟเสิร์ฟ
$ waitress-serve --port=8001 run:app
Serving on http://localhost:8001
ไปที่ http://localhost:8001
ในเบราว์เซอร์ของคุณ แอปควรเปิดใช้งานและทำงานอยู่
Flask Dashboard AdminKit - จัดทำโดย AppSeed App Generator