dbcawa/gokart

Gokart Docker镜像文档

概述和主要用途

Gokart Docker镜像是为简化Gokart应用构建与部署而设计的预配置环境包。Gokart是由西澳大利亚生物多样性、保护与景点部（DBCA）开发的基于Django的Web应用，主要用于管理公园、保护区的活动许可、预订及相关业务流程。该镜像整合了应用运行所需的所有依赖、配置文件和环境设置，旨在降低部署复杂度，实现快速、一致的应用交付。

核心功能和特性

• 预配置运行环境：包含Python、Django、数据库驱动等应用依赖，无需手动安装配置
• 简化构建流程：集成构建脚本，支持一键生成应用部署包
• 环境隔离：通过Docker容器化确保应用运行环境与主机系统隔离，避免依赖冲突
• 可定制配置：支持通过环境变量和挂载配置文件自定义应用参数
• 多阶段构建支持：优化镜像体积，区分构建环境与运行环境

使用场景和适用范围

• 开发环境快速搭建：供开发团队快速初始化本地开发环境，统一开发配置
• 测试环境部署：用于自动化测试流程，确保测试环境一致性
• 生产环境部署：支持生产环境中的容器化部署，配合Docker Compose或Kubernetes实现规模化管理
• 适用机构：公园管理部门、自然保护区管理机构、环境监管组织等需要管理户外许可和活动的单位

使用方法和配置说明

前提条件

• Docker Engine 20.10+
• Docker Compose 2.0+（如需使用编排功能）

获取镜像

从私有仓库拉取镜像（需权限）：

bash
docker pull docker.xuanyuan.run/dbca-wa/gokart:latest

基本运行示例

使用docker run命令启动容器：

bash
docker run -d \
  --name gokart-app \
  -p 8000:8000 \
  -e DATABASE_URL=postgresql://user:password@db-host:5432/gokart \
  -e SECRET_KEY=your-secure-secret-key \
  -e DEBUG=False \
  docker.xuanyuan.run/dbca-wa/gokart:latest

Docker Compose配置示例

创建docker-compose.yml文件：

yaml
version: '3.8'

services:
  web:
    image: docker.xuanyuan.run/dbca-wa/gokart:latest
    ports:
      - "8000:8000"
    environment:
      - DATABASE_URL=postgresql://postgres:postgres@db:5432/gokart
      - SECRET_KEY=${SECRET_KEY}
      - DEBUG=False
      - ALLOWED_HOSTS=example.com,localhost,127.0.0.1
    depends_on:
      - db
    volumes:
      - static_volume:/app/static
      - media_volume:/app/media

  db:
    image: docker.xuanyuan.run/postgres:14
    volumes:
      - postgres_data:/var/lib/postgresql/data/
    environment:
      - POSTGRES_PASSWORD=postgres
      - POSTGRES_USER=postgres
      - POSTGRES_DB=gokart

volumes:
  postgres_data:
  static_volume:
  media_volume:

启动服务：

bash
docker-compose up -d

环境变量配置

数据持久化

通过挂载卷实现数据持久化：

• 静态文件：挂载/app/static目录
• 媒体文件：挂载/app/media目录
• 数据库数据：建议使用独立的数据库容器并挂载数据卷（如示例中的postgres_data）

构建自定义镜像

如需基于基础镜像添加自定义配置，可创建Dockerfile：

dockerfile
FROM docker.xuanyuan.run/dbca-wa/gokart:latest

# 添加自定义配置文件
COPY ./custom_settings.py /app/gokart/settings/custom.py

# 安装额外依赖
RUN pip install --no-cache-dir some-package

构建并运行：

bash
docker build -t my-custom-gokart .
docker run -d --name custom-gokart docker.xuanyuan.run/my-custom-gokart

注意事项

• 生产环境中需确保SECRET_KEY安全存储，避免硬编码
• 定期更新镜像以获取安全补丁和依赖更新
• 数据库迁移需在首次部署或版本更新后执行：docker exec -it gokart-app python manage.py migrate
• 静态文件收集：docker exec -it gokart-app python manage.py collectstatic --noinput