Skip to content

Deep Learning on Amazon EC2 Spot Instances without the agonizing pain.

License

Notifications You must be signed in to change notification settings

Coderik/portal-gun

Repository files navigation

Portal Gun

Command line tool that automates routine tasks associated with the management of Spot Instances on Amazon EC2 service.

Primarily it is intended to simplify usage of AWS Spot Instances for Deep Learning. This focus will further shape the future development.

Documentation

Full documentation can be found at http://portal-gun.readthedocs.io.

Installation

It is strongly recommended to install Portal Gun in a virtual Python environment.

To install the latest stable version from the PyPI:

$ pip install -U portal-gun

To install the latest pre-release version from the PyPI:

$ pip install -U portal-gun --pre

Refer to the documentation for details regarding general configuration and portal specification.

Basic Usage

1. Persistent volumes

Use volume group of commands to work with EBS volumes.

Create a new volume:

$ portal volume create

List created volumes:

$ portal volume list

Update previously created volume:

$ portal volume update <Volume-Id> [-n <New-Name>] [-s <New-Size>]

Delete previously created volume:

$ portal volume delete <Volume-Id>

2. Portals

Create draft specification for a new portal:

$ portal init <Portal-Name>

Open a portal (request a new Spot Instance):

$ portal open <Portal-Name>

Connect to the Spot Instance via ssh:

$ portal ssh <Portal-Name>

Connect to the Spot Instance via ssh and attach to a tmux session (session name is optional):

$ portal ssh <Portal-Name> -t [<Session-Name>]

Close opened portal (cancel Spot Instance request):

$ portal close <Portal-Name>

Get information about a portal:

$ portal info <Portal-Name>

3. Channels

Start syncing files across the channels configured for a portal:

$ portal channel <Portal-Name>

License

MIT licensed. See the bundled LICENSE file for details.

About

Deep Learning on Amazon EC2 Spot Instances without the agonizing pain.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published