必要條件設定 Python 虛擬環境並安裝 Django 建立 Django 專案針對 Elastic Beanstalk 設定您的 Django 應用程式使用 EB 部署您的網站 CLI 更新您的應用程式清除後續步驟

將 Django 應用程式部署至 Elastic Beanstalk

本教學會演練如何將自動產生的預設 Django 網站部署至執行 Python 的 AWS Elastic Beanstalk 環境。本教學示範說明如何使用 Elastic Beanstalk 環境在雲端託管 Python Web 應用程式。

在本教學中，您將執行下列作業：

設定 Python 虛擬環境並安裝 Django
建立 Django 專案
針對 Elastic Beanstalk 設定您的 Django 應用程式
使用 EB 部署您的網站 CLI
更新您的應用程式
清除

必要條件

按照這個教學課程，您應安裝適用 Python 的所有常見先決條件，包括下列套件：

Python 3.7 或更高版本
pip
virtualenv
awsebcli

教學中會安裝 Django 架構。

注意

使用 EB 建立環境CLI需要服務角色。您可以在 Elastic Beanstalk 主控台建立環境，以建立服務角色。如果您沒有服務角色，EB 會在您執行eb create時CLI嘗試建立一個服務角色。

設定 Python 虛擬環境並安裝 Django

透過 virtualenv 建立虛擬環境，並用其安裝 Django 及依存項目。透過使用虛擬環境，您可以準確知道應用程式需要哪些套件，以便在執行應用程式的 Amazon EC2 執行個體上安裝所需的套件。

下列步驟示範 Unix 系統和 Windows 必須輸入的命令，以不同的標籤顯示。

欲設定您的虛擬環境

建立名為 eb-virt 的虛擬環境。
Unix-based systems
```
~$ virtualenv ~/eb-virt
```
Windows
```
C:\> virtualenv %HOMEPATH%\eb-virt
```
啟用虛擬環境。
Unix-based systems
```
~$ source ~/eb-virt/bin/activate
(eb-virt) ~$
```
Windows
```
C:\>%HOMEPATH%\eb-virt\Scripts\activate
(eb-virt) C:\>
```
您的命令提示字元前方會加上 (eb-virt)，表示您正位於虛擬環境中。

注意
其餘說明會顯示您主目錄的 Linux 命令提示字元 ~$。在視窗上C:\Users\USERNAME>，這是哪裡 USERNAME 是您的視窗登入名稱。
使用 pip 安裝 Django。
```
(eb-virt)~$ pip install django==2.2
```
注意
您安裝的 Django 版本必須與您在 Elastic Beanstalk Python 組態選擇用於部署應用程式的 Python 版本相容。如需部署的資訊，請參閱本主題中的使用 EB 部署您的網站 CLI。
如需目前 Python 平台版本的詳細資訊，請參閱《AWS Elastic Beanstalk 平台文件》中的 Python。
如需 Django 版本與 Python 的相容性詳細資訊，請參閱 What Python version can I use with Django?
若要確認是否已安裝 Django，請輸入以下內容。
```
(eb-virt)~$ pip freeze
Django==2.2
...
```
本命令列出您虛擬環境安裝的所有套件。稍後，使用此命令的輸出設定您的專案，以搭配 Elastic Beanstalk 使用。

建立 Django 專案

現在您已準備就緒，能夠建立 Django 專案並使用虛擬環境執行於您的機器。

注意

本教程使用SQLite，它是 Python 中包含的數據庫引擎。這個資料庫會和您的專案檔案一同部署。對於生產環境，我們建議您使用 Amazon Relational Database Service (AmazonRDS)，並將其與環境分開。如需詳細資訊，請參閱將 Amazon RDS 數據庫實例添加到您的 Python Elastic Beanstalk 環境。

欲產生 Django 應用程式

啟用您的虛擬環境。
Unix-based systems
```
~$ source ~/eb-virt/bin/activate
(eb-virt) ~$
```
Windows
```
C:\>%HOMEPATH%\eb-virt\Scripts\activate
(eb-virt) C:\>
```
您的命令提示字元前方會加上 (eb-virt) 前綴，表示您正位於虛擬環境中。

注意
其餘說明會顯示您主目錄的 Linux 命令提示字元 ~$ 以及 Linux 主目錄 ~/。在窗戶上這些是C:\Users\USERNAME>，在哪裡 USERNAME 是您的視窗登入名稱。

使用 django-admin startproject 命令建立名為 ebdjango 的 Django 專案。


