SuperAPI AI 工具集

ansible

通用与其它

查看项目

更新于 10-16 08:11

技能介绍

用途:在仓库内使用 Ansible 对多台节点执行可重复、幂等的变更,适合需要在多个主机上应用相同改动、涉及操作系统软件包、服务或系统配置,以及引导或维护 k3s、Rancher、Tailscale 的场景。

主要能力:inventory 位于 ansible/inventory/hosts.ini,常见分组包括 kube_masters、kube_workers、k3s_cluster、proxy、docker_hosts。仓库内常见 playbook 覆盖安装 NFS 客户端、安装 Tailscale、启用并启动 tailscaled、启动 Tailscale 客户端服务、配置 k3s HA、配置 k3s OIDC、安装 Rancher、等待 Rancher 就绪、采集 Rancher 引导日志、启动 Rancher 容器。

使用方式:对集群所有节点执行 ping:ansible -i ansible/inventory/hosts.ini k3s_cluster -m ping -u kalmyk;运行 playbook:ansible-playbook -i ansible/inventory/hosts.ini ansible/playbooks/install_nfs_client.yml -u kalmyk -b;限制单主机:ansible-playbook -i ansible/inventory/hosts.ini ansible/playbooks/install_tailscale.yml -u kalmyk -b --limit kube-worker-00。

安全与幂等:优先使用 Ansible 模块而非 shell 命令;验证高风险变更时使用 --check 和 --diff;测试时用 --limit 限定范围;保持 playbook 幂等以便安全重跑。

验证:服务检查 systemctl status tailscaled;日志 journalctl -u tailscaled --no-pager -n 50;集群检查 kubectl get nodes -o wide。

资源:参考 references/ansible-runbook.md,运行器 scripts/run-playbook.sh,模板 assets/playbook-template.yml。

限制:资料未提供具体版本要求、依赖安装方式、权限细节及失败处理策略,暂未提供。