Sorna Agent

Package Structure

sorna
- agent: The agent daemon implementation

Installation

Sorna Agent requires Python 3.5 or higher. We highly recommend to use pyenv for an isolated setup of custom Python versions that might be different from default installations managed by your OS or Linux distros.

pip install sorna-agent

Due to limitation in current version (9.0.1) of pip, you may encounter errors while installing aiodocker. In that case, run pip install -r requirements.txt and try again.

For development:

We recommend to use an isolated virtual environment. This installs the current working copy and sorna-common as “editable” packages.

git clone https://github.com/lablup/sorna-agent.git
python -m venv venv-sorna
source venv-sorna/bin/activate
pip install -U pip setuptools wheel  # ensure latest versions
pip install -r requirements-dev.txt

Deployment

Running from a command line:

To handle uploads of generated files to AWS S3, you need to set several environment variables. If they are not set, the file upload feature is disabled. Currently we only support S3-based uploads.

export AWS_ACCESS_KEY_ID="..."
export AWS_SECRET_ACCESS_KEY="..."
export AWS_REGION="..."     # e.g., ap-northeast-2
export AWS_S3_BUCKET="..."  # e.g., my-precious-sorna
python -m sorna.agent.server --manager-addr tcp://localhost:5001 --max-kernels 15

For details about arguments, run the server with --help.

Example supervisord config:

[program:sorna-agent]
stopsignal = TERM
stopasgroup = true
command = /home/sorna/run-agent.sh
environment = AWS_ACCESS_KEY_ID="...",AWS_SECRET_ACCESS_KEy="...",AWS_REGION="...",AWS_S3_BUCKET="..."

TCP Port numbers to open against the manager

6001: ZeroMQ-based internal agent control protocol.
The containers will open arbitrary ports for their local 2000-2003 ports for REPL I/O and TTY I/O.

Metadata

Release files for sorna-agent 0.9.14

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sorna-agent 0.9.14
File	Size	Uploaded
sorna-agent-0.9.14.tar.gz	18.6 kB	Aug 30, 2017	Details

Built distribution (wheel)

Table of built distributions (wheels) for sorna-agent 0.9.14
File	Interpreter	ABI	Platform	Reset
sorna_agent-0.9.14-py36-none-any.whl 25.8 kB Aug 30, 2017	Python 3.6	none	any	Details

Total release size: 44.4 kB

Release files / sorna-agent-0.9.14.tar.gz

Download URL	sorna-agent-0.9.14.tar.gz
Size	18.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`7cd80d57b5b3c854961afc289a31eb2066b00eae00d4cc2aef8db4b60797e708`
BLAKE2b-256 checksum How to use checksums	`4821b208cf64d71f37ef149a70795889c995c29a966a3d56ffe8c762fda98cb9`
Upload date	Aug 30, 2017
Uploaded using Trusted Publishing? What is trusted publishing?	No

Release files / sorna_agent-0.9.14-py36-none-any.whl

Download URL	sorna_agent-0.9.14-py36-none-any.whl
Size	25.8 kB
Tags	Python 3.6
SHA-256 checksum How to use checksums	`a99f6742740e375442e1570b12c791fbafc4bb97122afc34bd0e4236e337618b`
BLAKE2b-256 checksum How to use checksums	`74521ccccf04ee96beb13fb26173afc8c087c32c85399e3770b1d536c277cc75`
Upload date	Aug 30, 2017
Uploaded using Trusted Publishing? What is trusted publishing?	No