开发 Ansible 自动化内容

流程

1. 在 VS Code 中，导航到您的项目目录。
2. 单击 VS Code 活动栏中的 Ansible 图标，以打开 Ansible 扩展。
3. 在 Ansible 扩展的 Ansible Development Tools 部分中，向下滚动到 ADD 选项，再选择 Devcontainer。

4. 在 Create a devcontainer 页面中，从容器镜像选项中选择 Downstream 容器镜像。

   此操作在 .devcontainer 目录中为 Podman 和 Docker 添加 devcontainer.json 文件。

5. 重新打开或重新载入项目目录：

   • 如果 VS Code 检测到您的目录包含 devcontainer.json 文件，则会出现以下通知：

     

     单击 Reopen in Container。

   • 如果没有显示通知，点 Remote ( )图标。在出现的下拉菜单中，选择 Reopen in Container。

6. 根据您使用的容器化平台，为 Podman 或 Docker 选择 dev 容器。

   VS Code Status 栏中的 Remote （） 状态会显示 打开 Remote，通知表示打开容器的进度。

流程

1. 运行以下命令检查是否启用了简单内容访问(SCA)：

   $ sudo subscription-manager status

   如果启用了简单内容访问，输出将包含以下信息：

   Content Access Mode is set to Simple Content Access.

   1. 如果没有启用简单内容访问，请附加 Red Hat Ansible Automation Platform SKU：

      $ sudo subscription-manager attach --pool=<sku-pool-id>

2. 使用以下命令安装 Ansible 开发工具：

   $ sudo dnf install --enablerepo=ansible-automation-platform-2.4-for-rhel-8-x86_64-rpms ansible-dev-tools

   $ sudo dnf install --enablerepo=ansible-automation-platform-2.4-for-rhel-9-x86_64-rpms ansible-dev-tools

流程

1. 在 VS Code 中为您的 playbook 创建一个新的 .yml 文件，如 example_playbook.yml。将它放在与示例 site.yml 文件相同的目录级别。

2. 将以下示例代码添加到 playbook 文件中，再保存文件。playbook 由一个对本地机器执行 ping 的 play 组成。

   ---
   - name: My first play
     hosts: localhost
     tasks:
       - name: Ping my hosts
         ansible.builtin.ping:

   ansible-lint 在后台运行，并在终端的 Problems 选项卡中显示错误。此 playbook 中没有错误：

   
3. 保存您的 playbook 文件。

流程

1. 将项目目录初始化为 git 存储库。
2. 将项目推送到源控制系统，如 GitHub。

流程

1. 在浏览器中，登录到自动化控制器。
2. 如果需要，为您的源控制系统配置 Source Control 凭证类型。如需了解更多详细信息 ， 请参阅 Automation controller 用户指南中的创建新凭证 部分。
3. 在自动化控制器中，为存储 playbook 项目的 GitHub 仓库创建一个项目。请参阅 自动化控制器用户指南中的 项目 章节。
4. 创建使用您创建的项目中的 playbook 的作业模板。请参阅 自动化控制器用户指南中的 作业模板 章节。
5. 通过启动作业模板，从自动化控制器运行您的 playbook。请参阅 自动化控制器 用户指南中的启动作业模板 部分。

流程

1. 打开 VS Code.
2. 导航到您要创建角色集合的目录。
3. 单击 VS Code 活动栏中的 Ansible 图标，以打开 Ansible 扩展。

4. 在 Ansible 内容创建者 部分选择 Get started。

   Ansible 内容创建者 选项卡将打开。

5. 在 Create 部分中，单击 Ansible collection project。

   此时会打开 Create new Ansible project 选项卡。

6. 在 Create Ansible project 选项卡中的表单中，输入以下内容：

   • 命名空间 ：输入命名空间的名称，如 company_namespace。
   • 集合 ：输入集合的名称，例如 myapp_network。

   • init 路径 ：输入您要构建新集合的目录的路径。

     如果您输入现有的目录名称，则构建过程会覆盖该目录的内容。如果启用 Force 选项，则构建过程只允许使用现有目录。

     • 如果您使用 Ansible 开发工具的容器化版本，则目标目录路径相对于容器，而不是本地系统中的路径。要在容器中发现当前目录名称，请在 VS Code 终端中运行 pwd 命令。如果容器中的当前目录为工作区，请输入 workspaces /<current_project>/collections。
     • 如果您使用本地安装的 Ansible Dev 工具版本，请输入到该目录的完整路径，如 /user/<username>/path/to/<collection_directory& gt;。
7. 点 Create。

流程

1. 如有必要，重命名包含角色的目录以反映其内容，例如 acl_config 或 tacacs。

   集合中的角色的名称不能有连字符。改为使用下划线字符(_)。

2. 将独立角色中的 roles 目录复制到集合中的 roles/ 目录中。

   例如，在名为 myapp_network 的集合中，将角色添加到 myapp_network/roles/ 目录中。

3. 将独立角色中的任何插件复制到新集合的 plugins directory/ 中。集合目录结构类似：

   company_namespace
   └── myapp_network
       ├── ...
       ├── galaxy.yml
       ├── docs
       ├── extensions
       ├── meta
       ├── plugins
       ├── roles
       │   ├── acl_config
       │   │   ├── README.md
       │   │   ├── defaults
       │   │   ├── files
       │   │   ├── handlers
       │   │   ├── meta
       │   │   ├── tasks
       │   │   ├── templates
       │   │   ├── tests
       │   │   └── vars
       │   └── tacacs
       │       ├── README.md
       │       ├── default
       │       ├── files
       │       ├── handlers
       │       ├── meta
       │       ├── tasks
       │       ├── templates
       │       ├── tests
       │       └── vars
       │   ├── run
       ├── ...
       ├── tests
       └── vars

   run 角色是构建集合时创建的默认角色目录。

4. 更新您的 playbook，以将完全限定集合名称(FQDN)用于您的集合中新角色。

流程

1. 要创建新角色，请复制创建集合时构建的默认 运行 角色目录。
2. 在 tasks/main.yml 文件中定义您希望角色执行的任务。如果您要创建角色来重新利用现有 playbook 中的任务，请将内容复制到 playbook YAML 文件的 tasks 块中。删除任务左侧的空格。在 VS Code 中使用 ansible-lint 检查您的 YAML 代码。
3. 如果您的角色依赖于另一个角色，请在 meta/main.yml 文件中添加依赖项。

1. 前提条件

   • 将集合打包为一个 tarball。按如下方式格式化您的集合文件名：

流程

1. 在私有自动化中心中为集合创建一个命名空间。请参阅 Automation hub 指南中的 创建命名空间。
2. 可选：在命名空间中添加信息。请参阅 Automation hub 指南中的管理内容中的 向命名空间添加额外信息和资源。
3. 将角色集合 tarball 上传到命名空间。请参阅 Automation Hub 指南中的 将集合上传到命名空间。
4. 批准您的集合以进行内部发布。请参阅 Automation Hub 指南中的 将集合上传到命名空间。