ansible管理大项目之使用Ansible galaxy部署角色

简介

1. Ansible Galaxy （官网：https://galaxy.ansible.com）是一个Ansible内容公共资源库，这些内容由许许多多Ansible管理员和用户编写。

2. 它包含数千个Ansible角色，具有可搜索的数据库，可帮助Ansible用户确定或许有助于他们完成管理任务的角色

3. Ansible Galaxy含有面向新的Ansible用户和角色开发人员的文档和视频链接

获取Ansible galaxy帮助

1. 通过Ansible Galaxy网站主页上的Documenttaion标签，可以进入描述如何使用Ansible Galaxy的页面

2. 其中包含了介绍如何从Ansible Galaxy下载和使用角色的内容。该页面也提供关于如何开发角色并上传到Ansible Galaxy的说明。

浏览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

以上命令用来显示Ansible Galaxy提供的geerlingguy.redis角色的相关信息。

从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/7.0.0.tar.gz
- extracting robertdebock.httpd to /root/project/robertdebock.httpd
- robertdebock.httpd (7.0.0) was installed successfully
[root@localhost ~]# ls project/
playbook.yaml  

使用要求安装文件安装角色

可以使用ansible-galaxy，根据某一文本文件中的定义来安装一个角色列表

例如，如果用户的一个playbook需要安装特定的角色，需要在项目目录中创建一个roles/requirements.yml文件来指定所需的角色

src属性指定角色的来源，本例中为来自Ansible Galaxy的robertdebock.httpd角色

• 重要：

  应当在requirements.yml文件中指定角色版本，特别是生产环境中的playbook
  如果不指定版本，将会获取角色的最新版本。如果作者对角色做出了更改，并与用户的playbook不兼容，这可能会造成自动化失败或其他问题。

若要使用角色文件来安装角色，可使用-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

用户可以使用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: [e-mail]: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。

管理下载角色

ansible-galaxy命令也可管理本地的角色，如位于playbook项目的roles目录中的角色。ansible-galaxy list子命令列出本地找到的角色

[root@ansible ~]# 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
[WARNING]: - the configured path /root/.ansible/roles does not exist.

可以使用ansible-galaxy remove子命令本地删除角色。

ansible-galaxy remove + 角色名

命令	说明
init	初始化
remove	卸载
delete	删除、卸载
list	列出（可以查看安装过的名字和版本）
search	搜索
import	导入
setup	管理基层
info	查看详细信息
install	安装（可以从网站链接或文件内装）

在playbook中使用下载并安装的角色的方式与任何其他角色都一样

在roles部分中利用其下载的角色名称来加以引用。如果角色不在项目的roles目录中，则将检查roles_path来查看角色是否安装在了其中一个目录中，将使用第一个匹配项