Ansible_使用Ansible galaxy部署角色

一、介绍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来查看角色是否安装在了其中一个目录中，将使用第一个匹配项