semantic-release-docker-mini v1.3.0

semantic-release-docker-mini

A semantic-release-plus or semantic-release plugin for publishing a docker images to a docker registry.

Install

npm install semantic-release-docker-mini -D

Usage

1. Build your docker image and tag it with a known name that does not include a registry.
2. Configure the plugin with the same name and specify the registry, if publishing to a registry other than docker.io. The registry to publish can either be defined in the name property, the registry property or the name.registry property.

The plugin can be configured in the semantic-release-plus configuration file:

Configuration

Name

The name field is required and can be either a string or an object, if a string it will be converted into an object using this syntax <registry>/<namespace>/<repo>:<tag> or <registry>/<namespace>/<repo>@<sha>.

{
  "name": {
    "registry": "string", // optional
    "namespace": "string", // optional
    "repository": "string", // required
    "tag": "string", // optional
    "sha": "string" // optional
  }
}

Example Configurations

Consider the image was built and tagged with the following command. The following configurations will result in the same behavior.

docker build -t `my-namespace/my-repo:my-tag` .

{
  "release": {
    "plugins": [
      [
        "semantic-release-docker-mini",
        {
          "name": "ghcr.io/my-namespace/my-repo:my-tag"
        }
      ]
    ]
  }
}

{
  "release": {
    "plugins": [
      [
        "semantic-release-docker-mini",
        {
          "name": "my-namespace/my-repo:my-tag",
          "registry": "ghcr.io"
        }
      ]
    ]
  }
}

{
  "release": {
    "plugins": [
      [
        "semantic-release-docker-mini",
        {
          "name": {
            "registry": "ghcr.io",
            "namespace": "my-namespace",
            "repository": "my-repo",
            "tag": "my-tag"
          }
        }
      ]
    ]
  }
}

The docker commands that will be run with this config are the following when releasing version 1.2.3

docker tag my-namespace/my-repo:my-tag ghcr.io/my-namespace/my-repo:1.2.3
docker tag my-namespace/my-repo:my-tag ghcr.io/my-namespace/my-repo:latest
docker push ghcr.io/my-namespace/my-repo:1.2.3
docker push ghcr.io/my-namespace/my-repo:latest

In the situation where you are adding an existing build to a channel it will pull the existing build from the registry and tag it with the new channel. With the above config and adding build 1.2.4. from the next channel to the latest channel it will run the following commands.

docker pull ghcr.io/my-namespace/my-repo:1.2.4
docker tag ghcr.io/my-namespace/my-repo:1.2.4 ghcr.io/my-namespace/my-repo:latest
docker push ghcr.io/my-namespace/my-repo:latest

Example github action publishing to ghcr.io

The following is an example github action configuration, the source repo can be found at https://github.com/JoA-MoS/srp-docker-example

name: CI

on:
  push:
    branches:
      - master
      - next
      - beta
      - alpha
      - '*.x'
  pull_request:
    types:
      - opened
      - synchronize

jobs:
  build_release:
    runs-on: ubuntu-latest
    steps:
      - name: Build
        uses: actions/checkout@v2
        with:
          fetch-depth: 0
      - run: docker build --tag joa-mos/srp-docker-example .
      - name: Release
        uses: actions/setup-node@v2
        with:
          cache: npm
      - run: npm ci
      - run: npx semantic-release-plus
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          DOCKER_USERNAME: joa-mos
          DOCKER_PASSWORD: ${{ secrets.DOCKER_PASSWORD }}

Example .travis.yml

jobs:
  include:
    - stage: release
      language: node_js
      node_js: '8'
      services:
        - docker
      script:
        - docker build -t namespace/repository .
        - npm run semantic-release-plus

stages:
  - test
  - name: release
    if: branch = master AND type = push AND fork = false

branches:
  except:
    - /^v\d+\.\d+\.\d+$/

Circle CI Example .config.yml

version: 2
jobs:
  release:
    docker:
      - image: circleci/node:8
    steps:
      - setup_remote_docker:
          docker_layer_caching: true
      - run:
          name: release
          command: |
            docker build -t namespace/repository .
            npm run semantic-release-plus

workflows:
  version: 2
  pipeline:
    jobs:
      - test
      - release:
          requires:
            - test
          filters:
            branches:
              only: master

Note that setup_remote_docker step is required for this plugin to work in Circle CI environment

How to keep new version in package.json inside docker image?

It is best to let semantic-release focus on releasing your built artifact and not extend semantic-release to also do the build. I recommend using semantic-release-plus to get the next version without creating a tag then using that durning your build process. An example of this can be found in the semantic-release-plus Expected next version recipe.

Publishing to multiple registries

You should be able to publish to multiple registries by adding the docker plugin multiple times with different registry configurations. You will need to login to the registries outside of the plugin and configure the plugin to skip login (unless you happen to have the same username and password between different registries)