Fedora Docker 镜像文档

镜像概述与主要用途

amd64/fedora 是 Fedora 官方提供的 Docker 镜像，专为 amd64 架构构建，是 Fedora 发行版的容器化版本。该镜像旨在提供一个轻量级、官方维护的 Fedora 环境，适用于开发、测试、持续集成以及作为基础镜像构建自定义容器应用。

amd64/fedora:latest 标签始终指向最新稳定版 Fedora，而 rawhide 标签对应 Fedora 开发版（Rawhide），用户也可通过指定版本号（如 amd64/fedora:42）获取特定版本的 Fedora 环境。

核心功能与特性

• 轻量级设计：相比标准 Fedora 安装，镜像体积更小，适合容器化场景。
• 官方构建与维护：由 Fedora 发布工程团队（Fedora Release Engineering）维护，通过 Fedora 构建系统（Koji）生成，确保与 Fedora 发行版同步。
• 透明构建流程：基于 fedora-container-base.ks kickstart 文件构建，构建过程可追溯。
• 多版本支持：提供稳定版（如 42、43）和开发版（Rawhide），满足不同阶段需求。
• 多架构兼容：除 amd64 外，还支持 arm64v8、ppc64le、s390x 等架构（需使用对应架构的镜像仓库）。

支持的标签

以下标签对应 Fedora 不同版本，括号内为其 Dockerfile 链接：

• 41：Dockerfile
• 42、latest：Dockerfile（最新稳定版）
• 43：Dockerfile
• 44、rawhide：Dockerfile（开发版）

使用场景与适用范围

• 开发环境：快速搭建 Fedora 开发环境，无需本地安装完整系统。
• 测试验证：测试应用在不同 Fedora 版本（如稳定版、Rawhide）上的兼容性。
• CI/CD 流程：作为持续集成/部署的基础镜像，运行自动化测试或构建任务。
• 自定义镜像构建：基于 Fedora 基础镜像，通过 Dockerfile 安装额外软件包，构建专用容器。

使用方法与配置说明

基本使用（docker run 命令）

1. 运行交互式 shell

通过以下命令启动 Fedora 容器并进入交互式 bash 终端：

docker run -it --rm amd64/fedora:latest /bin/bash

• -it：启用交互式终端并分配伪终端。
• --rm：容器退出后自动删除，避免残留。
• /bin/bash：指定运行的命令（默认 shell）。

2. 运行一次性命令

在容器中执行指定命令（如查看系统版本）：

docker run --rm amd64/fedora:42 cat /etc/os-release

输出示例：

NAME=Fedora
VERSION="42 (Container Image)"
ID=fedora
VERSION_ID=42
VERSION_CODENAME=""
PLATFORM_ID="platform:f42"
PRETTY_NAME="Fedora 42 (Container Image)"
ANSI_COLOR="0;38;2;60;110;180"
LOGO=fedora-logo-icon
CPE_NAME="cpe:/o:fedoraproject:fedora:42"
DEFAULT_HOSTNAME="fedora"
HOME_URL="[***]"
DOCUMENTATION_URL="[***]"
SUPPORT_URL="[***]"
BUG_REPORT_URL="[***]"
REDHAT_BUGZILLA_PRODUCT="Fedora"
REDHAT_BUGZILLA_PRODUCT_VERSION=42
REDHAT_SUPPORT_PRODUCT="Fedora"
REDHAT_SUPPORT_PRODUCT_VERSION=42

构建自定义镜像（Dockerfile 示例）

基于 Fedora 镜像安装额外软件包（如 nginx）：

# 使用最新稳定版 Fedora 作为基础镜像
FROM amd64/fedora:latest

# 更新系统并安装 nginx
RUN dnf update -y && \
    dnf install -y nginx && \
    dnf clean all  # 清理缓存以减小镜像体积

# 暴露 80 端口
EXPOSE 80

# 启动 nginx
CMD ["nginx", "-g", "daemon off;"]

构建并运行自定义镜像：

docker build -t fedora-nginx .
docker run -d -p 8080:80 fedora-nginx

Docker Compose 配置示例

创建 docker-compose.yml 文件，定义基于 Fedora 的服务：

version: '3'
services:
  fedora-app:
    image: amd64/fedora:latest
    container_name: fedora-demo
    tty: true  # 保持终端运行
    command: /bin/bash  # 启动 bash
    volumes:
      - ./app:/app  # 挂载本地目录到容器

启动服务：

docker-compose up -d

进入容器：

docker-compose exec fedora-app bash

配置说明

默认配置

• 默认 shell：/bin/bash。
• 包管理器：dnf（Fedora 官方包管理器），可用于安装、更新软件包。
• 用户：默认以 root 用户运行，可通过 USER 指令在 Dockerfile 中切换普通用户。

自定义环境变量

可通过 docker run -e 或 Dockerfile ENV 指令设置环境变量，例如：

docker run -it --rm -e "APP_ENV=production" amd64/fedora:latest bash

支持与反馈

维护者

由 Fedora Release Engineering 维护。

帮助渠道

• Docker 社区 Slack
• Server Fault
• Unix & Linux Stack Exchange
• Stack Overflow

问题反馈

• Bugzilla：Fedora Container Images 项目
• GitHub：docker-brew-fedora 仓库

许可信息

• 镜像中软件的许可信息详见 Fedora 官方许可文档。
• 镜像可能包含其他软件（如 Bash、基础系统工具等），其许可可能不同，用户需自行确保使用该镜像符合所有包含软件的许可要求。
• 额外自动检测的许可信息可参考 repo-info 仓库的 fedora 目录。

作为预构建镜像的使用者，您有责任确保对本镜像的任何使用均符合其中所有软件的相关许可。