$ ansible-galaxy init role_name

  $ ansible-galaxy init --role-skeleton = / path / to / skeleton role_name

当提供骨架时，init将：

• 将所有文件和目录从骨架复制到新角色
• 在模板文件夹之外找到的任何.j2文件将被渲染为模板。 目前唯一有用的变量是role_name
• .git文件夹和任何.git_keep文件将不被复制

或者，可以通过ansible.cfg配置role_skeleton和忽略文件

[galaxy]

role_skeleton = /path/to/skeleton

role_skeleton_ignore = ^.git$,^.*/.git_keep$

Search for Roles

通过标签，平台，作者和多个关键字搜索Galaxy数据库。 例如：

$ ansible-galaxy search elasticsearch --author geerlingguy

搜索命令将返回与您的搜索匹配的前1000个结果的列表：

Found 2 roles matching your search:

Name                              Description

----                              -----------

geerlingguy.elasticsearch         Elasticsearch for Linux.

geerlingguy.elasticsearch-curator Elasticsearch curator for Linux.

Get more information about a role

使用info命令可查看有关特定角色的更多详细信息：

$ ansible-galaxy info username.role_name

这将返回Galaxy中发现的所有角色：

Role: username.role_name

    description: Installs and configures a thing, a distributed, highly available NoSQL thing.

    active: True

    commit: c01947b7bc89ebc0b8a2e298b87ab416aed9dd57

    commit_message: Adding travis

    commit_url: https://github.com/username/repo_name/commit/c01947b7bc89ebc0b8a2e298b87ab

    company: My Company, Inc.

    created: 2015-12-08T14:17:52.773Z

    download_count: 1

    forks_count: 0

    github_branch:

    github_repo: repo_name

    github_user: username

    id: 6381

    is_valid: True

    issue_tracker_url:

    license: Apache

    min_ansible_version: 1.4

    modified: 2015-12-08T18:43:49.085Z

    namespace: username

    open_issues_count: 0

    path: /Users/username/projects/roles

    scm: None

    src: username.repo_name

    stargazers_count: 0

    travis_status_url: https://travis-ci.org/username/repo_name.svg?branch=master

    version:

    watchers_count: 1

List installed roles

使用list显示在roles_path中安装的每个角色的名称和版本。

$ ansible-galaxy list

- chouseknecht.role-install_mongod, master

- chouseknecht.test-role-1, v1.0.2

- chrismeyersfsu.role-iptables, master

- chrismeyersfsu.role-required_vars, master

删除已安装的角色

使用remove从roles_path删除角色：

$ ansible-galaxy remove username.role_name

Authenticate with Galaxy

使用import ， delete和setup命令来管理Galaxy网站上的角色需要身份验证，并且可以使用login命令来执行此操作。 在您可以使用login命令之前，您必须在Galaxy网站上创建一个帐户。

login命令需要使用您的GitHub凭据。 您可以使用您的用户名和密码，也可以创建个人访问令牌 。 如果您选择创建令牌，则授予对令牌的最小访问权限，因为它仅用于验证标识。

以下显示使用GitHub用户名和密码与Galaxy网站进行身份验证：

$ ansible-galaxy login

We need your GitHub login to identify you.

This information will not be sent to Galaxy, only to api.github.com.

The password will not be displayed.

Use --github-token if you do not want to enter your password.

Github Username: dsmith

Password for dsmith:

Successfully logged into Galaxy as dsmith

当您选择使用您的用户名和密码时，您的密码不会发送到Galaxy。 它用于使用GitHub进行身份验证，并创建个人访问令牌。 然后，它将令牌发送到Galaxy，该Galaxy又会验证您的身份并返回Galaxy访问令牌。 验证完成后，GitHub令牌将被销毁。

如果您不希望使用GitHub密码，或者如果您使用GitHub启用双重身份验证，请使用-github-token选项传递您创建的个人访问令牌。

Import a role

import命令要求您首先使用login命令进行身份验证。 一旦经过身份验证，您可以导入您拥有或已被授予访问权限的任何GitHub存储库。

使用以下内容导入角色：

  $ ansible-galaxy import github_user github_repo

默认情况下，命令将等待Galaxy完成导入过程，并在导入进度时显示结果：

Successfully submitted import request 41

Starting import 41: role_name=myrole repo=githubuser/ansible-role-repo ref=

Retrieving GitHub repo githubuser/ansible-role-repo

Accessing branch: master

Parsing and validating meta/main.yml

Parsing galaxy_tags

Parsing platforms

Adding dependencies

Parsing and validating README.md

Adding repo tags as role versions

Import completed

Status SUCCESS : warnings=0 errors=0

Delete a role

delete命令要求您首先使用login命令进行身份验证。 通过身份验证，您可以从Galaxy网站中删除角色。 您只能删除您可以访问GitHub中的存储库的角色。

使用以下内容删除角色：

$ ansible-galaxy delete github_user github_repo

这只会消除Galaxy的角色。 它不会删除或更改实际的GitHub信息库。

Travis集成

您可以在Galaxy和Travis中的角色之间创建集成或连接。 建立连接后，Travis中的版本将自动触发Galaxy中的导入，并使用关于角色的最新信息更新搜索索引。

您可以使用setup命令创建集成，但在创建集成之前，必须首先使用login命令进行身份验证; 您还需要在Travis的帐户和您的Travis令牌。 准备好后，使用以下命令创建集成：

  $ ansible-galaxy setup travis github_user github_repo xxx-travis-token-xxx

设置命令需要您的Travis令牌，但令牌不会存储在Galaxy中。 它与GitHub用户名和repo一起使用，以创建Travis文档中所述的哈希。 散列存储在Galaxy中，用于验证从Travis收到的通知。

设置命令使Galaxy能够响应通知。 要配置Travis在您的存储库上运行构建并发送通知，请遵循Travis入门指南 。

要指示Travis在构建完成时通知Galaxy，请将以下内容添加到.travis.yml文件中：

  通知 ：

     webhooks ： https : //galaxy.ansible.com/api/v1/notifications/

  $ ansible-galaxy setup --list

 ID来源报告

 ---------- ---------- ----------

 2 travis github_user / github_repo

 1 travis github_user / github_repo

  $ ansible-galaxy setup --remove ID