README
¶
Porter
Porter is a Kubernetes-powered PaaS that runs in your own cloud provider. Porter brings the Heroku experience to your own AWS/GCP account, while upgrading your infrastructure to Kubernetes. Get started on Porter without the overhead of DevOps and customize your infrastructure later when you need to.
Community and Updates
For help, questions, or if you just want a place to hang out, join our Discord community.
To keep updated on our progress, please watch the repo for new releases (Watch > Custom > Releases) and follow us on Twitter!
Why Porter?
A PaaS that grows with your applications
A traditional PaaS like Heroku is great for minimizing unnecessary DevOps work but doesn't offer enough flexibility as your applications grow. Custom network rules, resource constraints, and cost are common reasons developers move their applications off Heroku beyond a certain scale.
Porter brings the simplicity of a traditional PaaS to your own cloud provider while preserving the configurability of Kubernetes. Porter is built on top of a popular Kubernetes package manager helm and is compatible with standard Kubernetes management tools like kubectl, preparing your infra for mature DevOps work from day one.
Features
Basics
- One-click provisioning of a Kubernetes cluster in your own cloud console
- ✅ AWS
- ✅ GCP
- ✅ Digital Ocean
- Simple deploy of any public or private Docker image
- Auto CI/CD with buildpacks for non-Dockerized apps
- Heroku-like GUI to monitor application status, logs, and history
- Application rollback to previously deployed versions
- Zero-downtime deploy and health checks
- Monitor CPU, RAM, and Network usage per deployment
- Marketplace for one click add-ons (e.g. MongoDB, Redis, PostgreSQL)
DevOps Mode
For those who are familiar with Kubernetes and Helm:
- Connect to existing Kubernetes clusters that are not provisioned by Porter
- Visualize, deploy, and configure Helm charts via the GUI
- User-generated form overlays for managing
values.yaml - In-depth view of releases, including revision histories and component graphs
- Rollback/update of existing releases, including editing of raw
values.yaml
Docs
Below are instructions for a quickstart. For full documentation, please visit our official Docs.
Getting Started
-
Sign up and log into Porter Dashboard.
-
Create a Project and put in your cloud provider credentials. Porter will automatically provision a Kubernetes cluster in your own cloud. It is also possible to link up an existing Kubernetes cluster.
-
🚀 Deploy your applications from a git repository or Docker image registry.
Running Porter Locally
While it requires a few additional steps, it is possible to run Porter locally. Follow this guide to run the local version of Porter.
Want to Help?
We welcome all contributions. If you're interested in contributing, please read our contributing guide and join our Discord community.
Directories
¶
| Path | Synopsis |
|---|---|
|
api
|
|
|
server/authz/policy
Package policy provides methods for parsing RBAC policies to determine if a user has access to a given resource.
|
Package policy provides methods for parsing RBAC policies to determine if a user has access to a given resource. |
|
cli
|
|
|
cmd
|
|
|
app
command
|
|
|
dev
command
|
|
|
docker-credential-porter
command
|
|
|
migrate
command
|
|
|
ready
command
|
|
|
internal
|
|
|
auth/sessionstore
Package sessionstore is a postgresql backend implementation of gorilla/sessions Session interface, based on antonlindstrom/pgstore.
|
Package sessionstore is a postgresql backend implementation of gorilla/sessions Session interface, based on antonlindstrom/pgstore. |
|
services
|
|
|
deploy_init_container
command
|
|
|
cli_install_script_container
module
|
|
|
preview_env_setup_job
module
|