本教程适用于以下操作系统版本

  • Ubuntu 22.04(Jammy Jellyfish)
  • Ubuntu 20.04(Focal Fossa)
  • Ubuntu 18.04(Bionic Beaver)

本页内容

  • 先决条件
  • 第 1 步 - 安装 Ansible
  • 第 2 步 - 设置 Inventory 文件 将服务器组织为组和子组
  • 第 3 步 - 设置 SSH 密钥 在已有公钥的节点上设置 SSH 密钥
  • 第 4 步 - 测试连接
  • 第 5 步 - 运行一些基本命令 检查磁盘使用情况 针对单个主机和组 更新所有服务器
  • 第 6 步 - Playbook 简介
  • 结论
  • 将服务器组织为组和子组
  • 在已有公钥的节点上设置 SSH 密钥
  • 检查磁盘使用情况
  • 针对单个主机和组
  • 更新所有服务器

Ansible 是一款非常流行的配置管理工具,旨在简化控制大量服务器的流程。它可以通过单条命令或单个文件自动完成新服务器的设置和应用程序的安装。你可以从单个节点控制任意数量的服务器,并在这些服务器上同时运行进程。Ansible 不需要在服务器节点上安装任何特殊软件,即可通过 SSH 对它们进行控制。

在本指南中,我们将学习如何在 Ubuntu 22.04 服务器上安装和配置 Ansible。

先决条件

  • 两台或更多运行 Ubuntu 22.04 且已安装 OpenSSH 服务器的服务器系统。
  • 服务器和节点均可通过公网 IP 地址访问。
  • 在 Ansible 服务器上设置一个具有 sudo 权限的非 root 用户,并在 Ansible 客户端上设置一个带密码的 root 用户。

第 1 步 - 安装 Ansible

我们将使用 Ansible 的官方仓库来安装其最新版本。将 Ansible 的官方仓库添加到服务器。

$ sudo add-apt-repository ppa:ansible/ansible

幸运的是,Ubuntu 自带 Ansible 2.9,这正是我们要安装的版本。运行以下命令来安装 Ansible。

$ sudo apt install ansible -y

运行以下命令来测试你的安装。

$ ansible --version
ansible [core 2.13.3rc1]
  config file = /etc/ansible/ansible.cfg
  configured module search path = ['/home/navjot/.ansible/plugins/modules', '/usr/share/ansible/plugins/modules']
  ansible python module location = /usr/lib/python3/dist-packages/ansible
  ansible collection location = /home/navjot/.ansible/collections:/usr/share/ansible/collections
  executable location = /usr/bin/ansible
  python version = 3.10.4 (main, Jun 29 2022, 12:14:53) [GCC 11.2.0]
  jinja version = 3.0.3
  libyaml = True

安装并激活 python3-argcomplete 软件包,以设置 Ansible 的 bash 补全支持。

$ sudo apt install python3-argcomplete
$ sudo activate-global-python-argcomplete3

现在你可以按 Tab 键获取 bash shell 的选项列表。

第 2 步 - 设置 Inventory 文件

为了能够连接到多台主机,你需要一个记录节点详细信息的文件。这个文件称为 Inventory 文件。

根据你要控制的服务器数量,Ansible 的 Inventory 文件还允许你将它们按组和子组进行组织。你还可以设置适用于选定主机或组的自定义变量,这些变量可在传递指令时进一步使用。

Ansible 自带一个默认的 Inventory 文件,位于 /etc/ansible/hosts。用 Nano 编辑器打开它。

$ sudo nano /etc/ansible/hosts

在文件底部粘贴以下代码。

[servers]
server1 ansible_host=203.0.113.111
server2 ansible_host=203.0.113.112
server3 ansible_host=203.0.113.113

[all:vars]
ansible_python_interpreter=/usr/bin/python3

servers 部分定义了你要连接的节点列表。你可以创建任意数量的组,将服务器组织到多个组中。

all:vars 组为 inventory 中的所有主机设置 ansible_python_interpreter 参数。它确保 Ansible 使用 Python 3 可执行文件,而不是在近期 Ubuntu 版本中已被移除的 Python 2。

