Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Best practices #664

Merged
merged 3 commits into from Sep 30, 2019
Merged

Best practices #664

merged 3 commits into from Sep 30, 2019

Conversation

carolynvs
Copy link
Member

@carolynvs carolynvs commented Sep 27, 2019

What does this change

This add a best practice section to the docs and kicks it off with two documents and updated examples:

What issue does it fix

Closes #658
Closes #177

Notes for the reviewer

N/A

Checklist

  • Unit Tests
  • Documentation
    • Documentation Not Impacted

@carolynvs
Copy link
Member Author

The "sad hack" that I mention in the GKE docs inspired me to make #663.

Explain how to use porter with minikube and gke
Copy link
Member

@vdice vdice left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM


This is a sample Porter bundle that makes use of both the Kubernetes and Exec mixins. The Kubernetes mixin is used to apply Kubernetes manifests to an existing Kubernetes cluster, creating an NGINX deployment and a service. The Kubernetes mixin is also used to produce an output with the value of the service's ClusterIP. After the kubernetes mixin finishes, the `exec` mixin is ued to echo the cluster IP of the service that was created.

To use this bundle, you will need an existing Kuberentes cluster and a kubeconfig file for use as a credential.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

typo: Kuberentes

@@ -0,0 +1,11 @@
# Kubernetes + Exec Mixin Example

This is a sample Porter bundle that makes use of both the Kubernetes and Exec mixins. The Kubernetes mixin is used to apply Kubernetes manifests to an existing Kubernetes cluster, creating an NGINX deployment and a service. The Kubernetes mixin is also used to produce an output with the value of the service's ClusterIP. After the kubernetes mixin finishes, the `exec` mixin is ued to echo the cluster IP of the service that was created.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

nit: last sentence has lowercase kubernetes as opposed to capitalized precedents -- or perhaps we should quote it a la exec to signify we're referring to the mixin name as used in Porter manifests?

* Fix typo
* Use  mixin
* Use hard line wraps for easier reviews going forward
@carolynvs carolynvs merged commit 8229cb5 into getporter:master Sep 30, 2019
@carolynvs carolynvs deleted the best-practices branch September 30, 2019 18:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Doc how to use gke with porter Add faq for minikube users to embed their certs
3 participants