README.md

chectl

Eclipse Che CLI

• Installation
• Usage
• Commands
• Contributing

Installation

Binary downloads of chectl can be found on the Release page.

Download the chectl binary and add it to your PATH.

Currently chectl requires minikube and helm to be locally installed.

Usage

$ chectl server:start
running command...

$ chectl server:stop
running command...

$ chectl workspace:start --devfile
running command...

$ chectl --help [COMMAND]
USAGE
  $ chectl COMMAND
...

Commands

• chectl autocomplete [SHELL]
• chectl help [COMMAND]
• chectl server:start
• chectl server:stop
• chectl server:update
• chectl workspace:inject
• chectl workspace:list
• chectl workspace:start
• chectl workspace:stop

chectl autocomplete [SHELL]

display autocomplete installation instructions

USAGE
  $ chectl autocomplete [SHELL]

ARGUMENTS
  SHELL  shell type

OPTIONS
  -r, --refresh-cache  Refresh cache (ignores displaying instructions)

EXAMPLES
  $ chectl autocomplete
  $ chectl autocomplete bash
  $ chectl autocomplete zsh
  $ chectl autocomplete --refresh-cache

See code: @oclif/plugin-autocomplete

chectl help [COMMAND]

display help for chectl

USAGE
  $ chectl help [COMMAND]

ARGUMENTS
  COMMAND  command to show help for

OPTIONS
  --all  see all commands in CLI

See code: @oclif/plugin-help

chectl server:start

start Eclipse Che Server

USAGE
  $ chectl server:start

OPTIONS
  -d, --debug                          Starts chectl in debug mode
  -h, --help                           show CLI help
  -i, --cheimage=cheimage              [default: eclipse/che-server:nightly] Che server container image
  -n, --chenamespace=chenamespace      [default: kube-che] Kubernetes namespace where Che resources will be deployed
  -o, --cheboottimeout=cheboottimeout  (required) [default: 40000] Che server bootstrap timeout (in milliseconds)
  -t, --templates=templates            [default: /Users/mloriedo/github/chectl/templates] Path to the templates folder

See code: src/commands/server/start.ts

chectl server:stop

stop Eclipse Che Server

USAGE
  $ chectl server:stop

OPTIONS
  -h, --help                       show CLI help
  -n, --chenamespace=chenamespace  [default: kube-che] Kubernetes namespace where Che resources will be deployed

See code: src/commands/server/stop.ts

chectl server:update

update Eclipse Che Server

USAGE
  $ chectl server:update

OPTIONS
  -h, --help                       show CLI help
  -n, --chenamespace=chenamespace  [default: kube-che] Kubernetes namespace where Che resources will be deployed

See code: src/commands/server/update.ts

chectl workspace:inject

inject configurations and tokens in a Che Workspace

USAGE
  $ chectl workspace:inject

OPTIONS
  -c, --container=container        [default: theia-ide] Target container
  -h, --help                       show CLI help
  -k, --kubeconfig                 Inject the local Kubernetes configuration
  -n, --chenamespace=chenamespace  [default: kube-che] Kubernetes namespace where Che workspace is deployed
  -w, --workspace=workspace        Target workspace

See code: src/commands/workspace/inject.ts

chectl workspace:list

list Che workspaces

USAGE
  $ chectl workspace:list

OPTIONS
  -h, --help                       show CLI help
  -n, --chenamespace=chenamespace  [default: kube-che] Kubernetes namespace where Che server is deployed

See code: src/commands/workspace/list.ts

chectl workspace:start

create and start a Che workspace

USAGE
  $ chectl workspace:start

OPTIONS
  -f, --devfile=devfile            (required) path to a valid devfile
  -h, --help                       show CLI help
  -n, --chenamespace=chenamespace  [default: kube-che] kubernetes namespace where Che server is deployed

See code: src/commands/workspace/start.ts

chectl workspace:stop

stop a running Che workspace

USAGE
  $ chectl workspace:stop

OPTIONS
  -h, --help                       show CLI help
  -n, --chenamespace=chenamespace  [default: kube-che] Kubernetes namespace where Che server is deployed

See code: src/commands/workspace/stop.ts

Contributing

Clone the repository:

git clone https://github.com/che-incubator/chectl.git
cd chectl

Build the source code and run chectl:

yarn
./bin/run --help

Run the tests:

yarn test

Package the binary

yarn pack
pkg . -t node10-linux-x64,node10-macos-x64,node10-win-x64 --out-path ./bin/