创建 Ansible 游戏手册

要创建 Ansible playbook 供 Schematics 使用，请遵循以下前提条件和一般步骤。

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

准备好您打算运行 Ansible playbook 的资源清单。您还可以使用 Schematics 的内置 Terraform 功能来配置目标主机。有关更多信息，请参阅使用 Schematics 工作空间进行基础架构部署。
制定 Ansible 游戏手册。使用 IBM 提供的 playbook 之一，或探索 Ansible Galaxy 中的现有角色和集合。根据需要在游戏本中引用这些角色和集合](/docs/schematics?topic=schematics-create-playbook#schematics-collections)。
建立 GitHub 或 GitLab 资源库，并根据所需的目录结构组织 Ansible playbook、模块、角色和集合。示例结构可在此示例播放列表中找到。
将 Ansible 运行手册，模块，角色和集合上载到 GitHub 存储库。
使用上传的播放列表创建 Schematics 操作。

确保您的操作手册遵循必要的结构，并引用任何所需的角色和集合，以便在 Schematics 中无缝执行。更多信息，请参阅 Ansible 文档或游戏本创建。

在运行手册中引用 Ansible 集合

Ansible 集合是一组可重复使用的 Ansible 资源，如 playbook、模块和角色，您可以在 playbook 中安装和使用这些资源。藏品可从 Ansible Galaxy 存储库中获取。

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

请按照以下步骤在 Schematics playbook 中使用集合

浏览 Ansible Galaxy 以查找要在运行手册中使用的集合。
创建 requirements.yml 文件，指定要从 Ansible Galaxy 安装的程序集。文件结构应遵循 Ansible 文档。下面是一个使用 community.kubernetes 系列的示例。
```
collections:
  - name: community.kubernetes
    version: 0.9.0
```
在 GitHub 资源库中添加一个 collections 文件夹（相对于 playbook），并将 requirements.yml 文件放在该文件夹中。
```
├── collections
        └── requirements.yml
├── playbook.yaml
├── README.md
```
在运行手册中引用集合中的资源。更多信息，请参阅 Ansible 文档。确保游戏手册的文件夹结构符合要求，并正确引用集合，以便在 Schematics 中无缝执行。

在 Schematics 中运行 Ansible playbook 之前，请考虑以下几点：

将 Ansible playbook 存储在 GitHub 或 GitLab 资源库中。
为 Ansible 资源清单指定目标主机时要注意限制。如需了解更多信息，请参阅“为 Schematics 行动创建资源清单”指南。
确保您的游戏本与 Schematics 中支持的 Ansible 版本兼容。要检查支持的版本，请运行 ibmcloud schematics version 命令。
（可选）使用 IBM 提供的 Ansible playbook 之一，探索 Schematics 中的 Ansible playbook 功能。

了解 Ansible playbook 的前提条件和准备步骤后，下一步就是创建 Schematics 操作。这一过程包括指定 Ansible playbook、配置资源清单以及设置任何必要的凭证或变量。请按照创建 Schematics 操作的指南继续操作。