cluster

Use the cluster plug-in to provision and manage kubernetes clusters in Tanzu Mission Control.

Installation

tanzu plugin install cluster --target mission-control 

A Kubernetes cluster managed by Tanzu Mission Control

Usage

tanzu mission-control cluster [command]

Commands

  admin-kubeconfig  Service fetches admin kubeconfig for provisioned clusters
  attach            Attach an existing cluster
  create            Create a cluster
  delete            Delete a cluster
  extension         Cluster addons for the platform.
  get               Get details from a cluster
  list              List clusters
  logs              Archive the logs of Tanzu Mission Control components present in the cluster
  managed-resources Managed Kubernetes resources
  nodepool          Group of nodes within a cluster with the same configuration
  object            Kubernetes objects that exists on a cluster.
  options           Options for the cluster resource
  reattach          Reattach an existing cluster
  template          Cluster template
  tsm-ca            Service fetches certificate authorities configured on Tanzu Service Mesh.
  update            Update (overwrite) a cluster
  upgrade           Upgrade a provisioned Tanzu Kubernetes cluster
  validate          Prints report of tmc components present in the cluster

attach

Attach an existing cluster.

Usage

tanzu mission-control cluster attach [flags]

Flags

      --continue-bootstrap   continue bootstrap to apply the Tanzu Mission Control resource manifest to complete attaching
  -f, --file string          resource file from which to attach the cluster
      --force                clean up the Tanzu Misson Control resources of a partially detached/attached cluster
  -h, --help                 help for attach
  -k, --kubeconfig string    the kubeconfig file of the actual cluster to use for applying the Tanzu Mission Control resource manifest
  -n, --name string          name of the cluster. Used in conjunction with --continue-bootstrap flag
  -o, --output string        output file to write the Tanzu Mission Control resource manifest (default "k8s-attach-manifest.yaml")
      --skip-verify          skip the post-flight checks that confirms if the cluster attach was successful

admin-kubeconfig

Service fetches admin kubeconfig for provisioned clusters.

Usage

tanzu mission-control cluster admin-kubeconfig [command]

Commands

  get         Get admin kubeconfig.

create

Create a cluster.

Usage

tanzu mission-control cluster create [flags]

Flags

  -v, --data-values-file string   data values file to use
      --dry-run                   create the data model only, do not apply to server
  -f, --file string               Resource file from which to create a cluster
  -h, --help                      help for create
  -t, --template string           template to use (default "default")

delete

Delete a cluster.

Usage

  tanzu mission-control cluster delete CLUSTER_NAME [flags]

Flags

  -f, --force                            force delete a cluster
  -h, --help                             help for delete
  -m, --management-cluster-name string   management cluster name of the cluster
  -p, --provisioner-name string          provisioner name of the cluster

extension

Cluster add-ons for the platform.

Usage

  tanzu mission-control cluster extension [command]

Commands

  get         Retrieve an extension object
  list        Return a list of extensions

get

Get details from a cluster.

Usage

  tanzu mission-control cluster get CLUSTER_NAME [flags]

Flags

  -m, --management-cluster-name string   management cluster name of the cluster
  -o, --output string                    Output format (yaml | json) (default "yaml")
  -p, --provisioner-name string          provisioner name of the cluster

kubeconfig

Service fetches kubeconfig for attached clusters.

Usage

tanzu mission-control cluster kubeconfig [command]

Commands

  get         Get cluster kubeconfig.

list

List clusters.

Usage

  tanzu mission-control cluster list [flags]

Flags

  -m, --management-cluster-name string   management cluster name of the cluster
      --max-size uint                    number of records to return
      --name string                      scope search to the specified name
      --offset uint                      offset at which to start returning records
  -o, --output string                    output format (yaml|json)
  -p, --provisioner-name string          provisioner name of the cluster
  -q, --query string                     tql to query the stores

Examples

To list all clusters and filter by label foo=bar:

tanzu mission-control cluster list -q meta.labels.foo=bar

To list all clusters and filter by label foo=*:

tanzu mission-control cluster list -q "meta.labels.foo=*"

To list all clusters and filter by label foo=* and fizz=buzz:

tanzu mission-control cluster list -q "meta.labels.foo=* AND meta.labels.fizz=buzz"

logs

Archive the logs of Tanzu Mission Control components present in the cluster.

Usage

  tanzu mission-control cluster logs [flags]

Flags

  -k, --kubeconfig string   the kubeconfig file of the cluster managed by Tanzu Mission Control
  -o, --output string       the output directory to save logs (default temp directory)

managedresources

Managed Kubernetes resources.

Usage

  tanzu mission-control cluster managed-resources [command]

Commands

  list       lists all the tmc managed resources
  retain     retain tmc managed resources

nodepool

Group of nodes within a cluster with the same configuration.

Usage

  tanzu mission-control cluster nodepool [command]

Commands

  create      Create a nodepool object
  delete      Delete a nodepool
  get         Get details from a nodepool
  list        Return a list of nodepools
  template    Nodepool template
  update      Update (overwrite) a nodepool

object

Kubernetes objects that exists on a cluster.

Usage

  tanzu mission-control cluster object [command]

Commands

  list        Return a list of objects

reattach

Reattach an existing cluster.

Usage

  tanzu mission-control cluster reattach [flags]

Flags

  -h, --help                             help for reattach
      --image-registry string            name of the image registry to be used for the cluster. If set empty, no image registry config will be used. If left unset, existing image registry config will be used. (default "use-default")
  -k, --kubeconfig string                the kubeconfig file of the actual cluster to use for applying the Tanzu Mission Control resource manifest
  -m, --management-cluster-name string   name of the management cluster
  -p, --provisioner-name string          name of the provisioner
      --proxy-name string                name of the proxy config to be used for the cluster. if empty, original proxy config (if any) will be picked
      --skip-verify                      skip the post-flight checks that confirms if the cluster re-attach was successful
      --use-proxy                        use proxy config for the cluster

template

Cluster template.

Usage

  tanzu mission-control cluster template [command]

Commands

  get         Get Template for cluster
  list        List Templates for cluster

tsm-ca

Service fetches certificate authorities configured on Tanzu Service Mesh.

Usage

tanzu cluster tsm-ca get [flags]

Flags

  -c, --cluster-name string              name of the cluster
  -h, --help                             help for tsm-ca
  -m, --management-cluster-name string   management cluster name of the cluster
  -o, --output string                    Output format (yaml | json) (default "yaml")
  -p, --provisioner-name string          provisioner name of the cluster

update

Update (overwrite) a cluster.

Usage

  tanzu mission-control cluster update [flags]

Flags

  -f, --file string   resource file from which to update the cluster
  -h, --help          help for update

upgrade

Upgrade a provisioned Tanzu Kubernetes cluster.

Usage

  tanzu mission-control cluster upgrade CLUSTER_NAME [version] [flags]

Flags

      --include-all-families             include versions from different operating system families.
      --latest                           automatically select the latest available version eligible for upgrade.
  -m, --management-cluster-name string   management cluster name of the cluster
  -p, --provisioner-name string          provisioner name of the cluster

validate

Prints report of tmc components present in the cluster.

Usage

  tanzu mission-control cluster validate [flags]

Flags

  -k, --kubeconfig string   config file of cluster monitored via TMC