/continous_integration-deployment

Intro to Continuous Integration / Continuous Deployment

Primary LanguageShellMIT LicenseMIT

Intro to CI/CD 💻 ☁️

TLDR; This repository is a sample project demonstrating a basic continuous integration (CI) / continuous deployment (CD) setup. This project is in READ ONLY mode.

Continuous Deployment Workflow Continuous Integration Workflow Code scanning

Project structure

# You can generate this tree with:
# $ tree -a -I '.git|assets|.github|venv|node_modules|images|.DS_Store|*.tfvars|.terraform'
.
├── .gitignore
├── CODEOWNERS
├── LICENSE
├── README.md
├── infra
│   ├── README.md
│   └── instances
│       ├── production
│       │   ├── .terraform.lock.hcl
│       │   ├── main.tf
│       │   └── terraform.auto.tfvars.example
│       └── staging
│           ├── .terraform.lock.hcl
│           ├── create_staging_resource.sh
│           ├── extra_staging.tf.example
│           ├── main.tf
│           └── terraform.tfvars.auto.example
└── web
    ├── README.md
    ├── app.js
    ├── bin
    │   └── www
    ├── package-lock.json
    ├── package.json
    ├── public
    │   ├── javascripts
    │   └── stylesheets
    │       └── style.css
    ├── routes
    │   ├── index.js
    │   └── users.js
    ├── tests
    │   ├── app.test.js
    │   └── routes.test.js
    └── views
        ├── error.jade
        ├── index.jade
        └── layout.jade

12 directories, 26 files
  • infra/images: contains Packer template to build our AWS EC2 AMI
  • infra/instances: contains our Terraform templates to setup our staging and production EC2 instances
  • web: contains our simple Express web application

Setup

Configure your GitHub repository to run the workflows

Click to expand
  1. Navigate to the Settings in your repository then to Environments 37EE1AFF-BDBC-405E-8D43-672E09CA87D5

  2. Add a new environment and call it staging (or anything else you like) F1BC0A94-3BB5-4409-B057-6E6FC241C78A

  3. Enable required reviewers and add your secrets 085BF9C1-552E-46C5-91D0-687A9634A885

  4. Enable branch protection on the main branch 2E8B02F5-CD8E-40C1-B03C-5FD7074C1C77 955A1F29-D628-46C4-86A4-8F614A712CFF

Test your setup

  1. Create a new branch from the main branch and make some changes to the app
  2. Push the new branch to GitHub
  3. Watch the CI workflow being triggered
  4. Troubleshoot issues as they rise