快速上手
先在本机运行第一个 playbook,再通过 SSH 在远程主机上运行。
本页假定 volant 已经在你的 PATH 上。如果还没有,请先看安装。
在本机运行 playbook
Section titled “在本机运行 playbook”-
创建一个只有一台主机的 inventory,不通过 SSH 连接它:
inventory.ini localhost ansible_connection=local -
编写 playbook:
site.yml - hosts: localhostgather_facts: falsetasks:- name: Who am I?command: id -unregister: me- name: Say hellodebug:msg: "Hello from {{ me.stdout }}" -
运行它。
volant playbook接受与ansible-playbook相同的参数:终端窗口 volant playbook -i inventory.ini site.yml
输出和你在 Ansible 里见到的一样:
PLAY [localhost] ***************************************************************
TASK [Who am I?] ***************************************************************changed: [localhost]
TASK [Say hello] ***************************************************************ok: [localhost] => { "msg": "Hello from alice"}
PLAY RECAP *********************************************************************localhost : ok=2 changed=1 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0在远程主机上运行
Section titled “在远程主机上运行”主机需要有 SSH 服务,以及一个可以用密钥登录的账户。它不需要安装 Volant:控制节点会随第一个 task 上传自己的 agent(一个大约 1.2 MB 的小程序),并把它保存在主机的 ~/.ansible/tmp 里,供下一次运行使用。
[web]web1 ansible_host=192.0.2.10 ansible_user=deploy- hosts: web tasks: - name: Show the distribution debug: msg: "{{ ansible_distribution }} {{ ansible_distribution_version }}"
- name: Make sure the release directory exists become: true file: path: /srv/app state: directory mode: "0755"volant playbook -i inventory.ini site.yml你的 ~/.ssh/config 会生效,因为 Volant 运行的就是你已有的 ssh。最简单的登录方式是密钥文件或 ssh-agent。如果要使用密码,传入 -k,或设置 ansible_password。
你现有的项目
Section titled “你现有的项目”Volant 按原样读取 Ansible 项目。在项目目录中运行它,或者用 -i 指向 inventory:
ansible.cfg从与 Ansible 相同的位置读取,ANSIBLE_*变量同样生效。见配置。- INI、YAML 或脚本形式的 inventory,以及放在旁边的
group_vars/和host_vars/,无需修改即可使用。见 Inventory和优先级与 facts。 - 传入
--ask-vault-pass或 vault 密码文件后,用 vault 加密的文件和变量会被解密。见 Vault。 - role 会在
roles/和roles_path中查找,连同它们的 defaults、handler 和依赖。见 role、include 与 import。 - 用
volant runtime install --collections安装 collection 之后,它们就可以使用。
第一次真正运行之前,请用我的 playbook 能运行吗?检查这个版本做不到什么。它会读取 playbook,并列出一次运行会做什么,而不连接任何主机。
一个可用的项目布局
Section titled “一个可用的项目布局”Volant 在 Ansible 查找 role、group_vars 和 host_vars 的位置找到它们:
- ansible.cfg
- inventory.ini
- site.yml
文件夹group_vars/
- all.yml
- web.yml
文件夹host_vars/
- web1.yml
文件夹roles/
文件夹nginx/
- defaults/main.yml
- handlers/main.yml
- tasks/main.yml
- 我的 playbook 能运行吗?检查现有项目。
- Volant 会在你的机器上留下什么列出它在控制节点和主机上写入的内容。
- 运行 play解释从第一行到汇总之间发生了什么。
- 命令行列出所有选项。