cloudformationを使ってみる

1からインフラを構築する機会があったのでどうせなら次やるときも楽できるようにある程度定義ファイルを用意することにしました

terraformと迷ったのですがterraformは以前個人的に使ったことがあったので今回はcloudformationを使うことにしました

yaml対応もされたようですしね

デザイナーでごにょごにょしてテンプレート生成するか、すでに誰かが作っているであろうテンプレートを使うか、1から使うか迷ったものの調べていて思ったのはなんかよくわからん！ということだけだったので1から作ってみて感覚をつかむことにしました

権限の追加

cliから実行するためにIAMロールに追加します

AWS Identity and Access Management によるアクセスの制御 - AWS CloudFormation

docs.aws.amazon.com

cloudformation:*とかで大丈夫ですが、ElasticacheやRDSなどを追加する場合は別途で権限が必要なので必要な場合は加えておく

簡単なサンプルを動作させてみる

まずは感じをつかむためVPCのみ作ってみます

sample.template.yml

AWSTemplateFormatVersion: '2010-09-09'
Resources:
  myVPC:
    Type: AWS::EC2::VPC
    Properties:
      CidrBlock: 10.0.0.0/16
      EnableDnsSupport: 'false'
      EnableDnsHostnames: 'false'
      InstanceTenancy: default
      Tags:
      - Key: Name
        Value: Sample

aws cloudformation create-stack \
  --stack-name sample \
  --template-body file:///home/vagrant/sandbox/cfn/sample.template.yml

{
    "StackId": "arn:aws:cloudformation:ap-northeast-1:111111111111:stack/sample/e97ffe10-4a09-11e7-8ce1-50a68a175a82"
}

マネジメントコンソールからVPCが作られたことを確認します

f:id:swfz:20170618043810p:plain

myVPCが論理IDということでこれを元にリソースを管理しているようです

stackの更新

先ほど作ったテンプレートに少し追加して更新してみます

sample.template.yml

AWSTemplateFormatVersion: '2010-09-09'
Resources:
  myVPC:
    Type: AWS::EC2::VPC
    Properties:
      CidrBlock: 10.0.0.0/16
      EnableDnsSupport: 'false'
      EnableDnsHostnames: 'false'
      InstanceTenancy: default
      Tags:
      - Key: Name
        Value: SampleVPC

簡単なところでタグのNameをSample -> SampleVPCに変更してみました

aws cloudformation create-stack \
  --stack-name sample \
  --template-body file:///home/vagrant/sandbox/cfn/sample.template.yml

マネジメントコンソールから確認します

変更する項目によってはidが変わってしまう(delete and createになってしまう)ようなので気をつける必要があります

ドキュメントに変更時の挙動が書いてあるので確認すればOKですね

f:id:swfz:20170618043832p:plain

リソース一覧

リソースの一覧が見れるのでcloudformationで作ったものは判断つきますね

デフォルトでcloudformationでつけたタグ以外に色々タグがつくようです(論理IDとか)

f:id:swfz:20170618043847p:plain

リソースの数は。。。35個!!(かもしれない)

引数

Parameters:以下でパラメータを指定できます

リージョンが変わっても対応できるようavailability zoneを指定できるようにしてみます

sample.template.yml

AWSTemplateFormatVersion: '2010-09-09'
Parameters:
  AZ1Parameter:
    Type: String
    Default: 'ap-northeast-1a'
    Description: select availability zone
  AZ2Parameter:
    Type: String
    Default: 'ap-northeast-1c'
    Description: select availability zone

Resources:
....
  public0A:
    Type: "AWS::EC2::Subnet"
    Properties:
      AvailabilityZone:
        Ref: AZ1Parameter
      CidrBlock: 10.0.0.0/24
      Tags:
      - Key: Project
        Value: Sample
      - Key: Name
        Value: 'Public 0a'
      VpcId:
        Ref: myVPC
....

AZ1Parameterで値を渡しています

実行時は--parametersに渡してあげます

./aws cloudformation update-stack \
  --stack-name sample \
  --template-body file:///home/sawafuji.yuya/sandbox/cfn/sample.template.yml \
  --parameters ParameterKey=AZ1Parameter,ParameterValue=ap-northeast-1a \
  ParameterKey=AZ2Parameter,ParameterValue=ap-northeast-1c

ここら辺は理解しやすいですね

部分的に変数を扱う

下記参考にしました

【小ネタ】CloudFormationで文字列内に変数を入れる。(YAML版) ｜ Developers.IO

dev.classmethod.jp

設定例としてプロジェクトネーム+何かしらみたいな場合

myVPC:
    Type: AWS::EC2::VPC
    Properties:
      CidrBlock: 10.0.0.0/16
      EnableDnsSupport: 'false'
      EnableDnsHostnames: 'false'
      InstanceTenancy: default
      Tags:
      - Key: Name
      Value: !Sub ${ProjectNameParameter}WithB

こんな感じで扱うことが出来ます

f:id:swfz:20170618043920p:plain