AnsibleでEC2インスタンスを自動作成・管理するPlaybook設計入門｜amazon.awsコレクションとec2_instanceモジュールの使い方

この記事のポイント

・amazon.aws.ec2_instanceモジュール1つでEC2を冪等に作成・管理できる
・IAM認証は環境変数またはIAMロールで設定し、Playbookに認証情報を書かない
・group_varsでdev・prod環境を分離するとPlaybookを使いまわせる
・add_hostでプロビジョニング直後から設定Playbookを続けて流せる

# boto3・botocoreをインストールする
pip install boto3 botocore

# amazon.awsコレクションをインストールする（バージョン8.x系）
ansible-galaxy collection install amazon.aws

# インストール確認
ansible-galaxy collection list | grep amazon.aws

# 環境変数で認証する場合（.envファイルなどで管理する）
export AWS_ACCESS_KEY_ID=AKIAIOSFODNN7EXAMPLE
export AWS_SECRET_ACCESS_KEY=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
export AWS_DEFAULT_REGION=ap-northeast-1

# credentialsファイルのプロファイルを切り替える場合
export AWS_PROFILE=myproject-prod

# playbooks/provision_ec2.yml
---
- name: EC2インスタンスを1台起動する（動作確認用）
  hosts: localhost
  connection: local
  gather_facts: false

  tasks:
    - name: Webサーバー用EC2インスタンスを作成・起動する
      amazon.aws.ec2_instance:
        name: "web-test-01"
        image_id: "ami-0a0000000000aaaaa"    # Amazon Linux 2023 ap-northeast-1
        instance_type: "t3.micro"
        key_name: "my-ec2-keypair"
        security_groups:
          - "default"
        vpc_subnet_id: "subnet-0abc12345678"
        state: present
        region: ap-northeast-1
        tags:
          Environment: test
          Role: webserver
      register: ec2_result

    - name: 起動結果のIPアドレスを表示する
      ansible.builtin.debug:
        msg: "インスタンスID: {{ ec2_result.instances[0].instance_id }}  プライベートIP: {{ ec2_result.instances[0].private_ip_address }}"

$ ansible-playbook playbooks/provision_ec2.yml

PLAY [EC2インスタンスを1台起動する（動作確認用）] ***

TASK [Webサーバー用EC2インスタンスを作成・起動する] ***
changed: [localhost]

TASK [起動結果のIPアドレスを表示する] ***
ok: [localhost] => {
    "msg": "インスタンスID: i-0abc12345678abcde  プライベートIP: 10.0.1.50"
}

PLAY RECAP ***
localhost                  : ok=2    changed=1

# ディレクトリ構成
provision/
├── playbooks/
│   └── provision_ec2.yml
├── group_vars/
│   ├── all.yml          # 共通設定（AMI ID、リージョン、キーペア名）
│   ├── development.yml  # dev環境: t3.micro、devサブネット
│   └── production.yml   # prod環境: t3.medium、prodサブネット
└── inventory/
    └── localhost.yml

# group_vars/all.yml
aws_region: ap-northeast-1
ec2_ami_id: "ami-0a0000000000aaaaa"   # Amazon Linux 2023
ec2_key_name: "my-ec2-keypair"
ec2_security_groups:
  - "web-sg"

# group_vars/development.yml
env_name: development
ec2_instance_type: t3.micro
ec2_subnet_id: "subnet-0dev123456789"

# group_vars/production.yml
env_name: production
ec2_instance_type: t3.medium
ec2_subnet_id: "subnet-0prod12345678"