(eb-virt)~$ django-admin startproject ebdjango

此命令會建立名為 ebdjango 的標準 Django 網站，採用下列目錄結構。


~/ebdjango
  |-- ebdjango
  |   |-- __init__.py
  |   |-- settings.py
  |   |-- urls.py
  |   `-- wsgi.py
  `-- manage.py

使用 manage.py runserver 在本機執行您的 Django 網站。


(eb-virt) ~$ cd ebdjango


(eb-virt) ~/ebdjango$ python manage.py runserver

在 Web 瀏覽器中開啟 http://127.0.0.1:8000/ 以檢視此網站。

檢查伺服器日誌，以查看您請求的輸出。若要停止 Web 伺服器並返回您的虛擬環境，請按 Ctrl+C。


Django version 2.2, using settings 'ebdjango.settings'
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.
[07/Sep/2018 20:14:09] "GET / HTTP/1.1" 200 16348
Ctrl+C

針對 Elastic Beanstalk 設定您的 Django 應用程式

現在您的本機已具備採用 Django 的網站，因此您可將其設定為透過 Elastic Beanstalk 進行部署。

根據預設，Elastic Beanstalk 會尋找名為 application.py 的檔案，以啟動您的應用程式。因為您建立的 Django 專案中不存在此檔案，所以您需要對您的應用程式環境稍加調整。您也必須設定環境變數，以便載入您的應用程式模組。

欲針對 Elastic Beanstalk 設定您的網站

啟用您的虛擬環境。

執行 pip freeze，然後將輸出儲存至名為 requirements.txt 的檔案。
```
(eb-virt) ~/ebdjango$ pip freeze > requirements.txt
```
Elastic Beanstalk 使用requirements.txt來決定要在執行應用程式的EC2執行個體上安裝哪個套件。

建立名為 .ebextensions 的目錄。


(eb-virt) ~/ebdjango$ mkdir .ebextensions

在 .ebextensions 目錄中，新增具有下列文字的組態檔案 django.config。
範例 ~/ebdjango/.ebextensions/django.config
```
option_settings:
  aws:elasticbeanstalk:container:python:
    WSGIPath: ebdjango.wsgi:application
```
此設定會指定 Elastic Beanstalk 用來啟動應用程式的指WSGI令碼位置。WSGIPath

注意
如果您使用的是 Amazon Linux AMI Python 平台版本（在 Amazon Linux 2 之前），請將的值替換為 WSGIPathebdjango/wsgi.py. 範例中的值適用於 Gunicorn WSGI 伺服器，該伺服器在 Amazon Linux AMI 平台版本上不受支援。
使用 deactivate 命令停用您的虛擬環境。
```
(eb-virt) ~/ebdjango$ deactivate
```
每當需要將套裝服務新增至應用程式，或於本機執行應用程式時，即可重新啟用您的虛擬環境。

使用 EB 部署您的網站 CLI

您已新增於 Elastic Beanstalk 部署應用程式所需的所有事物。您的專案目錄現應如下所示。


