run-container

run a docker container in nodejs

runs a container using dockerode, bootstrapping the pull & start processes, whilst also exposing a compact function to simplify docker's and dockerode's otherwise complex APIs

usage

import { run, runSimple } from 'run-container'

// runSimple, minimal example
const container = await runSimple({ image: 'postgres' }) // => Dockerode.Container instance
await container.remove({ force: true })

// runSimple, rich example
await runSimple({
  autoRemove: true,
  bindMounts: { '/path/to/host/file.sh': '/path/to/container/file.sh' },
  cmd: ['bash', '/path/to/container/file.sh'],
  env: { 'KEY': 'VALUE' },
  image: 'bash',
  name: 'script-fun',
  ports: { '4000': '4000' } // tcp ports only. otherwise, use `run`
})
await container.wait()
await container.remove()

// run
// exposes Dockerodes.ContainerCreateOptions full API,
// which directly reflects the docker engine API!
// https://docs.docker.com/engine/api/latest/
const container = await run({
  Image: 'postgres',
  ExposedPorts: {
    '5432/tcp': {}
  },
  HostConfig: {
    AutoRemove: true,
    PortBindings: { '5432/tcp': [{ HostPort: '40000' }] }
  }
})
// ... do work
await container.remove({ force: true })

see the exported typescript typings in the docs folder, or check out the tiny source.