https://github.com/0-vortex/eclass-docker-fork
Opinionated fork of @eclass/semantic-release-docker with minimal features
https://github.com/0-vortex/eclass-docker-fork
Last synced: 5 months ago
JSON representation
Opinionated fork of @eclass/semantic-release-docker with minimal features
- Host: GitHub
- URL: https://github.com/0-vortex/eclass-docker-fork
- Owner: 0-vortex
- License: mit
- Created: 2021-12-01T18:24:58.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2021-12-03T20:47:30.000Z (over 4 years ago)
- Last Synced: 2025-01-30T18:16:06.323Z (over 1 year ago)
- Language: JavaScript
- Size: 1.11 MB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# eclass-docker-fork
[](https://www.npmjs.com/package/eclass-docker-fork)
[](https://www.npmjs.com/package/eclass-docker-fork)
[](https://david-dm.org/eclass/semantic-release-docker)
[](https://david-dm.org/eclass/semantic-release-docker#info=devDependencies)
[](https://coveralls.io/github/eclass/semantic-release-docker?branch=master)
[](https://codeclimate.com/github/eclass/semantic-release-docker/maintainability)
[](https://github.com/semantic-release/semantic-release)
> [semantic-release](https://github.com/semantic-release/semantic-release) plugin to tag and push docker images
| Step | Description |
| ------------------ | -------------------------------------------------------------------------------------- |
| `verifyConditions` | Verify the presence of the `baseImageName`, and `registries` options in plugin config. |
| `prepare` | Tag docker images. |
| `publish` | Push docker images. |
## Install
```bash
npm i -D eclass-docker-fork
```
## Usage
The plugin can be configured in the [**semantic-release** configuration file](https://github.com/semantic-release/semantic-release/blob/caribou/docs/usage/configuration.md#configuration):
```json
{
"plugins": [
"@semantic-release/changelog",
"@semantic-release/npm",
"@semantic-release/git",
"@semantic-release/gitlab",
"eclass-docker-fork"
]
}
```
## Configuration
### Options
#### Config
| Variable | Description |
| ---------------- | ----------- |
| `baseImageName` | Name of the previously constructed docker image. Required. |
| `registries` | Array of [Registry](#registry) objects. Required. Example: {"user": "DOCKER_USER", "password": "DOCKER_PASSWORD", "url": "docker.pkg.github.com", "imageName": "docker.pkg.github.com/myuser/myrepo/myapp"} |
| `additionalTags` | Array of additional tags to push. Optional. Example: `["beta", "next"]` |
#### Registry
| Variable | Description |
| ---------------- | ----------- |
| url | Url of the docker registry. Required. Example: `"docker.pkg.github.com"` |
| imageName | Name of the docker image. Required. Example: `"docker.pkg.github.com/myuser/myrepo/myapp"` |
| user | Name of the environment variable used as user name for login to the docker registry. Required. Example: `"DOCKER_USER"` |
| password | Name of the environment variable used as password for login to the docker registry. Required. Example: `"DOCKER_PASSWORD"` |
| skipTags | Array of image tags that should not be pushed to the docker registry. Optional. Example: `["latest"]` |
### Environment variables
Environment variables are variables. Depends of `registries` option.
| Variable | Description |
| ----------------------- | ----------------------------- |
| `DOCKER_USER` | username for docker registry. |
| `DOCKER_PASSWORD` | password for docker registry. |
### Examples
Push images to many docker registry
```json
{
"plugins": [
"@semantic-release/changelog",
"@semantic-release/npm",
"@semantic-release/git",
"@semantic-release/gitlab",
[
"eclass-docker-fork",
{
"baseImageName": "myapp",
"registries": [
{
"url": "registry.gitlab.com",
"imageName": "registry.gitlab.com/mygroup/myapp",
"user": "CI_REGISTRY_USER",
"password": "CI_REGISTRY_PASSWORD"
},
{
"url": "docker.io",
"imageName": "docker.io/myuser/myapp",
"user": "DOCKER_REGISTRY_USER",
"password": "DOCKER_REGISTRY_PASSWORD"
},
{
"url": "docker.pkg.github.com",
"imageName": "docker.pkg.github.com/myuser/myrepo/myapp",
"user": "GITHUB_USER",
"password": "GITHUB_TOKEN"
},
{
"url": "123456789012.dkr.ecr.us-east-1.amazonaws.com",
"imageName": "123456789012.dkr.ecr.us-east-1.amazonaws.com/myapp",
"user": "AWS_DOCKER_USER",
"password": "AWS_DOCKER_PASSWORD",
"skipTags": ["latest"]
}
],
"additionalTags": ["next", "beta"]
}
]
]
}
```
```yml
# .gitlab-ci.yml
release:
image: node:alpine
stage: release
before_script:
- docker build -t myapp .
script:
- npx semantic-release
only:
- master
```
```yml
# .travis.yml
language: node_js
cache:
directories:
- ~/.npm
node_js:
- '12'
stages:
- test
- name: deploy
if: branch = master
jobs:
include:
- stage: test
script: npm t
- stage: deploy
before_script: docker build -t myapp .
script: npx semantic-release
```
## License
[MIT](https://tldrlegal.com/license/mit-license)