README.md

自宅サーバーの構成管理用のAnsible

Envirionment

• Conda: 24.9.2
• Python: 3.13.0
• Ansible: 11.0.0, https://github.com/ansible/ansible
  • Ansible Core: 2.18.0

SSH Configの設定

• ~/.ssh/configに以下の設定を追加する

Include ~/.ssh/ssh_config.d/*.conf

• Ansible用のホストを./ssh_config.d/に設定し、以下のコマンドを実行する

$ task apply-ssh-config

Ansible Roleの雛形の作成

$ task create-ansible-role -- MY_ROLE

疎通確認

$ task ping-ansible-host

AnsibleのRoleやPlaybookの構文チェック

$ task lint-ansible

Ansible Playbookの実行

Roleの実行前に差分を確認

$ task check-ansible-diff -v TAG_NAME={TAG_NAME} # Tagを指定して実行
$ task check-ansible-diff -v HOST_NAME={HOST_NAME} # Hostを指定して実行

Roleの実行

$ task apply-ansible-playbook -v TAG_NAME={TAG_NAME} # Tagを指定して実行
$ task apply-ansible-playbook -v HOST_NAME={HOST_NAME} # Hostを指定して実行

Ansible Factsを全て表示するタスク

- name: Print all available facts
  ansible.builtin.debug:
    var: ansible_facts

便利コマンド

• リモートに存在しないブランチとマージ済みのブランチを削除する

$ task clean-branch

その他のドキュメント

• Ansibleのコマンド例
• Install Conda
• Install uv

Ref

• https://docs.ansible.com/ansible/latest/collections/ansible/builtin/apt_module.html
• https://docs.ansible.com/ansible/devel/command_guide/index.html