makinacorpus/geodjango Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

docker-geodjango 镜像文档

1. 镜像概述

docker-geodjango是一个基于Ubuntu系统构建的Docker镜像，专门为GeoDjango应用提供预配置的二进制依赖环境。该镜像旨在简化GeoDjango应用的部署流程，通过预先集成GeoDjango运行所需的底层依赖组件，减少开发者在环境配置上的工作量。

2. 核心功能与特性

• 基于Ubuntu系统：采用Ubuntu作为基础镜像，提供稳定且广泛使用的操作系统环境
• 预安装二进制依赖：包含GeoDjango运行所需的全部二进制依赖项，无需手动安装地理空间相关库
• 简化部署流程：减少GeoDjango应用部署时的依赖配置步骤，降低环境一致性问题风险

3. 使用场景与适用范围

• 开发环境：快速搭建本地GeoDjango开发环境，避免本地环境依赖冲突
• 测试环境：在CI/CD流程中作为测试基础镜像，确保测试环境与生产环境依赖一致
• 生产环境：作为GeoDjango应用生产部署的基础镜像，简化生产环境配置

4. 使用方法与配置说明

4.1 基本使用方式

该镜像主要作为基础镜像使用，可在Dockerfile中通过FROM指令引用，构建包含GeoDjango应用的自定义镜像。

示例Dockerfile

dockerfile
# 以docker-geodjango为基础镜像
FROM docker-geodjango

# 设置工作目录
WORKDIR /app

# 复制应用代码
COPY . .

# 安装Python依赖（如需）
RUN pip install -r requirements.txt

# 启动命令
CMD ["gunicorn", "myproject.wsgi:application", "--bind", "0.0.0.0:8000"]

4.2 直接运行（测试用）

如需快速测试镜像环境，可通过以下命令启动容器并进入交互模式：

bash
docker run -it --rm docker-geodjango /bin/bash

4.3 作为docker-compose服务组件

在docker-compose.yml中可将该镜像作为服务的基础镜像使用：

yaml
version: '3'
services:
  web:
    build:
      context: .
      dockerfile: Dockerfile  # Dockerfile中需FROM docker-geodjango
    ports:
      - "8000:8000"
    depends_on:
      - db
  db:
    image: postgis/postgis:14-3.3
    environment:
      - POSTGRES_DB=geodjango
      - POSTGRES_USER=geouser
      - POSTGRES_PASSWORD=geopassword

5. 注意事项

• 该镜像仅包含GeoDjango所需的二进制依赖，Python及GeoDjango本身需在基于此镜像的自定义镜像中另行安装
• 建议根据具体应用需求，在Dockerfile中补充必要的系统依赖或配置调整
• 生产环境使用时，应结合具体安全需求配置用户权限、网络策略等