搜索

第 18 章 使用 Ansible 自动化配置任务

download PDF

Ansible 是一个自动化工具,用于配置系统、部署软件和执行滚动更新。Ansible 包含对 Red Hat Virtualization 的支持,Ansible 模块可用于自动执行安装后任务,如数据中心设置和配置、管理用户或虚拟机操作。

Ansible 提供了与 REST API 和 SDK 相比自动化 Red Hat Virtualization 配置的简单方法,并允许您与其他 Ansible 模块集成。有关 Red Hat Virtualization 可用的 Ansible 模块的更多信息,请参阅 Ansible 文档中的 Ovirt 模块

注意

Ansible Tower 是通过 Web 界面和 Ansible 的 REST API 访问的图形化启用了框架。如果您想要对 Ansible Tower 的支持,则必须具有 Ansible Tower 许可证,它不属于 Red Hat Virtualization 订阅。

Ansible 由 Red Hat Virtualization 提供。要安装 Ansible,请在 Manager 机器中运行以下命令:

# yum install ansible

有关使用 Ansible 的替代安装说明,请参阅 Ansible 文档

注意

要在运行 Ansible playbook 时永久提高 Manager 的详细级别,请在 /etc/ovirt-engine/engine.conf.d/ 中创建配置文件,并添加以下行:

ANSIBLE_PLAYBOOK_VERBOSE_LEVEL=4

运行 systemctl restart ovirt-engine 创建该文件后,您必须重启 Manager。

18.1. Ansible 角色

有多个 Ansible 角色可用于帮助配置和管理 Red Hat Virtualization 基础架构的各个部分。Ansible 角色提供了一种方法来模块化 Ansible 代码,可将大型 playbook 划分为可被其他用户共享的较小、可重复使用的文件。

可用于 Red Hat Virtualization 的 Ansible 角色由各种内部组件分类。如需有关 Ansible 角色的更多信息,请参阅 oVirt Ansible Roles 文档。有关使用 Ansible 角色安装的文档,请参阅 第 18.1.1 节 “安装 Ansible 角色”

18.1.1. 安装 Ansible 角色

您可以从 Red Hat Virtualization Manager 仓库为 Red Hat Virtualization 安装 Ansible 角色。使用以下命令在 Manager 机器上安装 Ansible 角色:

# yum install ovirt-ansible-roles

默认情况下,角色安装到 /usr/share/ansible/roles 中。ovirt-ansible-roles 软件包的结构如下:

  • /usr/share/ansible/roles - 存储角色。
  • /usr/share/doc/ovirt-ansible-roles/ - 存储示例、基本概述和 licence。
  • /usr/share/doc/ansible/roles/role_name - 存储特定于该角色的文档。

18.1.2. 使用 Ansible 角色配置 Red Hat Virtualization

以下流程指导您创建并运行使用 Ansible 角色配置 Red Hat Virtualization 的 playbook。本例使用 Ansible 连接到本地计算机上的 Manager 并创建一个新的数据中心。

先决条件

  • 确保 /etc/ansible/ansible.cfg 中的 roles_path 选项指向 Ansible 角色的位置(/usr/share/ansible/roles)。
  • 确保在运行 playbook 的机器上安装了 Python SDK。

使用 Ansible 角色配置 Red Hat Virtualization

  1. 在工作目录中创建用于存储 Red Hat Virtualization Manager 用户密码的文件:

    # cat passwords.yml
      ---
    engine_password: youruserpassword
  2. 加密用户密码。系统将要求您提供 Vault 密码。

    # ansible-vault encrypt passwords.yml
    New Vault password:
    Confirm New Vault password:
  3. 创建存储 Manager 详情的文件,如 URL、证书位置和用户。

    # cat engine_vars.yml
    ---
    engine_url: https://example.engine.redhat.com/ovirt-engine/api
    engine_user: admin@internal
    engine_cafile: /etc/pki/ovirt-engine/ca.pem
    注意

    如果您愿意,可以直接将这些变量添加到 playbook 中。

  4. 创建 playbook。要简化这一操作,您可以在 /usr/share/doc/ovirt-ansible-roles/examples 中复制和修改示例。

    # cat rhv_infra.yml
    ---
    - name: RHV infrastructure
      hosts: localhost
      connection: local
      gather_facts: false
    
      vars_files:
        # Contains variables to connect to the Manager
        - engine_vars.yml
        # Contains encrypted engine_password variable using ansible-vault
        - passwords.yml
    
      pre_tasks:
        - name: Login to RHV
          ovirt_auth:
            url: "{{ engine_url }}"
            username: "{{ engine_user }}"
            password: "{{ engine_password }}"
            ca_file: "{{ engine_cafile | default(omit) }}"
            insecure: "{{ engine_insecure | default(true) }}"
          tags:
            - always
    
      vars:
        data_center_name: mydatacenter
        data_center_description: mydatacenter
        data_center_local: false
        compatibility_version: 4.1
    
      roles:
        - ovirt-datacenters
    
      post_tasks:
        - name: Logout from RHV
          ovirt_auth:
            state: absent
            ovirt_auth: "{{ ovirt_auth }}"
          tags:
            - always
  5. 运行 playbook。

    # ansible-playbook --ask-vault-pass rhv_infra.yml

您已成功使用 ovirt-datacenters Ansible 角色创建名为 mydatacenter s 的数据中心。

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.