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
- CFNgin (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: # Environments
dev: "123456789012" # AWS development Account ID
prod: "234567890123" # AWS production Account ID
regions:
- us-east-1
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
$ pip install runway
$ runway new
# OR
$ poetry add --dev runway
$ poetry run runway new
Documentation
See the doc site for full documentation.
Quickstart documentation, including CloudFormation templates and walkthrough can be found here
2 maintainers
Metadata
2 maintainers
Release files for runway 2.8.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| runway-2.8.4.tar.gz | 548.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| runway-2.8.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.3 MB
Release files / runway-2.8.4.tar.gz
| Download URL | runway-2.8.4.tar.gz |
|---|---|
| Size | 548.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3cd549863db52ab7f535b1250a137f11275e8f9ea677a58ead3b4a897595ede6
|
|
BLAKE2b-256 checksum How to use checksums |
54a691237e1245988e41a7d23a03feb14105cc1942fcb29a357989fb8cad2f5b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 10, 2025.
Transparency logRelease files / runway-2.8.4-py3-none-any.whl
| Download URL | runway-2.8.4-py3-none-any.whl |
|---|---|
| Size | 764.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
54d7524b633c17fbd05554308b07dc607cd5ab5550d15077e603d2ca3f1ef995
|
|
BLAKE2b-256 checksum How to use checksums |
7ef51a4e0e9b030cafa68278a75dd27cf7eebbe247b4b043d452712482208f8d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.12.8
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Jul 10, 2025.
Transparency log
