Django Deployment Workshop 技术文档

1. 安装指南

在开始部署之前，请确保您的服务器操作系统为 Ubuntu 10.04 LTS，否则某些脚本可能无法正常工作。

安装依赖

1. 安装 pip 和 virtualenv：

   sudo apt-get install python-pip python-dev build-essential
   pip install virtualenv
   

2. 安装 Apache、mod_wsgi 和 Gunicorn：

   sudo apt-get install apache2 libapache2-mod-wsgi
   pip install gunicorn
   

3. 安装 Nginx：

   sudo apt-get install nginx
   

4. 安装 Memcached：

   sudo apt-get install memcached
   

5. 安装 PostgreSQL 和 pgpool：

   sudo apt-get install postgresql postgresql-contrib
   sudo apt-get install pgpool2
   

配置 PostgreSQL

1. 创建一个新的 PostgreSQL 数据库用户和数据库：

   sudo -u postgres createuser -d -P yourusername
   sudo -u postgres createdb -O yourusername yourdbname
   

2. 配置 pg_hba.conf 文件以允许本地连接：

   host    all             all             127.0.0.1/32            trust
   host    all             all             ::1/128                 trust
   

3. 重启 PostgreSQL 服务：

   sudo service postgresql restart
   

配置 Memcached

编辑 /etc/memcached.conf 文件，确保 [memcached] 部分的 listen 设置为 localhost：

[memcached]
listen = 127.0.0.1:11211

重启 Memcached 服务：

sudo service memcached restart

2. 项目的使用说明

本项目使用 Fabric 脚本来进行部署。以下是一个基本的部署流程：

1. 克隆项目仓库：

   git clone https://github.com/yourusername/django-deployment-workshop.git
   cd django-deployment-workshop
   

2. 配置项目 settings：

   在项目根目录下创建一个 local_settings.py 文件，并添加以下内容：

   DATABASES = {
       'default': {
           'ENGINE': 'django.db.backends.postgresql_psycopg2',
           'NAME': 'yourdbname',
           'USER': 'yourusername',
           'PASSWORD': 'yourpassword',
           'HOST': 'localhost',
           'PORT': '',
       }
   }
   
   CACHES = {
       'default': {
           'BACKEND': 'django.core.cache.backends.memcached.MemcachedCache',
           'LOCATION': '127.0.0.1:11211',
       }
   }
   

3. 运行部署脚本：

   fab deploy
   

3. 项目API使用文档

本项目不提供特定的 API 接口，但是作为 Django 项目，您可以按照 Django 的标准方式开发和使用 API。

4. 项目安装方式

请参考上述的“安装指南”部分进行项目安装。