wooyek/geodjango

支持PostGIS和SpatiaLite的GeoDjango Docker镜像

GeoDjango项目的测试环境，开箱即支持PostGIS和SpatiaLite，助力GeoDjango应用的开发与测试工作。

https://img.shields.io/docker/pulls/wooyek/geodjango.svg](https://hub.docker.com/r/wooyek/geodjango/) https://img.shields.io/docker/stars/wooyek/geodjango.svg](https://hub.docker.com/r/wooyek/geodjango/) https://img.shields.io/docker/automated/wooyek/geodjango.svg](https://hub.docker.com/r/wooyek/geodjango/) https://img.shields.io/travis/wooyek/docker-geodjango.svg](https://travis-ci.org/wooyek/docker-geodjango)

BitBucket Pipelines支持

你可以将此镜像用作BitBucket Pipelines的测试镜像，示例如下：

yaml
image: docker.xuanyuan.run/wooyek/geodjango

pipelines:
  default:
    - step:
      script:        
        # Pipelines会覆盖默认的Docker入口点，需手动运行
        - docker-entrypoint.sh  
        - tox

Tox支持

Tox是封装测试的最佳方式，示例配置如下：

ini
[tox]
envlist = py35,py27
skipsdist = True

[testenv]
passenv =
    DJANGO_SETTINGS_MODULE
    DATABASE_PASSWORD
    DATABASE_USER
    DATABASE_HOST
    DATABASE_NAME
    DATABASE_TEST_NAME
    

setenv =
    TOX_ENVBINDIR = {envbindir}
    LIBRARY_PATH = /usr/local/lib
    CPATH=/usr/local/include
    PYTHONIOENCODING = utf-8

commands =
    coverage erase
    coverage run setup.py test
    coverage report
    coverage xml

deps =
    -rrequirements.txt
    -rrequirements-dev.txt

构建Docker镜像

若未安装Docker，可使用Vagrant开发环境：

bash
vagrant up
vagrant ssh

替换wooyek/geodjango为你的镜像名称，若不使用Vagrant则替换/vagrant/为合适路径：

bash
docker build -t wooyek/geodjango /vagrant/
docker push wooyek/geodjango

运行与测试

可通过以下命令查看Docker容器环境变量（默认值在Dockerfile中设置）：

bash
docker run --rm docker.xuanyuan.run/wooyek/geodjango env

推荐创建环境变量文件，从示例文件生成：

bash
ENV_FILE=/vagrant/sample/environment.env
source <(sed -E 's/[^#]+/export &/' ${ENV_FILE})
envsubst < ${ENV_FILE} | tee /vagrant/environment.env

检查环境变量：

bash
docker run --rm --env-file /vagrant/environment.env docker.xuanyuan.run/wooyek/geodjango env

运行示例项目测试：

bash
docker run --rm -it --name qa \
    --volume=/vagrant:/vagrant \
    --workdir="/vagrant" \
    --memory=4g \
    --memory-swap=4g \
    --entrypoint=/bin/bash \
    --env-file /vagrant/environment.env \
    --hostname ${HOSTNAME} \
    -e DJANGO_SETTINGS_MODULE=website.settings \
    docker.xuanyuan.run/wooyek/geodjango \
    docker-entrypoint.sh tox -c /vagrant/sample/awesome-project

清理

清理Docker资源：

bash
docker system prune
docker image prune
docker container prune