Metadata-Version: 1.2
Name: sorna-agent
Version: 0.9.14
Summary: Sorna agent
Home-page: https://github.com/lablup/sorna-agent
Author: Lablup Inc.
Author-email: joongi@lablup.com
License: LGPLv3
Description: 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 <https://github.com/yyuu/pyenv>`_ for an isolated setup of custom Python
        versions that might be different from default installations managed by your OS
        or Linux distros.
        
        .. code-block:: sh
        
           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.
        
        .. code-block:: sh
        
           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.
        
        .. code-block:: sh
        
           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:
        ~~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        .. code-block:: dosini
        
           [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.
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Operating System :: POSIX
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Environment :: No Input/Output (Daemon)
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Software Development
Requires-Python: >=3.6
