FreeIPA Docker镜像文档

1. 镜像概述与主要用途

本镜像基于CentOS系统，通过***yum仓库构建FreeIPA服务器及客户端Docker镜像，支持在Docker环境中快速部署FreeIPA服务。FreeIPA是一个集成身份认证、授权、集中式用户/主机管理及Kerberos服务的开源解决方案，本镜像旨在简化其部署流程，适用于容器化环境中的身份服务搭建。

2. 核心功能与特性

服务器自动化部署：通过非交互式执行ipa-server-install，支持首次运行时自动完成FreeIPA服务器配置
客户端自动注册：客户端容器可通过链接服务器容器，自动执行ipa-client-install完成注册
环境变量配置：支持通过环境变量设置管理员密码，简化初始化流程
容器生命周期管理：支持容器的启动、停止、重启等标准Docker操作
跨容器通信：客户端容器通过--link参数与服务器容器建立网络链接，实现服务发现

3. 使用场景与适用范围

开发测试环境：快速搭建隔离的身份认证服务，用于应用程序集成测试
小型生产部署：适用于对资源要求较低的场景，提供集中式用户与权限管理
临时服务需求：需要短期部署身份服务的场景（如临时项目、演示环境）
学与实验**：用于FreeIPA功能学**和配置实验，避免直接影响物理环境

4. 使用方法

4.1 FreeIPA服务器镜像

4.1.1 环境准备

安装Docker 1.2+（以EL 7系统为例）：

bash
yum install -y docker

启动Docker服务：

bash
systemctl start docker

4.1.2 构建镜像

在仓库根目录执行以下命令构建服务器镜像：

bash
docker build -t freeipa-server .

4.1.3 运行容器

首次运行容器时，将自动执行ipa-server-install完成初始化：

bash
docker run --name freeipa-server-container -ti -h ipa.example.test -e PASSWORD=Secret123 freeipa-server

4.1.4 容器管理

停止容器：

bash
docker stop freeipa-server-container

启动容器（带交互终端）：

bash
docker start -ai freeipa-server-container

4.2 FreeIPA客户端镜像

4.2.1 环境准备

根据需求切换至对应客户端分支（如fedora-20-client、fedora-rawhide-client或rhel-7-client）：

bash
git checkout <分支名称>  # 例如：git checkout fedora-20-client

4.2.2 构建镜像

在仓库根目录执行以下命令构建客户端镜像：

bash
docker build -t freeipa-client .

4.2.3 运行容器

客户端容器需链接至服务器容器，并通过环境变量传入管理员密码：

bash
docker run --privileged --link freeipa-server-container:ipa -e PASSWORD=Secret123 -ti freeipa-client

说明：首次运行时将自动执行ipa-client-install完成客户端注册。

5. 配置参数说明

5.1 服务器容器参数

参数/环境变量	说明
`--name`	指定容器名称（如`freeipa-server-container`），用于后续生命周期管理
`-h/--hostname`	设置容器主机名（如`ipa.example.test`），需符合FreeIPA域名规范
`-e PASSWORD`	必选，设置FreeIPA管理员（admin）密码（如`Secret123`）
`-ti`	可选，分配交互式终端，便于容器内操作与调试

5.2 客户端容器参数

参数/环境变量	说明
`--privileged`	必选，赋予容器特权模式，满足客户端注册所需系统权限
`--link`	必选，链接服务器容器（格式：`服务器容器名称:别名`，如`freeipa-server-container:ipa`）
`-e PASSWORD`	必选，传入FreeIPA管理员密码，用于客户端注册认证
`-ti`	可选，分配交互式终端，便于查看注册过程与调试

6. Docker部署示例

6.1 服务器容器启动示例

bash
# 构建服务器镜像  
docker build -t freeipa-server .  

# 运行服务器容器（设置主机名、密码，指定容器名称）  
docker run \  
  --name freeipa-server-container \  
  -h ipa.example.test \  
  -e PASSWORD=Admin@123 \  
  -d \  # 后台运行（替换-ti为-d，适合生产环境）  
  freeipa-server

6.2 客户端容器链接示例

bash
# 构建客户端镜像（切换至rhel-7-client分支）  
git checkout rhel-7-client  
docker build -t freeipa-client .  

# 链接服务器容器并运行客户端  
docker run \  
  --privileged \  
  --link freeipa-server-container:ipa \  
  -e PASSWORD=Admin@123 \  
  -ti \  
  freeipa-client