robertdebock/amazonlinux

Docker Amazon Linux Systemd 镜像文档

镜像概述与主要用途

本镜像基于 Amazon Linux 构建，支持运行 systemd 服务，主要用于测试 Ansible 角色及需要 systemd 环境的场景。通过提供完整的 systemd 功能，可模拟类生产环境的系统服务管理，适合验证服务部署、进程控制等操作。

!amazonlinux build status](https://hub.docker.com/repository/docker/robertdebock/amazonlinux)

核心功能与特性

• 支持 systemd：容器内可运行 systemd 服务，管理系统进程、服务单元及依赖关系。
• 多版本 Amazon Linux 支持：提供 Amazon Linux 1 和 2 两个版本的环境，满足不同测试需求。
• 轻量级基础：基于官方 Amazon Linux 镜像构建，保持环境精简，降低测试干扰。
• Ansible 测试适配：专为验证 Ansible 角色设计，尤其适合测试涉及 systemd 服务配置的场景。

版本与标签

镜像通过不同分支维护 Amazon Linux 版本，对应 Docker 镜像标签如下：

分支策略

各分支独立维护，不进行合并，确保不同 Amazon Linux 版本的环境隔离，避免版本间配置冲突。

使用场景与适用范围

• Ansible 角色测试：验证涉及 systemd 服务启停、配置文件管理、服务依赖的 Ansible 角色。
• systemd 服务部署验证：测试服务单元文件（.service）的正确性、服务启动顺序及故障恢复。
• 系统工具测试：运行依赖 systemd 环境的系统工具（如 journalctl、systemctl），验证工具功能。

使用方法与配置说明

前置要求

• Docker 环境：需安装 Docker Engine（推荐 19.03+ 版本）。
• 权限：运行容器需 root 权限或 sudo 权限。

手动启动容器

使用以下命令启动容器，支持 systemd 功能：

bash
docker run \
  --tty \                   # 分配伪终端，保持终端连接
  --privileged \            # 提供特权模式，确保 systemd 正常运行
  --volume /sys/fs/cgroup:/sys/fs/cgroup:ro \  # 挂载 cgroup 文件系统（只读），systemd 依赖
  robertdebock/amazonlinux  # 镜像名称（默认使用 latest 标签，即 Amazon Linux 2）

参数说明

• --tty：维持终端会话，避免容器启动后立即退出。
• --privileged：赋予容器额外权限，允许 systemd 管理进程和设备。
• --volume /sys/fs/cgroup:/sys/fs/cgroup:ro：挂载主机的 cgroup 文件系统（只读），systemd 需通过 cgroup 管理进程资源。

指定版本启动

若需使用 Amazon Linux 1，指定标签 1：

bash
docker run \
  --tty \
  --privileged \
  --volume /sys/fs/cgroup:/sys/fs/cgroup:ro \
  robertdebock/amazonlinux:1

Docker Compose 配置示例

创建 docker-compose.yml 文件，配置如下：

yaml
version: '3'
services:
  amazonlinux-systemd:
    image: robertdebock/amazonlinux:latest  # 或指定标签 :1
    tty: true
    privileged: true
    volumes:
      - /sys/fs/cgroup:/sys/fs/cgroup:ro
    # 可选：添加端口映射或额外挂载（根据测试需求）
    # ports:
    #   - "8080:80"
    # volumes:
    #   - ./ansible-roles:/etc/ansible/roles

启动命令：

bash
docker-compose up -d

容器内验证 systemd

容器启动后，可通过以下命令验证 systemd 状态：

bash
# 进入容器
docker exec -it <容器ID> bash

# 检查 systemd 运行状态
systemctl status

若输出类似 Active: active (running)，表示 systemd 已正常启动。