adamculp / builder-bootcamp-python-starter-kit

builder-bootcamp-python-starter-kit

Requirements

• AWS CLI already configured with Administrator permission
• Git installed and configured
• Python 3.8. You can install this with Pyenv.

  # e.g. to use python 3.8 in the get lambda
  pyenv install 3.8.0
  cd src/get
  pipenv --python ~/.pyenv/versions/3.8.0/bin/python3.8
  

• Pipenv installed
• Docker installed

Initial setup & deployment

Prepare the infrastructure

1. Create an S3 bucket

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

2. Deploy the infrastructure

make infra

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 master

Local development

Requirements

• AWS CLI
• Python 3.8. You can install this with Pyenv.

  # e.g. to use python 3.8 in the get lambda
  pyenv install 3.8.0
  cd src/get
  pipenv --python ~/.pyenv/versions/3.8.0/bin/python3.8
  

• Pipenv installed
• Docker installed

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

pipenv 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

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