Ansible ロール: update

Ansible ロールは、システムのアップデートを確認し、オプションでインストールします。また、パッケージを実際にアップグレードせずに、アップグレード可能なパッケージを表示するオプションもあります。

ベータ警告

このロールは現在ベータ版であり、プロダクション用途には適していません。リリース間で破壊的な変更が行われる可能性があるため、リリースノートを必ず確認してください。

要件

このロールは、ansible-core に含まれていない特定のコレクションに依存しています。

このロールの要件をインストールするには、以下の内容を持つ requirements.yml ファイルを作成してください。

---
collections:
  - name: community.general

その後、ansible-base/ansible-core 2.10 以降を使用している場合は、以下のコマンドを実行します。

ansible-galaxy install -r requirements.yml

まだ Ansible 2.9 を使用している場合は、代わりに以下のコマンドを実行します。

ansible-galaxy collection install -r requirements.yml

ロール変数

以下は、このロールの変数とそのデフォルト値で、[defaults/main.yml][link-defaults] に設定されています。必要に応じて、これらを変更してロールの動作をカスタマイズできます。

---
# update のデフォルトファイル

# オプション:
# - `check`: アップグレード可能なパッケージを表示するが、アップグレードはしない
# - `full`: アップグレード可能なパッケージを表示し、その後アップグレードする
# - `run`: 最初にリストを表示せずに全パッケージをアップデートする
mode: full

# apt アップグレードの種類を設定するオプション。利用可能なオプションは `dist`, `full`, `safe`, `true`。
# 詳細は [ansible.builtin.apt][1] モジュールのドキュメントを参照してください。
update_apt_upgrade_type: true

# zypper モジュールの状態キーを設定するオプション。
# 正常なアップグレードには `latest`、`zypper dup` の同等品を使用するには `dist-upgrade` を選択します。
# 詳細は [community.general.zypper][2] モジュールのドキュメントを参照してください。
update_zypper_state: latest

# zypper がベンダー変更を許可するかどうかを決定します。
update_zypper_allow_vendor_change: false

# 不要な依存関係を自動的に削除するかどうか。これは dnf や yum、apt のみです。
update_autoremove: false

[1]: https://docs.ansible.com/ansible/latest/collections/ansible/builtin/apt_module.html

[2]: https://docs.ansible.com/ansible/latest/collections/community/general/zypper_module.html

例 プレイブック

---
- name: Converge
  hosts: all
  become: true
  tasks:
    - name: "Include update"
      ansible.builtin.include_role:
        name: gotmax23.update

互換性

このロールは、最新の ansible-core バージョンと Ansible Galaxy のコレクションの最新バージョンでテストされています。これがこのロールが公式にサポートする唯一の Ansible バージョンです。他のバージョンについてはベストエフォートサポートを提供します。

このロールは以下のディストリビューションと互換性があります：

ライセンス

[MIT][link-license]

著者

Maxwell G (@gotmax23)