建立 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 文件或 playbook 建立。

在教戰手冊中參照 Ansible 集合

Ansible 集合是可重複使用的 Ansible 資源群組，例如播放簿、模組和角色，您可以在播放簿中安裝和使用這些資源。收藏集可在 Ansible Galaxy 儲存庫中找到。

類似於 Ansible 角色，集合需要 GitHub 儲存庫中的特定資料夾結構。

遵循以下步驟在 Schematics playbook 中使用集合

瀏覽 Ansible Galaxy 以尋找您要在教戰手冊中使用的集合。
建立 requirements.yml 檔案，指定您要從 Ansible Galaxy 安裝的合集。檔案結構應遵循 Ansible 文件。以下是使用 community.kubernetes 套件的範例。
```
collections:
  - name: community.kubernetes
    version: 0.9.0
```
相對於您的 playbook，在 GitHub 套件庫中新增 collections 資料夾，並將 requirements.yml 檔案放入此資料夾。
```
├── collections
        └── requirements.yml
├── playbook.yaml
├── README.md
```
在教戰手冊中參照集合中的資源。如需詳細資訊，請參閱 Ansible 文件。確保您的 playbook 文件夾結構符合需求，並正確引用集合，以便在 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 動作的指南繼續進行。