~/ebdjango/
|-- .ebextensions
|   `-- django.config
|-- ebdjango
|   |-- __init__.py
|   |-- settings.py
|   |-- urls.py
|   `-- wsgi.py
|-- db.sqlite3
|-- manage.py
`-- requirements.txt

接著，您將建立應用程式環境，並透過 Elastic Beanstalk 部署已設定的應用程式。

部署後，您要立即編輯 Django 的組態，將 Elastic Beanstalk 指派給您應用程式的網域名稱新增至 Django 的 ALLOWED_HOSTS。然後，您要重新部署應用程式。這是 Django 的安全要求，旨在防止HTTPHost標頭攻擊。如需詳細資訊，請參閱主機標頭驗證。

欲建立環境並部署您的 Django 應用程式

注意

本教學課程使用 EB CLI 做為部署機制，但您也可以使用 Elastic Beanstalk 主控台來部署包含專案內容的 .zip 檔案。

使用eb init命令初始化您的 EB CLI 存放庫。
```
~/ebdjango$ eb init -p python-3.7 django-tutorial
Application django-tutorial has been created.
```
此命令會建立名為 django-tutorial 的應用程式。這也會設定您的本機儲存庫，使用最新的 Python 3.7 平台版本建立環境。
(選擇性) eb init 再次執行以設定預設 key pair，以便您可以用SSH來連線至執行應用程式的執行個EC2體。
```
~/ebdjango$ eb init
Do you want to set up SSH for your instances?
(y/n): y
Select a keypair.
1) my-keypair
2) [ Create new KeyPair ]
```
若您已有金鑰對，請選擇一對，或依照提示建立金鑰對。若未出現提示，或稍後需要變更設定，請執行 eb init -i。
使用 eb create 建立環境並於其中部署您的應用程式。
```
~/ebdjango$ eb create django-env
```
注意
如果您看到「需要服務角色」錯誤訊息，請以eb create互動方式執行 (不指定環境名稱)，EB CLI 會為您建立角色。

本命令會建立名為 django-env 的負載平衡 Elastic Beanstalk 環境。建立環境約需要 5 分鐘。隨著 Elastic Beanstalk 建立執行應用程式所需的資源，它會輸出 EB CLI 轉送到您的終端機的資訊訊息。

完成環境建立程序後，請執行 eb status 尋找新環境的網域名稱。


~/ebdjango$ eb status
Environment details for: django-env
  Application name: django-tutorial
  ...
  CNAME: eb-django-app-dev.elasticbeanstalk.com
  ...

您環境的網域名稱為 CNAME 屬性的數值。

在 settings.py 目錄中，開啟檔案 ebdjango。找出 ALLOWED_HOSTS 設定，然後將您在上個步驟中找到的應用程式網域名稱新增至設定值中。如果您無法找到檔案中的這個設定，請在新行中新增。
```
...
ALLOWED_HOSTS = ['eb-django-app-dev.elasticbeanstalk.com']
```
儲存檔案，然後執行 eb deploy 來部署應用程式。當您執行時eb deploy，EB 會CLI捆綁專案目錄的內容，並將其部署到您的環境。
```
~/ebdjango$ eb deploy
```
注意
如果您使用 Git 來處理專案，請參閱搭配 Git 使用 EB CLI。
完成環境更新程序後，請使用 eb open 開啟您的網站。
```
~/ebdjango$ eb open
```
這會開啟瀏覽器視窗，並使用為應用程式建立的網域名稱。您應該會看到與本機建立和測試相同的 Django 網站。

若未顯示您的應用程式正在執行，或收到錯誤訊息，請參閱疑難排解部署尋求協助，以判斷錯誤發生的原因。

若您「確實」看見您的應用程式正在執行，恭喜您，您透過 Elastic Beanstalk 部署的第一個 Django 應用程式已完成！

更新您的應用程式

現在，您已於 Elastic Beanstalk 上執行應用程式，可以更新並重新部署應用程式或其組態，Elastic Beanstalk 會負責更新您的執行個體，並啟動新的應用程式版本。

在此範例中，我們將啟用 Django 管理主控台，並進行數項設定。

修改您的網站設定

默認情況下，您的 Django 網站使用UTC時區來顯示時間。您可在 settings.py 中指定時區來進行變更。

欲變更您網站的時區

在 settings.py 中修改 TIME_ZONE 設定。

範例 ~/ebdjango/ebdjango/settings.py


...
# Internationalization
LANGUAGE_CODE = 'en-us'
TIME_ZONE = 'US/Pacific'
USE_I18N = True
USE_L10N = True
USE_TZ = True

如需時區清單，請造訪此頁面。

將應用程式部署至您的 Elastic Beanstalk 環境。
```
~/ebdjango/$ eb deploy
```

建立網站管理員

您可以為 Django 應用程式建立網站管理員，從網站直接存取管理主控台。管理員登入詳細資訊安全存放於本機資料庫映像，位於 Django 產生的預設專案中。

欲建立網站管理員

初始化您 Django 應用程式的本機資料庫。


(eb-virt) ~/ebdjango$ python manage.py migrate
Operations to perform:
  Apply all migrations: admin, auth, contenttypes, sessions
Running migrations:
  Applying contenttypes.0001_initial... OK
  Applying auth.0001_initial... OK
  Applying admin.0001_initial... OK
  Applying admin.0002_logentry_remove_auto_add... OK
  Applying admin.0003_logentry_add_action_flag_choices... OK
  Applying contenttypes.0002_remove_content_type_name... OK
  Applying auth.0002_alter_permission_name_max_length... OK
  Applying auth.0003_alter_user_email_max_length... OK
  Applying auth.0004_alter_user_username_opts... OK
  Applying auth.0005_alter_user_last_login_null... OK
  Applying auth.0006_require_contenttypes_0002... OK
  Applying auth.0007_alter_validators_add_error_messages... OK
  Applying auth.0008_alter_user_username_max_length... OK
  Applying auth.0009_alter_user_last_name_max_length... OK
  Applying sessions.0001_initial... OK

執行 manage.py createsuperuser 以建立管理員。


(eb-virt) ~/ebdjango$ python manage.py createsuperuser
Username: admin
Email address: me@mydomain.com
Password: ********
Password (again): ********
Superuser created successfully.

若要指示 Django 存放靜態檔案的位置，請在 settings.py 中定義 STATIC_ROOT。

範例 ~/ebdjango/ebdjango/settings.py


# Static files (CSS, JavaScript, Images)
# https://docs.djangoproject.com/en/2.2/howto/static-files/
STATIC_URL = '/static/'
STATIC_ROOT = 'static'

執行manage.py collectstatic以在目static錄中填入管理網站的靜態資產 (JavaScriptCSS、和影像)。


(eb-virt) ~/ebdjango$ python manage.py collectstatic
119 static files copied to ~/ebdjango/static

部署您的應用程式。
```
~/ebdjango$ eb deploy
```
在瀏覽器中開啟網站，並附加/admin/至網站，如下所示URL，以檢視管理控制台。
```
http://djang-env.p33kq46sfh.us-west-2.elasticbeanstalk.com/admin/
```
使用您於步驟 2 中設定的使用者名稱和密碼登入。

您可以使用類似於本機更新/測試的程序，之後進行 eb deploy。Elastic Beanstalk 會負責更新線上伺服器，因此您能夠專心開發應用程式，不受伺服器管理作業影響！

新增資料庫遷移組態檔案

您可以將命令新增至 .ebextensions 指令碼，這是更新網站時所執行的指令碼。這可讓您自動產生資料庫遷移。

欲在部署應用程式時新增遷移步驟

使用下列內容，建立名為 db-migrate.config 的組態檔案。
範例 ~/ebdjango/.ebextensions/db-migrate.config
```
container_commands:
  01_migrate:
    command: "source /var/app/venv/*/bin/activate && python3 manage.py migrate"
    leader_only: true
