An open API service indexing awesome lists of open source software.

https://github.com/guildai/_guild-docker-legacy

Legacy code Guild's Docker support
https://github.com/guildai/_guild-docker-legacy

Last synced: 4 months ago
JSON representation

Legacy code Guild's Docker support

Awesome Lists containing this project

README

          

# Docker support for Guild AI

This project is a preliminary implementation of Docker image/container
support for Guild AI. It is currently structured to build from Guild
source (see https://github.com/guildai/guild) and generates a local
Docker image. Operations are defined in `Makefile`.

## Preparation

Clone both the Guild source and this Docker project:

```
$ git clone https://github.com/guildai/guild.git
$ git clone https://github.com/guildai/guild-docker.git
```

## Creating Docker image

Change into the Docker project and run `make`:

```
$ cd guild-docker
$ make VERSION=XXX
```

where `XXX` is the version of Guild to generate. This value should
correspond to the current working code in the Guild source project. If
you are on an untagged commit in the Guild source, use a shortened
version of the git commit.

This command will create a release of Guild using the specified
version and then create the Docker image.

## Running Guild from the Docker image

In the Docker project, run:

```
$ make run
```

This will start the Docker container for Guild and attach your
console. From there you can run Guild commands.

For example, to train the MNIST example:

```
$ git clone https://github.com/guildai/guild-examples.git
$ cd guild-examples/mnist2
$ guild prepare
$ guild train
```

## Opening another bash session to the Docker container

To open another bash session in an running container, run:

```
$ make attach
```

From this session you can run other Guild commands such as `guild
view`.

## Stopping a container

Simply exit from all connected sessions to stop the container. Note
that this will not delete the container. To delete a stopped container
you must use `docker rm CONTAINER-ID`. Use `docker ps -a` to list all
containers along with their IDs.

## Starting a stopped container

To start a stopped container, run:

```
$ make start
```