弃用通知

随着CentOS 7的生命周期结束（2024年6月30日），此镜像/项目已正式弃用。请相应调整您的使用方式。

快速参考

• 维护者：
  ClefOS项目

• 获取帮助：
  Docker社区Slack、Server Fault、Unix & Linux或Stack Overflow

支持的标签及对应的Dockerfile链接

无支持的标签

快速参考（续）

• 问题反馈：
  GitHub

• 支持的架构：(更多信息)
  无支持的架构

• 已发布镜像工件详情：
  repo-info仓库的repos/clefos/目录 (历史记录)
  （镜像元数据、传输大小等）

• 镜像更新：
  official-images仓库的library/clefos标签
  official-images仓库的library/clefos文件 (历史记录)

• 此描述的来源：
  docs仓库的clefos/目录 (历史记录)

ClefOS

ClefOS Linux是一个社区支持的发行版，面向IBM Z（又称“大型机”），基于CentOS免费提供的源代码构建，而CentOS又源自Red Hat的Red Hat Enterprise Linux (RHEL)源代码。因此，ClefOS Linux旨在与CentOS和RHEL功能兼容。ClefOS项目主要修改软件包以移除上游供应商的品牌和 artwork。ClefOS Linux是免费的，且可自由再分发。每个ClefOS Linux版本均根据CentOS的计划进行维护和发布。

!logo

ClefOS镜像文档

clefos:latest标签始终指向当前可用的最新版本。

构建基础镜像

镜像通过make命令构建，该命令将创建tarball并构建镜像。

createBase.sh脚本用于为docker构建命令创建tarball。该脚本使用带有tsflags=nodocs选项的yum命令以减小镜像大小。此外，镜像中会删除大量 locale 文件。

VERSION文件包含当前ClefOS版本的ID，并将作为标签添加到镜像中。

滚动构建

ClefOS项目为所有活跃版本提供定期更新的镜像。这些镜像将每月更新，或在需要紧急修复时更新。这些滚动更新使用主版本号和次要标签进行标记。例如，如果7.4.1708是最新版本，则构建结果将为clefos:7和clefos:7.4.1708。当下一个次要版本可用时，clefos:7和clefos:7.x.yymm将保持一致。

Overlayfs与yum

最新的Docker版本支持overlayfs后端，从Docker 1.13起，大多数发行版默认启用该后端。在ClefOS 7上，该后端要求安装并启用yum-plugin-ovl；虽然最新的ClefOS镜像中默认已安装，但如果您更新/etc/yum.conf文件，请确保保留plugins=1选项；否则，可能会遇到与rpmdb校验和失败相关的错误 - 详见Docker issue ***。

包文档

默认情况下，ClefOS容器使用yum的nodocs选项构建，以帮助减小镜像大小。如果您安装软件包后发现文件缺失，请注释掉/etc/yum.conf中的tsflags=nodocs行并重新安装软件包。

Systemd集成

clefos:7和clefos:latest基础容器均不包含systemd，但可基于这些基础创建包含systemd的容器：

用于systemd基础镜像的Dockerfile

dockerfile
FROM 		clefos:7

ENV 		container docker

RUN		yum install -y --setopt=tsflags=nodocs systemd && \
		yum clean all && \
		rm -rf /var/cache/yum/* /tmp/* /var/log/yum.log

RUN 		(cd /lib/systemd/system/sysinit.target.wants/; for i in *; do [ $i == systemd-tmpfiles-setup.service ] || rm -f $i; done); \
		rm -f /lib/systemd/system/multi-user.target.wants/*;\
		rm -f /etc/systemd/system/*.wants/*;\
		rm -f /lib/systemd/system/local-fs.target.wants/*; \
		rm -f /lib/systemd/system/sockets.target.wants/*udev*; \
		rm -f /lib/systemd/system/sockets.target.wants/*initctl*; \
		rm -f /lib/systemd/system/basic.target.wants/*;\
		rm -f /lib/systemd/system/anaconda.target.wants/*;

VOLUME 		["/sys/fs/cgroup"]

CMD 		["/usr/sbin/init"]

此Dockerfile删除了许多可能导致问题的单元文件。至此，您已准备好构建基础镜像。

console
$ docker build --rm -t local/c7-systemd .

启用systemd的应用容器示例

要使用上述创建的启用systemd的基础容器，您需要创建类似以下的Dockerfile：

dockerfile
FROM local/c7-systemd
RUN yum -y install httpd; yum clean all; systemctl enable httpd.service
EXPOSE 80
CMD ["/usr/sbin/init"]

构建此镜像：

console
$ docker build --rm -t local/c7-systemd-httpd .

运行启用systemd的应用容器

要运行包含systemd的容器，需要从主机挂载cgroups卷。以下是运行前面创建的启用systemd的httpd容器的示例命令：

console
$ docker run -ti -v /sys/fs/cgroup:/sys/fs/cgroup:ro -p 80:80 local/c7-systemd-httpd

此容器在有限上下文中运行systemd，并挂载了cgroups文件系统。有报告称，如果使用Ubuntu主机，除了cgroups挂载外，还需要添加-v /tmp/$(mktemp -d):/run。

许可证

查看创建此镜像的脚本的许可证信息。

与所有Docker镜像一样，这些镜像可能还包含其他受其他许可证约束的软件（如基础发行版中的Bash等，以及主要软件的任何直接或间接依赖项）。

一些能够自动检测到的其他许可证信息可能位于repo-info仓库的clefos/目录中。

对于任何预构建镜像的使用，镜像用户有责任确保对该镜像的任何使用都符合其中包含的所有软件的相关许可证。