Merge pull request #305 from vmware-tanzu/buildpack-commands

Add buildpack and clusterbuildpack commands

Author: chenbh

docs/kp.md

@@ -20,7 +20,9 @@ Learn more about kpack @ https://github.com/pivotal/kpack
 
 * [kp build](kp_build.md)	 - Build Commands
 * [kp builder](kp_builder.md)	 - Builder Commands
+* [kp buildpack](kp_buildpack.md)	 - Buildpack Commands
 * [kp clusterbuilder](kp_clusterbuilder.md)	 - ClusterBuilder Commands
+* [kp clusterbuildpack](kp_clusterbuildpack.md)	 - ClusterBuildpack Commands
 * [kp clusterstack](kp_clusterstack.md)	 - ClusterStack Commands
 * [kp clusterstore](kp_clusterstore.md)	 - ClusterStore Commands
 * [kp completion](kp_completion.md)	 - Generate completion script

docs/kp_buildpack.md

@@ -0,0 +1,20 @@
+## kp buildpack
+
+Buildpack Commands
+
+### Options
+
+```
+  -h, --help   help for buildpack
+```
+
+### SEE ALSO
+
+* [kp](kp.md)	 - 
+* [kp buildpack create](kp_buildpack_create.md)	 - Create a buildpack
+* [kp buildpack delete](kp_buildpack_delete.md)	 - Delete a buildpack
+* [kp buildpack list](kp_buildpack_list.md)	 - List available buildpacks
+* [kp buildpack patch](kp_buildpack_patch.md)	 - Patch an existing buildpack configuration
+* [kp buildpack save](kp_buildpack_save.md)	 - Create or patch a buildpack
+* [kp buildpack status](kp_buildpack_status.md)	 - Display status of a buildpack
+

docs/kp_buildpack_create.md

@@ -0,0 +1,44 @@
+## kp buildpack create
+
+Create a buildpack
+
+### Synopsis
+
+Create a buildpack by providing command line arguments.
+The buildpack will be created only if it does not exist in the provided namespace.
+
+The namespace defaults to the kubernetes current-context namespace.
+
+```
+kp buildpack create <name> --image <image> [flags]
+```
+
+### Examples
+
+```
+kp buildpack create my-buildpack --image gcr.io/paketo-buildpacks/java
+kp buildpack create my-buildpack --image gcr.io/paketo-buildpacks/java:8.9.0
+kp buildpack create my-buildpack --image gcr.io/paketo-buildpacks/java@sha256:fc1c6fba46b582f63b13490b89e50e93c95ce08142a8737f4a6b70c826c995de
+
+```
+
+### Options
+
+```
+      --dry-run                  perform validation with no side-effects; no objects are sent to the server.
+                                   The --dry-run flag can be used in combination with the --output flag to
+                                   view the Kubernetes resource(s) without sending anything to the server.
+  -h, --help                     help for create
+  -i, --image string             registry location where the buildpack is located
+  -n, --namespace string         kubernetes namespace
+      --output string            print Kubernetes resources in the specified format; supported formats are: yaml, json.
+                                   The output can be used with the "kubectl apply -f" command. To allow this, the command
+                                   updates are redirected to stderr and only the Kubernetes resource(s) are written to stdout.
+                                   The APIVersion of the outputted resources will always be the latest APIVersion known to kp (currently: v1alpha2).
+      --service-account string   service account name to use (default "default")
+```
+
+### SEE ALSO
+
+* [kp buildpack](kp_buildpack.md)	 - Buildpack Commands
+

docs/kp_buildpack_delete.md

@@ -0,0 +1,32 @@
+## kp buildpack delete
+
+Delete a buildpack
+
+### Synopsis
+
+Delete a buildpack in the provided namespace.
+
+The namespace defaults to the kubernetes current-context namespace.
+
+```
+kp buildpack delete <name> [flags]
+```
+
+### Examples
+
+```
+kp buildpack delete my-buildpack
+kp buildpack delete -n my-namespace other-buildpack
+```
+
+### Options
+
+```
+  -h, --help               help for delete
+  -n, --namespace string   kubernetes namespace
+```
+
+### SEE ALSO
+
+* [kp buildpack](kp_buildpack.md)	 - Buildpack Commands
+

docs/kp_buildpack_list.md

@@ -0,0 +1,32 @@
+## kp buildpack list
+
+List available buildpacks
+
+### Synopsis
+
+Prints a table of the most important information about the available buildpacks in the provided namespace.
+
+The namespace defaults to the kubernetes current-context namespace.
+
+```
+kp buildpack list [flags]
+```
+
+### Examples
+
+```
+kp buildpack list
+kp buildpack list -n my-namespace
+```
+
+### Options
+
+```
+  -h, --help               help for list
+  -n, --namespace string   kubernetes namespace
+```
+
+### SEE ALSO
+
+* [kp buildpack](kp_buildpack.md)	 - Buildpack Commands
+

docs/kp_buildpack_patch.md

@@ -0,0 +1,41 @@
+## kp buildpack patch
+
+Patch an existing buildpack configuration
+
+### Synopsis
+
+Patch an existing buildpack configuration by providing command line arguments.
+
+The namespace defaults to the kubernetes current-context namespace.
+
+```
+kp buildpack patch <name> [flags]
+```
+
+### Examples
+
+```
+kp buildpack patch my-buildpack --image gcr.io/paketo-buildpacks/java
+kp buildpack patch my-buildpack --service-account my-other-sa
+```
+
+### Options
+
+```
+      --dry-run                  perform validation with no side-effects; no objects are sent to the server.
+                                   The --dry-run flag can be used in combination with the --output flag to
+                                   view the Kubernetes resource(s) without sending anything to the server.
+  -h, --help                     help for patch
+  -i, --image string             registry location where the buildpack is located
+  -n, --namespace string         kubernetes namespace
+      --output string            print Kubernetes resources in the specified format; supported formats are: yaml, json.
+                                   The output can be used with the "kubectl apply -f" command. To allow this, the command
+                                   updates are redirected to stderr and only the Kubernetes resource(s) are written to stdout.
+                                   The APIVersion of the outputted resources will always be the latest APIVersion known to kp (currently: v1alpha2).
+      --service-account string   service account name to use
+```
+
+### SEE ALSO
+
+* [kp buildpack](kp_buildpack.md)	 - Buildpack Commands
+

