一、介绍Anisble galaxy
1、介绍Ansibleu galaxy
1️⃣：Ansible Galaxy （官网：https://galaxy.ansible.com）是一个Ansible内容公共资源库，这些内容由许许多多Ansible管理员和用户编写。
2️⃣：它包含数千个Ansible角色，具有可搜索的数据库，可帮助Ansible用户确定或许有助于他们完成管理任务的角色
3️⃣：Ansible Galaxy含有面向新的Ansible用户和角色开发人员的文档和视频链接
2、获取Ansible galaxy帮助
1️⃣：通过Ansible Galaxy网站主页上的Documenttaion标签，可以进入描述如何使用Ansible Galaxy的页面
2️⃣：其中包含了介绍如何从Ansible Galaxy下载和使用角色的内容。该页面也提供关于如何开发角色并上传到Ansible Galaxy的说明。
3、浏览Ansible galaxy中的角色
1️⃣：通过Ansible Galaxy网站主页上左侧的Search标签，用户可以访问关于Ansible Galaxy上发布的角色的信息
2️⃣：用户可以使用标记通过角色的名称或通过其他角色属性来搜索Ansible角色。
3️⃣：结果按照Best Match分数降序排列，此分数依据角色质量、角色受欢迎程度和搜索条件计算而得。
二、Ansible Galaxy命令行工具
1、从命令行搜索角色
1️⃣：ansible-galaxy search子命令在Ansible Galaxy中搜索角色
2️⃣：如果以参数形式指定了字符串，则可用于按照关键字在Ansible Galaxy中搜索角色
3️⃣：用户可以使用--author、--platforms和--galaxy-tags选项来缩小搜索结果的范围
4️⃣：例如，命令ansible-galaxy search --author geerlingguy将显示由用户geerlingguy提交的所有角色
[root@localhost ~]# ansible-galaxy search 'redis' --author geerlingguy Found 3 roles matching your search: Name Description ---- ----------- geerlingguy.php-pecl PHP PECL extension installation. geerlingguy.php-redis PhpRedis support for Linux geerlingguy.redis Redis for Linux
5️⃣：ansible-galaxy info子命令显示与角色相关的更多详细信息
6️⃣：Ansible Galaxy从多个位置获取这一信息，包括角色的meta/main.yml文件及其GigHub存储库
[root@localhost ~]# ansible-galaxy info geerlingguy.redis
Role: geerlingguy.redis
description: Redis for Linux
active: True
commit: 4f6fbdff6b566a596b2eaac168f88be820d4bbc5
commit_message: Ignore the tyranny of ansible-lint rule 106.
commit_url: https://api.github.com/repos/geerlingguy/ansible-role-redis/git/commits/4f6fbdff6b566a596b2eaac168f88be820d4bbc5
company: Midwestern Mac, LLC
created: 2014-03-06T16:48:12.451903Z
download_count: 374535
forks_count: 131
github_branch: master
github_repo: ansible-role-redis
github_user: geerlingguy
id: 468
imported: 2020-09-11T15:06:16.909297-04:00
is_valid: True
issue_tracker_url: https://github.com/geerlingguy/ansible-role-redis/issues
license: license (BSD, MIT)
min_ansible_version: 2.4
modified: 2020-09-11T19:06:16.916742Z
open_issues_count: 6
path: ('/root/.ansible/roles', '/usr/share/ansible/roles', '/etc/ansible/roles')
role_type: ANS
stargazers_count: 161
travis_status_url: https://travis-ci.org/geerlingguy/ansible-role-redis.svg?branch=master
以上命令显示了Ansible Galaxy提供的geerlingguy.redis角色的相关信息。
2、从Ansibel galaxy安装角色
1️⃣：ansible-galaxy install子命令从Ansible Galaxy下载角色，并将它安装到控制节点本地
2️⃣：默认情况下，角色安装到用户的roles_path下的第一个可写目录中。根据为Ansible设置的默认roles_path，角色通常将安装到用户的~/.ansible/roles目录
3️⃣：默认的roles_path可能会被用户当前Ansible配置文件或环境变量ANSIBLE_ROLES_PATH覆盖，这将影响ansible-galaxy的行为
4️⃣：用户可以通过使用-p DIRECTORY选项，指定具体的目录来安装角色
[root@localhost ~]# ls project/ playbook.yaml [root@localhost ~]# ansible-galaxy install robertdebock.httpd -p project/ //-p 指定安装目录 - downloading role 'httpd', owned by robertdebock - downloading role from https://github.com/robertdebock/ansible-role-httpd/archive/5.3.0.tar.gz - extracting robertdebock.httpd to /root/project/robertdebock.httpd - robertdebock.httpd (5.3.0) was installed successfully [root@localhost ~]# ls project/ playbook.yaml robertdebock.httpd
3、使用要求安装文件安装角色
1️⃣：可以使用ansible-galaxy，根据某一文本文件中的定义来安装一个角色列表
2️⃣：例如，如果用户的一个playbook需要安装特定的角色，需要在项目目录中创建一个roles/requirements.yml文件来指定所需的角色
3️⃣：src属性指定角色的来源，本例中为来自Ansible Galaxy的robertdebock.httpd角色
4️⃣：重要：
- 应当在requirements.yml文件中指定角色版本，特别是生产环境中的playbook
- 如果不指定版本，将会获取角色的最新版本。如果作者对角色做出了更改，并与用户的playbook不兼容，这可能会造成自动化失败或其他问题。
5️⃣：若要使用角色文件来安装角色，可使用-r REQUIREMENTS-FILE选项
[root@localhost project]# cat roles/requirements.yml --- - src: robertdebock.httpd [root@localhost project]# ansible-galaxy install -r roles/requirements.yml -p ./ - downloading role 'httpd', owned by robertdebock - downloading role from https://github.com/robertdebock/ansible-role-httpd/archive/5.3.0.tar.gz - extracting robertdebock.httpd to /root/project/robertdebock.httpd - robertdebock.httpd (5.3.0) was installed successfully [root@localhost project]# ls playbook.yaml robertdebock.httpd roles
6️⃣：用户可以使用ansible-galaxy来安装不在Ansible Galaxy中的角色。可以在私有的Git存储库或Web服务器上托管自有的专用或内部角色
- 实例：
[root@localhost project]# cat roles/requirements.yml --- - src: geerlingguy.redis - src: geerlingguy.redis version: "1.5.0" name: redis_prod - src: https://gitlab.com/guardianproject-ops/ansible-nginx-acme.git scm: git version: 56e00a54 name: nginx-acme - src: git@gitlab.com:guardianproject-ops/ansible-nginx-acme.git scm: git version: master name: nginx-acme-ssh - src: file:///opt/local/roles/myrole.tar name: myrole
src关键字指定Ansible Galaxy角色名称。如果角色没有托管在Ansible Galaxy中，则src关键字将指明角色的URL。
4、管理下载角色
1️⃣：ansible-galaxy命令也可管理本地的角色，如位于playbook项目的roles目录中的角色。ansible-galaxy list子命令列出本地找到的角色
[root@localhost ]# ansible-galaxy list # /usr/share/ansible/roles - linux-system-roles.kdump, (unknown version) - linux-system-roles.network, (unknown version) - linux-system-roles.postfix, (unknown version) - linux-system-roles.selinux, (unknown version) - linux-system-roles.storage, (unknown version) - linux-system-roles.timesync, (unknown version) - rhel-system-roles.kdump, (unknown version) - rhel-system-roles.network, (unknown version) - rhel-system-roles.postfix, (unknown version) - rhel-system-roles.selinux, (unknown version) - rhel-system-roles.storage, (unknown version) - rhel-system-roles.timesync, (unknown version) # /etc/ansible/roles - robertdebock.httpd, 5.3.0
2️⃣：可以使用ansible-galaxy remove子命令本地删除角色。
- 实例：删除robertdebock.httpd, 5.3.0
[root@localhost roles]# ansible-galaxy remove robertdebock.httpd [root@localhost ~]# ansible-galaxy list # /usr/share/ansible/roles - linux-system-roles.kdump, (unknown version) - linux-system-roles.network, (unknown version) - linux-system-roles.postfix, (unknown version) - linux-system-roles.selinux, (unknown version) - linux-system-roles.storage, (unknown version) - linux-system-roles.timesync, (unknown version) - rhel-system-roles.kdump, (unknown version) - rhel-system-roles.network, (unknown version) - rhel-system-roles.postfix, (unknown version) - rhel-system-roles.selinux, (unknown version) - rhel-system-roles.storage, (unknown version) - rhel-system-roles.timesync, (unknown version) # /etc/ansible/roles
3️⃣：在playbook中使用下载并安装的角色的方式与任何其他角色都一样
- 在roles部分中利用其下载的角色名称来加以引用。如果角色不在项目的roles目录中，则将检查roles_path来查看角色是否安装在了其中一个目录中，将使用第一个匹配项