Skip to content

Latest commit

 

History

History
83 lines (57 loc) · 5.93 KB

README_JP.md

File metadata and controls

83 lines (57 loc) · 5.93 KB

English / 日本語

AWSCloudFormationTemplates/cicd

Build Status GitHub GitHub release (latest by date)

AWSCloudFormationTemplates/cicd は、CodePipeline を用いて このリポジトリにある CloudFormation テンプレートを一括デプロイします。

TL;DR

以下のいずれかのボタンをクリックすることで、 この CloudFormationをデプロイ することが可能です。

アーキテクチャ

このテンプレートが作成するAWSリソースのアーキテクチャ図は、以下の通りです。

このテンプレートは、以下のダイアグラムを作成します。

準備

GitHub パーソナルアクセストークンの作成

GitHub パーソナルアクセストークン を作成し、その値をコピーします。

S3 アーティファクトバケットの作成 (オプション)

Global Settings Template を実行する際には、バージニアリージョン(us-east-1)に Amazon S3 アーティファクトバケットを作成してください。

aws s3api create-bucket --bucket my-bucket --region us-east-1

テンプレート設定ファイルの作成 (オプション)

テンプレート設定ファイル を使用する場合は、GitHubリポジトリに以下に示す命名規則で Configuration File をアップロードした上で、CloudFormationを実行する際には、GitHubOwnerNameForTemplateConfiguration パラメータと GitHubRepoNameForTemplateConfiguration パラメータを指定してください。

スタック名 Template Configuration File 名
CICD Template CICD.json
Global Settings Template GlobalSettings.json
Notification Template Notification.json
Security Template DefaultSecuritySettings.json
Security Template with Config Rule DefaultSecuritySettings-ConfigRules.json
Static Website Hosting Template StaticWebsiteHosting.json
EC2-based Web Servers Template WebServers.json
Systems Manager Template SystemsManager.json

デプロイ

ArtifactBacketInVirginia パラメータと GitHubOAuthToken パラメータを指定して、デプロイを実行してください。

aws cloudformation deploy --template-file template.yaml --stack-name StaticWebsiteHosting --parameter-overrides ArtifactBacketInVirginia=my0bucket GitHubOAuthToken=XXXXX

デプロイ時に、以下のパラメータを指定することができます。

名前 タイプ デフォルト値 必須 詳細
ArtifactBacketInVirginia String Amazon S3 アーティファクトバケット(us-east-1)
CodeBuildImageName String aws/codebuild/amazonlinux2-x86_64-standard:3.0
GitHubOAuthToken String GitHubからコードを取得する際に用いる OAuthトークン
GitHubOwnerNameForTemplateConfiguration String TemplateConfigurationファイルが置かれている GitHubリポジトリの所有者名 
GitHubRepoNameForTemplateConfiguration String TemplateConfigurationファイルが置かれている GitHubリポジトリ名 
GitHubStage String master CloudFormationテンプレートが置かれているリポジトリのステージ名
TemplateConfigurationBasePath String 設定プロパティのあるディレクトリのパス
DefaultSecuritySettingsConfigRules ENABLED / DISABLED DISABLED ENABLEDを指定した場合、DefaultSecuritySettingsConfigRules スタックがデプロイされます。
GlobalSettings ENABLED / DISABLED DISABLED ENABLEDを指定した場合、GlobalSettings スタックがデプロイされます。
Notification ENABLED / DISABLED DISABLED ENABLEDを指定した場合、Notification スタックがデプロイされます。
Route53 ENABLED / DISABLED DISABLED ENABLEDを指定した場合、Route53 スタックがデプロイされます。
StaticWebsiteHosting ENABLED / REALTIME_DASHBOARD_ONLY / DISABLED DISABLED ENABLEDを指定した場合、StaticWebsiteHosting スタックがデプロイされます。
WebServers ENABLED / SYSTEMS_MANAGER_ONLY / DISABLED DISABLED ENABLEDを指定した場合、WebServers スタックがデプロイされます。