Ansibleで複数のAWSリージョンへ同じ構成を展開する｜region指定とインベントリ分割の設計

この記事のポイント

・インベントリはリージョン別ディレクトリ型が運用しやすい
・group_varsにaws_regionを定義し全モジュールで参照する設計が基本
・AMI IDはリージョン固有のためgroup_varsで別管理が必須
・実行は -i inventory/ap-northeast-1 のようにリージョンを明示指定する

inventory/
├── ap-northeast-1/           # 東京リージョン
│   ├── hosts
│   └── group_vars/
│       └── all.yml
├── us-east-1/                # バージニアリージョン
│   ├── hosts
│   └── group_vars/
│       └── all.yml
└── ap-southeast-1/           # シンガポールリージョン
    ├── hosts
    └── group_vars/
        └── all.yml

# inventory/hosts
[region_tokyo]
localhost

[region_virginia]
localhost

inventory/
└── group_vars/
    ├── region_tokyo.yml    # aws_region: ap-northeast-1
    └── region_virginia.yml # aws_region: us-east-1

# inventory/ap-northeast-1/group_vars/all.yml
aws_region: ap-northeast-1
ami_id: ami-0abc1234567890ef  # Amazon Linux 2023（東京）

# inventory/us-east-1/group_vars/all.yml
aws_region: us-east-1
ami_id: ami-0def456789012abc  # Amazon Linux 2023（バージニア）同じOSでもIDが異なる

# playbooks/site.yml
- name: Deploy infrastructure to AWS region
  hosts: localhost
  connection: local
  gather_facts: false

  tasks:
    - name: S3バケットを作成する
      amazon.aws.s3_bucket:
        name: "myapp-{{ aws_region }}-assets"
        region: "{{ aws_region }}"
        state: present

    - name: EC2インスタンスを起動する
      amazon.aws.ec2_instance:
        name: "webserver-{{ aws_region }}"
        region: "{{ aws_region }}"
        instance_type: t3.small
        image_id: "{{ ami_id }}"
        state: running

# shell/commandモジュールでawscliを使う場合のみ
  tasks:
    - name: Route53レコードをawscliで確認する
      shell: aws route53 list-hosted-zones --output json
      environment:
        AWS_DEFAULT_REGION: "{{ aws_region }}"
      register: route53_result

project/
├── inventory/
│   ├── ap-northeast-1/
│   │   ├── hosts              # 中身: localhost ansible_connection=local
│   │   └── group_vars/
│   │       └── all.yml        # リージョン固有変数
│   └── us-east-1/
│       ├── hosts
│       └── group_vars/
│           └── all.yml
├── playbooks/
│   └── site.yml               # 共通Playbook
└── ansible.cfg

# inventory/ap-northeast-1/hosts
[all]
localhost ansible_connection=local

# inventory/ap-northeast-1/group_vars/all.yml
aws_region: ap-northeast-1
ami_id: ami-0abc123456789ef0   # Amazon Linux 2023 ap-northeast-1
instance_type: t3.small
s3_bucket_prefix: myapp

# inventory/us-east-1/group_vars/all.yml
aws_region: us-east-1
ami_id: ami-0123456789abcdef0  # Amazon Linux 2023 us-east-1（IDが異なる）
instance_type: t3.small
s3_bucket_prefix: myapp

# playbooks/site.yml
---
- name: Deploy infrastructure to AWS
  hosts: localhost
  connection: local
  gather_facts: false

  tasks:
    - name: 対象リージョンを表示する
      debug:
        msg: "Deploying to region: {{ aws_region }}"

    - name: S3バケットを作成する
      amazon.aws.s3_bucket:
        name: "{{ s3_bucket_prefix }}-{{ aws_region }}-data"
        region: "{{ aws_region }}"
        versioning: true
        state: present

    - name: EC2インスタンスを起動する
      amazon.aws.ec2_instance:
        name: "webserver-{{ aws_region }}"
        region: "{{ aws_region }}"
        instance_type: "{{ instance_type }}"
        image_id: "{{ ami_id }}"
        state: running
        wait: true

# 東京リージョンのみに適用する
$ ansible-playbook -i inventory/ap-northeast-1 playbooks/site.yml

# バージニアリージョンのみに適用する
$ ansible-playbook -i inventory/us-east-1 playbooks/site.yml

# 両リージョンに連続適用する（シェルでループ）
$ for region in ap-northeast-1 us-east-1; do
    ansible-playbook -i inventory/ playbooks/site.yml
  done

# 実行結果（抜粋）
PLAY [Deploy infrastructure to AWS] **************************

TASK [対象リージョンを表示する] *****************************
ok: [localhost] => {
    "msg": "Deploying to region: ap-northeast-1"
}

TASK [S3バケットを作成する] **********************************
changed: [localhost]

TASK [EC2インスタンスを起動する] *****************************
changed: [localhost]

PLAY RECAP ***************************************************
localhost : ok=3  changed=2  unreachable=0  failed=0