第 4 章 创建 playbook 项目
4.1. 构建 playbook 项目
下列步骤介绍了使用 Ansible VS Code 扩展构建新 playbook 项目的流程。
先决条件
- 您已安装了 Ansible 开发工具。
- 已安装并打开 Ansible VS Code 扩展。
- 您已识别要保存项目的目录。
流程
- 打开 VS Code.
- 单击 VS Code 活动栏中的 Ansible 图标,以打开 Ansible 扩展。
在 Ansible 内容创建者 部分选择 Get started。
Ansible 内容创建者 选项卡将打开。
在 Create 部分中,单击 Ansible playbook project。
Create Ansible project 选项卡将打开。
在 Create Ansible project 选项卡中的表单中,输入以下内容:
目标目录 :输入您要构建新 playbook 项目的目录的路径。
注意如果您输入现有的目录名称,则构建过程会覆盖该目录的内容。如果启用
Force
选项,则构建过程只允许使用现有目录。-
如果您使用 Ansible Dev 工具的容器化版本,则目标目录路径相对于容器,而不是本地系统中的路径。要在容器中发现当前目录名称,请在 VS Code 终端中运行
pwd
命令。如果容器中的当前目录为工作区,请输入workspaces
/<destination_directory_name -
如果您使用本地安装的 Ansible Dev 工具版本,请输入到该目录的完整路径,如
/user/<username>/projects/<destination_directory_name
>。
-
如果您使用 Ansible Dev 工具的容器化版本,则目标目录路径相对于容器,而不是本地系统中的路径。要在容器中发现当前目录名称,请在 VS Code 终端中运行
- SCM 组织和 SCM 项目 :输入目录和子目录的名称,您可以在其中存储您为 playbook 创建的角色。
- 输入您要构建新 playbook 项目的目录的名称。
验证
创建项目目录后,Create Ansible Project 选项卡的 Logs 窗格中会出现以下消息。在本例中,目标目录名称为 destination_directory_name
。
------------------ ansible-creator logs ------------------ Note: ansible project created at /Users/username/test_project
在项目目录中创建以下目录和文件:
$ tree -a -L 5 . ├── .devcontainer │ ├── devcontainer.json │ ├── docker │ │ └── devcontainer.json │ └── podman │ └── devcontainer.json ├── .gitignore ├── README.md ├── ansible-navigator.yml ├── ansible.cfg ├── collections │ ├── ansible_collections │ │ └── scm_organization_name │ │ └── scm_project_name │ └── requirements.yml ├── devfile.yaml ├── inventory │ ├── group_vars │ │ ├── all.yml │ │ └── web_servers.yml │ ├── host_vars │ │ ├── server1.yml │ │ ├── server2.yml │ │ ├── server3.yml │ │ ├── switch1.yml │ │ └── switch2.yml │ └── hosts.yml ├── linux_playbook.yml ├── network_playbook.yml └── site.yml