Merge pull request #433 from neil-hickey/feat/add-clusterlifecycle-command

feat: add ClusterLifecycle command and deprecate lifecycle command

Author: tomkennedy513

docs/kp.md

@@ -23,13 +23,13 @@ Learn more about kpack @ https://github.com/pivotal/kpack
 * [kp buildpack](kp_buildpack.md)	 - Buildpack Commands
 * [kp clusterbuilder](kp_clusterbuilder.md)	 - ClusterBuilder Commands
 * [kp clusterbuildpack](kp_clusterbuildpack.md)	 - ClusterBuildpack Commands
+* [kp clusterlifecycle](kp_clusterlifecycle.md)	 - ClusterLifecycle Commands
 * [kp clusterstack](kp_clusterstack.md)	 - ClusterStack Commands
 * [kp clusterstore](kp_clusterstore.md)	 - ClusterStore Commands
 * [kp completion](kp_completion.md)	 - Generate completion script
 * [kp config](kp_config.md)	 - Config commands
 * [kp image](kp_image.md)	 - Image commands
 * [kp import](kp_import.md)	 - Import dependencies for stores, stacks, and cluster builders
-* [kp lifecycle](kp_lifecycle.md)	 - Lifecycle Commands
 * [kp secret](kp_secret.md)	 - Secret Commands
 * [kp version](kp_version.md)	 - Display kp version
 

docs/kp_clusterlifecycle.md

@@ -0,0 +1,20 @@
+## kp clusterlifecycle
+
+ClusterLifecycle Commands
+
+### Options
+
+```
+  -h, --help   help for clusterlifecycle
+```
+
+### SEE ALSO
+
+* [kp](kp.md)	 - 
+* [kp clusterlifecycle create](kp_clusterlifecycle_create.md)	 - Create a clusterlifecycle
+* [kp clusterlifecycle delete](kp_clusterlifecycle_delete.md)	 - Delete a clusterlifecycle
+* [kp clusterlifecycle list](kp_clusterlifecycle_list.md)	 - List cluster lifecycles
+* [kp clusterlifecycle patch](kp_clusterlifecycle_patch.md)	 - Patch a clusterlifecycle
+* [kp clusterlifecycle save](kp_clusterlifecycle_save.md)	 - Create or patch a cluster lifecycle
+* [kp clusterlifecycle status](kp_clusterlifecycle_status.md)	 - Display cluster lifecycle status
+

docs/kp_clusterlifecycle_create.md

@@ -0,0 +1,53 @@
+## kp clusterlifecycle create
+
+Create a clusterlifecycle
+
+### Synopsis
+
+Create a cluster-scoped lifecycle by providing command line arguments.
+
+The image will be uploaded to the default repository.
+Therefore, you must have credentials to access the registry on your machine.
+Additionally, your cluster must have read access to the registry.
+
+Env vars can be used for registry auth as described in https://github.com/buildpacks-community/kpack-cli/blob/main/docs/auth.md
+
+The default repository is read from the "default.repository" key in the "kp-config" ConfigMap within "kpack" namespace.
+The default service account used is read from the "default.repository.serviceaccount" key in the "kp-config" ConfigMap within "kpack" namespace.
+
+
+```
+kp clusterlifecycle create <name> [flags]
+```
+
+### Examples
+
+```
+kp clusterlifecycle create my-lifecycle --image buildpacksio/lifecycle
+
+```
+
+### 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.
+      --dry-run-with-image-upload      similar to --dry-run, but with container image uploads allowed.
+                                         This flag is provided as a convenience for kp commands that can output Kubernetes
+                                         resource with generated container image references. A "kubectl apply -f" of the
+                                         resource from --output without image uploads will result in a reconcile failure.
+  -h, --help                           help for create
+  -i, --image string                   image tag or local tar file path
+      --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).
+      --registry-ca-cert-path string   add CA certificate for registry API (format: /tmp/ca.crt)
+      --registry-verify-certs          set whether to verify server's certificate chain and host name (default true)
+```
+
+### SEE ALSO
+
+* [kp clusterlifecycle](kp_clusterlifecycle.md)	 - ClusterLifecycle Commands
+

docs/kp_clusterlifecycle_delete.md

@@ -0,0 +1,28 @@
+## kp clusterlifecycle delete
+
+Delete a clusterlifecycle
+
+### Synopsis
+
+Delete a specific cluster-scoped lifecycle from the cluster.
+
+```
+kp clusterlifecycle delete <name> [flags]
+```
+
+### Examples
+
+```
+kp clusterlifecycle delete my-lifecycle
+```
+
+### Options
+
+```
+  -h, --help   help for delete
+```
+
+### SEE ALSO
+
+* [kp clusterlifecycle](kp_clusterlifecycle.md)	 - ClusterLifecycle Commands
+

docs/kp_clusterlifecycle_list.md

@@ -0,0 +1,28 @@
+## kp clusterlifecycle list
+
+List cluster lifecycles
+
+### Synopsis
+
+Prints a table of the most important information about cluster-scoped lifecycles in the cluster.
+
+```
+kp clusterlifecycle list [flags]
+```
+
+### Examples
+
+```
+kp clusterlifecycle list
+```
+
+### Options
+
+```
+  -h, --help   help for list
+```
+
+### SEE ALSO
+
+* [kp clusterlifecycle](kp_clusterlifecycle.md)	 - ClusterLifecycle Commands
+

docs/kp_clusterlifecycle_patch.md

@@ -0,0 +1,50 @@
+## kp clusterlifecycle patch
+
+Patch a clusterlifecycle
+
+### Synopsis
+
+Patches the image of a specific cluster-scoped lifecycle.
+
+The image will be uploaded to the registry configured on your lifecycle.
+Therefore, you must have credentials to access the registry on your machine.
+
+Env vars can be used for registry auth as described in https://github.com/buildpacks-community/kpack-cli/blob/main/docs/auth.md
+
+The default repository is read from the "default.repository" key in the "kp-config" ConfigMap within "kpack" namespace.
+The default service account used is read from the "default.repository.serviceaccount" key in the "kp-config" ConfigMap within "kpack" namespace.
+
+```
+kp clusterlifecycle patch <name> [flags]
+```
+
+### Examples
+
+```
+kp clusterlifecycle patch my-lifecycle --image buildpacksio/lifecycle
+```
+
+### 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.
+      --dry-run-with-image-upload      similar to --dry-run, but with container image uploads allowed.
+                                         This flag is provided as a convenience for kp commands that can output Kubernetes
+                                         resource with generated container image references. A "kubectl apply -f" of the
+                                         resource from --output without image uploads will result in a reconcile failure.
+  -h, --help                           help for patch
+  -i, --image string                   image tag or local tar file path
+      --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).
+      --registry-ca-cert-path string   add CA certificate for registry API (format: /tmp/ca.crt)
+      --registry-verify-certs          set whether to verify server's certificate chain and host name (default true)
+```
+
+### SEE ALSO
+
+* [kp clusterlifecycle](kp_clusterlifecycle.md)	 - ClusterLifecycle Commands
+