docs/kp_buildpack_save.md

@@ -0,0 +1,44 @@
+## kp buildpack save
+
+Create or patch a buildpack
+
+### Synopsis
+
+Create or patch a buildpack by providing command line arguments.
+The buildpack will be created only if it does not exist in the provided namespace, otherwise it will be patched.
+
+No defaults will be assumed for patches.
+
+The namespace defaults to the kubernetes current-context namespace.
+
+```
+kp buildpack save <name> [flags]
+```
+
+### Examples
+
+```
+kp buildpack save my-buildpack --image gcr.io/paketo-buildpacks/java
+kp buildpack save my-buildpack --service-account my-other-sa
+```
+
+### Options
+
+```
+      --dry-run                  perform validation with no side-effects; no objects are sent to the server.
+                                   The --dry-run flag can be used in combination with the --output flag to
+                                   view the Kubernetes resource(s) without sending anything to the server.
+  -h, --help                     help for save
+  -i, --image string             registry location where the buildpack is located
+  -n, --namespace string         kubernetes namespace
+      --output string            print Kubernetes resources in the specified format; supported formats are: yaml, json.
+                                   The output can be used with the "kubectl apply -f" command. To allow this, the command
+                                   updates are redirected to stderr and only the Kubernetes resource(s) are written to stdout.
+                                   The APIVersion of the outputted resources will always be the latest APIVersion known to kp (currently: v1alpha2).
+      --service-account string   service account name to use
+```
+
+### SEE ALSO
+
+* [kp buildpack](kp_buildpack.md)	 - Buildpack Commands
+

docs/kp_buildpack_status.md

@@ -0,0 +1,32 @@
+## kp buildpack status
+
+Display status of a buildpack
+
+### Synopsis
+
+Prints detailed information about the status of a specific buildpack in the provided namespace.
+
+The namespace defaults to the kubernetes current-context namespace.
+
+```
+kp buildpack status <name> [flags]
+```
+
+### Examples
+
+```
+kp buildpack status my-buildpack
+kp buildpack status -n my-namespace other-buildpack
+```
+
+### Options
+
+```
+  -h, --help               help for status
+  -n, --namespace string   kubernetes namespace
+```
+
+### SEE ALSO
+
+* [kp buildpack](kp_buildpack.md)	 - Buildpack Commands
+

docs/kp_clusterbuildpack.md

@@ -0,0 +1,20 @@
+## kp clusterbuildpack
+
+ClusterBuildpack Commands
+
+### Options
+
+```
+  -h, --help   help for clusterbuildpack
+```
+
+### SEE ALSO
+
+* [kp](kp.md)	 - 
+* [kp clusterbuildpack create](kp_clusterbuildpack_create.md)	 - Create a cluster buildpack
+* [kp clusterbuildpack delete](kp_clusterbuildpack_delete.md)	 - Delete a buildpack
+* [kp clusterbuildpack list](kp_clusterbuildpack_list.md)	 - List available cluster buildpacks
+* [kp clusterbuildpack patch](kp_clusterbuildpack_patch.md)	 - Patch an existing cluster buildpack configuration
+* [kp clusterbuildpack save](kp_clusterbuildpack_save.md)	 - Create or patch a cluster buildpack
+* [kp clusterbuildpack status](kp_clusterbuildpack_status.md)	 - Display status of a buildpack
+

docs/kp_clusterbuildpack_create.md

@@ -0,0 +1,42 @@
+## kp clusterbuildpack create
+
+Create a cluster buildpack
+
+### Synopsis
+
+Create a cluster buildpack by providing command line arguments.
+
+The default service account used is read from the "default.serviceaccount" key in the "kp-config" ConfigMap within "kpack" namespace.
+
+
+```
+kp clusterbuildpack create <name> --image <image> [flags]
+```
+
+### Examples
+
+```
+kp cbp create my-cluster-buildpack --image gcr.io/paketo-buildpacks/java
+kp cbp buildpack create my-cluster-buildpack --image gcr.io/paketo-buildpacks/java:8.9.0
+kp cbp buildpack create my-cluster-buildpack --image gcr.io/paketo-buildpacks/java@sha256:fc1c6fba46b582f63b13490b89e50e93c95ce08142a8737f4a6b70c826c995de
+
+```
+
+### Options
+
+```
+      --dry-run         perform validation with no side-effects; no objects are sent to the server.
+                          The --dry-run flag can be used in combination with the --output flag to
+                          view the Kubernetes resource(s) without sending anything to the server.
+  -h, --help            help for create
+  -i, --image string    registry location where the cluster buildpack is located
+      --output string   print Kubernetes resources in the specified format; supported formats are: yaml, json.
+                          The output can be used with the "kubectl apply -f" command. To allow this, the command
+                          updates are redirected to stderr and only the Kubernetes resource(s) are written to stdout.
+                          The APIVersion of the outputted resources will always be the latest APIVersion known to kp (currently: v1alpha2).
+```
+
+### SEE ALSO
+
+* [kp clusterbuildpack](kp_clusterbuildpack.md)	 - ClusterBuildpack Commands
+