完成后,按 Ctrl + X 保存文件,并在提示确认更改时输入 Y。

注意:你也可以在你选择的任何位置创建 Inventory 文件,然后在运行 Ansible 命令时使用 -i 参数传入该文件。

你可以通过以下命令查看 inventory 列表。

$ ansible-inventory --list -y
all:
  children:
    servers:
      hosts:
        server1:
          ansible_host: 203.0.113.111
          ansible_python_interpreter: /usr/bin/python3
        server2:
          ansible_host: 203.0.113.112
          ansible_python_interpreter: /usr/bin/python3
        server3:
          ansible_host: 203.0.113.113
          ansible_python_interpreter: /usr/bin/python3
    ungrouped: {}

将服务器组织为组和子组

如果你有很多服务器,且其中一些服务器承担特定功能,这是一个很有用的技巧。例如,你可以使用此方法将 Web 服务器和数据库服务器分别分组。你甚至可以让一台主机属于多个组。为此,你的 inventory 文件应类似于以下内容。

[webservers]
203.0.113.111
203.0.113.112

[dbservers]
203.0.113.113
server_hostname

[development]
203.0.113.111
203.0.113.113

[production]
203.0.113.112
server_hostname

第 3 步 - 设置 SSH 密钥

为了让 Ansible 能够连接到服务器,你必须在 Ansible 服务器与 inventory 文件中指定的主机之间配置 SSH 密钥。仅当 Ansible 客户端未启用公钥,且启用了带密码的 root 账户时,此方法才有效。

使用以下步骤为 Ansible 及其节点创建并设置 SSH 密钥。

为 Ansible 创建密钥。

$ ssh-keygen -t rsa -b 4096 -C "Ansible key"

将公钥复制到远程服务器上的账户中。为此,我们将使用 ssh-copy-id 命令。

$ ssh-copy-id -i $HOME/.ssh/id_rsa.pub 
[email protected]

$ ssh-copy-id -i $HOME/.ssh/id_rsa.pub 
[email protected]

$ ssh-copy-id -i $HOME/.ssh/id_rsa.pub 
[email protected]

就这样。现在 Ansible 应该能够与你的服务器通信了。

在已有公钥的节点上设置 SSH 密钥

如果客户端已经启用了公钥,那么你需要执行一些额外的步骤。为此,你需要在每个节点服务器上创建一个仅 Ansible 可访问的新用户。该用户将拥有无需密码即可使用的 sudo 权限,并且只能从你的 Ansible 服务器访问。

要创建一个 ansible 用户,运行以下命令。

$ sudo adduser ansible

选择一个强密码,并将其余所有字段留空。

现在,通过以下命令为该用户配置免密码 sudo 访问。

$ echo "ansible ALL=(ALL) NOPASSWD:ALL" | sudo tee /etc/sudoers.d/ansible

现在,新用户已添加并配置完成,你可以使用以下命令将 SSH 密钥从 Ansible 服务器复制到节点服务器。

$ ssh-copy-id 
[email protected]

系统将提示你输入 ansible 用户的密码。输入后,SSH 密钥即会被复制。

接下来,在节点服务器上禁用 ansible 用户的基于密码的登录。

$ sudo usermod -L ansible

现在,你的节点服务器只能从 Ansible 服务器访问,因为只有该服务器拥有对应的公钥;而且由于密码登录已被禁用,你也无法直接在节点服务器上以 sudo 权限使用该用户。

你需要对每个节点服务器重复这些步骤。此外,在本教程中用 ansible 用户替换 root 用户。

第 4 步 - 测试连接

设置好 inventory 文件和 SSH 密钥后,我们应检查 Ansible 是否能够连接到服务器。

输入以下命令来检查连接。此命令将测试与 inventory 文件中所有服务器的连接。

$ ansible all -m ping -u root

此命令使用 Ansible 的 ping 模块在所有服务器上运行连通性测试。你应该会得到类似下面的输出。

