AnsibleでVPCから作るAWS環境の自動化｜ネットワークを先に用意してからEC2を並べる順序設計

この記事のポイント

・VPC→サブネット→IGW→SG→EC2の順序を守らないとPlaybookは動かない
・register変数でVPC作成結果のIDをEC2タスクへ引き渡す
・role分割でVPCネットワーク層とEC2起動層の依存を明示的に管理する
・subnet_id/vpc_idが見つからないエラーは順序と変数名のミスが原因の9割

VPC（アドレス空間の定義）
  └─ サブネット（AZへの分散配置）
       └─ ルートテーブル（外への出口の設定）
            └─ インターネットゲートウェイ（パブリック接続）
セキュリティグループ（ポートのホワイトリスト）
  └─ EC2インスタンス（起動先サブネットとSGを指定して初めて作れる）

# コレクションのインストール
ansible-galaxy collection install amazon.aws

# バージョン確認
ansible-galaxy collection list amazon.aws

# /home/ansible/.ansible/collections/ansible_collections
Collection    Version
------------- -------
amazon.aws    8.2.1

export AWS_ACCESS_KEY_ID=AKIA...（取得したキーIDを設定）
export AWS_SECRET_ACCESS_KEY=wJal...（取得したシークレットを設定）
export AWS_REGION=ap-northeast-1

---
- name: VPCとネットワーク層を構築
  hosts: localhost
  connection: local
  gather_facts: false

  vars:
    region: ap-northeast-1
    vpc_cidr: "10.0.0.0/16"
    public_subnet_cidr: "10.0.1.0/24"
    private_subnet_cidr: "10.0.2.0/24"
    az: "ap-northeast-1a"

  tasks:
    - name: VPCを作成する
      amazon.aws.ec2_vpc_net:
        name: "production-vpc"
        cidr_block: "{{ vpc_cidr }}"
        region: "{{ region }}"
        tags:
          Environment: production
      register: vpc_result

    - name: VPC IDを表示して確認
      ansible.builtin.debug:
        msg: "VPC ID: {{ vpc_result.vpc.id }}"

    - name: パブリックサブネットを作成する
      amazon.aws.ec2_vpc_subnet:
        vpc_id: "{{ vpc_result.vpc.id }}"
        cidr: "{{ public_subnet_cidr }}"
        az: "{{ az }}"
        map_public: true
        region: "{{ region }}"
        tags:
          Name: "public-subnet-1a"
          Tier: public
      register: public_subnet_result

    - name: プライベートサブネットを作成する
      amazon.aws.ec2_vpc_subnet:
        vpc_id: "{{ vpc_result.vpc.id }}"
        cidr: "{{ private_subnet_cidr }}"
        az: "{{ az }}"
        region: "{{ region }}"
        tags:
          Name: "private-subnet-1a"
          Tier: private
      register: private_subnet_result

    - name: インターネットゲートウェイを作成する
      amazon.aws.ec2_vpc_igw:
        vpc_id: "{{ vpc_result.vpc.id }}"
        region: "{{ region }}"
        tags:
          Name: "production-igw"
      register: igw_result

    - name: パブリックサブネット用のルートテーブルを作成する
      amazon.aws.ec2_vpc_route_table:
        vpc_id: "{{ vpc_result.vpc.id }}"
        region: "{{ region }}"
        subnets:
          - "{{ public_subnet_result.subnet.id }}"
        routes:
          - dest: "0.0.0.0/0"
            gateway_id: "{{ igw_result.gateway_id }}"
        tags:
          Name: "public-rtb"

    - name: Webサーバー用のセキュリティグループを作成する
      amazon.aws.ec2_security_group:
        name: "web-sg"
        description: "Web server security group"
        vpc_id: "{{ vpc_result.vpc.id }}"
        region: "{{ region }}"
        rules:
          - proto: tcp
            from_port: 80
            to_port: 80
            cidr_ip: "0.0.0.0/0"
          - proto: tcp
            from_port: 443
            to_port: 443
            cidr_ip: "0.0.0.0/0"
          - proto: tcp
            from_port: 22
            to_port: 22
            cidr_ip: "10.0.0.0/8"
        tags:
          Name: "web-sg"
      register: sg_result

    - name: ネットワーク層のIDをホスト変数として保存する
      ansible.builtin.copy:
        dest: ./network_ids.yml
        content: |
          vpc_id: "{{ vpc_result.vpc.id }}"
          public_subnet_id: "{{ public_subnet_result.subnet.id }}"
          private_subnet_id: "{{ private_subnet_result.subnet.id }}"
          web_sg_id: "{{ sg_result.group_id }}"

---
- name: EC2インスタンスを起動する
  hosts: localhost
  connection: local
  gather_facts: false

  vars_files:
    - ../network/network_ids.yml

  vars:
    region: ap-northeast-1
    # Amazon Linux 2023 AMI（ap-northeast-1）
    ami_id: ami-0599b6e53ca798bb2
    instance_type: t3.small

  tasks:
    - name: EC2インスタンスを起動する
      amazon.aws.ec2_instance:
        name: "web-server-01"
        image_id: "{{ ami_id }}"
        instance_type: "{{ instance_type }}"
        subnet_id: "{{ public_subnet_id }}"
        security_groups:
          - "{{ web_sg_id }}"
        region: "{{ region }}"
        network:
          assign_public_ip: true
        tags:
          Role: web
          Environment: production
        wait: true
      register: ec2_result

    - name: 起動したEC2のパブリックIPを確認する
      ansible.builtin.debug:
        msg: "Public IP: {{ ec2_result.instances[0].public_ip_address }}"

roles/
├── vpc_network/
│   └── tasks/
│       └── main.yml   ← VPC・サブネット・IGW・SGを作成
└── ec2_launch/
    └── tasks/
        └── main.yml   ← vpc_networkのregister変数を受け取ってEC2を起動

site.yml              ← roleの実行順を明示

---
- name: AWS環境を構築する（ネットワーク→EC2の順序）
  hosts: localhost
  connection: local
  gather_facts: false

  roles:
    - vpc_network   # 必ず先に実行
    - ec2_launch    # vpc_networkの完了後に実行

fatal: [localhost]: FAILED! => {"msg": "The subnet ID 'subnet-xxxxxxxx' does not exist"}

An error occurred (InvalidVpc.Conflict) when calling the CreateVpc operation:
The CIDR '10.0.0.0/16' conflicts with another vpc

# 変数の中身を確認するデバッグタスク
- name: vpc_resultの構造を確認する
  ansible.builtin.debug:
    var: vpc_result