Home

Awesome

<img align="right" src="docs/static/images/porter-docs-header.svg" width="300px" />

CNCF Sandbox Project porter <a href="https://porter.sh/find-issue" alt="Find an issue to work on"> <img src="https://img.shields.io/github/issues-search?label=%22help%20wanted%22%20issues&query=org%3Agetporter%20label%3A%22good%20first%20issue%22%2C%22help%20wanted%22%20no%3Aassignee" /></a> OpenSSF Best Practices

Porter

Package your application, client tools, configuration, and deployment logic into an installer that you can distribute and run with a single command. Based on the Cloud Native Application Bundle Specification, CNAB, Porter provides a declarative authoring experience that lets you focus on what you know best: your application.

<p align="center">Learn all about Porter at <a href="https://porter.sh">porter.sh</a></p>

<a name="mixins"></a>Porter Mixins

Mixins provide out-of-the-box support for interacting with different tools and services from inside a bundle. You can always create a mixin, or use the exec mixin and a Custom Dockerfile if a custom mixin doesn't exist yet.

Porter Mixins are available for below platform's:

PlatformSupported?
<img src="docs\static\images\mixins\docker_icon.png" width="20" height="20" vertical-align="middle" /> Docker✔️
<img src="docs\static\images\mixins\docker-compose.png" width="20" height="20" vertical-align="middle" /> Docker-Compose✔️
<img src="docs\static\images\mixins\kubernetes.svg" width="20" height="20" vertical-align="middle" /> Kubernetes✔️
<img src="docs\static\images\mixins\helm.svg" width="20" height="20" vertical-align="middle" /> Helm✔️
<img src="docs\static\images\mixins\gcp.png" width="20" height="20" vertical-align="middle" /> GCloud✔️
<img src="docs\static\images\mixins\terraform_icon.png" width="20" height="20" vertical-align="middle" /> Terraform✔️
<img src="docs\static\images\mixins\aws.svg" width="20" height="20" vertical-align="middle" /> aws✔️
<img src="docs\static\images\plugins\azure.png" width="20" height="20" vertical-align="middle" /> Azure✔️
<img src="docs\static\images\mixins\exec.png" width="20" height="20" vertical-align="middle" /> exec✔️

<a name="Plugins"></a>Porter Plugins

Plugins let you store Porter's data and retrieve secrets from an external service.

Porter Plugins are available for below platform's:

PlatformSupported?
<img src="docs\static\images\plugins\hashicorp.png" width="20" height="20" vertical-align="middle" /> Hashicorp✔️
<img src="docs\static\images\plugins\azure.png" width="20" height="20" vertical-align="middle" /> Azure✔️
<img src="docs\static\images\mixins\kubernetes.svg" width="20" height="20" vertical-align="middle" /> Kubernetes✔️

Contact

Looking for Contributors

Want to work on Porter with us? 💖 We are actively seeking out new contributors with the hopes of building up both casual contributors and enticing some of you into becoming reviewers and maintainers.

<p align="center">Start with our <a href="https://porter.sh/docs/contribute/">New Contributors Guide</a>

Porter wouldn't be possible without our contributors, carrying the load and making it better every day! 🙇‍♀️

Do you use Porter?

Take our user survey and let us know if you are using Porter. Project funding is contingent upon knowing that we have active users!

Roadmap

Porter is an open-source project and things get done as quickly as we have motivated contributors working on features that interest them. 😉

We use a single project board across all of our repositories to track open issues and pull requests.

The roadmap represents what the maintainers have said that they are currently working on and plan to work on over the next few months. We use the "on-hold" bucket to communicate items of interest that do not have a maintainer who will be working on them.

<p align="center">Check out our <a href="https://porter.sh/roadmap">roadmap</a></p>