8.4. 将现有角色迁移到您的集合

单机角色的目录具有以下结构：您的角色可能不包含所有这些目录。

my_role
├── README.md
├── defaults
│   └── main.yml
├── files
├── handlers
│   └── main.yml
├── meta
│   └── main.yml
├── tasks
│   └── main.yml
├── templates
├── tests
│   ├── inventory
│   └── test.yml
└── vars
    └── main.yml

my_role
├── README.md
├── defaults
│   └── main.yml
├── files
├── handlers
│   └── main.yml
├── meta
│   └── main.yml
├── tasks
│   └── main.yml
├── templates
├── tests
│   ├── inventory
│   └── test.yml
└── vars
    └── main.yml

Copy to Clipboard

Toggle word wrap

Ansible 角色有一个定义的目录结构，包含 7 个主要标准目录。每个角色必须至少包含其中一个目录。您可以省略角色不使用的任何目录。每个目录包含一个 main.yml 文件。

流程

如有必要，重命名包含角色的目录以反映其内容，例如 acl_config 或 tacacs。
集合中的角色的名称不能有连字符。改为使用下划线字符(_)。
将独立角色中的 roles 目录复制到集合中的 roles/ 目录中。
例如，在名为 myapp_network 的集合中，将角色添加到 myapp_network/roles/ 目录中。

将独立角色中的任何插件复制到新集合的 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

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

Copy to Clipboard

Toggle word wrap

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

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

并非所有独立角色都会在不修改代码的情况下无缝集成到您的集合中。例如，如果包含插件的 Galaxy 的第三方单机角色使用 module_utils/ 目录，则插件本身具有 import 语句。

8.4. 将现有角色迁移到您的集合

学习

尝试、购买和销售

社区

关于红帽文档

让开源更具包容性

關於紅帽

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links