Simple Container

Simple and fast work with the Docker container.

Installation

npm install --save simple-container

Using

A simple example:

import Container from 'simple-container';

var container = new Container();

/* Create the container */
container.create('hello-world:latest');

/* Start the container */
container.start();

/* Stop and destroy the container */
container.destroy();

Remote connection

By default, the local service is used.

For example, if you want to use connection settings:

var container = new Container({
    host: '127.0.0.1',
    port: 3000
});

Examples and details in the documentation.

Creating a container

You can create a container in two ways.

A simple way - to specify the name of the image:

container.create('hello-world:latest');

Another way - to provide an object with parameters:

container.create({
    Image: 'postgres:alpine',
    Env: ['POSTGRES_PASSWORD = password'],
    Ports: [{
        IP: '0.0.0.0',
        PrivatePort: 5432,
        PublicPort: 5432,
        Type: 'tcp'
    }]
});

Examples and details in the documentation.

An additional example of obtaining a private image:

var auth = {
    username: 'username',
    password: 'password',
    email: 'email@example.org',
    serveraddress: 'https://index.docker.io/v1'
};

container.create({
    Image: 'project:latest',
    authconfig: auth
});

Details in the documentation.

Debugging

Use the DEBUG variable with the container option.

Result of output:

$ DEBUG="container" node ./example.js
  container { status: 'Pulling from library/postgres', id: 'alpine' } +0ms
  container { status: 'Already exists',
  container   progressDetail: {},
  container   id: '019300c8a437' } +0ms
  container { status: 'Pulling fs layer',
  container   progressDetail: {},
  container   id: '885fa9f8b950' } +0ms
...

License

MIT. Copyright (c) Valentin Popov.