previousnext/passenger

PreviousNext Skipper 官方 Passenger 容器文档

镜像概述和主要用途

本镜像为 PreviousNext 内部容器管理解决方案 Skipper 的官方 Passenger 容器，是 Skipper 容器套件的组成部分。该容器基于 Docker Hub 官方容器构建，旨在为内部项目提供生产环境与本地环境的配置一致性，同时作为开发（dev）镜像的基础容器，支撑 Skipper 管理的容器化部署流程。

核心功能和特性

1. 基于官方镜像构建

以 Docker Hub 官方 Passenger 容器为基础镜像，确保底层环境的安全性、稳定性及社区支持。

2. 生产与本地环境配置一致性

通过将托管容器作为 dev 镜像的基础容器，实现从生产环境到本地开发环境的配置对齐，减少环境差异导致的问题。

3. 标准化构建与发布流程

提供统一的 Makefile 构建工具链，支持多版本镜像构建及自动化发布到 Docker Hub，简化容器版本管理。

4. Skipper 集成兼容性

作为 Skipper 容器管理解决方案的官方组件，原生适配 Skipper 的容器编排、部署及生命周期管理流程。

使用场景和适用范围

适用场景

• Skipper 管理的内部容器化环境部署
• 开发团队需要本地环境配置接近生产环境的场景
• 基于 Passenger 应用服务器的应用（如 Ruby on Rails、Node.js 应用）容器化构建
• 内部项目的容器镜像版本统一管理与发布

适用范围

• PreviousNext 内部开发及运维团队
• 使用 Skipper 进行容器生命周期管理的项目
• 依赖 Passenger 作为应用服务器的内部业务系统

详细的使用方法和配置说明

构建容器镜像

每个容器目录下提供 Makefile 工具链，支持以下构建命令：

bash
# 构建当前容器的所有版本镜像
make

# 将构建完成的镜像发布到 Docker Hub（需配置 Docker Hub 认证）
make release

注：具体版本定义、构建参数及依赖配置可通过修改容器目录下的 Makefile 实现。

运行容器

基础运行示例（docker run）

bash
# 启动 Passenger 容器，映射宿主机 8080 端口到容器 80 端口，挂载应用代码目录
docker run -d \
  --name skipper-passenger-instance \
  -p 8080:80 \
  -v /path/to/local/app:/app \  # 挂载应用代码到容器内 /app 目录
  -v /path/to/passenger/config:/etc/passenger \  # 挂载 Passenger 配置文件
  previousnext/skipper-passenger:latest

容器编排示例（docker-compose）

创建 docker-compose.yml 文件：

yaml
version: '3.8'

services:
  passenger-app:
    image: previousnext/skipper-passenger:latest
    container_name: skipper-passenger-app
    ports:
      - "8080:80"  # 端口映射：宿主机 8080 -> 容器 80
    volumes:
      - ./app:/app  # 本地应用代码目录挂载
      - ./passenger.conf:/etc/passenger/passenger.conf  # Passenger 主配置
      - ./logs:/var/log/passenger  # 日志持久化
    environment:
      - PASSENGER_APP_ENV=production  # 应用环境变量（示例）
    restart: unless-stopped  # 容器退出时自动重启

配置说明

构建配置

• 版本管理：通过 Makefile 中的 VERSION 变量定义镜像版本，支持多版本并行构建。
• 基础镜像选择：可在 Makefile 或 Dockerfile 中指定底层官方 Passenger 镜像版本（如 phusion/passenger-ruby32:latest）。

运行时配置

• 应用代码挂载：通过 -v /local/app:/app 挂载应用代码到容器内指定目录，Passenger 会自动检测并启动应用。
• Passenger 配置：通过挂载 /etc/passenger 目录下的配置文件（如 passenger.conf）自定义应用启动参数、工作进程数、超时设置等。
• 环境变量：支持通过 -e 参数或 docker-compose.yml 的 environment 字段注入环境变量（如 PASSENGER_APP_ENV、PORT 等）。

注意事项

1. 文档参考：每个容器的详细配置参数、环境变量说明及高级用法，请参考容器各自目录下的专属文档。
2. 权限配置：运行容器时需确保挂载目录的权限与容器内用户（通常为 app 或 root）匹配，避免权限错误。
3. 生产环境部署：生产环境使用前需通过 make release 发布指定版本镜像，并在 Skipper 中配置资源限制（CPU/内存）、健康检查及自动恢复策略。