Metadata-Version: 2.1
Name: runway
Version: 1.0.0
Summary: Simplify infrastructure/app testing/deployment
Home-page: https://github.com/onicagroup/runway
Author: Onica Group LLC
Author-email: opensource@onica.com
License: Apache License 2.0
Description: Runway
        ======
        
        Runway is a lightweight integration app designed to ease management of
        infrastructure tools.
        
        Its main goals are to encourage GitOps best-practices, avoid convoluted
        Makefiles/scripts (enabling identical deployments from a workstation or
        CI job), and enable developers/admins to use the best tool for any given
        job.
        
        Features
        --------
        
        -  Centralized environment-specific configuration
        -  Automatic environment identification from git branches
        -  Automatic linting/verification
        -  Support of IAM roles to assume for each deployment
        -  Terraform backend/workspace config management w/per-environment
           tfvars
        -  Automatic kubectl/terraform version management per-environment
        
        Supported Deployment Tools
        ~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        -  AWS CDK
        -  Kubectl
        -  Serverless Framework
        -  Stacker (CloudFormation)
        -  Static websites (build & deploy to S3+CloudFront)
        -  Terraform
        
        Example
        -------
        
        A typical Runway configuration is unobtrusive – it just lists the
        deployment order and locations (regions).
        
        ::
        
           deployments:
             - modules:
               - resources.tf  # terraform resources
               - backend.sls  # serverless lambda functions
               - frontend  # static web site
               environments:  # Environment settings
                   dev:
                       foo: dev-bar
                   prod:
                       foo: prod-bar
        
        The example above contains enough information for Runway to deploy all
        resources, lambda functions and a static website backed by S3 and
        Cloudfront in either dev or prod environments
        
        Install
        -------
        
        Runway is available via any of the following installation methods. Use
        whatever works best for your project/team (it’s the same application no
        matter how you obtain it).
        
        HTTPS Download (e.g cURL)
        ~~~~~~~~~~~~~~~~~~~~~~~~~
        
        Use one of the endpoints below to download a single-binary executable
        version of Runway based on your operating system.
        
        +------------------+------------------------------------+
        | Operating System | Endpoint                           |
        +==================+====================================+
        | Linux            | https://oni.ca/runway/latest/linux |
        +------------------+------------------------------------+
        | macOS            | https://oni.ca/runway/latest/osx   |
        +------------------+------------------------------------+
        | Windows          | https://oni.ca/runway/latest/win   |
        +------------------+------------------------------------+
        
        ::
        
           $ curl -L oni.ca/runway/latest/osx -o runway
           $ chmod +x runway
           $ ./runway init
        
        **Suggested use:** CloudFormation or Terraform projects
        
        npm
        ~~~
        
        ::
        
           $ npm i -D @onica/runway
           $ npx runway init
        
        **Suggested use:** Serverless or AWS CDK projects
        
        pip (or pipenv,poetry,etc)
        ~~~~~~~~~~~~~~~~~~~~~~~~~~
        
        ::
        
           $ pip install runway
           $ runway init
           # OR
           $ pipenv install runway
           $ pipenv run runway init
        
        **Suggested use:** Python projects
        
        Documentation
        -------------
        
        See the `doc site <https://docs.onica.com/projects/runway>`__ for full
        documentation.
        
        Quickstart documentation, including CloudFormation templates and
        walkthrough can be found
        `here <https://docs.onica.com/projects/runway/en/latest/quickstart.html>`__
        
Keywords: cli
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Topic :: Utilities
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Requires-Python: >=2.6
Provides-Extra: test
