geokrety/website-base

geokrety-website-docker-base

镜像概述和主要用途

geokrety-website-docker-base 是为 GeoKrety 网站（geokrety.org）提供基础运行环境的 Docker 镜像。该镜像作为 GeoKrety 网站服务的底层基础，旨在为上层应用提供标准化、可复用的运行环境，确保 GeoKrety 网站服务的一致性部署和运行。其主要用途是作为构建、测试和部署 GeoKrety 网站服务的基础镜像层，需与 GeoKrety 网站服务的应用代码仓库（https://github.com/geokrety/geokrety-website%EF%BC%89%E9%85%8D%E5%90%88%E4%BD%BF%E7%94%A8%E3%80%82

核心功能和特性

• 标准化运行环境：提供 GeoKrety 网站服务所需的基础依赖和运行时环境，确保跨平台部署的一致性。
• 依赖管理：预配置网站服务运行所需的核心依赖库和工具，简化上层应用的构建流程。
• 兼容性保障：与 GeoKrety 网站服务专用代码仓库（https://github.com/geokrety/geokrety-website%EF%BC%89%E6%B7%B1%E5%BA%A6%E5%85%BC%E5%AE%B9%EF%BC%8C%E6%94%AF%E6%8C%81%E6%97%A0%E7%BC%9D%E9%9B%86%E6%88%90%E3%80%82
• 构建流程优化：通过基础镜像固化底层环境，减少上层应用构建时的重复依赖安装步骤，提升构建效率。

使用场景和适用范围

使用场景

• 开发环境构建：为开发人员提供统一的本地开发基础环境，确保开发环境与生产环境一致性。
• 测试环境部署：作为测试环境中 GeoKrety 网站服务的基础镜像，支持自动化测试流程。
• 生产环境基础：作为生产环境中部署 GeoKrety 网站服务的底层镜像，提供稳定的运行基础。

适用范围

• GeoKrety 网站服务的开发团队成员。
• 需要部署或测试 GeoKrety 网站服务的运维人员。
• 构建基于 GeoKrety 网站服务衍生应用的第三方开发者。

使用方法和配置说明

快速开始

该镜像提供了基于 Makefile 的快捷操作方式，获取帮助信息可执行：

bash
make help

通过 make help 可查看支持的构建、启动、停止等命令详情。

Docker部署方案示例

docker run 命令示例

以下命令示例基于基础镜像启动容器，实际使用需结合上层应用代码仓库（https://github.com/geokrety/geokrety-website%EF%BC%89%E7%9A%84%E5%85%B7%E4%BD%93%E9%85%8D%E7%BD%AE%EF%BC%9A

bash
docker run -d \
  --name geokrety-base \
  -p 8080:8080 \
  --volume /path/to/app:/app \
  geokrety/geokrety-website-docker-base:latest

说明：/path/to/app 需替换为本地 GeoKrety 网站应用代码的路径，端口映射和 volumes 配置需根据实际需求调整。

docker-compose 配置示例

创建 docker-compose.yml 文件，整合基础镜像与应用服务：

yaml
version: '3.8'

services:
  geokrety-base:
    image: geokrety/geokrety-website-docker-base:latest
    container_name: geokrety-base
    ports:
      - "8080:8080"
    volumes:
      - ./app:/app  # 挂载应用代码目录
    environment:
      - APP_ENV=production  # 环境变量示例：指定运行环境
      - LOG_LEVEL=info      # 环境变量示例：日志级别
    restart: unless-stopped

配置参数和环境变量

基础镜像支持通过环境变量调整运行参数，以下为常见配置项（具体参数需参考 https://github.com/geokrety/geokrety-website 文档）：

相关资源

• GeoKrety 网站服务代码仓库：https://github.com/geokrety/geokrety-website
• 官方网站：geokrety.org