server1 | SUCCESS => {
    "changed": false,
    "ping": "pong"
}
server2 | SUCCESS => {
    "changed": false,
    "ping": "pong"
}
server3 | SUCCESS => {
    "changed": false,
    "ping": "pong"
}

如果这是你第一次使用 Ansible,系统将要求你确认所有服务器的真实性。出现提示时,输入 yes 并按 ENTER 确认。

第 5 步 - 运行一些基本命令

让我们使用 Ansible 在服务器上运行一些基本命令。要在服务器上运行任意命令,需使用以下格式。

$ ansible all -a "command" -u <username>

检查磁盘使用情况

首先,让我们检查所有服务器上的磁盘使用情况。

$ ansible all -a "df -h" -u root
server1 | CHANGED | rc=0 >>
Filesystem      Size  Used Avail Use% Mounted on
tmpfs           198M  972K  197M   1% /run
/dev/sda2        50G  3.9G   44G   9% /
tmpfs           989M     0  989M   0% /dev/shm
tmpfs           5.0M     0  5.0M   0% /run/lock
tmpfs           198M  4.0K  198M   1% /run/user/1000

server2 | CHANGED | rc=0 >>
Filesystem      Size  Used Avail Use% Mounted on
tmpfs           198M  922K  197M   1% /run
/dev/sda2        50G  4.9G   43G  10% /
tmpfs           989M     0  989M   0% /dev/shm
tmpfs           5.0M     0  5.0M   0% /run/lock
tmpfs           198M  4.0K  198M   1% /run/user/1000

针对单个主机和组

到目前为止,我们都是在所有远程服务器上同时运行命令。但情况并非总是如此。若只在一台服务器上运行命令,你应使用以下格式。

$ ansible server1 -a "uptime" -u root
server1 | CHANGED | rc=0 >>
 21:38:26 up 11 min,  2 users,  load average: 0.00, 0.20, 0.19

上述命令检查 inventory 组中 server1 的运行时间。

你也可以使用以下格式针对多台服务器。

$ ansible server1:server2 -m ping -u root

你也可以直接针对 inventory 文件中的组或子组。

$ ansible groupname -m ping -u <username>

更新所有服务器

在本教程中,我们假设所有远程服务器都运行 Debian 或 Ubuntu 操作系统。

运行以下命令更新所有服务器上的软件。

$ ansible all -m apt -a "update_cache=yes upgrade=yes" -u root

-m 参数定义 Ansible 要运行的模块。-a 参数指关联模块的参数或命令。这里我们使用 Ansible 的 apt 模块来更新服务器,就像在上一个示例中使用 ping 模块一样。update_cache 会更新服务器上的 APT 缓存,而 upgrade=yes 则告诉 Ansible 运行 apt upgrade 命令。

如果你使用上文所述的 ansible 用户,则需要修改 ansible 命令,使其以提升的 sudo 权限运行。

$ ansible server2 -m apt -a "update_cache=yes upgrade=yes" -K -b -u ansible

这里,-K 要求输入权限提升密码。-b 以 become 方式运行 ansible 操作,使你能够切换为另一个用户。两者结合使 ansible 能够以提升的 sudo 权限运行。对于所有需要 sudo 权限的命令,你都需要使用这种方式。

有时,其中某些更新命令可能需要重启,因此运行以下命令重启所有服务器。

$ ansible all -a "reboot" -u root

这些只是你可以使用 Ansible 运行的一些基本命令。

第 6 步 - Playbook 简介

上述命令允许你运行一次性任务,但如果你想设置多台服务器,或在多台服务器上运行相同的命令序列,则需要设置 playbook。Playbook 是用 YAML 编写的文件,包含用于自动执行一系列任务以设置应用程序和服务的指令。

现在我们将创建一个 playbook,用于安装 Nginx 并在 Ansible 节点上设置一个 HTML 页面。在你的主目录中为 Ansible 创建一个目录。

$ mkdir ~/ansible

创建并打开 playbook 文件进行编辑。

$ cd ~/ansible
$ nano testplaybook.yml

