etude_for_aws 0.7.4

data/docker-compose.yml

@@ -0,0 +1,9 @@
+version: '2'
+services:
+  app:
+    build: .
+    image: aws-cli
+    volumes:
+     - .:/project
+    env_file:
+      - .env     

data/docs/README.md

@@ -0,0 +1,54 @@
+Etude for AWS
+===================
+
+# 目的 #
+AWS構築のための練習プログラム集
+
+# 前提 #
+| ソフトウェア   | バージョン   | 備考        |
+|:---------------|:----------|:------------|
+| aws-cli        | 1.11.81   |             |
+| eb             | 3.10.1    |             |
+| terraform      | 0.6.16    |             |
+| vagrant        |1.8.7      |             |
+| packer         |0.10.1     |             |
+| chef-dk        |1.3.43     |             |
+| docker         |17.04.0    |             |
+| docker-compose |1.8.0      |             |
+
+# 構成 #
+1. [構築](#構築)
+1. [配置](#配置)
+1. [開発](#開発)
+1. [運用](#運用)
+
+## 構築
+[Using the AWS SDK for Ruby REPL](./ops/build_aws_sdk_repl.md)
+
+**[⬆ back to top](#構成)**
+
+## 配置
+### [CircleCI配置](./ops/ship_circleci.md)
+### [Jenkins配置](./ops/ship_jenkins.md)
+### [RubyGemパッケージの配置](./ops/ship_ruby_gem.md)
+
+**[⬆ back to top](#構成)**
+
+## 開発
+### [CFM](./dev/cfm/cfm.md)
+### [VPC](./dev/vpc/vpc.md)
+### [EC2](./dev/ec2/ec2.md)
+
+**[⬆ back to top](#構成)**
+
+## 運用
+[Rake Task](./ops/run_rake_task.md)
+
+**[⬆ back to top](#運用)**
+
+# 参照 #
++ [AWS SDK for Ruby - Version 2](https://github.com/aws/aws-sdk-ruby)
++ [AWS SDK for Ruby - Version 2 API Docs](http://docs.aws.amazon.com/sdkforruby/api/index.html)
++ [AWS SDK for Ruby Code Examples](http://docs.aws.amazon.com/ja_jp/sdk-for-ruby/v2/developer-guide/examples.html)
++ [RSpec Expectations 3.5](http://www.relishapp.com/rspec/rspec-expectations/v/3-5/docs)
++ [PlantUML](http://plantuml.com/)

data/docs/_config.yml

@@ -0,0 +1,6 @@
+highlighter: rouge
+markdown: kramdown
+kramdown:
+  input: GFM
+  auto_ids: true
+  syntax_highlighter: rouge

data/docs/dev/cfm/cfm.md

@@ -0,0 +1,9 @@
+CloudFormation
+---
+
+## 基本仕様
+
+## ユースケース
+### [VPC](./vpc/vpc.md)
+
+## コアモデル

data/docs/dev/cfm/vpc/core_model.puml

@@ -0,0 +1,35 @@
+@startuml
+
+package Aws {
+  class CloudFormation
+}
+
+package EC2 {
+  Interface VpcInterface
+}
+
+Interface CertificationHelper
+Interface ConfigurationHelper
+
+package CFM {
+  class Vpc {
+    create()
+    destroy()
+  }
+
+  Vpc <|-- VpcInterface
+  CertificationHelper <|-- Configuration
+  ConfigurationHelper <|-- Configuration
+  Configuration -l-> CloudFormation
+  Vpc *-l- Configuration
+  Vpc <|-- NullVpc
+  Vpc <|-- OneAzOnePublicSubnetVpc
+  Vpc <|-- OneAzTwoPublicAndPrivateSubnetVpc
+  Vpc <|-- OneAzTwoPublicSubnetVpc
+  Vpc <|-- TwoAzOnePublicSubnetAndPrivateSubnetVpc
+  Vpc <|-- TwoAzTwoPrivateSubnetVpc
+  Vpc <|-- TwoAzTwoPublicSubnetAndPrivateSubnetVpc
+  Vpc <|-- TwoAzTwoPublicSubnetVpc
+}
+
+@enduml

data/docs/dev/cfm/vpc/vpc.md

@@ -0,0 +1,39 @@
+VPC
+---
+
+## 基本仕様
++ CloudFormationのテンプレートファイルに記述されたパターンごとにVPC環境を構築する
++ 7パターンに対応する
+  1. １つのアベイラビリティゾーンに１つのパブリックサブネット
+  1. １つのアベイラビリティゾーンに２つのパブリックサブネット
+  1. １つのアベイラビリティゾーンに１つのパブリックサブネットと１つのプライベートサブネット
+  1. ２つのアベイラビリティゾーンに２つのプライベートサブネット
+  1. ２つのアベイラビリティゾーンに２つのパブリックサブネット
+  1. ２つのアベイラビリティゾーンに１つのパブリックサブネットと１つのプライベートサブネット
+  1. ２つのアベイラビリティゾーンに２つのパブリックサブネットと２つのプライベートサブネット
+
+## ユースケース
+### パターン1
+![](../images/vpc_type1.png)
+
+### パターン2
+![](../images/vpc_type2.png)
+
+### パターン3
+![](../images/vpc_type3.png)
+
+### パターン4
+![](../images/vpc_type4.png)
+
+### パターン5
+![](../images/vpc_type5.png)
+
+### パターン6
+![](../images/vpc_type6.png)
+
+### パターン7
+![](../images/vpc_type7.png)
+
+
+## コアモデル
+![](../images/vpc_core_model.png)

data/docs/dev/cfm/vpc/vpc_type1.puml

@@ -0,0 +1,17 @@
+@startuml
+cloud Internet
+frame "AWS" {
+frame "VPC" {
+    Internet - [InternetGateway]
+    [InternetGateway] -- [RouteTable]
+    [RouteTable] -- PublicSubnet1
+    frame "AZ1" {
+      frame "PublicSubnet1" {
+      }
+    }
+}
+}
+note right of PublicSubnet1
+  10.0.0.0/24
+end note
+@enduml

data/docs/dev/cfm/vpc/vpc_type2.puml

@@ -0,0 +1,23 @@
+@startuml
+cloud Internet
+frame "AWS" {
+frame "VPC" {
+    Internet - [InternetGateway]
+    [InternetGateway] -- [RouteTable]
+    [RouteTable] -- PublicSubnet1
+    [RouteTable] -- PublicSubnet2
+    frame "AZ1" {
+      frame "PublicSubnet1" {
+      }
+      frame "PublicSubnet2" {
+      }
+    }
+}
+}
+note right of PublicSubnet1
+  10.0.0.0/24
+end note
+note right of PublicSubnet2
+  10.0.1.0/24
+end note
+@enduml

data/docs/dev/cfm/vpc/vpc_type3.puml

@@ -0,0 +1,24 @@
+@startuml
+cloud Internet
+frame "AWS" {
+frame "VPC" {
+    Internet - [InternetGateway]
+    [InternetGateway] -- [RouteTable1]
+    [RouteTable1] -- PublicSubnet1
+    [RouteTable2] -- PublicSubnet1
+    [RouteTable2] -- PrivateSubnet1
+    frame "AZ1" {
+      frame "PublicSubnet1" {
+      }
+      frame "PrivateSubnet1" {
+      }
+    }
+}
+}
+note right of PublicSubnet1
+  10.0.0.0/24
+end note
+note right of PrivateSubnet1
+  10.0.1.0/24
+end note
+@enduml

data/docs/dev/cfm/vpc/vpc_type4.puml

@@ -0,0 +1,23 @@
+@startuml
+cloud Internet
+frame "AWS" {
+frame "VPC" {
+    [RouteTable] -- PrivateSubnet1
+    [RouteTable] -- PrivateSubnet2
+    frame "AZ1" {
+      frame "PrivateSubnet1" {
+      }
+    }
+    frame "AZ2" {
+      frame "PrivateSubnet2" {
+      }
+    }
+}
+}
+note right of PrivateSubnet1
+  10.0.2.0/24
+end note
+note right of PrivateSubnet2
+  10.0.3.0/24
+end note
+@enduml

data/docs/dev/cfm/vpc/vpc_type5.puml

@@ -0,0 +1,25 @@
+@startuml
+cloud Internet
+frame "AWS" {
+frame "VPC" {
+    Internet - [InternetGateway]
+    [InternetGateway] -- [RouteTable]
+    [RouteTable] -- PublicSubnet1
+    [RouteTable] -- PublicSubnet2
+    frame "AZ1" {
+      frame "PublicSubnet1" {
+      }
+    }
+    frame "AZ2" {
+      frame "PublicSubnet2" {
+      }
+    }
+}
+}
+note right of PublicSubnet1
+  10.0.0.0/24
+end note
+note right of PublicSubnet2
+  10.0.1.0/24
+end note
+@enduml

data/docs/dev/cfm/vpc/vpc_type6.puml

@@ -0,0 +1,26 @@
+@startuml
+cloud Internet
+frame "AWS" {
+frame "VPC" {
+    Internet - [InternetGateway]
+    [InternetGateway] -- [RouteTable1]
+    [RouteTable1] -- PublicSubnet1
+    [RouteTable2] -- PublicSubnet1
+    [RouteTable2] -- PrivateSubnet1
+    frame "AZ1" {
+      frame "PublicSubnet1" {
+      }
+    }
+    frame "AZ2" {
+      frame "PrivateSubnet1" {
+      }
+    }
+}
+}
+note right of PublicSubnet1
+  10.0.0.0/24
+end note
+note right of PrivateSubnet1
+  10.0.1.0/24
+end note
+@enduml

data/docs/dev/cfm/vpc/vpc_type7.puml

@@ -0,0 +1,39 @@
+@startuml
+cloud Internet
+frame "AWS" {
+frame "VPC" {
+    Internet - [InternetGateway]
+    [InternetGateway] -- [RouteTable1]
+    [RouteTable1] -- PublicSubnet1
+    [RouteTable1] -- PublicSubnet2
+    [RouteTable2] -- PublicSubnet1
+    [RouteTable2] -- PublicSubnet2
+    [RouteTable2] -- PrivateSubnet1
+    [RouteTable2] -- PrivateSubnet2
+    frame "AZ1" {
+      frame "PublicSubnet1" {
+      }
+      frame "PrivateSubnet1" {
+      }
+    }
+    frame "AZ2" {
+      frame "PublicSubnet2" {
+      }
+      frame "PrivateSubnet2" {
+      }
+    }
+}
+}
+note right of PublicSubnet1
+  172.16.1.0/24
+end note
+note right of PrivateSubnet1
+  172.16.3.0/24
+end note
+note right of PublicSubnet2
+  172.16.2.0/24
+end note
+note right of PrivateSubnet2
+  172.16.4.0/24
+end note
+@enduml

data/docs/dev/ec2/core_model.puml

@@ -0,0 +1,43 @@
+@startuml
+
+package Aws {
+  class EC2::Client
+  class EC2::Resource
+}
+
+package CFM {
+  class CFM::Vpc
+}
+
+package VPC {
+  class VPC::Vpc
+}
+
+Interface CertificationHelper
+Interface ConfigurationHelper
+
+package EC2 {
+  Interface VpcInterface
+  VpcInterface <|-r- CFM::Vpc
+  VpcInterface <|-l- VPC::Vpc
+
+  class Ec2 {
+    create()
+    destroy()
+    start()
+    stop()
+    reboot()
+  }
+  CertificationHelper <|-- Ec2ApiGateway
+  ConfigurationHelper <|-- Configuration
+  Ec2ApiGateway -u-> Aws
+  Ec2 -r-> VpcInterface
+  Ec2 "1" *-u- "1" Configuration
+  Ec2 "1" *-u- "1" Ec2ApiGateway
+  Ec2 "1" *-- "1..*" Ec2Instance
+  Ec2 "1" *-- "1" KeyPair
+  Ec2 "1" *-- "1" SecurityGroup
+
+}
+
+@enduml

data/docs/dev/ec2/ec2.md

@@ -0,0 +1,36 @@
+EC2
+---
+
+## 基本仕様
++ VPCで作成されたネットワークにインスタンスを作成する。
++ 対応するパターンは[７パターン](../vpc/vpc.md)
++ すべてのインスタンスに共通のセキュリティグループが適用される。
++ すべてのインスタンスに共通のキーペアが適用される。
++ シンプルなVPC環境はパターン１に対応する。
++ 標準的なVPC環境はパターン３に対応する。
+
+## ユースケース
+### パターン1
+![](images/ec2_type1.png)
+
+### パターン2
+![](images/ec2_type2.png)
+
+### パターン3
+![](images/ec2_type3.png)
+
+### パターン4
+![](images/ec2_type4.png)
+
+### パターン5
+![](images/ec2_type5.png)
+
+### パターン6
+![](images/ec2_type6.png)
+
+### パターン7
+![](images/ec2_type7.png)
+
+
+## コアモデル
+![](images/ec2_core_model.png)