はじめに

下記のような定番構成をテンプレート化したい

※auto scailingは、テンプレートファイルに記述していません。

テンプレートファイルは複数に分割して、可読性と変更のしやすさを向上させたいので、
cloudformationでスタックをネストした構成にする

cloudformation ネストされたスタックとは

簡単に言うと
親スタックが子のスタックを作成すること

１つのテンプレートファイルに全てのリソースを記述には、行数が膨大になりリソースごとに分割する必要がある。しかし、分割するとデプロイ時に、テンプレートの数だけコマンドを叩く必要があるので、面倒。

そこでネストされたスタックを使用することで、親スタックをデプロイすれば依存関係のある子スタックもデプロイしてくれるので、とっても便利！
また、パラメータの変更など修正箇所を親テンプレートのみにできるので、エンハンスもしやすくなるなどのメリットもある。

大まかな手順

1.テンプレートファイルの作成

2.子テンプレートをS3へアップロード

3.子テンプレートのリンクを親テンプレートへ記述

4.親テンプレートのスタックを作成

テンプレート

.
├── root.yml
└── vpc.yml
└── ec2.yml
└── elb.yml
└── rds.yml

AWS::CloudFormation::Stack

ネストを使用する場合は、Typeに、AWS::CloudFormation::Stackを指定する

root.yml

Resources:
  # VPCの作成
  VPC:
    Type: AWS::CloudFormation::Stack
    Properties:
      TemplateURL: !Ref TemplateVPC
      Parameters:
        AZ1: !Select [0, !GetAZs ""]
        AZ2: !Select [1, !GetAZs ""]
        CIDRBlock: "10.0.0.0/16"
        PublicSubnet1CIDR: "10.0.1.0/24"
        PublicSubnet2CIDR: "10.0.2.0/24"
        PrivateSubnet1CIDR: "10.0.3.0/24"
        PrivateSubnet2CIDR: "10.0.4.0/24"

Parameters:に記載したパラメータは、子テンプレートに引き継いで使用できる

vpc.yml

# パラメータ
Parameters:
  AZ1:
    Type: String
    Description: Use AZ name
  AZ2:
    Type: String
    Description: Use AZ name
  CIDRBlock:
    Type: String
    Description: CIDRBlock of VPC
  PublicSubnet1CIDR:
    Type: String
    Description: CIDRBlock of PublicSubnet1
  PublicSubnet2CIDR:
    Type: String
    Description: CIDRBlock of PublicSubnet2
  PrivateSubnet1CIDR:
    Type: String
    Description: CIDRBlock of PrivateSubnet1
  PrivateSubnet2CIDR:
    Type: String
    Description: CIDRBlock of PrivateSubnet2

Resources:
  # VPCの作成
  VPC:
    Type: AWS::EC2::VPC
    Properties:
      CidrBlock: !Ref CIDRBlock
      InstanceTenancy: default
      EnableDnsSupport: true
      EnableDnsHostnames: true
      Tags: 
        - Key: !FindInMap [Common, ServiceTag, Key]
          Value: !FindInMap [Common, ServiceTag, Value]

Parameters:に指定したkeyを、!Refで参照することができる

子テンプレートをS3にアップロード

$ aws s3 mb yourbacket-name
$ aws s3 ls

#テンプレートファイルがあるディレクトリへ移動
$ cd currentDir

#カレントディレクトリにあるファイルを全てS3へアップロード
$ aws s3 cp . yourbacket-name --recursive

子テンプレートのリンクをroot.ymlに記載

roo.yml

Parameters:
  TemplateVPC:
    Description: VPC template Object URL
    Type: String
    Default: https://~~~~/vpc.yml

テンプレートファイルの構文チェック

$ aws cloudformation \
  validate-template --template-body file://root.yml

yamlの構文に問題があれば、エラーとして表示される

root.ymlをデプロイ

$ aws cloudformation \
  create-stack --stack-name test-cfn \
  --template-body file://root.yml

作成されたstackのidが返ってくる

スタックのアップデート

アップデート前に、changesetを作成すると、変更箇所が影響を及ぼすか確認することができる
アップデート時には、リソースが再起動する場合もあるので、注意が必要

$ aws cloudformation \
  create-change-set --stack-name test-cfn　\
  --change-set-name fixup \
  --template-body file://root.yml

$ aws cloudformation \
  update-stack --stack-name test-cfn \
  --template-body file://root.yml

(参考)省略記法

 #省略前
 VpcId: {Ref: VPC}
 #省略記法
 VpcId: !Ref VPC

(参考)組込関数

！Ref

 VpcId: !Ref VPC

パラメータを指定した場合、設定した値
リソースを指定した場合、リソースのID

が返り値となる

!GetAtt

Outputs:
  VPCId:
    Value: !GetAtt VPC.Outputs.VPCId
    Description: VPC CIDR Block

リソースごとに戻り値が異なるため、確認が必要

！Base64

      UserData: !Base64 |
        #! /bin/bash
        yum update -y
        amazon-linux-extras install php7.2 -y
        yum -y install mysql httpd php-mbstring php-xml

        wget http://ja.wordpress.org/latest-ja.tar.gz -P /tmp/
        tar zxvf /tmp/latest-ja.tar.gz -C /tmp
        cp -r /tmp/wordpress/* /var/www/html/
        touch /var/www/html/.check_alive
        chown apache:apache -R /var/www/html

        systemctl enable httpd.service
        systemctl start httpd.service

入力文字列をBase64表現に変換する

テンプレート全体