Kubernetes powered PaaS that runs in your own cloud. https://porter.run

jusrhee 8a8af221ea Merge pull request #68 from porter-dev/staging %!s(int64=5) %!d(string=hai) anos
cli ec13f50b3c postgres wait for healthy %!s(int64=5) %!d(string=hai) anos
cmd 3ca584ab73 init on startup %!s(int64=5) %!d(string=hai) anos
dashboard f6fde1900c cookie error when session does not exist in the db %!s(int64=5) %!d(string=hai) anos
docker 3ca584ab73 init on startup %!s(int64=5) %!d(string=hai) anos
docs 8ee2294c52 graph per release %!s(int64=5) %!d(string=hai) anos
internal 8ee2294c52 graph per release %!s(int64=5) %!d(string=hai) anos
server f6fde1900c cookie error when session does not exist in the db %!s(int64=5) %!d(string=hai) anos
.air.toml e71b846b93 ignore dashboard in air.toml %!s(int64=5) %!d(string=hai) anos
.dockerignore d7b83fb445 onboarding with default sqlite %!s(int64=5) %!d(string=hai) anos
.gitignore e00e0bbf39 gitignore yaml %!s(int64=5) %!d(string=hai) anos
.goreleaser.yml 3056d754fa update goreleaser %!s(int64=5) %!d(string=hai) anos
README.md c35d7ba99b updated readme %!s(int64=5) %!d(string=hai) anos
docker-compose.dev.yaml 9eb5469cc8 yaml in nodes %!s(int64=5) %!d(string=hai) anos
go.mod 8ee2294c52 graph per release %!s(int64=5) %!d(string=hai) anos
go.sum 558c04888a cli generate command %!s(int64=5) %!d(string=hai) anos
package-lock.json 97c6704158 handle specrel in default namespace %!s(int64=5) %!d(string=hai) anos

README.md

Porter

Porter is a dashboard for Helm with support for the following features:

  • Visualization of all Helm releases with filtering by namespace
  • In-depth view of releases, including revision histories and component graphs
  • Rollback/update of existing releases, including editing of values.yaml

What's next for Porter? View our roadmap, or read our mission statement.

Quick Start

To view the dashboard locally, download our CLI and grab the latest release via:

curl "https://api.github.com/repos/porter-dev/porter/releases/latest"
chmod +x ./porter
sudo mv ./porter /usr/local/bin/porter

Then run the dashboard (Docker engine must be running on the host machine):

porter start

When prompted, enter the admin email/password you would like to use. After the server has started, go to localhost:8080 and log in with the credentials you just set.

Differences from Kubeapps

As a disclaimer, we're big fans of Kubeapps, and many of the initial features that we build out will be very similar. Currently, Porter's graph-based chart visualization is the only fundamental difference, and it should be assumed that most Kubeapps features will be supported on Porter in the near future. However, on the feature side, Porter will eventually support:

  • IDE-like tooling for chart creation, templating, and packaging
  • Deep integration with GitOps workflows and CI/CD tools
  • Visualization of lifecycle hooks and robust error tracing for deployments

Mission Statement

kubectl for your fundamental operations. Porter for everything else.

Our mission is to be the go-to tool for interacting with complex Kubernetes deployments as both a beginner and an expert. While our initial focus is on visualizing Helm components, we believe this visualization and editing can be extended to a number of other tools and concepts, including alternative templating tools (kustomize, Terraform), other deployment tools (CI/CD tools, Terraform), Kubernetes package repositories (ChartMuseum, JFrog Artifactory), and even popular Kubernetes packages (nginx-ingress, cert-manager, prometheus, velero).

More specifically, we have the following long-term goals:

  • Design a visual interface for complex deployments and operations
  • Make deployments and operations editable by and accessible for non-Kubernetes experts
  • Improve the development experience for packaging and releasing Kubernetes applications
  • Increase interoperability of Kubernetes tooling without compromising usability

Why did we begin with Helm? Helm is the most popular auxiliary Kubernetes tool, and can function in nearly all parts of deployment lifecycle. We think of the various features of Helm in the following manner, adapted from Brian Grant's Helm Summit talk (slides here): package management, dependency management, application metadata, parameterization, templating, deployment/config revision management, lifecycle management hooks, and application probes. Along with these fundamental features, an expanding number of command plugins for more specific use-cases have started to become popular in the Helm ecosystem. If we can build a better workflow for both application developers and application operators by improving the user experience for most of these Helm features, we can generalize and expand this workflow to support alternative tooling that exists in the Kubernetes application management ecosystem.