get.porter.sh/porter@v1.3.0/README.md (about)

     1  <img align="right" src="docs/static/images/porter-docs-header.svg" width="300px" />
     2  
     3  [![CNCF Sandbox Project](docs/static/images/cncf-sandbox-badge.svg)](https://www.cncf.io/projects/porter/)
     4  [![porter](https://github.com/getporter/porter/actions/workflows/porter.yml/badge.svg?branch=main&event=push)](https://github.com/getporter/porter/actions/workflows/porter.yml)
     5  <a href="https://porter.sh/find-issue" alt="Find an issue to work on">
     6  <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>
     7  [![OpenSSF Best Practices](https://www.bestpractices.dev/projects/8720/badge)](https://www.bestpractices.dev/projects/8720)
     8  
     9  # Porter
    10  
    11  Package your application, client tools, configuration, and deployment logic into an installer that you can distribute and run with a single command.
    12  Based on the Cloud Native Application Bundle Specification, [CNAB](https://deislabs.io/cnab), Porter provides a declarative authoring experience that lets you focus on what you know best: your application.
    13  
    14  <p align="center">Learn all about Porter at <a href="https://porter.sh">porter.sh</a></p>
    15  
    16  # <a name="mixins"></a>Porter Mixins
    17  
    18  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.
    19  
    20  [Porter Mixins](https://porter.sh/mixins/) are available for below platform's:
    21  
    22  | Platform                                                                                                                                                                                                                        | Supported?  |
    23  | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------: |
    24  | <img src="docs\static\images\mixins\docker_icon.png" width="20" height="20" vertical-align="middle" /> [Docker](https://porter.sh/mixins/docker/)                                            |     ✔️      |
    25  | <img src="docs\static\images\mixins\docker-compose.png" width="20" height="20" vertical-align="middle" /> [Docker-Compose](https://porter.sh/mixins/docker-compose/)            |     ✔️      |
    26  | <img src="docs\static\images\mixins\kubernetes.svg" width="20" height="20" vertical-align="middle" /> [Kubernetes](https://porter.sh/mixins/kubernetes/)            |     ✔️      |
    27  | <img src="docs\static\images\mixins\helm.svg" width="20" height="20" vertical-align="middle" /> [Helm](https://porter.sh/mixins/helm/)            |     ✔️      |
    28  | <img src="docs\static\images\mixins\gcp.png" width="20" height="20" vertical-align="middle" /> [GCloud](https://porter.sh/mixins/gcloud/)            |     ✔️      |
    29  | <img src="docs\static\images\mixins\terraform_icon.png" width="20" height="20" vertical-align="middle" /> [Terraform](https://porter.sh/mixins/terraform/)            |     ✔️      |
    30  | <img src="docs\static\images\mixins\aws.svg" width="20" height="20" vertical-align="middle" /> [aws](https://porter.sh/mixins/aws/)            |     ✔️      |
    31  | <img src="docs\static\images\plugins\azure.png" width="20" height="20" vertical-align="middle" /> [Azure](https://porter.sh/mixins/azure/)            |     ✔️      |
    32  | <img src="docs\static\images\mixins\exec.png" width="20" height="20" vertical-align="middle" /> [exec](https://porter.sh/mixins/exec/)            |     ✔️      |
    33  
    34  # <a name="Plugins"></a>Porter Plugins
    35  
    36  Plugins let you store Porter's data and retrieve secrets from an external service.
    37  
    38  [Porter Plugins](https://porter.sh/plugins/) are available for below platform's:
    39  
    40  | Platform                                                                                                                                                                                                                        | Supported?  |
    41  | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :---------: |
    42  | <img src="docs\static\images\plugins\hashicorp.png" width="20" height="20" vertical-align="middle" /> [Hashicorp](https://porter.sh/plugins/hashicorp/)                                            |     ✔️      |
    43  | <img src="docs\static\images\plugins\azure.png" width="20" height="20" vertical-align="middle" /> [Azure](https://porter.sh/plugins/azure/)            |     ✔️      |
    44  | <img src="docs\static\images\mixins\kubernetes.svg" width="20" height="20" vertical-align="middle" /> [Kubernetes](https://porter.sh/plugins/kubernetes/)            |     ✔️      |
    45  
    46  
    47  # Contact
    48  
    49  * [Mailing List] - Great for following the project at a high level because it is
    50    low traffic, mostly release notes and blog posts on new features.
    51  * [Forum] - Share an idea or propose a design where everyone can benefit from
    52    the discussion and find answers to questions later.
    53  * [Dev Meeting] - Biweekly meeting where we discuss [Porter Enhancement Proposals], demo new features and help other contributors.
    54  * [Open an Issue] - If you are having trouble or found a bug, ask on GitHub so
    55    that we can prioritize it and make sure you get an answer.
    56  * [Slack] - We have a #porter channel and there's also #cnab for deep thoughts
    57    about the CNAB specification.
    58  
    59  [Mailing List]: https://porter.sh/mailing-list
    60  [Slack]: https://porter.sh/community/#slack
    61  [Open an Issue]: https://github.com/getporter/porter/issues/new/choose
    62  [Forum]: https://porter.sh/forum/
    63  [Dev Meeting]: https://porter.sh/community/#dev-meeting
    64  [Porter Enhancement Proposals]: https://porter.sh/docs/contribute/proposals/
    65  
    66  # Looking for Contributors
    67  
    68  Want to work on Porter with us? 💖 We are actively seeking out new contributors
    69  with the hopes of building up both casual contributors and enticing some of you
    70  into becoming reviewers and maintainers.
    71  
    72  <p align="center">Start with our <a href="https://porter.sh/docs/contribute/">New Contributors Guide</a>
    73  
    74  Porter wouldn't be possible without our [contributors][contributors], carrying
    75  the load and making it better every day! 🙇‍♀️
    76  
    77  [contributors]: /CONTRIBUTORS.md
    78  
    79  # Do you use Porter?
    80  
    81  Take our [user survey](https://porter.sh/user-survey) and let us know if you are using Porter.
    82  Project funding is contingent upon knowing that we have active users!
    83  
    84  # Roadmap
    85  
    86  Porter is an open-source project and things get done as quickly as we have
    87  motivated contributors working on features that interest them. 😉
    88  
    89  We use a single [project board][board] across all of our repositories to track
    90  open issues and pull requests.
    91  
    92  The roadmap represents what the maintainers have said that they are
    93  currently working on and plan to work on over the next few months. We use the
    94  "on-hold" bucket to communicate items of interest that do not have a
    95  maintainer who will be working on them.
    96  
    97  <p align="center">Check out our <a href="https://porter.sh/roadmap">roadmap</a></p>
    98  
    99  [board]: https://porter.sh/board
   100  [version strategy]: https://porter.sh/project/version-strategy/