option_settings:
  aws:elasticbeanstalk:application:environment:
    DJANGO_SETTINGS_MODULE: ebdjango.settings
```
此組態檔案會先在部署過程中啟用伺服器的虛擬環境並執行 manage.py migrate 命令，再啟動您的應用程式。由於此命令在啟動應用程式前執行，因此您必須明確設定 DJANGO_SETTINGS_MODULE 環境變數 (wsgi.py 通常會於啟動時負責此作業)。於命令中指定 leader_only: true，可確保當您部署多個執行個體時，該命令僅執行一次。
部署您的應用程式。
```
~/ebdjango$ eb deploy
```

清除

若要節省開發工作階段之間的執行個體時數和其他 AWS 資源，請使用終止 Elastic Beanstalk 環境。eb terminate


~/ebdjango$ eb terminate django-env

此命令會終止環境及其中執行的所有 AWS 資源。但它不會刪除應用程式，因此您隨時能夠再次執行 eb create，以同一組態建立更多的環境。如需 EB CLI 指令的更多資訊，請參閱使用 EB CLI 管理 Elastic Beanstalk 環境。

如不再需要範例應用程式，您也可以移除專案資料夾和虛擬環境。


~$ rm -rf ~/eb-virt
~$ rm -rf ~/ebdjango

後續步驟

如需 Django 的詳細資訊 (包括更深入的教學)，請參閱官方文件。

若欲嘗試其他 Python Web 框架，請參閱將 Flask 應用程式部署至 Elastic Beanstalk。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

教學 - Flask

新增資料庫

將 Django 應用程式部署至 Elastic Beanstalk

必要條件

注意

設定 Python 虛擬環境並安裝 Django

欲設定您的虛擬環境

注意

注意

建立 Django 專案

注意

欲產生 Django 應用程式

注意

針對 Elastic Beanstalk 設定您的 Django 應用程式

欲針對 Elastic Beanstalk 設定您的網站

範例 ~/ebdjango/.ebextensions/django.config

注意

使用 EB 部署您的網站 CLI

欲建立環境並部署您的 Django 應用程式

注意

注意

注意

更新您的應用程式

修改您的網站設定

欲變更您網站的時區

範例 ~/ebdjango/ebdjango/settings.py

建立網站管理員

欲建立網站管理員

範例 ~/ebdjango/ebdjango/settings.py

新增資料庫遷移組態檔案

欲在部署應用程式時新增遷移步驟

範例 ~/ebdjango/.ebextensions/db-migrate.config

清除

後續步驟