Skip to content

Latest commit

 

History

History
86 lines (65 loc) · 4.33 KB

File metadata and controls

86 lines (65 loc) · 4.33 KB
title kbcli playground init

Bootstrap a kubernetes cluster and install KubeBlocks for playground.

Synopsis

Bootstrap a kubernetes cluster and install KubeBlocks for playground.

If no cloud provider is specified, a k3d cluster named kb-playground will be created on local host, otherwise a kubernetes cluster will be created on the specified cloud. Then KubeBlocks will be installed on the created kubernetes cluster, and an apecloud-mysql cluster named mycluster will be created.

kbcli playground init [flags]

Examples

  # create a k3d cluster on local host and install KubeBlocks
  kbcli playground init
  
  # create an AWS EKS cluster and install KubeBlocks, the region is required
  kbcli playground init --cloud-provider aws --region us-west-1
  
  # after init, run the following commands to experience KubeBlocks quickly
  # list database cluster and check its status
  kbcli cluster list
  
  # get cluster information
  kbcli cluster describe mycluster
  
  # connect to database
  kbcli cluster connect mycluster
  
  # view the Grafana
  kbcli dashboard open kubeblocks-grafana
  
  # destroy playground
  kbcli playground destroy

Options

      --auto-approve             Skip interactive approval during the initialization of playground
      --cloud-provider string    Cloud provider type, one of [local aws] (default "local")
      --cluster-type string      Specify the cluster type to create, use 'kbcli cluster create --help' to get the available cluster type. (default "apecloud-mysql")
  -h, --help                     help for init
      --k3d-proxy-image string   Specify k3d proxy image if you want to init playground locally (default "docker.io/apecloud/k3d-proxy:5.4.4")
      --k3s-image string         Specify k3s image that you want to use for the nodes if you want to init playground locally (default "rancher/k3s:v1.23.8-k3s1")
      --region string            The region to create kubernetes cluster
      --timeout duration         Time to wait for init playground, such as --timeout=10m (default 10m0s)
      --version string           KubeBlocks version

Options inherited from parent commands

      --as string                      Username to impersonate for the operation. User could be a regular user or a service account in a namespace.
      --as-group stringArray           Group to impersonate for the operation, this flag can be repeated to specify multiple groups.
      --as-uid string                  UID to impersonate for the operation.
      --cache-dir string               Default cache directory (default "$HOME/.kube/cache")
      --certificate-authority string   Path to a cert file for the certificate authority
      --client-certificate string      Path to a client certificate file for TLS
      --client-key string              Path to a client key file for TLS
      --cluster string                 The name of the kubeconfig cluster to use
      --context string                 The name of the kubeconfig context to use
      --disable-compression            If true, opt-out of response compression for all requests to the server
      --insecure-skip-tls-verify       If true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure
      --kubeconfig string              Path to the kubeconfig file to use for CLI requests.
      --match-server-version           Require server version to match client version
  -n, --namespace string               If present, the namespace scope for this CLI request
      --request-timeout string         The length of time to wait before giving up on a single server request. Non-zero values should contain a corresponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't timeout requests. (default "0")
  -s, --server string                  The address and port of the Kubernetes API server
      --tls-server-name string         Server name to use for server certificate validation. If it is not provided, the hostname used to contact the server is used
      --token string                   Bearer token for authentication to the API server
      --user string                    The name of the kubeconfig user to use

SEE ALSO

  • kbcli playground - Bootstrap or destroy a playground KubeBlocks in local host or cloud.

Go Back to CLI Overview Homepage.