openshift/origin-ansible

Containerized openshift-ansible 镜像文档

镜像概述和主要用途

本镜像打包了https://github.com/openshift/openshift-ansible%EF%BC%8C%E8%BF%99%E6%98%AF%E4%B8%80%E5%A5%97%E5%9F%BA%E4%BA%8EAnsible%E7%9A%84%E5%B7%A5%E5%85%B7%EF%BC%8C%E7%94%A8%E4%BA%8E%E5%AE%89%E8%A3%85%E5%92%8C%E7%AE%A1%E7%90%86OpenShift%E9%9B%86%E7%BE%A4%E3%80%82

该镜像基于https://hub.docker.com/r/aweiteka/playbook2image/ source-to-image基础镜像构建，可运行openshift-ansible中提供的任意剧本。

注意：目前存在已知问题，无法在作为安装目标的主机上运行此镜像以执行安装/升级操作（即运行配置/升级类剧本）：如果要运行的剧本尝试管理Docker守护进程并重启它（如安装/升级剧本所为），会导致容器在运行过程中自身被终止。

核心功能和特性

• 基于playbook2image基础镜像，支持灵活配置容器行为
• 包含完整的openshift-ansible剧本集，可执行各类OpenShift集群管理任务
• 通过环境变量控制剧本执行参数，支持多种清单文件获取方式
• 支持挂载SSH密钥以实现Ansible对目标主机的访问

使用场景和适用范围

适用于OpenShift集群的日常管理、配置检查、证书过期检查等任务。特别适合需要通过Ansible自动化执行OpenShift集群操作的场景。

不适用场景：在目标主机上直接运行安装或升级剧本（可能导致容器被终止）。

使用方法和配置说明

基本要求

运行本镜像的容器时，至少需要指定以下内容：

1. 清单文件（inventory）：可通过卷挂载到容器内，并通过INVENTORY_FILE环境变量指定路径；或通过INVENTORY_URL环境变量从Web服务器获取。

2. SSH密钥：需挂载为卷，路径为/opt/app-root/src/.ssh，确保Ansible能访问目标主机。

3. 要运行的剧本：通过PLAYBOOK_FILE环境变量设置。若未指定，默认运行openshift_facts剧本，用于收集和显示OpenShift环境信息。

环境变量说明

使用示例

以下示例展示如何运行容器化的openshift-ansible剧本，检查OpenShift内部证书的过期日期（使用https://github.com/openshift/openshift-ansible/blob/master/roles/openshift_certificate_expiry%EF%BC%89%EF%BC%9A

bash
docker run -u `id -u` \
       -v $HOME/.ssh/id_rsa:/opt/app-root/src/.ssh/id_rsa:Z,ro \
       -v /etc/ansible/hosts:/tmp/inventory:ro \
       -e INVENTORY_FILE=/tmp/inventory \
       -e OPTS="-v" \
       -e PLAYBOOK_FILE=playbooks/certificate_expiry/default.yaml \
       openshift/origin-ansible

更多参考

有关playbook2image基础镜像的更多使用选项，可参考https://github.com/aweiteka/playbook2image%E3%80%82https://github.com/openshift/playbook2image/tree/master/examples%E4%B9%9F%E6%8F%90%E4%BE%9B%E4%BA%86%E5%9F%BA%E4%BA%8E%E6%AD%A4%E7%B1%BB%E9%95%9C%E5%83%8F%E7%9A%84%E6%9B%B4%E5%A4%9A%E4%BD%BF%E7%94%A8%E5%9C%BA%E6%99%AF%E3%80%82