docs/kp_clusterlifecycle_save.md

@@ -0,0 +1,52 @@
+## kp clusterlifecycle save
+
+Create or patch a cluster lifecycle
+
+### Synopsis
+
+Create or patch a cluster-scoped lifecycle by providing command line arguments.
+
+The image will be uploaded to the default repository.
+Therefore, you must have credentials to access the registry on your machine.
+Additionally, your cluster must have read access to the registry.
+
+Env vars can be used for registry auth as described in https://github.com/buildpacks-community/kpack-cli/blob/main/docs/auth.md
+
+The default repository is read from the "default.repository" key in the "kp-config" ConfigMap within "kpack" namespace.
+The default service account used is read from the "default.repository.serviceaccount" key in the "kp-config" ConfigMap within "kpack" namespace.
+
+
+```
+kp clusterlifecycle save <name> [flags]
+```
+
+### Examples
+
+```
+kp clusterlifecycle save my-lifecycle --image buildpacksio/lifecycle
+```
+
+### 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.
+      --dry-run-with-image-upload      similar to --dry-run, but with container image uploads allowed.
+                                         This flag is provided as a convenience for kp commands that can output Kubernetes
+                                         resource with generated container image references. A "kubectl apply -f" of the
+                                         resource from --output without image uploads will result in a reconcile failure.
+  -h, --help                           help for save
+  -i, --image string                   image tag or local tar file path
+      --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).
+      --registry-ca-cert-path string   add CA certificate for registry API (format: /tmp/ca.crt)
+      --registry-verify-certs          set whether to verify server's certificate chain and host name (default true)
+```
+
+### SEE ALSO
+
+* [kp clusterlifecycle](kp_clusterlifecycle.md)	 - ClusterLifecycle Commands
+

docs/kp_clusterlifecycle_status.md

@@ -0,0 +1,29 @@
+## kp clusterlifecycle status
+
+Display cluster lifecycle status
+
+### Synopsis
+
+Prints detailed information about the status of a specific cluster-scoped lifecycle.
+
+```
+kp clusterlifecycle status <name> [flags]
+```
+
+### Examples
+
+```
+kp clusterlifecycle status my-lifecycle
+```
+
+### Options
+
+```
+  -h, --help      help for status
+  -v, --verbose   display supported and deprecated buildpack APIs
+```
+
+### SEE ALSO
+
+* [kp clusterlifecycle](kp_clusterlifecycle.md)	 - ClusterLifecycle Commands
+