mongodb-ci-checker v1.0.4

mongodb-ci-checker

The MongoDB CI Checker checks whether the GitHub CI workflow test environments use the latests MongoDB versions.

Content

• Installation
• Configuration
  • Example
• Need help?

Installation

1. Install package:

   npm install --save-dev mongodb-ci-checker

2. Add script to package.json:

   "scripts": {
     "mongodb:ci:checker": "node ./node_modules/mongodb-ci-checker/lib",
     ...
   },

3. Add task to GitHub CI workflow YAML file:

   mongodb-ci-checker:
     name: MongoDB CI Checker
     timeout-minutes: 30
     runs-on: ubuntu-18.04
     steps:
       - uses: actions/checkout@v2
       - uses: actions/setup-node@v1
         with:
           node-version: 10
     - name: Install dependencies
       run: npm ci
     - name: Run MongoDB CI Checker
       run: npm run mongodb:ci:checker
       env:
         MONGODB_CI_CHECKER_VERSION_KEY: [...]
         MONGODB_CI_CHECKER_ENV_KEY_PATH: [...]
         MONGODB_CI_CHECKER_YAML_PATH: [...]
         MONGODB_CI_CHECKER_IGNORE_VERSIONS: [...]

Configuration

The check is configured via environment variables in the GitHub workflow YAML file:

Example

This is an example configuration, where for each of the test environments the MongoDB CI Checker will ensure that the MONGODB_VERSION set as environment variable is the latest available patch version and there are environments that cover all recent MongoDB versions.

name: CI
on: push
jobs:
  mongodb-ci-checker:
    name: MongoDB CI Checker
    timeout-minutes: 30
    runs-on: ubuntu-18.04
    steps:
    - name: Checkout branch
        uses: actions/checkout@v2
    - name: Set-up node
        uses: actions/setup-node@v1
        with:
          node-version: 10
    - name: Install dependencies
        run: npm ci
    - name: Run MongoDB CI Checker
        run: npm run mongodb:ci:checker
        env:
          MONGODB_CI_CHECKER_VERSION_KEY: 'MONGODB_VERSION'
          MONGODB_CI_CHECKER_ENV_KEY_PATH: 'jobs.tests.strategy.matrix.include'
          MONGODB_CI_CHECKER_YAML_PATH: './github/workflow/ci.yaml'
          MONGODB_CI_CHECKER_IGNORE_VERSIONS: '["~4.7.0"]'
  tests:
    strategy:
      matrix:
        include:
          - name: Test Environment Mongo 4.4
            MONGODB_VERSION: 4.4.3
          - name: Test Environment Mongo 4.2
            MONGODB_VERSION: 4.2.12
          - name: Test Environment Mongo 4.0
            MONGODB_VERSION: 4.0.22
    name: ${{ matrix.name }}
    env:      
      MONGODB_VERSION: ${{ matrix.MONGODB_VERSION }}
    timeout-minutes: 30
    runs-on: ubuntu-18.04
    steps:
      steps:
      - name: Checkout branch
        uses: actions/checkout@v2
      - name: Set-up node
        uses: actions/setup-node@v1
        with:
          node-version: 10
      - name: Install dependencies
        run: npm ci
      - name: Run tests
        run: npm test

As defined above, the tests will be executed in environments with the following MongoDB versions:

• 4.4.3
• 4.2.12
• 4.0.22

The MongoDB CI Check will fail, if:

• There is a newer MongoDB patch version available, such as 4.4.4, 4.2.13 or 4.0.23.
• There is a newer MongoDB minor version available, such as 4.5.x.
• There is a newer MongoDB major version available, such as 5.x.x.

The MongoDB CI Check will not fail, if:

• There is a newer MongoDB version 4.7.x available because it is excluded in MONGODB_CI_CHECKER_IGNORE_VERSIONS.
• There is no environment defined with a MongoDB version <4.0.0 because versions below the smallest defined minor version 4.0.22 are automatically ignored.

Note:

• Available MongoDB pre-release versions such as release candidates (x.y.z-rc0) or alpha/beta versions (x.y.z-alpha01) are ignored.

Need help?

• Ask on StackOverflow using the mongodb tag.
• Search through existing issues or open a new issue.