Run locally and deploy an example project in AWS - BIBSYSDEV/pipeline-builder GitHub Wiki

Deploying a sample project in AWS Code Pipeline

Requirements:

  1. You have an AWS account
  2. You have installed and configured the AWS CLI client on your PC
  3. You have access to the example project.
    • If you do not belong to the BIBSYSDEV group, you can fork the project

In the following, we assume that we will be using the original sample project. If you have forked it, then you should replace the occurrences of "BIBSYSDEV" with the correct account name.

Steps:

  1. Navigate to your AWS account

    • Add an API key for reading from Github as described here

  2. Clone the Pipeline Builder to a folder (e.g pipeline-builder)

  3. Build the project

  4. Run the command: python run.py BIBSYSDEV pipeline-builder-sample-projects master create <awsRegion>

    where: awsRegion: an AWS region, such as eu-west-1

  5. In AWS CloudFormation, you should be able to see the stack that will build the pipeline

  6. After the pipeline stack has been created, go to CodePipelines and select the newly created pipeline

  7. After completion of the test or the final stage (or, in fact, any other time) run the following command: python run.py BIBSYSDEV pipeline-builder-sample-project master delete <awsRegion>

  8. In CloudFormation, you can watch the generated stacks being deleted

Notes:

  • The command run.py takes the following arguments:
    1. Github owner account
    2. Repository name
    3. The branch we want to deploy
    4. "create" or "delete"
    5. AWS Region.
⚠️ **GitHub.com Fallback** ⚠️