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 环境准备

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

   yum install -y docker  
   

2. 启动Docker服务：

   systemctl start docker  
   

4.1.2 构建镜像

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

docker build -t freeipa-server .  

4.1.3 运行容器

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

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

4.1.4 容器管理

• 停止容器：

  docker stop freeipa-server-container  
  

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

  docker start -ai freeipa-server-container  
  

4.2 FreeIPA客户端镜像

4.2.1 环境准备

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

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

4.2.2 构建镜像

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

docker build -t freeipa-client .  

4.2.3 运行容器

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

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

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

5. 配置参数说明

5.1 服务器容器参数

5.2 客户端容器参数

6. Docker部署示例

6.1 服务器容器启动示例

# 构建服务器镜像  
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 客户端容器链接示例

# 构建客户端镜像（切换至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  

7. 版权信息

Copyright 2014 Jan Pazdziora

本镜像基于Apache License 2.0许可协议发布。您可在[***]"原样"分发，不提供任何明示或默示担保。