基础设施即代码 / 系统课时

管理软件包与仓库

管理软件包与仓库

这节课解决两类常见标准化任务:让不同 Linux 发行版安装同一组能力,并把软件仓库配置收敛为可重复执行的状态。完成后,你能用通用模块覆盖常规包操作,并在仓库、缓存和包名存在平台差异时安全分支。

学习目标

  • 使用 ansible.builtin.package 统一安装、升级和移除软件包
  • 根据 ansible_facts.os_family 处理包名与仓库模块差异
  • 用重复执行和检查模式验证软件包任务的幂等性

先区分通用操作与平台差异

ansible.builtin.package 会调用目标主机可用的包管理后端,适合表达“某包应存在或不存在”这类共同意图。它不能消除发行版之间的真实差异:同一软件可能包名不同,APT 与 RPM 仓库的配置格式也不同。

因此,常用做法是把业务意图统一,把平台差异放进变量或条件分支。安装普通软件优先使用 package;需要刷新 APT 缓存、设置 DNF 特有参数或维护仓库时,再使用发行版专用模块。

需求 推荐模块 说明
安装或移除常规软件包 ansible.builtin.package 尽量保持跨发行版任务一致
管理 Debian/Ubuntu APT 仓库 ansible.builtin.apt_repository 使用 APT 仓库语法
管理 RPM 系仓库 ansible.builtin.yum_repository 管理 YUM/DNF 使用的仓库定义

用变量收敛包名差异

下面的 Playbook 假设 Inventory 中已有 linux_hosts 组。它先确认当前操作系统族在映射表中,再使用统一的 package 任务安装对应包名。包名集中在变量中,比在多个任务里重复写 when 更容易维护。

yaml
---
- name: Standardize base packages
  hosts: linux_hosts
  become: true
  gather_facts: true

  vars:
    package_map:
      Debian:
        - curl
        - vim
        - chrony
      RedHat:
        - curl
        - vim-enhanced
        - chrony

  tasks:
    - name: Ensure the OS family is supported
      ansible.builtin.assert:
        that:
          - ansible_facts.os_family in package_map
        fail_msg: "Unsupported OS family: {{ ansible_facts.os_family }}"

    - name: Install baseline packages
      ansible.builtin.package:
        name: "{{ package_map[ansible_facts.os_family] }}"
        state: present

state: present 表示只要求软件已安装,不会为了追逐最新版本而在每次执行时升级。若目标是移除软件,把状态改为 absent;若确实要跟随仓库中的最新候选版本,可以使用 latest,但这意味着仓库一旦出现新版,下一次执行可能产生变更。

执行主示例:

bash
ansible-playbook -i inventory.ini packages.yml

预期输出:

text
PLAY RECAP *********************************************************************
<HOST> : ok=<VALUE> changed=<VALUE> unreachable=0 failed=0 skipped=<VALUE>

<HOST> 和计数会随主机数量与初始状态变化。第一次执行可能安装软件而出现 changed>0;目标状态已经满足后再次执行,通常应看到 changed=0。

仓库配置按发行版显式分支

仓库不是适合强行统一的对象。APT 使用源列表语法,RPM 系使用仓库段配置。下面是片段示例,依赖你在 Inventory 或 group_vars 中提供内部仓库地址、签名密钥路径等变量。

yaml
- name: Configure APT repository
  ansible.builtin.apt_repository:
    repo: "deb [signed-by={{ internal_repo_keyring }}] {{ internal_apt_repo_url }} {{ ansible_distribution_release }} main"
    filename: internal
    state: present
    update_cache: true
  when: ansible_facts.os_family == "Debian"

- name: Configure RPM repository
  ansible.builtin.yum_repository:
    name: internal
    description: Internal package repository
    baseurl: "{{ internal_rpm_repo_url }}/$releasever/$basearch"
    enabled: true
    gpgcheck: true
    gpgkey: "{{ internal_rpm_gpgkey_url }}"
    state: present
  when: ansible_facts.os_family == "RedHat"

这两个任务的目标相同,都是“内部仓库应存在且启用”,但把各自原生参数保留下来。生产环境还应把仓库签名验证作为默认要求,不要为了绕过密钥部署问题而长期关闭 GPG 校验。

处理升级、缓存与失败边界

批量升级要先明确策略。latest 适合“始终跟随仓库最新版本”的场景;若变更需要审批、灰度和回滚,更稳妥的做法是固定明确版本,并通过变量升级版本号。版本字符串格式由具体包管理器决定,不能假设 Debian 与 RPM 系完全一致。

仓库任务常见失败点包括 DNS 或网络不可达、签名密钥缺失、仓库元数据损坏以及发行版代号配置错误。定位时先确认失败发生在“仓库配置”“缓存刷新”还是“包安装”,再检查对应平台模块的返回信息,不要直接改成 shell 执行 apt 或 dnf 来掩盖问题。

标准化包管理的关键不是消灭发行版差异,而是把差异限制在清晰的变量和条件边界内,让上层 Playbook 始终表达同一个可审计的目标状态。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

管理软件包与仓库

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通