AgentSkillsCN

ansible-configure-vm

通过 Ansible Playbook 和临时命令配置虚拟机。运行 Playbook，安装 Galaxy 角色、临时模块，进行清单管理与检查模式操作。适用于配置虚拟机，或在主机上执行 Ansible 命令时使用。

SKILL.md
--- frontmatter
name: ansible-configure-vm
description: Configure VMs with Ansible playbooks and ad-hoc commands. Run playbooks, install Galaxy roles, ad-hoc modules, inventory management, check mode. Use when configuring VMs or running Ansible against hosts.

Ansible Configure VM

Configure virtual machines using Ansible playbooks and ad-hoc commands.

Inputs

InputTypeDefaultPurpose
playbookstring""Path to Ansible playbook
inventorystring"inventory.yaml"Inventory file path
hostsstring"all"Target hosts or group pattern
tagsstring""Ansible tags to run
check_modeboolfalseDry-run (check) mode
install_requirementsboolfalseInstall Galaxy requirements first

Persona

Load infra persona (ansible, ssh tools).

Workflow

1. Bootstrap

  • •persona_load("infra")
  • •check_known_issues("ansible", "") — known Ansible issues

2. Environment Check

  • •ansible_version() — Ansible version
  • •ansible_config_dump() — configuration

3. Inventory

  • •ansible_inventory_list(inventory=inventory) — list hosts
  • •ansible_inventory_graph(inventory=inventory) — inventory graph
  • •ansible_inventory_host(inventory=inventory, host=hosts) — host variables

4. Connectivity

  • •ssh_test(host=hosts) — SSH connectivity
  • •ansible_ping(host=hosts, inventory=inventory) — Ansible ping
  • •ansible_setup(host=hosts, inventory=inventory) — gather facts

5. Galaxy (if install_requirements)

  • •ansible_galaxy_list() — installed roles
  • •ansible_galaxy_search(query=playbook) — search
  • •ansible_galaxy_install(requirements="requirements.yaml") — install

6. Playbook Operations (if playbook provided)

  • •ansible_playbook_list_tasks(playbook=playbook, inventory=inventory) — list tasks
  • •ansible_playbook_list_tags(playbook=playbook, inventory=inventory) — list tags
  • •If check_mode: ansible_playbook_check(playbook=playbook, inventory=inventory, limit=hosts, tags=tags)
  • •Else: ansible_playbook_run(playbook=playbook, inventory=inventory, limit=hosts, tags=tags)

7. Ad-hoc (if no playbook)

  • •ansible_command(host=hosts, inventory=inventory, command="hostname")
  • •ansible_shell(host=hosts, inventory=inventory, command="uptime && free -h")

8. Error Handling

  • •On "unreachable": learn_tool_fix("ansible_ping", "unreachable", "Host not reachable via SSH", "Check SSH and host is running")
  • •On "permission denied": ensure SSH key authorized or become password
  • •On "playbook not found": verify playbook path

9. Session Log

  • •memory_session_log("Ansible configure VM", "playbook={playbook}, hosts={hosts}")

Related Skills

  • •vm_lab_setup — create VMs first
  • •manage_secrets — vault-encrypted vars