README.md

builder-bootcamp-nodejs-starter-kit

Requirements

• AWS CLI already configured with Administrator permission
• Git installed and configured
• NodeJS 12+ installed
• Docker installed

Initial setup & deployment

Prepare the infrastructure

1. Create an S3 bucket

aws s3 mb s3://bootcamp-starter-kit-$USER

Note: For Windows environments, you may use the following powershell command

aws s3 mb s3://bootcamp-starter-kit-$env:UserName

2. Deploy the infrastructure

make infra

Note: For Windows envirnonments, you may use the following powershell command

cd .\infrastructure\ && ./deploy.ps1

Deploy the application

1. Add a new git remote and point it at the CodeCommit repo created by make infra

git remote add codecommit <codecommit-clone-url-http>

2. Push your changes and the pipeline should kick off a build

git push -u codecommit main

Local development

Please refer to the troubleshooting section for help with setting up authentication and authorization

Run unit tests

1. Run the unit tests

make test

2. Hope they work!

Start the local dev server

1. Install npm dependencies

npm install

2. Start up the dev server

make dev

3. Write code, it will be automatically recompiled on save.

4. Test your work at the address returned

Running the Swagger editor

1. Start the service

make swagger-start

2. Point your browser to http://0.0.0.0:8080

3. When done, stop the service

make swagger-stop

Troubleshooting

If you face the The requested URL returned error: 403 error while performing git operations:

1. Check if your AWS account user being used has the following 3 permissions:

   1. AWSCodeCommitFullAccess
   2. AWSCodeCommitPowerUser
   3. AWSCodeCommitReadOnly

2. Make sure git credentials are setup properly as described here