ansibleguy.sw_ansible_webui

<a href="https://github.com/ansibleguy/webui">
  <img src="https://raw.githubusercontent.com/ansibleguy/webui/latest/src/ansibleguy-webui/aw/static/img/logo.svg" alt="AnsibleGuy-WebUIロゴ" width="300"/>
</a>

# Ansibleロール - Ansible-WebUI

LinuxサーバーでAnsibleを使用するための[基本的なWebUI](https://github.com/ansibleguy/webui)を提供するロールです。

<a href='https://ko-fi.com/ansible0guy' target='_blank'><img height='35' style='border:0px;height:46px;' src='https://az743702.vo.msecnd.net/cdn/kofi3.png?v=0' border='0' alt='コーヒーを買ってください' />

**免責事項**: このWebUIは**非公式のコミュニティプロジェクト**です！ 公式の[Ansible](https://ansible.com/)製品と混同しないでください！

[![Moleculeテストステータス](https://badges.ansibleguy.net/sw_ansible_webui.molecule.svg)](https://github.com/ansibleguy/_meta_cicd/blob/latest/templates/usr/local/bin/cicd/molecule.sh.j2)
[![YamlLintテストステータス](https://badges.ansibleguy.net/sw_ansible_webui.yamllint.svg)](https://github.com/ansibleguy/_meta_cicd/blob/latest/templates/usr/local/bin/cicd/yamllint.sh.j2)
[![PyLintテストステータス](https://badges.ansibleguy.net/sw_ansible_webui.pylint.svg)](https://github.com/ansibleguy/_meta_cicd/blob/latest/templates/usr/local/bin/cicd/pylint.sh.j2)
[![Ansible-Lintテストステータス](https://badges.ansibleguy.net/sw_ansible_webui.ansiblelint.svg)](https://github.com/ansibleguy/_meta_cicd/blob/latest/templates/usr/local/bin/cicd/ansiblelint.sh.j2)
[![Ansible Galaxy](https://badges.ansibleguy.net/galaxy.badge.svg)](https://galaxy.ansible.com/ui/standalone/roles/ansibleguy/sw_ansible_webui)

Moleculeログ: [短いログ](https://badges.ansibleguy.net/log/molecule_sw_ansible_webui_test_short.log), [フルログ](https://badges.ansibleguy.net/log/molecule_sw_ansible_webui_test.log)

**テスト済み:**
* Debian 12

## インストール

```bash
# 最新版
ansible-galaxy role install git+https://github.com/ansibleguy/sw_ansible_webui

# Galaxyからインストール
ansible-galaxy install ansibleguy.sw_ansible_webui

# またはカスタムロールパスにインストール
ansible-galaxy install ansibleguy.sw_ansible_webui --roles-path ./roles

# 依存関係をインストール
ansible-galaxy install -r requirements.yml

使い方

設定

必要に応じて設定を定義します：

最小限の設定：

ansible_webui:
  config:
    AW_HOSTNAMES: 'ansible.template.ansibleguy.net'

オプション：

ansible_webui:
  manage:
    webserver: true  # ローカルのnginxを最小限の証明書でインストールおよび設定
    backup: true  # データベースが管理されている場合、毎日のローカルデータベースバックアップサービスをインストール
    user: true  # サービスユーザー 'ansible-webui' を作成
    ansible_cfg: true  # /home/ansible-webui/ansible.cfg をプロビジョニング

  requirements:  # 実行環境の必要条件
    pip: ['httpx']  # すべてのpython3モジュール
    collections: ['community.general']  # すべてのansibleコレクション（persistent_requirements=trueの場合）
    roles: []  # すべてのansibleロール（persistent_requirements=trueの場合）

  config:  # オプションについては次を参照: https://webui.ansibleguy.net/en/latest/usage/4_config.html#settings
    AW_HOSTNAMES: 'ansible.template.ansibleguy.net'
    # AW_SECRET: '...'  # 最小30文字; 提供されていない場合はランダムに使用されます

  ansible_config:  # /home/ansible-webui/ansible.cfg => manage.ansible_cfg=trueの場合; 参照: https://docs.ansible.com/ansible/latest/reference_appendices/config.html
    defaults:  # セクション
      remote_port: 48322
      vault_id_match: 'webui'
    diff:
      context: 2

  nginx:
    ...   # ウェブサーバー設定を構成 => 参照: https://github.com/ansibleguy/infra_nginx

パスワードを暗号化するために「ansible-vault」を使用することをお勧めします：

ansible-vault encrypt_string

実行

プレイブックを実行します：

ansible-playbook -K -D -i inventory/hosts.yml playbook.yml

いくつかの便利なタグも利用可能です：

• config
• webserver

エラーをデバッグするために、実行時に「debug」変数を設定できます：

ansible-playbook -K -D -i inventory/hosts.yml playbook.yml -e debug=yes

機能

• パッケージのインストール

  • Python3、Python3-PIP、Python3-Virtualenv、Git、Git-LFS
  • Python3モジュール依存関係を持つAnsibleGuy-WebUI

• 設定

  • 使用される仮想環境 (/home/ansible-webui/venv)

  • デフォルト設定:

    • 180日より古いログをクリーンアップ
    • バックアップの保持期間30日

  • デフォルトオプション:

    • 一般的なPython3モジュールのインストール ('jmespath', 'netaddr', 'passlib', 'pywinrm', 'requests', 'cryptography')
    • 毎日のローカルバックアップ
    • サービス起動時のアプリと要件の自動アップグレード
    • Nginxプロキシ
    • サービスユーザーの作成

情報

• 注意: このロールは現在、Debianベースのシステムのみをサポートしています。

• 注意: ロールのほとんどの機能は、選択によって有効または無効にできます。

  利用可能なすべてのオプションは、メインのデフォルトファイルにあるデフォルト設定を参照してください！

• 警告: 提供されたすべての設定/変数が有効性を確認されるわけではありません。 不適切な設定はロールを破損する可能性があります！

```