korrmal/ansible

Ansible Docker镜像文档

镜像概述

本镜像基于Debian Slim构建，包含Ansible v2.9.27（运行于Python 2.7.16环境），并集成k8s插件、Yandex控制台工具、kubectl及Helm，提供一站式Kubernetes集群自动化部署与资源管理能力。

核心功能与特性

• Ansible基础环境：内置Ansible v2.9.27，支持通过Playbook实现自动化任务编排
• Python环境：基于Python 2.7.16运行，兼容对应版本Ansible依赖
• Kubernetes工具链：
  • k8s插件：支持通过Ansible Playbook管理Kubernetes资源
  • kubectl：Kubernetes命令行工具，用于集群资源操作
  • Helm：Kubernetes包管理工具，支持Chart部署与管理
• Yandex控制台集成：包含Yandex云服务控制台工具，支持与Yandex云资源交互

使用场景与适用范围

• Kubernetes集群自动化部署与配置管理
• 多环境（开发/测试/生产）Kubernetes资源一致性维护
• 基于Ansible的云资源（Yandex云）与K8s集群协同管理
• 基础设施即代码（IaC）实践中的自动化执行环境

使用方法与配置说明

基本运行方式

bash
docker run -it --rm \
  -v /path/to/ansible/playbooks:/ansible/playbooks \
  -v ~/.kube/config:/root/.kube/config \  # 挂载kubectl配置
  ansible-image:latest \
  ansible-playbook /ansible/playbooks/deploy_k8s.yml

关键配置说明

1. 挂载Ansible资源：通过-v参数挂载本地Playbook、Inventory等文件至容器内/ansible目录
2. Kubernetes配置：挂载本地~/.kube/config至容器/root/.kube/config，使kubectl和k8s插件可访问目标集群
3. Yandex控制台配置：需通过环境变量或挂载配置文件设置Yandex云凭证，例如：

   bash
   docker run -it --rm \
     -e YC_TOKEN=your_yandex_cloud_token \
     ansible-image:latest \
     yc config set token $YC_TOKEN
   

常用命令示例

• 执行Ansible Playbook：

  bash
  docker run -it --rm -v $(pwd):/ansible ansible-image:latest ansible-playbook /ansible/site.yml
  

• 运行kubectl命令：

  bash
  docker run -it --rm -v ~/.kube/config:/root/.kube/config ansible-image:latest kubectl get pods
  

• 使用Helm部署Chart：

  bash
  docker run -it --rm -v ~/.kube/config:/root/.kube/config ansible-image:latest helm install my-app ./chart