uma-arai
diff --git a/‎README.md
Lines changed: 263 additions & 1 deletion b/‎README.md
Lines changed: 263 additions & 1 deletion
diff --git a/‎app/Dockerfile
Lines changed: 23 additions & 0 deletions b/‎app/Dockerfile
Lines changed: 23 additions & 0 deletions
diff --git a/‎app/Makefile
Lines changed: 37 additions & 0 deletions b/‎app/Makefile
Lines changed: 37 additions & 0 deletions
diff --git a/‎app/README.md
Lines changed: 53 additions & 0 deletions b/‎app/README.md
Lines changed: 53 additions & 0 deletions
diff --git a/‎app/app
11.2 MB b/‎app/app
11.2 MB
diff --git a/‎app/domain/model/app.go
Lines changed: 7 additions & 0 deletions b/‎app/domain/model/app.go
Lines changed: 7 additions & 0 deletions
diff --git a/‎app/domain/model/error.go
Lines changed: 7 additions & 0 deletions b/‎app/domain/model/error.go
Lines changed: 7 additions & 0 deletions
@@ -1 +1,263 @@
-# iac-story-code
+# クラウドネイティブIaCストーリー/サンプルコード
+
+## Overview
+
+本リポジトリでは「比べてわかる！IaCの選び方 ~クラウドネイティブIaCストーリー」の付録である各IaCのサンプルソースコードを提供しています。
+また、Cloud9上でサンプルコードを動作させる手順も併せて記載していますので、AWSアカウントをお持ちの方はぜひハンズオン感覚でお試しください。
+
+## サンプルコードの種類
+
+|IaCサービス|言語/フォーマット|対象ディレクトリ|
+|-|-|-|
+|CloudFormation|YAML|[cloudformation](./cloudformation)|
+|CDK|TypeScript|[cdk-typescript](./cdk-typescript)|
+|Terraform|HCL|[terraform](./terraform)|
+|Pulumi|Go|[pulumi-go](./pulumi-go)|
+
+## サンプルコードの動作環境・バージョン情報
+
+- CloudFormation: 2021年6月時点にAWS マネジメントコンソールから提供されるサービスバージョン
+  - Template version: 2010-09-09
+
+- AWS CDK: 1.106.1 (build c832c1b)
+  - Node.js: v14.15.1
+
+- Terraform: v1.0
+  - tfenv: v2.2.2
+  - AWS Provider: 3.45.0
+  - Terragrant: v0.30.3
+
+- Pulumi: v3.4.0
+  - AWS Provider: v4.7.0
+  - Go: 1.16.5
+
+
+## 構築可能なAWS環境
+
+いずれのIaCサービスサンプルコードを実行しても以下のAWSサービスが構築されます。
+
+![サンプルコードで作成されるAWS構成](images/iac-architecture.drawio.svg)
+
+### 作成されるAWSサービス群
+
+- Amazon VPC
+  - Subnet (パブリック - AZ x 2)
+  - Subnet (プライベートApp用 - AZ x 2)
+  - Subnet (プライベートVPC Endpoint用 - AZ x 2)
+  - Route Table (内部通信用)
+  - VPC Endpoint(S3, CloudWatch Logs, ECR)
+  - Security Group(ALB用)
+  - Security Group(App用)
+  - Security Group(VPC Endpoint用)
+  - Internet Gateway
+- Elastic Load Balancing
+  - ALBリスナー
+  - ターゲットグループ
+- AWS IAM
+  - Role (ECSタスク実行用)
+  - Policy (ECSタスク実行用)
+- AWS Systems Manager パラメータストア
+- Amazon ECS
+  - Cluster
+  - Service
+  - Task定義
+- Amazon ECR リポジトリ
+- Amazon CloudWatch Log Group
+
+## ハンズオン実施に向けて
+ここでは、本リポジトリで提供するIaCサービスをハンズオンとして実施するための準備事項を記載します。
+
+### 前提事項
+- AWSアカウントを所有していること
+- AdministratorAccessポリシー相当のIAMユーザもしくはIAMロールで作業可能なこと
+
+### 事前準備
+
+IaCサービスの実行はAWS Cloud9上で行います。
+ここではCloud9の作成と関連するセットアップ手順を記載します。
+
+#### Amazon Cloud9の作成
+
+各IaCサンプルコードを実行するためにCloud9を利用します。
+デフォルトで各種言語のランタイムやDocker CLIが利用できるなど、メリットがあります。
+早速、Cloud9用のインスタンスから作成します。
+
+1. AWSマネジメントコンソール上部の [サービス] タブより [Cloud9] を選択します。
+2. Cloud9ダッシュボードの左側ナビゲーションメニューから [Account environments] を選択し、[Create environment] ボタンを押します。
+3. [Step1 Name environment] では、次のように各項目を入力後、 [Next step] ボタンを押します。
+
+|項目名|値|
+|-|-|
+|Name|cnis-playground|
+|Description|(入力なし)|
+
+4. [Step2 Configure settings] では、次のように各項目を入力・選択後、 [Next step] ボタンを押します。
+ネットワークVPC及びサブネットはデフォルトのものを選択してください（デフォルトVPCが存在しない場合、インターネットに接続可能なVPCとサブネットを選択してください）。
+
+|項目名|値|
+|-|-|
+|Environment type|Create a new EC2 instance for environment(direct access)|
+|Instance type|t3.micro(2 GiB RAM + 1 vCPU)|
+|Platform|Amazon Linux2 (recommended)|
+|Cost-saving setting|After 30 minutes(default)|
+|Network(VPC)|vpc-xxxxxxx(default) ※インターネットに接続可能なVPC|
+|Subnet|subnet-xxxxxxx | Default in ap-northeast-1a|
+
+5. [Review] にて入力内容を確認し、 [Create environment] ボタンを押します。
+
+<img src="./images/cloud9-confirm.png">
+
+6. 以下のようにCloud9コンソールが利用可能であることを確認してください。
+
+<img src="./images/cloud9-main.png">
+
+#### IAMユーザーの作成
+
+Cloud9ではマネジメントコンソールにログインしたIAMユーザーの権限で自動的に認証権限が設定される仕組みを持っています。
+これは AWS Managed Temporary Credentials(以降「AMTC」と略します) と呼ばれています。
+
+[AWS Managed Temporary Credentials](https://docs.aws.amazon.com/ja_jp/cloud9/latest/user-guide/how-cloud9-with-iam.html#auth-and-access-control-temporary-managed-credentials)
+
+IAMロール等の付与等も不要であるため便利なのですが、以下のような制約があります。
+
+[Actions Supported by AWS Managed Temporary Credentials](https://docs.aws.amazon.com/ja_jp/cloud9/latest/user-guide/how-cloud9-with-iam.html#auth-and-access-control-temporary-managed-credentials-supported)
+
+今回は上記制約を回避するため、AMTCは無効化とし、別な権限からAWSCLIを実行できるようにします。
+TerraformやPulumiではIAMユーザーアカウントから生成されるアクセスキーIDとシークレットアクセスキーが環境変数として設定されることを期待して動作します。
+そのため、インスタンスプロファイルによるIAMロール付与ではなく、アクセスキーIDの設定を行います。
+
+1. AWSマネジメントコンソールのトップ画面上部の [サービス] タブより [IAM] を 選択。
+2. IAMダッシュボードの左側ナビゲーションメニューから [ユーザー] を選択し、表示画面上部の [ユーザーを追加] ボタンを押下。
+3. ユーザーを追加画面にて次表の項目を選択後、[次のステップ:アクセス権限] ボタンを 押下。
+
+|項目名|値|
+|-|-|
+|ユーザー名|cnis-user|
+|アクセスの種類|プログラムによるアクセス|
+
+4. ユーザーを作成画面にて、[既存のポリシーを直接アタッチ]を選択し、[AdministratorAccess] にチェックを入れた後、[次ののステップ:タグ] ボタンを押下。
+5. ここではタグの追加はスキップ。[次のステップ:確認] ボタンを押下。
+6. 確認画面にて、確認画面に表示された内容を確認し、[ユーザーの作成] ボタンを押下。
+7. 成功の旨を確認し、表示されるアクセスキーIDとシークレットアクセスキーの値を控えておく。
+　
+#### AWSアクセスキーの設定
+
+1. AWS マネジメントコンソールのトップ 画面上部の [サービス] タブより [Cloud9] を選択。
+2. Cloud9 ダッシュボードの左側ナビゲーションメニューから [Your environments] を選択し、表示画面中央の cnapp-playground 内 [Open IDE] ボタンを押下。コンソールが表示されるまで待つ。
+
+3. コンソール上で`~/.aws/credentials`を作成し、以下のように入力して保存。
+```
+[default]
+aws_access_key_id=******
+aws_secret_access_key=******
+```
+
+`aws_access_key_id`と`aws_secret_access_key`は、先程IAMユーザー作成時に払い出して作成したアクセスキーIDとシークレットアクセスキーを入力する。
+
+4. コンソール上で`~/.aws/config`を作成し、以下のように入力して保存。
+```
+[profile default]
+region = ap-northeast-1
+```
+
+以上でAWSアクセスキーの設定は完了です。
+実際には、AWSアクセスキーをそのままフラットファイルに記載してしまうのは危険なので、[aws-vault](https://github.com/99designs/aws-vault)等と組み合わせて利用するのが実運用を考えると現実的です。
+今回のハンズオンは簡略化のため、credentialsに記載しています。
+
+#### AMTCの無効化
+
+発行したAWSアクセスキーを利用するため、AMTCを無効化します。
+
+1. AWS マネジメントコンソールのトップ 画面上部の [サービス] タブより [Cloud9] を選択。
+2. Cloud9 ダッシュボードの左側ナビゲーションメニューから [Your environments] を選択し、表示画面中央の cnapp-playground 内 [Open IDE] ボタンを押下。コンソールが表示されるまで待つ。
+3. 画面中央上部のタブの [+] ボタンを押し、[Open Preferences] を選択して新規タブを作成。タブ画面内の左側ナビゲーションメニューから [AWS Settings] → [Credentials] を選択。
+4. 表示される画面上の [AWS managed temporary credentials:] を OFFに設定。
+
+<img src="./images/cloud9-amtc-off.png">
+
+5. 以下のコマンドで作成した`cnis-user`の情報が返却できれば、AMTCではなくアクセスキーID経由でAWSCLIが実行できる状態。
+
+```bash
+$ aws iam list-users
+{
+    "Users": [
+        {
+            "UserName": "cnis-user", 
+            "Path": "/", 
+			:
+        }, 
+	:
+}
+```
+
+以上により、Cloud9環境が整いました。
+
+#### EBSボリュームサイズの変更
+
+IaCによってはプロバイダーのダウンロードを行います。
+Cloud9のデフォルトボリュームだとサイズが足りないので、別途EBSをアタッチします。
+
+1. AWS マネジメントコンソールのトップ 画面上部の [サービス] タブより [EC2] を選択。
+2. EC2ダッシュボードの左側ナビゲーションメニューから [インスタンス] を選択。
+3. インスタンス一覧画面から Name 列で [aws-cloud9-cnis-playground-] のインスタンスを選択し、画面下部の [ストレージ] を選択。
+4. [vol-**] から始まるボリュームIDを控えておく。
+5. EC2ダッシュボードの左側ナビゲーションメニューから [ボリューム] を選択。
+6. 手順4.で選択したボリュームID選択し、画面上部の [アクション] → [ボリュームの変更] を選択。
+7. ボリュームの変更画面上の [サイズ] を10 → 30 に変更した後、[変更] ボタンを押下。
+8. ボリュームを変更してもよいか確認する旨が表示されるので [はい] を選択。
+9. ボリュームの変更リクエストが成功しました、と表示されることを確認して[閉じる] ボタンを押し、ボリューム一覧画面の右上の更新ボタンを押してサイズが変更されることを確認。
+
+以上でEBSボリュームサイズの変更作業は完了です。
+ディスクサイズ拡張を確実に反映させるため、インスタンスを再起動させておきましょう。
+
+
+#### 各種ツールのインストール
+
+再びCloud9コンソールに戻り、以下をインストールしておきます。
+```
+$ sudo yum -y install tree jq
+```
+
+### リポジトリの取得
+
+Cloud9上で実行する本リポジトリを取得します。
+
+1. Cloud9 IDEを開き、画面下部のコマンドラインにて以下を入力。
+
+```
+$ git clone https://github.com/uma-arai/iac-story-code
+Cloning into 'iac-story-code'...
+:
+Resolving deltas: 100% (172/172), done.
+```
+
+2. リポジトリがクローンされていることを確認。
+```
+$ cd iac-story-code/
+$ tree .
+```
+
+これで各サンプルコードを実行する準備が出来ました。
+
+## 各IaCサービスのハンズオン
+
+本リポジトリの各IaCサービスディレクトリ配下の`README.md`に従って実施してください。
+
+## 注意事項
+
+- 本リポジトリは不定期にバージョンアップを行います。READMEのバージョン情報を適宜ご参照ください。
+- IaCサービス利用により、以下のAWSサービスが作成されます。料金が発生するサービスも含まれており、各IaCサービス用 README.md に従ってリソースの削除をオススメします。
+  - リソースを作成したまま1ヶ月放置すると、東京リージョン(ap-northeast-1)で**約¥13,000程度請求されてしまう**ので、消し忘れにご注意ください($1=¥110換算、消費税なし)。
+
+
+## 免責事項
+
+- 本リポジトリ（以降、`iac-story-code`）は利用者ご自身の判断と責任において行われるものとします。
+
+- `iac-story-code`の各種情報等については、慎重に作成、管理し、正確性を保つようには努めていますが、万一記載情報が事実と異なる場合は、Issueを作成していただけると幸いです。
+
+- `iac-story-code`の内容の全部または一部を事前の告知なしに変更する場合があります。
+
+- `iac-story-code`上から入手された情報により発生したあらゆる損害に関して一切の責任を負いません。 ここに掲載する情報およびリンクが設定されている他のサイトから取得された各種情報の利用によって生じたあらゆる損害に関しても一切の責任を負いません。
+
+- `iac-story-code`にに登場するシステム名や製品名は、関係各社の商標または登録商標です。また本書では、™、®、©などのマークは省略しています。
@@ -0,0 +1,23 @@
+# Multi stage building strategy for reducing image size.
+FROM golang:1.16.5-alpine3.13 AS build-env
+ENV GO111MODULE=on
+RUN mkdir /app
+ADD . /app
+WORKDIR /app
+# Use "Ultimate Packer for eXecutables". ref: https://upx.github.io/
+RUN apk add --no-cache --virtual .go-builddeps git gcc make build-base alpine-sdk upx&& \
+    go mod download && \
+    go get golang.org/x/lint/golint && \
+    make validate && \
+    make build-linux && \
+    go get github.com/pwaller/goupx && \
+    goupx main
+
+FROM alpine:3.14
+RUN mkdir /app && \
+    apk add --no-cache tzdata&& \
+    cp /usr/share/zoneinfo/Asia/Tokyo /etc/localtime
+WORKDIR /app
+COPY --from=build-env /app/main /app
+EXPOSE 80
+ENTRYPOINT ["/app/main"]
@@ -0,0 +1,37 @@
+# Golang parameter(gofmt: code formatter, go vet/golist: lint tools)
+GOCMD=go
+GOFMT=go fmt
+GOVET=$(GOCMD) vet
+GOLINT=golint
+GOBUILD=$(GOCMD) build
+GOCLEAN=$(GOCMD) clean
+GOTEST=$(GOCMD) test
+GOGET=$(GOCMD) get
+BINARY_NAME=main
+BINARY_UNIX=$(BINARY_NAME)_unix
+
+BUILD_PATH=.
+APP_PATH=.
+
+all:
+	make validate
+	make build
+	make run
+
+# delete debug symbols by golang option -dlflags "-s -w"
+build:
+	$(GOBUILD) -o $(BUILD_PATH)/$(BINARY_NAME) -ldflags "-s -w" $(APP_PATH)/main.go
+validate:
+	$(GOFMT) ./...
+	$(GOVET) ./...; $(GOLINT) -set_exit_status ./...
+	$(GOTEST) -v ./...
+clean:
+	rm -f $(BUILD_PATH)/$(BINARY_NAME)
+	rm -f $(BUILD_PATH)/$(BINARY_UNIX)
+run:
+	$(BUILD_PATH)/$(BINARY_NAME)
+
+# cross-compile for linux
+build-linux:
+	CGO_ENABLED=0 GOOS=linux GOARCH=amd64 make build
+
@@ -0,0 +1,53 @@
+# Demo Web API
+
+## Overview
+This app provides demo web application coded by golang. This app is consist of three APIs.
+- Healthcheck API
+- Hello World API (turn inside the container)
+- DB Access API
+- Parameter Store Access API
+
+## Prerequisite
+- Before start, you should build go runtime with go 1.16.5.
+- Download required go module for this app by following command.
+```bash
+❯ go get golang.org/x/lint/golint
+❯ go get 
+❯ go mod download
+```
+- Set following env variables to connect DB.
+  - CNAPP_DB_HOST
+  - CNAPP_DB_USERNAME 
+  - CNAPP_DB_PASSWORD 
+  - CNAPP_DB_NAME
+
+## How to Build and Deploy
+### Golang
+```bash
+❯ make all
+```
+### Docker
+```bash
+❯ docker build -t cnis:latest .
+❯ docker images
+REPOSITORY                  TAG                 IMAGE ID            CREATED             SIZE
+cnis                   latest              cdb20b70f267        58 minutes ago      4.45MB
+:
+❯ docker run -d -p 80:80 cnis:latest
+```
+
+### REST API (after deploy)
+```bash
+❯ curl http://localhost:80/cnis/v1/helloworld
+"Hello world!"
+
+❯ curl http://localhost:80/healthcheck
+null
+```
+
+## Options
+- If you want to deploy this app with SSL signed by self, set env
+variables TLS_CERT and TLS_KEY. 
+
+## Notes
+- We just check this operation only Mac OS (version 10.15).
@@ -0,0 +1,7 @@
+package model
+
+// App is entity for db result
+type App struct {
+	ID        string    `json:"id" gorm:"column:id"`
+	Message   string    `json:"message" gorm:"column:message"`
+}
@@ -0,0 +1,7 @@
+package model
+
+// ErrorMessages is entity for error result
+type ErrorMessages struct {
+	Code    string `json:"code"`
+	Message string `json:"message"`
+}