baasgeo/mapgallery

MapGallery Docker镜像文档

镜像概述和主要用途

MapGallery是一个用于交互式地图和位置数据查看的简单解决方案，设计考虑了简洁性、性能和可用性，可在所有主要桌面和移动平台高效运行。本Docker镜像基于官方nginx镜像构建，旨在简化组织部署MapGallery的过程。

核心功能和特性

• 简洁易用：设计注重用户体验，易于设置和操作
• 跨平台兼容：高效支持所有主要桌面和移动平台
• 基于nginx：依托稳定的nginx基础镜像，确保服务可靠性
• 数据持久化：支持通过数据卷挂载实现配置和数据持久化
• 版本化管理：为每个MapGallery次要版本提供对应的镜像标签，便于版本控制

安装方法

从Docker Hub拉取镜像

bash
$ docker pull docker.xuanyuan.run/baasgeo/mapgallery:tagname

本地构建镜像

bash
$ git clone https://github.com/baasgeo/docker-mapgallery.git
$ cd mapgallery-docker
$ docker build -t "baasgeo/mapgallery:tagname" .

快速启动

1. 创建主机数据文件夹

bash
$ sudo mkdir /var/mapgallery/

2. 运行容器

bash
$ docker run \
    --name=mapgallery \
    --publish=8080:8081 \
    --volume /var/mapgallery:/usr/share/nginx/assets \
    --memory 32mb \
    baasgeo/mapgallery:4

3. 访问和登录

在浏览器中访问 http://localhost:8080/，使用MapGallery默认用户名和密码登录：

• 用户名：admin
• 密码：admin

版本使用方法

每个MapGallery次要版本对应一个主要镜像标签：

• 4.0.x -> baasgeo/mapgallery:4.0
• 4.1.x -> baasgeo/mapgallery:4.1
• 4.2.x -> baasgeo/mapgallery:4.2
• 5.0.x -> baasgeo/mapgallery:5.0 ...以此类推

补丁更新会应用到对应次要版本标签，更新时只需重新拉取镜像并重启容器：

bash
$ docker pull docker.xuanyuan.run/baasgeo/mapgallery:tagname
$ docker restart mapgallery

配置说明

数据卷

容器将配置数据存储在 /usr/share/nginx/assets，并将其暴露为卷。通过挂载主机目录到该路径，可实现数据持久化，即使容器重启或重建也不会丢失数据：

bash
--volume /var/mapgallery:/usr/share/nginx/assets

资源约束

默认情况下，容器无资源限制。可通过Docker的运行时配置标志限制CPU和内存使用，详情参见https://docs.docker.com/config/containers/resource_constraints/%E3%80%82

数据库配置

MapGallery使用PostgREST API与PostgreSQL数据库配合工作，可通过链接对应容器实现集成。

链接PostgREST容器

使用官方PostgREST镜像启动容器：

bash
$ docker run -d --name="postgrest" postgrest/postgrest

启动MapGallery时添加--link选项链接容器：

bash
--link postgrest:postgrest

链接PostgreSQL容器

可使用任意PostgreSQL容器，以下是官方postgres镜像示例：

bash
$ docker run -d --name="postgis" postgres

启动MapGallery时添加--link选项链接容器：

bash
--link postgres:postgis

更多信息参见https://registry.hub.docker.com/r/postgrest/postgrest%E5%92%8Chttps://registry.hub.docker.com/_/postgres/%E3%80%82