Playbook 使用 YAML 格式定义一个或多个 play。play 是一组有序的任务,通过编排来自动完成某个流程。这些 play 以 YAML 列表的形式定义。

定义 play 的第一步是使用 hosts: all 指令确定目标主机。become 指令用于表明后续任务必须由超级用户执行。

我们将定义三个任务:一个用于添加用户,一个用于升级所有软件包,最后一个用于安装 Nginx 服务器。playbook 的 vars 部分用于定义自定义变量。我们定义两个变量,一个用于需要添加的用户,另一个用于定义需要安装的软件包的状态。要使用变量,需要将变量名放在双花括号之间。

ansible.builtin.user 模块用于添加一个具有 sudo 权限的新用户。为了添加该用户,我们使用 name、password 和 group 变量。group 变量设置为 sudo,以授予该用户超级用户权限。你不能在 playbook 文件中放置明文密码,因此我们将添加一个 SHA 哈希后的密文。为此我们将使用 mkpasswd 工具。要安装它,运行以下命令安装 whois 软件包。

$ sudo apt install whois

生成哈希密码。系统会要求你输入常规密码,并为你生成对应的哈希字符串。记下该哈希密钥,以便用于 playbook 文件。

$ mkpasswd --method=sha-512
Password:
$6$dGbprm2oVqClDDDh$Epk6r5eXYkYBaQpQpP.H7VCdz0g9Aj0aO8hjy/WXq4WmfQ7GvQP2/cl/cNhd7.LRFuCKix9uCF2t8X5/Pv0Lk1

update_cache 指令用于更新系统的仓库列表,就像 apt update 命令一样;upgrade: dist 指令告诉 Ansible 执行系统升级。第三个任务不言自明,即安装最新版本的 Nginx 服务器。

根据我们讨论的信息,将以下代码粘贴到文件中。将你得到的哈希密钥粘贴为 password 变量的值。

---
- name: Test playbook
  hosts: all
  become: true
  vars:
      state: latest
      user: navjot
  tasks:
  - name: Add the user {{ user }}
    ansible.builtin.user:
      name: "{{ user }}"
      password: '$6$dGbprm2oVqClDDDh$Epk6r5eXYkYBaQpQpP.H7VCdz0g9Aj0aO8hjy/WXq4WmfQ7GvQP2/cl/cNhd7.LRFuCKix9uCF2t8X5/Pv0Lk1'
      group: sudo
  - name: Upgrade all apt packages
    apt:
      update_cache: yes
      upgrade: dist
  - name: Install the {{ state }} of package "nginx"
    apt:
      name: "nginx"
      state: "{{ state }}"

按 Ctrl + X 保存文件,并在提示确认更改时输入 Y。

要执行该 playbook,运行以下命令。--ask-become-pass 标志将要求你输入 root 密码以执行提升权限的操作。

$ ansible-playbook testplaybook.yml --ask-become-pass

你将得到以下输出。

BECOME password:

PLAY [Test playbook] ***************************************************************************************************

TASK [Gathering Facts] *************************************************************************************************
ok: [server1]
ok: [server2]
ok: [server3]

TASK [Add the user casablanca] *****************************************************************************************
changed: [server3]
changed: [server2]
changed: [server1]

TASK [Upgrade all apt packages] ****************************************************************************************
changed: [server1]
changed: [server2]
changed: [server3]

TASK [Install the latest of package "nginx"] ***************************************************************************
changed: [server3]
changed: [server2]
changed: [server1]

PLAY RECAP *************************************************************************************************************
server1                    : ok=4    changed=3    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
server2                    : ok=4    changed=3    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0
server3                    : ok=4    changed=3    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

这确认你的 playbook 已成功运行。

如果你使用自定义的 inventory 文件,需要在命令中包含该文件的位置,如下所示。

$ ansible-playbook -i /etc/ansible/custominventory testplaybook.yml --ask-become-pass 

结论

关于在 Ubuntu 22.04 服务器上安装和配置 Ansible 的教程到此结束。如果你有任何问题,请在下方评论中提出。