Learning Ansible Without Opening the Docs Website

说明与用途

作者通过仅使用本地资源（虚拟环境、ansible-doc 和本地集合）学习 Ansible，创建了一个可运行的 playbook，而无需访问网络文档。

问题

Relying on online documentation made learning Ansible tedious and memory‑poor; the author wanted to understand Ansible using only local resources.

结果

The author achieved a self‑contained learning workflow, avoided dependency drift, and produced a working playbook, all without browsing the web.

工作流

• Create a clean virtual environment and install Ansible
• Use ansible-doc -l to list available modules and grep for specific names
• Read module pages with ansible-doc <module> and examine EXAMPLES
• Use ansible-doc -s <module> for concise option snippets
• Discover keyword documentation with ansible-doc -t keyword <name>
• Search local collection paths for real YAML examples of keywords
• Assemble a small playbook combining modules, arguments, and keywords
• Run the playbook to validate understanding

证据

I stopped reaching for the browser.

来源

python3 -m venv ~/.venvs/ansible source ~/.venvs/ansible/bin/activate pip install --upgrade pip ansible

来源

ansible-doc -l

来源

ansible-doc copy

来源

ansible-doc -t keyword loop ansible-doc -t keyword when

来源

PAGER=cat ansible-doc -s copy

来源

ansible-galaxy collection list

来源

• name: Install and start nginx

hosts: webservers
become: true
tasks:

• name: Install nginx

ansible.builtin.package:
name: nginx
state: present
when: ansible_os_family == "Debian"

来源