AWS CodePipeline Gitflow Demo Service

This is a demo service project to show how to use Gitflow branching model workflow with AWS CodePipeline.

See the Infrastructure Repository for the infrastructure setup.

Table of Contents

• Prerequisites
• Getting Started
• Branching Model
• CI/CD Pipeline

Prerequisites

• Docker
• Node.js
• Taskfile
• git-remote-codecommit

Getting Started

Clone the repository

git clone https://github.com/grigore147/aws-codepipeline-gitflow-service-demo.git

Install dependencies

npm ci

Run the service locally

# This will run the service for current branch
task service:run

# or

# This will run the docker:build task before running the service
task service:run-build

Run the task command to see all available tasks.

After you have made changes to the service, commit and push the changes to the remote CodeCommit repository (the git-remote-codecommit tool may be required depending on the method used).

This will trigger the CI/CD pipeline to build and deploy the service to a related environment.

Branching Model

This project uses the Gitflow Workflow branching model.

CI/CD Pipeline

The CI/CD pipeline is setup using AWS CodePipeline and AWS CodeBuild. The pipeline is triggered on push to on of the branch that follows gitflow branching model.

See the Infrastructure Repository for more details.