mesasadc/postgis

docker-postgis

一个运行PostGIS的简单Docker容器。

访问Docker Hub页面：https://registry.hub.docker.com/u/kartoza/postgis/

现有多个PostGIS Docker容器，本容器的差异化特点包括：

• 开箱即用地提供SSL支持
• 连接限制在Docker子网内
• 预创建template_postgis数据库模板
• 预创建'gis'数据库，便于开箱即用地与QGIS等工具配合使用

我们将持续添加更多安全特性，旨在打造可用于生产环境的PostGIS镜像（尽管可能不适合高负载数据库）。

注意：建议使用apt-cacher-ng加速包获取 - 需在提供的71-apt-cacher-ng文件中配置主机。

标记版本

构建镜像时采用以下标记约定：

kartoza/postgis:[postgres_version]-[postgis-version]

例如：

kartoza/postgis:9.4-2.1 提供PostgreSQL 9.4和PostGIS 2.1

注意：强烈建议使用标记版本，因为PostgreSQL的后续次要版本会将数据库集群写入不同的数据库目录 - 若使用持久卷存储数据库，可能导致数据库看似为空。

获取镜像

有多种方式将镜像获取到系统中：

首选方式（但初始镜像带宽消耗较大）是拉取Docker信任构建：

docker pull kartoza/postgis

不使用apt-cacher构建镜像（每次构建需重新获取deb包，带宽消耗较大）：

docker build -t kartoza/postgis git://github.com/kartoza/docker-postgis

使用apt-cache构建（最小化下载需求）：需先本地克隆仓库，修改71-apt-cacher-ng内容以匹配缓存主机，然后使用本地URL构建：

git clone git://github.com/kartoza/docker-postgis

编辑71-apt-cacher-ng后执行：

docker build -t kartoza/postgis .

运行

创建运行中的容器：

sudo docker run --name "postgis" -p 25432:5432 -d -t kartoza/postgis

可使用以下环境变量指定用户名和密码：

• -e POSTGRES_USER=
• -e POSTGRES_PASS=

这些变量将用于创建具有指定凭据的超级用户。若未指定，PostgreSQL用户默认为'docker'，密码为'docker'。

便捷运行脚本

提供了bash脚本用于运行容器，可指定卷挂载点和超级用户的用户名/密码。支持以下选项：

OPTIONS:
   -h      显示帮助信息
   -n      容器名称
   -v      挂载Postgres集群的卷
   -u      Postgres用户名（默认为'docker'）
   -p      Postgres密码（默认为'docker'）

使用示例：

./run-postgis-docker.sh -v /tmp/foo/ -n postgis -u foo -p bar

通过psql连接

使用psql连接（确保在主机/客户端上安装PostgreSQL客户端工具）：

psql -h localhost -U docker -p 25432 -l

注意：默认PostgreSQL用户为'docker'，密码为'docker'。

之后可使用常规PostgreSQL命令操作容器。

在Ubuntu 14.04上安装PostgreSQL客户端：

sudo apt-get install postgresql-client-9.3

在主机而非容器中存储数据

可使用Docker卷持久化数据：

mkdir -p ~/postgres_data
docker run -d -v $HOME/postgres_data:/var/lib/postgresql kartoza/postgis

需确保postgres_data目录具有足够权限，允许Docker进程读写。

credits

Tim Sutton (***) 2014年5月