@aircall/ci-scripts

CI Scripts

Centralize CircleCI scripts for all project

Usage

Install release management on a CircleCI project

Add the prerelease job in the .circleci/config.yml file of your project

1. Add a node executor if you don't already have one, to run the script.

executors:
  (...)
  node:
    docker:
      - image: circleci/node:10.11.0

1. Add the prerelease job.

jobs:
  (...)
  create-prerelease:
    executor: node
    steps:
      - run:
          name: Create pre-release
          command: npx @aircall/ci-scripts prerelease

1. Use the job in a workflow.

workflows:
  version: 2
  commit-workflow:
    jobs:
      (...)
      - create-prerelease:
          requires:
            - {job_name}

Add the release job

jobs:
  (...)
  convert-release:
    executor: node
    steps:
      - run:
          name: Convert pre-release to release
          command: npx @aircall/ci-scripts release --from-prerelease

Use the node executor and insert the job in a workflow just like for the prerelease job.

Mandatory environments variables

Add JIRA_BASE_URL and GITHUB_CREDENTIALS env vars in CircleCI.

Authorize GitHub deployment account in your project

Authorize our deployment Github account to access to your GitHub project as a Collaborator: https://github.com/{username}/{project}/settings/collaboration

Features

Check running jobs

Verify if there is an ongoing Workflow on CircleCI, and if there is one, make a pause. This script is particularly usefull when run on deployment jobs, to ensure no overlapping deployment is possible.

npx ci-scripts check-running-jobs

Launch Jenkins End-to-end tests

This will launch a test suite on a Jenkins instance with the Parameterized Build plugin. The script then watches the queue, waits for the test suite to end and notifies on Slack if the test suite fails.

npx ci-scripts e2e-tests

Create a GitHub draft release

Create a release draft with a generated changelog based on merged Pull Requests from the last release to the CircleCI Workflow current commit.

npx ci-scripts draft

Create a GitHub prerelease or release

If there is no draft: Create a prerelease/release with a generated changelog based on merged Pull Requests from the last release to the CircleCI Workflow current commit.

If there is a draft: Convert the draft into a prerelease/release. If the draft is on a different target commit that the release, The draft will be converted with only the needed changelog for the prerelease/release, and another draft will be created with the changelog diff.

npx ci-scripts prerelease

npx ci-scripts release

Same as above, but the changelog will be generated from the last release to the last merged Pull Request

npx ci-scripts prerelease --to-last-commit

npx ci-scripts release --to-last-commit

Create the prerelease/release on an existing tag, based on CIRCLE_TAG

npx ci-scripts prerelease --from-circle-ci-tag

npx ci-scripts release --from-circle-ci-tag

Convert a GitHub pre-release as a release

npx ci-scripts release --from-prerelease

Generate the changelog output (display only)

npx ci-scripts changelog

Generate the next version based on the diff (display only)

npx ci-scripts next_version

Post a Slack Deployment Notification

jobs:
  slack-notify:
    executor: node
    parameters:
      env:
        type: string
      channel:
        type: string
    steps:
      - *restore-workspace
      - run: npx @aircall/ci-scripts notify-slack << parameters.env >> << parameters.channel >>

workflows:
  version: 2
  build-deploy:
    jobs:
      - checkout-install-dependencies
      - slack-notify:
        requires: [checkout-install-dependencies]
        filters: *branch-filter
        env: staging
        channel: aircall-xyz