# playbooks/provision_ec2.yml
---
- name: EC2インスタンスを環境別にプロビジョニングする
  hosts: localhost
  connection: local
  gather_facts: false

  # 実行時に -e "env=development" または -e "env=production" で切り替える
  vars:
    env: "{{ lookup('env', 'TARGET_ENV') | default('development') }}"

  tasks:
    - name: 環境別のgroup_varsを読み込む
      ansible.builtin.include_vars:
        file: "group_vars/{{ env }}.yml"

    - name: Webサーバー用EC2インスタンスを作成する
      amazon.aws.ec2_instance:
        name: "web-{{ env_name }}-01"
        image_id: "{{ ec2_ami_id }}"
        instance_type: "{{ ec2_instance_type }}"
        key_name: "{{ ec2_key_name }}"
        security_groups: "{{ ec2_security_groups }}"
        vpc_subnet_id: "{{ ec2_subnet_id }}"
        state: present
        region: "{{ aws_region }}"
        tags:
          Environment: "{{ env_name }}"
          Role: webserver
          ManagedBy: ansible
      register: ec2_result

    - name: インスタンス情報を変数に保持する
      ansible.builtin.set_fact:
        provisioned_private_ip: "{{ ec2_result.instances[0].private_ip_address }}"
        provisioned_instance_id: "{{ ec2_result.instances[0].instance_id }}"

    - name: 起動結果を表示する
      ansible.builtin.debug:
        msg:
          - "環境: {{ env_name }}"
          - "インスタンスID: {{ provisioned_instance_id }}"
          - "プライベートIP: {{ provisioned_private_ip }}"

# 開発環境のEC2を起動する
ansible-playbook playbooks/provision_ec2.yml -e "env=development"

# 本番環境のEC2を起動する
ansible-playbook playbooks/provision_ec2.yml -e "env=production"

# 本番環境のEC2を停止する（stateをstopped に変更）
ansible-playbook playbooks/provision_ec2.yml -e "env=production" -e "ec2_state=stopped"

AnsibleでAWS構築を体系的に学びたい方へ

Playbookの書き方・Role設計・Vault暗号化・CI/CD連携まで、実機環境で手を動かしながら習得できます。
独学でつまずいている方は、現役エンジニアが指導するハンズオンセミナーで一気に理解を深めましょう。
＞＞ Ansible実践セミナーの詳細・申込はこちら

# EC2プロビジョニング → 初期設定まで1本で流すPlaybook例
---
- name: フェーズ1：EC2インスタンスを作成する
  hosts: localhost
  connection: local
  gather_facts: false

  tasks:
    - name: EC2を起動する
      amazon.aws.ec2_instance:
        name: "web-prod-01"
        image_id: "ami-0a0000000000aaaaa"
        instance_type: t3.medium
        key_name: my-ec2-keypair
        security_groups:
          - web-sg
        vpc_subnet_id: subnet-0prod12345678
        state: present
        region: ap-northeast-1
        tags:
          Environment: production
      register: ec2_result

    - name: EC2が起動完了するまで待つ
      amazon.aws.ec2_instance_info:
        instance_ids: "{{ ec2_result.instances[0].instance_id }}"
        region: ap-northeast-1
      register: instance_info
      until: instance_info.instances[0].state.name == 'running'
      retries: 10
      delay: 15

    - name: 新しいEC2をインベントリに追加する
      ansible.builtin.add_host:
        name: "{{ ec2_result.instances[0].private_ip_address }}"
        groups: newly_provisioned
        ansible_user: ec2-user
        ansible_ssh_private_key_file: "~/.ssh/my-ec2-keypair.pem"

- name: フェーズ2：新しいEC2に初期設定を流す
  hosts: newly_provisioned
  gather_facts: true

  tasks:
    - name: SSHが応答できる状態になるまで待つ
      ansible.builtin.wait_for_connection:
        delay: 10
        timeout: 120

    - name: パッケージを最新化する
      ansible.builtin.dnf:
        name: "*"
        state: latest
      become: true

    - name: Nginxをインストールする
      ansible.builtin.dnf:
        name: nginx
        state: present
      become: true

【注意】state: absent は本番環境での誤実行に注意

`state: absent` または `state: terminated` を指定したPlaybookを本番環境で誤って実行すると、EC2インスタンスが削除されます。
削除されたインスタンスはストレージも含めて失われ、復元はできません。
本番Playbook実行前には必ず `--check`（ドライランモード）で変更内容を確認する習慣をつけてください。
また、本番環境用のPlaybookには `when: env_name == 'production'` の条件ガードを設けて、誤った環境への適用を防ぐ設計が重要です。

AnsibleでAWS構築を体系的に学びたい方へ

Playbookの書き方・Role設計・Vault暗号化・CI/CD連携まで、実機環境で手を動かしながら習得できます。
独学でつまずいている方は、現役エンジニアが指導するハンズオンセミナーで一気に理解を深めましょう。
＞＞ Ansible実践セミナーの詳細・申込はこちら