ansible-synology-dsm

DSMを実行しているSynology NASを設定するためのAnsibleロール

概要

ansible-synology-dsmは、DSMを実行しているSynology NASを設定するためのAnsibleロールです。さまざまなサービスや設定を管理するためにSynology APIを利用しています。

要件

• Ansible 2.6以上
• DSMを搭載したSynology NASへのアクセス

インストール

GitHubリポジトリから直接インストール

1. 要件ファイルを作成: Ansibleプロジェクトディレクトリにrequirements.ymlという名前のファイルを作成し、以下の内容を記入します：

   - src: https://github.com/agaffney/ansible-synology-dsm
     name: ansible-synology-dsm
   

2. ansible-galaxyを使用してロールをインストール: GitHubリポジトリから直接ロールをインストールするには、以下のコマンドを実行します：

   ansible-galaxy install -r requirements.yml
   

3. プレイブックでロールを参照: インストール後、プレイブックでロールを参照します：

   - hosts: synology_nas
     roles:
       - ansible-synology-dsm
   

   synology_nasをAnsibleインベントリ内の適切なホストまたはグループに置き換えます。

この方法では、Ansible Galaxyに利用できなくてもロールを簡単にAnsibleのワークフローに組み込むことができます。

使用方法

ログイン

NASとのセッションを確立し、次のAPIリクエストを可能にします。

- include_tasks: login.yml

ファイルサービスの有効化/無効化 (NFS, SMB, AFP)

- name: ファイルサービスの設定
  hosts: synology_nas
  roles:
    - ansible-synology-dsm
  vars:
    synology_dsm_nfs_enable: true  # NFSを有効化
    synology_dsm_smb_enable: true  # SMBを有効化
    synology_dsm_afp_enable: false # AFPを無効化

SSH/Telnetサービスの有効化/無効化

- name: ターミナルサービスの設定
  hosts: synology_nas
  roles:
    - ansible-synology-dsm
  vars:
    synology_dsm_ssh_enable: true     # SSHを有効化
    synology_dsm_ssh_port: 22         # SSHポートを設定
    synology_dsm_telnet_enable: false # Telnetを無効化

ユーザーサービスの管理

- name: ユーザーサービスの設定
  hosts: synology_nas
  roles:
    - ansible-synology-dsm
  vars:
    synology_dsm_user_home_service_enable: true                # ユーザーホームサービスを有効化
    synology_dsm_user_home_location: "/volume1/homes"          # ホームディレクトリの場所を設定
    synology_dsm_user_home_enable_recycle_bin: false           # ユーザーホームのごみ箱を無効化

パッケージソースの追加

- name: パッケージソースの追加
  hosts: synology_nas
  roles:
    - ansible-synology-dsm
  vars:
    synology_dsm_package_sources:
      - name: "例のソース"
        feed: "http://example.com/package/source"

貢献

貢献を歓迎します。改善点についてはプルリクエストを提出してください。