s390x/clefos

ClefOS Docker镜像文档

注意事项

本仓库是https://hub.docker.com/_/clefos针对`s390x`架构的"每架构"仓库——更多信息请参见官方镜像文档中的https://github.com/docker-library/official-images#architectures-other-than-amd64和官方镜像FAQ中的https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what。

弃用通知

随着CentOS 7的生命周期结束（2024年6月30日），此镜像/项目已https://github.com/docker-library/official-images/pull/7964#issuecomment-2253636315。请相应调整您的使用方式。

快速参考

• 维护者：
  https://github.com/nealef/clefos

• 获取帮助：
  https://dockr.ly/comm-slack、Server Fault、https://unix.stackexchange.com/help/on-topic或https://stackoverflow.com/help/on-topic

支持的标签及相应Dockerfile链接

警告：此镜像在s390x架构上不受支持

快速参考（续）

• 问题提交地址：
  https://github.com/nealef/clefos/issues

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  无支持架构

• 已发布镜像制品详情：
  https://github.com/docker-library/repo-info/blob/master/repos/clefos（https://github.com/docker-library/repo-info/commits/master/repos/clefos）
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fclefos
  https://github.com/docker-library/official-images/blob/master/library/clefos（https://github.com/docker-library/official-images/commits/master/library/clefos）

• 本描述的来源：
  https://github.com/docker-library/docs/tree/master/clefos（https://github.com/docker-library/docs/commits/master/clefos）

ClefOS简介

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

ClefOS镜像文档

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

构建基础镜像

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

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

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

滚动构建

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

Overlayfs与yum

最新的Docker版本支持https://docs.docker.com/engine/userguide/storagedriver/overlayfs-driver/后端，从Docker 1.13开始，大多数支持该后端的发行版都默认启用它。在ClefOS 7上，该后端需要安装并启用yum-plugin-ovl；虽然在最新的clefos镜像中默认已安装，但如果您更新/etc/yum.conf文件，请确保保留其中的plugins=1选项；否则，您可能会遇到与rpmdb校验和失败相关的错误——更多详情请参见https://github.com/docker/docker/issues/***。

软件包文档

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

Systemd集成

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

systemd基础镜像的Dockerfile

dockerfile
FROM 		docker.xuanyuan.run/s390x/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 docker.xuanyuan.run/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。

许可证

查看https://github.com/nealef/clefos/blob/master/LICENSE.md以了解创建此镜像的脚本。

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

一些能够自动检测到的其他许可证信息可能位于https://github.com/docker-library/repo-info/tree/master/repos/clefos中。

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