Ansible ロール: AWS EFS

Amazon EFS ファイルシステムを EC2 インスタンスにマウントします。

Galaxy リンク

https://galaxy.ansible.com/thiagoalmeidasa/aws_efs/

要件

Amazon AWS アカウント、EFS ファイルシステム、Ubuntu または RedHat を実行している EC2 仮想サーバー。

Ansible の要件

Ansible バージョン

必要な最低 Ansible バージョンは 2.0 です。

Ansible ロールの依存関係

なし。

インストール

Ansible Galaxy を使ってインストール

ansible-galaxy install thiagoalmeidasa.aws_efs

基本的な使い方は次のとおりです：

- hosts: all
  roles:
  - role: thiagoalmeidasa.aws_efs
    vars:
      aws_efs_paths:
      - path: "/path"
        owner: "root"
        group: "root"
        mode: "0644"
        region: "eu-west-1"
        filesystem_id: "fs-someid"

すべての変数を明示的に定義した例：

- hosts: all
  roles:
  - role: thiagoalmeidasa.aws_efs
    vars:
      aws_efs_paths:
      - path: "/path"
        owner: "root"
        group: "root"
        mode: "0644"
        region: "eu-west-1"
        filesystem_id: "fs-someid"
        state: "mounted",
        opts: "nfsvers=4.1,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2"

Git を使ってインストール

グローバルインストールを希望しない場合は、roles_path にクローンします。

git clone [email protected]:thiagoalmeidasa/ansible-role-aws-efs.git /path/to/roles_path

よく、特定の playbook_dir リポジトリにサブモジュールとして追加します。

git submodule add [email protected]:thiagoalmeidasa/ansible-role-aws-efs.git <playbook_dir>/roles/aws_efs

このようにロールを含めます：

- hosts: all
  roles:
  - role: aws_efs

このロールは Ansible Galaxy によって管理されていないため、GitHub のユーザーアカウントを指定する必要はありません。

ロールの変数

デフォルト変数

ロールのデフォルト変数は defaults/main.yml にあります。

# マウントマッピング
#
# 注：
# - ファイルシステムは、それを使用する EC2 インスタンスと同じセキュリティグループ内でなければなりません
# - Amazon EFS サービスの地域ごとの利用可能性の詳細は、以下を確認してください: https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/
#
# オプション：
# - path:           EC2 インスタンス内のマウント対象フォルダのローカルパス
# - owner:          フォルダのオーナー（デフォルト値 "root"）
# - group:          フォルダのグループ（デフォルト値 "root"）
# - mode:           フォルダの権限（デフォルト値 "0644"）
# - region:         ファイルシステムが存在する地域
# - filesystem_id:  ファイルシステム ID
# - state:          Ansible マウントモジュールのオプション（デフォルト値 "mounted"） http://docs.ansible.com/ansible/latest/mount_module.html#options
# - opts:           マウントオプション（fstab(5) や Solaris の vfstab(4) を参照）。デフォルトは AWS の指示に従う "nfsvers=4.1,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2"）

# マウントパス
aws_efs_paths:
  - path: /opt/efs
    owner: ""
    group: ""
    mode: ""
    region: ""
    filesystem_id: ""
    state: ""
    opts: ""

必須変数

aws_efs_paths:
- path: ""
  owner: ""
  group: ""
  mode: ""
  region: ""
  filesystem_id: ""

コンテキスト変数

なし。

ライセンス

ライセンス（BSD, MIT）。

著者情報

thiagoalmeidasa thiagoalmeidasa@gmail.com。