fundocker/arnold

Arnold 镜像概述

Arnold 是一个基于 Ansible 的工具镜像，旨在提供一种趣味（FUN）且高效的方式，帮助用户将容器化应用部署到 OpenShift 平台。通过自动化部署流程，简化传统手动操作步骤，降低容器化应用上云门槛，适用于开发和运维团队快速实现应用部署。

核心功能和特性

• Ansible 自动化部署：集成 Ansible 工具链，通过预定义的 playbook 自动化部署流程，减少手动操作
• OpenShift 深度集成：原生支持 OpenShift 平台 API，可直接与集群交互，完成应用创建、配置及发布
• 容器化应用支持：专为 Docker 容器化应用设计，兼容标准容器镜像格式
• 简化配置流程：提供清晰的配置模板，支持自定义应用参数、集群信息等
• 趣味化部署体验：设计理念强调操作便捷性与使用乐趣，降低部署工具的学习曲线

使用场景和适用范围

• 开发团队：快速将本地容器化应用部署到 OpenShift 测试/开发环境
• 运维团队：批量或标准化部署容器应用到 OpenShift 生产集群
• 学习场景：了解 Ansible 与 OpenShift 集成的实践案例，掌握自动化部署方法
• 中小团队：无需编写复杂部署脚本，通过现成工具实现高效部署

详细使用方法和配置说明

前提条件

• 本地环境已安装 Docker
• 目标 OpenShift 集群可访问，且用户具备部署权限
• 已安装 OpenShift CLI (oc) 并配置集群访问凭证
• Ansible 环境（2.9+ 版本，可通过容器内集成环境获取）

获取镜像

从 Docker Hub 或镜像仓库拉取 Arnold 镜像：

bash
docker pull openfun/arnold:latest

基本使用步骤

1. 准备配置文件
   创建应用部署配置文件（如 app-config.yml），包含以下关键信息：

   yaml
   # 示例配置文件
   openshift_cluster: "https://api.openshift.example.com:6443"  # OpenShift 集群 API 地址
   app_name: "my-docker-app"  # 应用名称
   app_image: "my-docker-image:latest"  # 容器镜像地址
   namespace: "my-project"  # OpenShift 项目名称
   replicas: 2  # 部署副本数
   

2. 启动 Arnold 容器并执行部署
   通过 Docker 容器运行 Arnold，挂载配置文件并执行 Ansible playbook：

   bash
   docker run -it --rm \
     -v $(pwd)/app-config.yml:/app/config.yml \
     -v $HOME/.kube/config:/root/.kube/config  # 挂载本地 OpenShift 凭证
     openfun/arnold:latest \
     ansible-playbook /app/playbooks/deploy.yml -e @/config.yml
   

3. 验证部署结果
   使用 OpenShift CLI 检查应用状态：

   bash
   oc get pods -n my-project
   

配置参数说明

注意事项

• 确保本地 oc 工具已配置正确的 OpenShift 集群访问权限
• 配置文件中的敏感信息（如集群凭证）建议通过环境变量或密钥管理工具注入
• 对于复杂应用部署，可扩展自定义 Ansible playbook 并挂载到容器中使用