socrata/base-bionic

socrata/base-bionic

镜像概述和主要用途

socrata/base-bionic 是基于 Ubuntu 18.04 (Bionic Beaver) 的基础 Docker 镜像，旨在为构建其他容器提供一套标准化的模式和工具集。其核心定位是作为基础镜像，为上层应用容器提供统一的运行时环境和基础工具，简化基于 Ubuntu 18.04 的容器构建流程。

核心功能和特性

ship.d pattern

• 功能：通过 ship 入口点执行 /etc/ship.d/ 目录下的脚本，实现容器初始化和服务启动逻辑。
• 主机感知能力：容器默认无法直接获取主机的 IP 和名称，该模式通过执行 ship.d 脚本使容器能够感知主机环境，并自动创建环境变量 ARK_HOST（主机 IP）和 ARK_HOSTNAME（主机名）。
• 执行逻辑：默认执行 /etc/ship.d/run 脚本，也可通过 CMD 指定执行 /etc/ship.d/ 目录下的其他脚本或容器内的可执行文件。

env_parse 工具

• 功能：基于 jinja 模板和环境变量生成配置文件。
• 工作原理：服务所有者可通过该工具在运行时基于环境变量和模板文件动态生成配置文件，模板中的变量需来自环境变量。
• 参数说明：
  • 必选参数：模板文件路径
  • 可选参数：输出文件路径（若未指定，默认输出文件名为模板文件名去除尾部 .j2 后缀）

核心功能和特性

ship.d pattern

• 入口点机制：容器默认入口点为 ship，用于执行 /etc/ship.d/ 目录下的脚本。
• 主机信息注入：通过执行 ship.d 脚本，容器可感知主机环境，自动生成 ARK_HOST（主机 IP）和 ARK_HOSTNAME（主机名）环境变量。

env_parse 配置生成工具

• 模板引擎：采用 jinja 模板语法，支持变量替换、条件判断等模板功能。
• 环境变量依赖：模板中的所有变量必须通过环境变量传入容器。
• 文件输出规则：若未指定输出文件，工具会自动将模板文件（如 config.ini.j2）处理为 config.ini。

使用场景和适用范围

适用场景

• 作为基础镜像构建其他容器，提供统一的运行时环境和初始化机制。
• 需要通过环境变量动态生成配置文件的服务（如依赖动态配置的应用）。
• 需要执行初始化脚本（如数据库迁移、权限配置）或服务启动脚本的场景。
• 需要容器感知主机信息（IP、主机名）的应用。

适用范围

• 基于 Ubuntu 18.04 构建的应用容器。
• 依赖环境变量注入配置的服务。
• 需要分阶段执行脚本（如初始化、启动、迁移）的服务。

使用方法和配置说明

基础使用流程

1. 拉取镜像：

   bash
   docker pull socrata/base-bionic
   

2. 运行容器：

   • 默认执行 /etc/ship.d/run 脚本：

     bash
     docker run --rm -t -i socrata/base-bionic
     

   • 指定执行 /etc/ship.d/ 目录下的脚本或容器内可执行文件：

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

3. 容器内执行脚本： 从容器内部通过 ship 命令执行 /etc/ship.d/ 目录下的脚本：

   bash
   # 在容器内执行 /etc/ship.d/run
   ship [run]
   

自定义配置示例

通过 Dockerfile 构建基于 socrata/base-bionic 的自定义镜像，并添加服务脚本：

Dockerfile 示例

dockerfile
FROM socrata/base-bionic
# 添加服务启动脚本（run）和迁移脚本（migrate）到 /etc/ship.d/ 目录
ADD run /etc/ship.d/
ADD migrate /etc/ship.d/

脚本说明

• run：服务启动脚本，用于启动应用服务。
• migrate：一次性迁移脚本，用于执行数据库迁移等初始化操作。

运行自定义镜像

bash
# 构建自定义镜像（假设镜像名为 awesome_sauce）
docker build -t awesome_sauce .

# 执行迁移脚本
docker run --rm -t -i awesome_sauce migrate

# 默认执行服务启动脚本（/etc/ship.d/run）
docker run --rm -t -i awesome_sauce

Docker 部署方案示例

基础运行示例

bash
# 拉取镜像
docker pull socrata/base-bionic

# 启动容器并默认执行 /etc/ship.d/run
docker run --rm -t -i socrata/base-bionic

# 启动容器并进入 bash 交互终端
docker run --rm -t -i socrata/base-bionic bash

自定义服务示例（结合 ship.d 脚本）

1. 准备脚本：

   • 创建 run 脚本（服务启动逻辑）：

     bash
     #!/bin/bash
     echo "Starting awesome service..."
     # 服务启动命令（如 ./app）
     

   • 创建 migrate 脚本（数据迁移逻辑）：

     bash
     #!/bin/bash
     echo "Running database migrations..."
     # 迁移命令（如 ./migrate-tool up）
     

2. 构建镜像（Dockerfile 见上文）：

   bash
   docker build -t awesome_sauce .
   

3. 运行服务：

   bash
   # 执行迁移
   docker run --rm -t -i awesome_sauce migrate
   
   # 启动服务
   docker run --rm -t -i -p 8080:8080 awesome_sauce
   

环境变量说明