socrata/base-focal

镜像概述和主要用途

socrata/base-focal 是一个基于 Ubuntu 20.04 的基础 Docker 镜像，旨在为构建其他容器提供标准化的基础模式和工具集。它继承了基础 Ubuntu 镜像的特性，专门设计用于作为上层应用容器的构建基础，简化容器初始化流程、脚本执行和配置管理。

核心功能和特性

ship.d pattern

• ship 入口点：提供 ship 命令作为容器入口点，用于执行 /etc/ship.d/ 目录下的脚本。
• 主机信息感知：通过执行 ship.d 脚本，容器可获取主机信息，自动创建环境变量 ARK_HOST（主机 IP）和 ARK_HOSTNAME（主机名）。
• 默认执行逻辑：未指定其他命令时，容器默认运行 /etc/ship.d/run 脚本，支持通过命令参数指定执行其他脚本。

env_parse 工具

• 功能：从 jinja 模板和环境变量动态生成配置文件。
• 工作原理：服务所有者可创建 jinja 模板文件，模板中的变量需对应环境变量；运行时，env_parse 根据模板和环境变量生成最终配置文件。
• 使用方式：接受一个必选参数（模板文件路径）和一个可选参数（输出文件路径）。若未指定输出文件，默认输出文件名为模板文件名去掉尾部的 .j2（例如：模板 config.conf.j2 生成 config.conf）。

使用场景和适用范围

适用于作为构建各类服务容器的基础镜像，尤其适合需要以下能力的场景：

• 容器启动时执行初始化脚本（如数据库迁移、服务注册）；
• 基于环境变量动态调整配置（如不同环境的端口、密钥配置）；
• 标准化容器启动流程，简化多服务镜像的构建和维护。

使用方法和配置说明

基础使用步骤

1. 拉取镜像

docker pull socrata/base-focal

2. 运行容器

• 默认执行：未指定命令时，容器自动运行 /etc/ship.d/run 脚本：

  docker run --rm -t -i socrata/base-focal
  

• 指定命令：通过 CMD 参数调用 /etc/ship.d/ 下的脚本或容器内可执行文件：

  # 启动 bash shell（需确保 bash 在 PATH 中）
  docker run --rm -t -i socrata/base-focal bash
  
  # 执行 /etc/ship.d/ 下的自定义脚本（如 migrate）
  docker run --rm -t -i socrata/base-focal migrate
  

3. 容器内执行脚本

在容器内部，可通过 ship 命令手动执行 /etc/ship.d/ 下的脚本：

# 执行 /etc/ship.d/run 脚本
ship [run]

# 执行 /etc/ship.d/migrate 脚本
ship migrate

构建自定义镜像示例

Dockerfile

基于 socrata/base-focal 构建包含服务脚本的自定义镜像（如 awesome_sauce）：

FROM socrata/base-focal
# 添加服务启动脚本（默认执行）
ADD run /etc/ship.d/
# 添加数据库迁移脚本（按需执行）
ADD migrate /etc/ship.d/

其中：

• run 脚本：用于启动服务（如 #!/bin/bash; /usr/local/bin/service start）；
• migrate 脚本：用于执行一次性任务（如数据库表结构迁移）。

运行自定义镜像

• 执行迁移脚本：

  docker run --rm -t -i awesome_sauce migrate
  

• 启动服务（默认执行 run 脚本）：

  docker run --rm -t -i awesome_sauce