5. CLI API

5.1. reana-cluster

Command line application for managing a REANA cluster.

reana-cluster [OPTIONS] COMMAND [ARGS]...

Options

-l, --loglevel <loglevel>

Sets log level

-f, --file <file>

REANA cluster specifications file describing configuration for the cluster and for REANA components

-s, --skip-validation

If set, specifications file is not validated before starting the initialization.

--prod

If set, REANA will use a production setup. For now it only affects the storage backend, CEPH if production otherwise local storage.

5.1.1. down

Bring REANA cluster down, i.e. delete all deployed components.

reana-cluster down [OPTIONS]

Options

--remove-persistent-storage

NOT IMPLEMENTED. If set, also persistent storage inside the cluster is deleted.

5.1.2. env

Display the commands to set up the environment for the REANA client.

reana-cluster env [OPTIONS]

Options

--namespace <namespace>

Namespace of the components which configuration should be produced.

--include-admin-token

Display also commands how to set REANA_ACCESS_TOKEN for administrator access. Use with care! Do no share with regular users.

5.1.3. get

Fetch information (e.g. URLs) about a REANA component deployed in REANA cluster.

reana-cluster get [OPTIONS] COMPONENT

Options

--namespace <namespace>

Namespace of the component which URL should be resolved.

Arguments

COMPONENT

Required argument

5.1.4. init

Initialize REANA cluster, i.e. deploy all REANA components to cluster type (e.g. ‘kubernetes’) defined in REANA cluster specifications file

reana-cluster init [OPTIONS]

Options

--skip-initialization

If set, configuration files for selected cluster type are generated, but cluster is not initialized.

-o, --output <output>

Path where generated cluster configuration files should be saved.If no value is given no files are outputted.

5.1.5. restart

NOT IMPLEMENTED. Restart components running in REANA cluster.

reana-cluster restart [OPTIONS]

Options

--remove-persistent-storage

NOT IMPLEMENTED. If set, also persistent storage inside the cluster is deleted.

5.1.6. status

Display the status of each component and if the cluster is ready.

reana-cluster status [OPTIONS]

Options

--component <component>

Specify for which component you want the statuse.g. job-controller.

5.1.7. verify

Verify that configuration of REANA cluster and components deployed there are set up according to REANA cluster specifications file.

reana-cluster verify [OPTIONS] COMMAND1 [ARGS]... [COMMAND2 [ARGS]...]...

5.1.7.1. backend

Only verify that configuration of REANA cluster matches to what is specified in REANA cluster specifications file.

reana-cluster verify backend [OPTIONS]

5.1.7.2. components

Only verify that configuration of REANA components deployed to REANA cluster matches to what is specified in REANA cluster specifications file.

reana-cluster verify components [OPTIONS]