Python¶

準備工作
支援的版本
基本功能
- 網域名稱
- 範例
應用程式相依套件
選擇 Python 版本
靜態檔案
日誌檔
範例

Simple Hosting 的 Python 主機能讓您輕鬆又快速的佈署您的 Python 應用程式。

準備工作 ¶

熟悉 Python 程式與 WSGI

您的程式必須設定 WSGI 進入點

您必須熟悉 Git

支援的版本 ¶

當您在建立 Python 主機時，您可以選擇兩種版本：

2.7 (可切換到 3.2)

3.6

如果您選擇 Python 2.7 主機，您可以切換 Python 的版本，切換方法請參考下方說明。

基本功能 ¶

您的 Python 程式必須包含一個名為 wsgi.py 的檔，內容包含了應用程式進入點，您可以參考此文件： http://www.python.org/dev/peps/pep-0333/#the-application-framework-side

網域名稱 ¶

在主機建立時已經預先連結了一個測試用的域名。您可以連結其他域名或子域名。全部都會連接到同一份程式碼。

範例 ¶

目錄結構

.
└── wsgi.py

wsgi.py:

def application(environ, start_response):
    start_response('200 OK', [('Content-Type', 'text/html; charset=utf-8')])
    return ['<!DOCTYPE html><html><meta charset="utf-8"><title>It works',
            '</title><h1>It works!</h1>']

應用程式相依套件 ¶

您的應用程式相依套件將會使用 pip 進行安裝，您必須將相依套件寫入 requirements.txt 內。

若要自動安裝相依套件，您必須使用 Git。

當您在本機開發應用程式時，您會使用 pip install 來安裝函式庫。完成後，您要將它佈署到線上環境，請在本機執行下列指令列出所有相關套件：

$ pip freeze > requirements.txt

這個指令會將您所有安裝的模組或是函式庫都列在 requirements.txt 這個檔案內。您必須使用 Git 推送您的程式碼與此檔案到主機上。當您使用 SSH 執行佈署指令時，就會自動安裝相依套件。

關於更多使用 git+ssh 佈署您程式碼的說明，請參閱我們的 Git 文件。

選擇 Python 版本 ¶

備註

此章節僅適用於 Python 2.7 / 3.2 的主機。

您可以在我們提供的版本中指定您要使用的版本。您必須建立一個檔案叫 gandi.yml，存放於專案的根目錄中，定義 python 的版本：

gandi.yml

python:
  version: 3.2

上述設定就會強制使用 Python 3.2 的版本。若是您只建立了檔案但並未設定 python ，或是您的 yaml 格式錯誤，將會跳回預設的版本。如果您指定了不存在的版本，則您的應用程式會無法執行，並且會在佈署日誌跟開機日誌中出現錯誤訊息。

備註

此檔案，跟其他您專案的檔一樣，必須要在您執行佈署指令之前，加入 Git 內並推送到 Simple Hosting 的遠端儲存庫中。

靜態檔案 ¶

請將您的靜態檔案儲存在名為 /static/ 或是 /media/ 的目錄中，這樣 Apache 伺服器就可以存取。

日誌檔 ¶

您的應用程式錯誤訊息將會寫入主機的日誌檔中：

若您使用 SSH 登入時，位置在： /srv/data/var/log/www/uwsgi.log

若您使用 sFTP 登入時，位置在： /lamp0/var/log/www/uwsgi.log

您可以查看這些檔案來了解應用程式是否正常啟動。

您也可以依照您的需求調整日誌檔，請在專案根目錄新增一個檔案叫 logging.ini。

如果想瞭解更多資訊，請參考以下說明：

http://docs.python.org/2/library/logging.config.html#configuration-file-format

http://docs.python.org/2/library/logging.html

範例 ¶

Flask 範例 ¶

https://github.com/crito/minitwit

目錄結構

.
├── minitwit.py
├── requirements.txt
├── static/
├── templates/
└── wsgi.py

wsgi.py:

from minitwit import app as application

requirements.txt:

flask

Django 範例 ¶

目錄結構

.
├── media/
├── cms/
│   ├── manage.py
│   └── cms/
│       ├── init.py
│       ├── settings.py
│       ├── templates/
│       └── urls.py
├── requirements.txt
├── static/
└── wsgi.py

wsgi.py:

import sys
import os
import os.path

sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__),
                                                'cms')))
os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'cms.settings')
from django.core.wsgi import get_wsgi_application
application = get_wsgi_application()

requirements.txt:

django-cms

字元編碼 ¶

若您要在 uwsig 中指定特殊語系，例如您的檔案使用非英文字元，請在 uwsig.py 增加下列設定：

os.environ['LC_ALL']="en_US.UTF-8"
os.environ['LC_LANG']="en_US.UTF-8"