robertglonek/rockylinux

docker-systemd

镜像概述和主要用途

docker-systemd是一个与systemd高度兼容的init系统，专为Docker容器设计。它通过安装辅助工具并模拟systemd行为，读取服务文件、执行已启用的启动服务，并支持systemctl和journalctl等常用管理工具，使Docker容器表现得更像完整的虚拟机。仅支持.service文件，不支持timer、socket等其他单元类型。

核心功能和特性

• 服务管理：解析.service单元文件，支持多实例服务文件和基本依赖关系处理
• 工具兼容：提供systemctl和journalctl命令支持，实现常用管理功能
• 进程管理：处理服务启动/停止信号，正确回收进程，避免僵尸进程
• 日志处理：支持日志输出到文件或stderr，便于通过docker logs查看
• 多发行版支持：提供基于Ubuntu、Debian、Rocky Linux和CentOS的预构建镜像

使用场景和适用范围

适用于需要在Docker容器中运行依赖systemd服务管理的应用场景，尤其适合以下情况：

• 开发或测试需要systemd环境的应用
• 部署需要服务依赖管理的应用
• 希望容器具备类似虚拟机的init系统行为

使用方法和配置说明

快速启动：使用预构建镜像

预构建镜像已包含二进制入口点，支持多种Linux发行版：

bash
# Ubuntu系列
docker run -itd robertglonek/ubuntu:24.04
docker run -itd robertglonek/ubuntu:22.04
docker run -itd robertglonek/ubuntu:20.04

# Debian系列
docker run -itd robertglonek/debian:12
docker run -itd robertglonek/debian:11
docker run -itd robertglonek/debian:10
docker run -itd robertglonek/debian:9

# Rocky Linux系列
docker run -itd robertglonek/rockylinux:9
docker run -itd robertglonek/rockylinux:8

# CentOS系列
docker run -itd robertglonek/centos:stream9

行为和启动参数

二进制文件会将自身符号链接到$PATH中第一个可能的本地目录，命名为journalctl,systemctl,service,poweroff,shutdown,systemd,init。使用相关名称运行将触发相应行为。

容器启动时可提供以下命令行开关修改行为：

支持的命令

Systemctl参数

bash
# systemctl -h
Usage:
  init [OPTIONS] <command>

Available commands:
  create-instance  create a new instance (for multi-instance services)
  daemon-reload    reload unit files
  delete-instance  delete an instance (for multi-instance services)
  disable          disable services
  enable           enable services
  list             list services
  mask             mask a service
  poweroff         shutdown the system
  reload           reload a service (send SIGHUP)
  restart          restart a service
  show             show details of a service
  start            start a service
  status           status of a service
  stop             stop a service
  unmask           unmask a service

Journalctl参数

bash
# journalctl -h
Usage:
  journalctl

Application Options:
  -S, --since=    format: 2012-10-30 18:17:16
  -U, --until=    format: 2012-10-30 18:17:16
  -b, --boot      since reboot
  -u, --unit=     unit name
  -n, --lines=    show max X last lines
  -f, --follow    follow log; implies lines
      --no-pager  do not page results; implied with follow
  -h, --help      display help

服务文件支持的定义

支持的定义

以下是单元文件中支持的定义，尽可能与原始systemd实现兼容：

go
	Description string
	// 依赖关系
	Wants        map[string]*daemon
	WantedBy     map[string]*daemon
	Requires     map[string]*daemon
	RequiredBy   map[string]*daemon
	Requisite    map[string]*daemon
	RequisiteOf  map[string]*daemon
	BindsTo      map[string]*daemon
	BoundBy      map[string]*daemon
	PartOf       map[string]*daemon
	ConsistsOf   map[string]*daemon
	Upholds      map[string]*daemon
	UpheldBy     map[string]*daemon
	Conflicts    map[string]*daemon
	ConflictedBy map[string]*daemon
	OnFailure    map[string]*daemon
	OnSuccess    map[string]*daemon
	// 行为
	StopWhenUnneeded bool
	FailureAction    string
	SuccessAction    string
	// 服务部分
	ServiceType      string // 注：仅支持simple/oneshot/forking类型，dbus视为forking
	RemainAfterExit  bool
	PidFile          string
	ExecStart        []string
	ExecStop         []string
	ExecStartPre     []string
	ExecStartPost    []string
	ExecStopPre      []string
	ExecStopPost     []string
	ExecCondition    []string
	ExecReload       string
	RestartSleep     time.Duration
	StopTimeout      time.Duration
	Restart          string // 注：支持always/on-failure/on-success，其他类型自动映射
	WorkingDirectory string
	User             string
	Group            string
	Env              []string
	EnvFile          []string

计划实现

以下功能尚未实现，服务启动顺序仅由依赖关系控制：

golang
	Before       map[string]*daemon
	After        map[string]*daemon

特殊说明

以下定义会在启动时在docker logs中产生警告并被忽略（因Docker权限限制），建议使用Docker的限制设置命令行替代：

golang
	// 资源限制
	LimitCpu        string
	LimitFsize      string
	LimitData       string
	LimitStack      string
	LimitCore       string
	LimitRss        string
	LimitNoFile     string
	LimitAs         string
	LimitNProc      string
	LimitMemLock    string
	LimitLocks      string
	LimitSigPending string
	LimitMsgQueue   string
	LimitNice       string
	LimitRtPrio     string
	LimitRtTime     string