@codedependant/semantic-release-docker 3.1.1

package/CHANGELOG.md

@@ -0,0 +1,90 @@
+# Semantic Release Docker
+
+## [3.1.1](https://github.com/esatterwhite/semantic-release-docker/compare/v3.1.0...v3.1.1) (2021-09-18)
+
+
+### Documentation
+
+* corrected the parameter - dockerFile [81e9319](https://github.com/esatterwhite/semantic-release-docker/commit/81e9319e7dae9905cf098a5b2c3a9837d4f5d1d9) - Eric Satterwhite
+
+# [3.1.0](https://github.com/esatterwhite/semantic-release-docker/compare/v3.0.1...v3.1.0) (2021-04-12)
+
+
+### Features
+
+* **lib**: parse tags array from string [27d078b](https://github.com/esatterwhite/semantic-release-docker/commit/27d078b2bbd1f8881f2a4c390b50ac6d384e40f4) - Eric Satterwhite
+
+## Changelog
+
+## [3.0.1](https://github.com/esatterwhite/semantic-release-docker/compare/v3.0.0...v3.0.1) (2021-04-09)
+
+
+### Bug Fixes
+
+* **docker**: honor absolute paths to docker file [723257b](https://github.com/esatterwhite/semantic-release-docker/commit/723257b705e83ed8d951673e5ab5f4ef7d75b437) - Eric Satterwhite
+
+# [3.0.0](https://github.com/esatterwhite/semantic-release-docker/compare/v2.2.0...v3.0.0) (2021-04-08)
+
+
+### Chores
+
+* **deps**: eslint-config-codedependant [dbe464e](https://github.com/esatterwhite/semantic-release-docker/commit/dbe464ebf7ca571ffe0430f67085d30a291f828d) - Eric Satterwhite
+* **deps**: release-config-npm@1.0.1 [98b1a88](https://github.com/esatterwhite/semantic-release-docker/commit/98b1a880ef213abb49af9f9bd5fcff6d13729c21) - Eric Satterwhite
+
+
+### Features
+
+* **config**: allow templated build arguments [7167dcf](https://github.com/esatterwhite/semantic-release-docker/commit/7167dcf9aba8f554e2ccb9d42209fce3ec86d3e3) - Eric Satterwhite
+* **config**: unnest config values from docker property [2087683](https://github.com/esatterwhite/semantic-release-docker/commit/2087683edfaf66825544ba2eb95eb8c6be533658) - Eric Satterwhite
+
+
+### **BREAKING CHANGES**
+
+* **config:** Flatten the docker config option for semantic relase into the root
+config. Semantic release doesn't do a very good job of merging options
+that are coming from a sharable configuration. This makes it easier to
+utilize overrides when using a sharable config. Options are camel cased
+using the docker root word prefix
+`docker.args` -> `dockerArgs`
+`docker.login` -> `dockerLogin`
+
+# Semantic Release Docker
+
+# [2.2.0](https://github.com/esatterwhite/semantic-release-docker/compare/v2.1.0...v2.2.0) (2020-12-21)
+
+
+### Features
+
+* **verify:** add option to opt out of docker login ([de17169](https://github.com/esatterwhite/semantic-release-docker/commit/de17169897965d197ed51b0aeff2e06d29157c99))
+
+# [2.1.0](https://github.com/esatterwhite/semantic-release-docker/compare/v2.0.2...v2.1.0) (2020-08-06)
+
+
+### Features
+
+* **docker:** Load default build args into docker build ([0760d5e](https://github.com/esatterwhite/semantic-release-docker/commit/0760d5e73560a4bddbadb5a849f7574522c503fc))
+
+## [2.0.2](https://github.com/esatterwhite/semantic-release-docker/compare/v2.0.1...v2.0.2) (2020-08-05)
+
+## [2.0.1](https://github.com/esatterwhite/semantic-release-docker/compare/v2.0.0...v2.0.1) (2020-07-28)
+
+# [2.0.0](https://github.com/esatterwhite/semantic-release-docker/compare/v1.0.1...v2.0.0) (2020-07-28)
+
+
+### Features
+
+* **pkg:** update to trigger a release ([acefb13](https://github.com/esatterwhite/semantic-release-docker/commit/acefb13697ca64723efd90ea0c7f3b5e5a8a5106))
+
+## [1.0.1](https://github.com/esatterwhite/semantic-release-docker/compare/v1.0.0...v1.0.1) (2020-07-26)
+
+
+### Bug Fixes
+
+* **lib:** fixes a bug in build config that would miss project config ([51b60c1](https://github.com/esatterwhite/semantic-release-docker/commit/51b60c12f8954c2cb59bb78a276529acc08fb8ea))
+
+# 1.0.0 (2020-07-24)
+
+
+### Features
+
+* **pkg:** initial implementation ([4a4dead](https://github.com/esatterwhite/semantic-release-docker/commit/4a4dead685892ecf89e900f3b6f7979c69fc440e))

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 Eric Satterwhite
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,184 @@
+# @codedependant/semantic-release-docker
+
+[![semantic-release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg)](https://github.com/semantic-release/semantic-release)
+[![MIT license](https://img.shields.io/npm/l/@codedependant/semantic-release-docker.svg)](https://www.npmjs.com/package/@codedependant/semantic-release-docker)
+
+A [semantic-release](https://github.com/semantic-release/semantic-release) plugin to use semantic versioning for docker images.
+
+## Supported Steps
+
+### verifyConditions
+
+verifies that environment variables for authentication via username and password are set.
+It uses a registry server provided via config or environment variable (preferred) or defaults to docker hub if none is given.
+It also verifies that the credentials are correct by logging in to the given registry.
+
+### prepare
+
+builds a an image using the specified docker file and context. This image will be used to create tags in later steps
+
+### publish
+
+pushes the tags Images with specified tags and pushes them to the registry.
+Tags support simple templating. Values enclosed in braces `{}` will be subsititued with release context information
+
+## Installation
+
+Run `npm i --save-dev @codedependant/semantic-release-docker` to install this semantic-release plugin.
+
+## Configuration
+
+### Docker registry authentication
+
+The `docker registry` authentication set via environment variables. It is not required, and if
+omitted, it is assumed the docker daemon is already authenticated with the targe registry.
+
+### Environment variables
+
+| Variable                 | Description                                                                               |
+| ------------------------ | ----------------------------------------------------------------------------------------- |
+| DOCKER_REGISTRY_USER     | The user name to authenticate with at the registry.                                       |
+| DOCKER_REGISTRY_PASSWORD | The password used for authentication at the registry.                                     |
+
+### Options
+
+| Option                | Description                                                                                                                                 | Default
+| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | --------
+| `dockerTags`          | _Optional_. An array of strings allowing to specify additional tags to apply to the image. Supports templating                              | [`latest`, `{major}-latest`, `{version}`]                     |
+| `dockerImage`         | _Optional_. The name of the image to release.                                                                                               | Parsed from package.json `name` property                      |
+| `dockerRegistry`      | _Optional_. The hostname and port used by the the registry in format `hostname[:port]`. Omit the port if the registry uses the default port | `null` (dockerhub)                                            |
+| `dockerProject`       | _Optional_. The project or repository name to publish the image to                                                                          | For scoped packages, the scope will be used, otherwise `null` |
+| `dockerFile`    | _Optional_. The path, relative to `$PWD` to a Docker file to build the target image with                                                    | `Dockerfile`                                                  |
+| `dockerContext`       | _Optional_. A path, relative to `$PWD` to use as the build context A                                                                        | `.`                                                           |
+| `dockerLogin`         | _Optional_. Set to false it by pass docker login if the docker daemon is already authorized                                                 | `true`                                                        |
+| `dockerArgs`          | _Optional_. Include additional values for docker's `build-arg`. Supports templating                                                         |                                                               |
+| `dockerPublish`       | _Optional_. Automatically push image tags during the publish phase.                                                                         | `true`                                                        |
+
+### Build Arguments
+
+By default several build arguments will be included when the docker images is being built.
+Build arguments can be templated in the same fashion as docker tags. If the value for a
+build argument is explictly `true`, the value will be omitted and the value from
+a matching environment variable will be utilized instead. This can be usefule when trying to include
+secrets and other sensitive information
+
+| Argument Name       | Description                                                                                | Default                      |
+|---------------------|--------------------------------------------------------------------------------------------|------------------------------|
+| `SRC_DIRECTORY`     | The of the directory the build was triggered from                                          | The directory name of CWD    |
+| `TARGET_PATH`       | Path relative to the execution root. Usefule for Sharing a Single Docker file in monorepos |                              |
+| `NPM_PACKAGE_NAME`  | The `name` property extracted from `package.json` - if present                             |                              |
+| `NPM_PACKAGE_SCOPE` | The parsed scope from the `name` property from `package.json` - sans `@`                   |                              |
+| `CONFIG_NAME`       | The configured name of the docker image.                                                   | The parsed package name      |
+| `CONFIG_PROJECT`    | The configured docker repo project name                                                    | The package scope if present |
+| `GIT_SHA`           | The commit SHA of the current release                                                      |                              |
+| `GIT_TAG`           | The git tag of the current release                                                         |                              |
+
+### Template Variables
+
+String template will be passed these
+
+| Variable name  | Description                                                        | Type     |
+|----------------|--------------------------------------------------------------------|----------|
+| `git_sha`      | The commit SHA of the current release                              | `String` |
+| `git_tag`      | The git tag of the current release                                 | `String` |
+| `release_type` | The severity type of the current build (`major`, `minor`, `patch`) | `String` |
+| `relase_notes` | The release notes blob associated with the release                 | `String` |
+| `next`         | Semver object representing the next release                        | `Object` |
+| `previous`     | Semver object representing the previous release                    | `Object` |
+| `major`        | The major version of the next release                              | `Number` |
+| `minor`        | The minor version of the next release                              | `Number` |
+| `patch`        | The patch version of the next release                              | `Number` |
+| `env`          | Environment variables that were set at build time                  | `Object` |
+| `pkg`          | Values parsed from `package.json`                                  | `Object` |
+| `build`        | A Random build hash representing the current execution context     | `String` |
+| `now`          | Current timestamp is ISO 8601 format                               | `String` |
+
+## Usage
+
+**full configuration**:
+
+```javascript
+// release.config.js
+
+module.exports = {
+  branches: ['main']
+  plugins: [
+    ['@codedependant/semantic-release-docker', {
+      dockerTags: ['latest', '{version}', '{major}-latest', '{major}.{minor}'],
+      dockerImage: 'my-image',
+      dockerFile: 'Dockerfile',
+      dockerRegistry: 'quay.io',
+      dockerProject: 'codedependant',
+      dockerArgs: {
+        API_TOKEN: true
+      , RELEASE_DATE: new Date().toISOString()
+      , RELEASE_VERSION: '{next.version}'
+      }
+    }]
+  ]
+}
+```
+
+results in `quay.io/codedependant/my-image` with tags `latest`, `1.0.0`, `1-latest` and the `1.0` determined by `semantic-release`.
+
+Alternatively, using global options w/ root configuration
+```json5
+// package.json
+{
+  "name": "@codedependant/test-project"
+  "version": "1.0.0"
+  "release": {
+    "extends": "@internal/release-config-docker",
+    "dockerTags": ["latest", "{version}", "{major}-latest", "{major}.{minor}"],
+    "dockerImage": "my-image",
+    "dockerFile": "Dockerfile",
+    "dockerRegistry": "quay.io",
+    "dockerArgs": {
+      "GITHUB_TOKEN": true
+    , "SOME_VALUE": '{git_sha}'
+    }
+  }
+}
+```
+
+This would generate the following for a `1.2.0` build
+
+```shell
+$ docker build -t quay.io/codedependant/my-image --build-arg GITHUB_TOKEN --build-arg SOME_VALUE=6eada70 -f Dockerfile .
+$ docker tag <SHA1> latest
+$ docker tag <SHA1> 1.2.0
+$ docker tag <SHA1> 1.2
+$ docker tag <SHA1> 1-latest
+$ docker push quay.io/codedependant/my-image
+```
+
+**minimum configuration**:
+
+```json
+{
+  "release": {
+    "plugins": [
+      "@codedependant/semantic-release-docker"
+    ]
+  }
+}
+```
+
+* A package name `@codedependant/test-project` results in docker project name`codedependant` and image name `test-project`
+* A package name `test-project` results in a docker image name `test-project`
+
+the default docker image tags for the 1.0.0 release would be `1.0.0`, `1-latest`, `latest`
+
+## Development
+
+### Docker Registry
+
+To be able to push to the local registry with auth credentials, ssl certificates are required.
+This project uses self signed certs. To regenerate the certs run the following:
+
+```bash
+$ openssl req -new -newkey rsa:2048 -days 365 -nodes -x509 -keyout server.key -out server.crt
+```
+
+**NOTE**: When prompted for an FQDN it must be `registry:5000`
+**NOTE**: The credentials for the local registry are **user:** `iamweasel`, **pass:** `secretsquirrel`

package/index.js

@@ -0,0 +1,28 @@
+'use strict'
+
+const crypto = require('crypto')
+const dockerPrepare = require('./lib/prepare.js')
+const dockerVerify = require('./lib/verify.js')
+const dockerPublish = require('./lib/publish.js')
+const buildConfig = require('./lib/build-config.js')
+const build_id = crypto.randomBytes(10).toString('hex')
+
+module.exports = {
+  prepare
+, publish
+, verifyConditions
+, buildConfig
+}
+
+async function prepare(config, context) {
+  return dockerPrepare(await buildConfig(build_id, config, context), context)
+}
+
+async function publish(config, context) {
+  return dockerPublish(await buildConfig(build_id, config, context), context)
+}
+
+async function verifyConditions(config, context) {
+  return dockerVerify(await buildConfig(build_id, config, context), context)
+}
+

package/lib/build-config.js

@@ -0,0 +1,63 @@
+'use strict'
+
+const path = require('path')
+const readPkg = require('./read-pkg.js')
+const object = require('./lang/object/index.js')
+const array = require('./lang/array/index.js')
+const parsePkgName = require('./parse-pkg-name.js')
+const PWD = '.'
+
+module.exports = buildConfig
+
+async function buildConfig(build_id, config, context) {
+  const {
+    dockerFile: dockerfile = 'Dockerfile'
+  , dockerNoCache: nocache = false
+  , dockerTags: tags = ['latest', '{major}-latest', '{version}']
+  , dockerArgs: args = {}
+  , dockerRegistry: registry = null
+  , dockerLogin: login = true
+  , dockerImage: image
+  , dockerPublish: publish = true
+  } = config
+
+  let name = null
+  let scope = null
+  let pkg = {}
+  try {
+    pkg = await readPkg({cwd: context.cwd})
+    const parsed = parsePkgName(pkg.name)
+    name = parsed.name
+    scope = parsed.scope
+  } catch (_) {}
+
+  const project = object.has(config, 'dockerProject') ? config.dockerProject : scope
+  const root = object.get(context, 'options.root')
+  const target = path.relative(root || context.cwd, context.cwd) || PWD
+  const {nextRelease = {}} = context
+  return {
+    registry
+  , dockerfile
+  , nocache
+  , pkg
+  , project
+  , publish
+  , tags: array.toArray(tags)
+  , args: {
+      SRC_DIRECTORY: path.basename(context.cwd)
+    , TARGET_PATH: target
+    , NPM_PACKAGE_NAME: object.get(pkg, 'name')
+    , NPM_PACKAGE_SCOPE: scope
+    , CONFIG_NAME: image || name
+    , CONFIG_PROJECT: project
+    , GIT_SHA: nextRelease.gitHead || ''
+    , GIT_TAG: nextRelease.gitTag || ''
+    , ...(args || {})
+    }
+  , name: image || name
+  , build: build_id
+  , login: login
+  , env: context.env
+  , context: config.context || '.'
+  }
+}

package/lib/build-template-vars.js

@@ -0,0 +1,28 @@
+'use strict'
+
+const semver = require('semver')
+const now = new Date().toISOString()
+
+module.exports = buildTemplateVars
+
+function buildTemplateVars(opts, context) {
+  const {nextRelease = {}, lastRelease = {}} = context
+
+  const versions = {
+    next: semver.parse(nextRelease.version) || {}
+  , previous: semver.parse(lastRelease.version) || {}
+  }
+
+  const {tags: _, ...rest} = opts
+  return {
+    ...versions.next
+  , ...versions
+  , ...nextRelease
+  , ...rest
+  , git_tag: nextRelease.gitTag
+  , git_sha: nextRelease.gitHead
+  , release_type: nextRelease.type
+  , release_notes: nextRelease.notes
+  , now: now
+  }
+}

package/lib/docker/image.js

@@ -0,0 +1,127 @@
+'use strict'
+
+const path = require('path')
+const crypto = require('crypto')
+const execa = require('execa')
+
+class Image {
+  constructor(opts) {
+    const {
+      registry = null
+    , project = null
+    , name = null
+    , sha = null
+    , build_id = crypto.randomBytes(10).toString('hex')
+    , dockerfile = 'Dockerfile'
+    , cwd = process.cwd()
+    , context = '.'
+    } = opts || {}
+
+    if (!name || typeof name !== 'string') {
+      const error = new TypeError('Docker Image "name" is required and must be a string')
+      throw error
+    }
+
+    this.sha = sha
+    this.opts = {
+      args: new Map()
+    , registry: registry
+    , project: project
+    , name: name
+    , build_id: build_id
+    , dockerfile: dockerfile
+    , context: context
+    , cwd: cwd
+    }
+  }
+
+  get id() {
+    if (this.sha) return this.sha
+    return `${this.opts.name}:${this.opts.build_id}`
+  }
+
+  get repo() {
+    const parts = []
+    if (this.opts.registry) parts.push(this.opts.registry)
+    if (this.opts.project) parts.push(this.opts.project)
+    parts.push(this.opts.name)
+    return parts.join('/')
+  }
+
+  get name() {
+    return `${this.repo}:${this.opts.build_id}`
+  }
+
+  get context() {
+    return this.opts.context
+  }
+
+  set context(ctx) {
+    this.opts.context = ctx
+    return this.opts.context
+  }
+
+  get dockerfile() {
+    return path.resolve(this.opts.cwd, this.opts.dockerfile)
+  }
+
+  arg(key, val) {
+    this.opts.args.set(key, val)
+    return this
+  }
+
+  get build_cmd() {
+    const args = []
+    for (const [name, value] of this.opts.args.entries()) {
+      if (value === true || value == null) { // eslint-disable-line no-eq-null
+        args.push('--build-arg', name)
+      } else {
+        args.push('--build-arg', `${name}=${value}`)
+      }
+    }
+    const cmd = [
+      'build'
+    , '--quiet'
+    , '--tag'
+    , this.name
+    , ...args
+    , '-f'
+    , this.dockerfile
+    , this.context
+    ]
+    return cmd
+  }
+
+  async build() {
+    const stream = execa('docker', this.build_cmd)
+    stream.stdout.pipe(process.stdout)
+    stream.stderr.pipe(process.stderr)
+    const {stdout} = await stream
+    const [_, sha] = stdout.split(':')
+    this.sha = sha.substring(0, 12)
+    return this.sha
+  }
+
+  async tag(tag, push = true) {
+    await execa('docker', ['tag', this.name, `${this.repo}:${tag}`])
+    if (!push) return
+
+    const stream = execa('docker', ['push', `${this.repo}:${tag}`])
+    stream.stdout.pipe(process.stdout)
+    stream.stderr.pipe(process.stderr)
+    await stream
+  }
+
+  async push() {
+    await execa('docker', ['push', this.repo])
+  }
+
+  async clean() {
+    const images = execa('docker', ['images', this.repo, '-q'])
+    const rm = execa('xargs', ['docker', 'rmi', '-f'])
+    images.stdout.pipe(rm.stdin)
+    return rm
+  }
+}
+
+module.exports = Image

package/lib/docker/index.js

@@ -0,0 +1,5 @@
+'use strict'
+
+module.exports = {
+  Image: require('./image.js')
+}

package/lib/lang/array/index.js

@@ -0,0 +1,5 @@
+'use strict'
+
+module.exports = {
+  toArray: require('./to-array.js')
+}

package/lib/lang/array/to-array.js

@@ -0,0 +1,9 @@
+'use strict'
+
+const CSV_SEP_EXP = /\s*,\s*/
+module.exports = function toArray(item, sep = CSV_SEP_EXP) {
+  if (!item) return []
+  if (item instanceof Set) return Array.from(item)
+  if (Array.isArray(item)) return item
+  return typeof item === 'string' ? item.split(sep) : [item]
+}

package/lib/lang/object/get.js

@@ -0,0 +1,18 @@
+'use strict'
+
+module.exports = getProperty
+
+function getProperty(obj, str, sep = '.') {
+  if (!obj || !str) return null
+  const parts = str.split(sep)
+  let ret = obj
+  const last = parts.pop()
+  let prop
+
+  /* eslint-disable no-cond-assign */
+  while (prop = parts.shift()) {
+    ret = ret[prop]
+    if (ret === null || ret === undefined) return ret
+  }
+  return ret[last]
+}

package/lib/lang/object/has.js

@@ -0,0 +1,8 @@
+'use strict'
+
+module.exports = hasProperty
+
+function hasProperty(obj, prop) {
+  if (!obj) return false
+  return Object.prototype.hasOwnProperty.call(obj, prop)
+}

package/lib/lang/object/index.js

@@ -0,0 +1,6 @@
+'use strict'
+
+module.exports = {
+  get: require('./get.js')
+, has: require('./has.js')
+}

package/lib/lang/string/index.js

@@ -0,0 +1,5 @@
+'use strict'
+
+module.exports = {
+  template: require('./template.js')
+}

package/lib/lang/string/template.js

@@ -0,0 +1,14 @@
+'use strict'
+const object = require('../object/index.js')
+
+module.exports = template
+
+function template(str) {
+  return function interpolate(values) {
+    if (typeof str !== 'string') return str
+    return str.replace(/{([^{}]*)}/g, function(original, parsed) {
+      const result = object.get(values, parsed)
+      return typeof result === 'string' || typeof result === 'number' ? result : original
+    })
+  }
+}

package/lib/parse-pkg-name.js

@@ -0,0 +1,12 @@
+'use strict'
+
+const NAME_EXP = /^(?:@([^/]+?)[/])?([^/]+?)$/
+
+module.exports = parsePkgName
+
+function parsePkgName(pkgname) {
+  if (!pkgname) return {scope: null, name: null}
+  const [_, scope = null, name = null] = (NAME_EXP.exec(pkgname) || [])
+  return {scope, name}
+}
+

package/lib/prepare.js

@@ -0,0 +1,34 @@
+'use strict'
+
+const path = require('path')
+const docker = require('./docker/index.js')
+const buildTemplateVars = require('./build-template-vars.js')
+const string = require('./lang/string/index.js')
+
+module.exports = dockerPrepare
+
+async function dockerPrepare(opts, context) {
+  const {cwd} = context
+  const image = new docker.Image({
+    registry: opts.registry
+  , project: opts.project
+  , name: opts.name
+  , dockerfile: opts.dockerfile
+  , build_id: opts.build
+  , cwd: cwd
+  })
+
+  const args = {
+    ...opts.args
+  }
+
+  const vars = buildTemplateVars(opts, context)
+  for (const [key, value] of Object.entries(args)) {
+    image.arg(key, string.template(value)(vars))
+  }
+
+  context.logger.info('building image', image.name)
+  context.logger.debug('build command: docker %s', image.build_cmd.join(' '))
+  await image.build(path.join(cwd, opts.context))
+  return image
+}