Code cleanup and docs refactor

Author: ricardosllm

DO_NOT_AUTOTEST

@@ -35,6 +35,18 @@ The domain for the static site (i.e. mystaticsite.com) must be configured as a h
 npm install
 ```
 
+### Create GitHub token
+
+Follow the instructions [here](https://docs.aws.amazon.com/codepipeline/latest/userguide/GitHub-authentication.html) and make sure to use the `CLI` instructions
+as you need a `personal access token` to authenticate with `cdk`
+
+### Upload your github token to SSM
+
+Once you have your token you have to upload it to ssm (preferably in the
+same region as the stack). 
+
+> Make sure to use the `plaintext` option and NOT the key value pair.
+
 ### Create AWS Service Role
 
 You need to create a service role that both `cloudformation` and `codebuild` 
@@ -70,19 +82,34 @@ Here's an example for the trust relationship policy:
 }
 ```
 
+> Once you have the value above edit [index.ts](./index.ts) with the required values
+
+### [optional] Context
+
+Edit [cdk.json](./cdk.json) with your `domain` and `subdomain`
+
 ## Build
 
 ```
 npm run build
 ```
 
-## Deploy
+## Deploy the Pipeline
 
 ```
 ./node_modules/.bin/cdk deploy --profile <your_aws_profile>
 ```
 
-> Optionally provide which stack to deploy
+> The static site is deployed automatically after a git commit 
+> Make sure you trigger the pipeline after the deployment
+
+
+## Test the Pipeline
+
+Edit [site-contents/index.html](./site-contents/index.html) and commit the changes
+Then go to your subdomain.domain and see the changes deployed. 
+
+> you can see the progress of the pipeline in the AWS Code Pipeline console
 
 ---
 

README.md

@@ -1,7 +1,7 @@
 {
   "app": "node index",
   "context": {
-    "domain": "ginienterprise-dev.com",
-    "subdomain": "test-cdk"
+    "domain": "mystaticsite.com",
+    "subdomain": "www"
   }
 }

cdk.json

@@ -3,17 +3,26 @@ import cdk = require('@aws-cdk/core');
 import { StaticSite } from './static-site';
 import { Pipeline } from './pipeline';
 
+// Configuration
+const appName = 'MyStaticSite'
+//   aws
+const awsAccount = '';
+const awsRegion = 'us-east-1'
+const awsServiceRoleName = 'ServiceRoleCloudFormationAdminAccess'
+//   github token
+const sourceToken = 'github-token-xxxxx'
+
 const app = new cdk.App();
 
 /**
  * This stack relies on getting the domain name from CDK context.
- * Use 'cdk synth -c domain=mystaticsite.com -c subdomain=www -c account=account_id'
+ * Use 'cdk synth -c domain=mystaticsite.com -c subdomain=www'
  * Or add the following to cdk.json:
  * {
  *   "context": {
  *     "domain": "mystaticsite.com",
  *     "subdomain": "www",
- *     "account": "aws_account_id"
+ *     "account": "awsAccount_id"
  *   }
  * }
  **/
@@ -33,20 +42,20 @@ class PipelineStack extends cdk.Stack {
     super(parent, name, props);
 
     new Pipeline(this, 'Pipeline', {
-      sourceToken: 'github-token-ricardosllm',
-      cfnTemplate: 'MyStaticSite.template.json',
-      serviceRole: 'arn:aws:iam::191560372108:role/ServiceRoleCloudFormationAdminAccess'
+      sourceToken,
+      cfnTemplate: appName + '.template.json',
+      serviceRole: 'arn:aws:iam::' + awsAccount + ':role/' + awsServiceRoleName
     });
   }
 }
 
-new MyStaticSiteStack(app, 'MyStaticSite', {
-  env: { region: 'us-east-1', account: '191560372108' }
+new MyStaticSiteStack(app, appName, {
+  env: { region: awsRegion, account: awsAccount }
 
 });
 
 new PipelineStack(app, 'PipelineMyStaticSite', {
-  env: { region: 'us-east-1', account: '191560372108' }
+  env: { region: awsRegion, account: awsAccount }
 })
 
 app.synth();