IBM Cloud Docs
创建 Ansible 剧本

创建 Ansible 剧本

遵循以下 先决条件 和常规步骤来创建 Ansible 运行手册。 有关如何构造运行手册的详细信息，请参阅 Ansible 文档 或 运行手册创建。

要使用现有 Ansible 运行手册来入门吗? 试用其中一个 IBM提供的 Ansible 运行手册 或浏览 Ansible Galaxy 中的现有 Ansible 集合和角色

  1. 创建要在其中运行 Ansible 运行手册 的资源清单。 您还可以使用 Schematics 中的内置 Terraform 功能来供应目标主机。 有关更多信息，请参阅 使用 Schematics 工作空间进行基础架构部署。

  2. 创建您的 Ansible 剧本。 使用其中一个 IBM提供的运行手册 开始或浏览 Ansible Galaxy 以查找现有角色和集合。 然后，可以在运行手册中引用这些 角色 和 集合。

  3. 在 GitHub 或 GitLab, 中创建存储库，并构建 Ansible playbook 目录和文件结构。 根据您是否使用 Ansible 角色和集合，此目录结构可能有所不同。 要查找样本结构，请参阅此 样本运行手册。

  4. 将 Ansible 运行手册，模块，角色和集合上载到 GitHub 存储库。

  5. 创建 Schematics 操作。

在运行手册中引用 Ansible 集合

Ansible 集合对不同的可复用 Ansible 资源 (例如，运行手册，模块和角色) 进行分组，以便您可以在运行手册中安装和使用这些资源。 集合存储在 Ansible Galaxy 存储库中。

与 Ansible 角色 类似，集合需要 GitHub 存储库中的特定文件夹结构。

  1. 浏览 Ansible Galaxy 以查找要在运行手册中使用的集合。

  2. 创建 requirements.yml 文件，在其中指定要从 Ansible Galaxy 安装的集合。 有关如何构造此文件的更多信息，请参阅 Ansible 文档。 以下示例使用 community.kubernetes 集合。

    collections:
  - name: community.kubernetes
    version: 0.9.0

  3. 将 collections 文件夹添加到与运行手册相关的 GitHub 存储库，并将 requirements.yml 文件存储在此文件夹中，如本示例中所示。

    ├── collections
        └── requirements.yml
├── playbook.yaml
├── README.md

  4. 在运行手册中引用集合中的资源。 有关更多信息，请参阅 Ansible 文档

准备 Ansible 运行手册以在 Schematics 中运行

要为 Schematics准备 Ansible 运行手册，请查看以下注意事项。