OSCAR-CLI provides a command line interface to interact with OSCAR clusters in a simple way. It supports service management, workflows definition from FDL (Functions Definition Language) files and the ability to manage files from OSCAR's compatible storage providers (MinIO, Amazon S3 and Onedata). The folder example-workflow
contains all the necessary files to create a simple workflow to test the tool.
The easy way to download OSCAR-CLI is through the github releases page. There are binaries for multiple platforms and OS. If you need a binary for another platform, please open an issue.
If you have go installed and configured, you can get it from source directly by executing:
go install github.com/grycap/oscar-cli@latest
The documentation is available on OSCAR's web for CLI. A video tutorial is available on YouTube.
Apply a FDL file to create or edit services in clusters.
Usage:
oscar-cli apply FDL_FILE [flags]
Aliases:
apply, a
Flags:
--config string set the location of the config file (YAML or JSON)
-h, --help help for apply
Manages the configuration of clusters.
Add a new existing cluster to oscar-cli.
Usage:
oscar-cli cluster add IDENTIFIER ENDPOINT {USERNAME {PASSWORD | --password-stdin} | --oidc-account-name ACCOUNT} [flags]
Aliases:
add, a
Flags:
--disable-ssl disable verification of ssl certificates for the added cluster
-h, --help help for add
-o, --oidc-account-name string OIDC account name to authenticate using oidc-agent. Note that oidc-agent must be started and properly configured
(See: https://indigo-dc.gitbook.io/oidc-agent/)
--password-stdin take the password from stdin
Global Flags:
--config string set the location of the config file (YAML or JSON)
Show or set the default cluster.
Usage:
oscar-cli cluster default [flags]
Aliases:
default, d
Flags:
-h, --help help for default
-s, --set string set a default cluster by passing its IDENTIFIER
Global Flags:
--config string set the location of the config file (YAML or JSON)
Show information of an OSCAR cluster.
Usage:
oscar-cli cluster info [flags]
Aliases:
info, i
Flags:
-c, --cluster string set the cluster
-h, --help help for info
Global Flags:
--config string set the location of the config file (YAML or JSON)
List the configured OSCAR clusters.
Usage:
oscar-cli cluster list [flags]
Aliases:
list, ls
Flags:
-h, --help help for list
Global Flags:
--config string set the location of the config file (YAML or JSON)
Remove a cluster from the configuration file.
Usage:
oscar-cli cluster remove IDENTIFIER [flags]
Aliases:
remove, rm
Flags:
-h, --help help for remove
Global Flags:
--config string set the location of the config file (YAML or JSON)
Manages the services within a cluster.
Get the definition of a service.
Usage:
oscar-cli service get SERVICE_NAME [flags]
Aliases:
get, g
Flags:
-c, --cluster string set the cluster
-h, --help help for get
Global Flags:
--config string set the location of the config file (YAML or JSON)
List the available services in a cluster.
Usage:
oscar-cli service list [flags]
Aliases:
list, ls
Flags:
-c, --cluster string set the cluster
-h, --help help for list
Global Flags:
--config string set the location of the config file (YAML or JSON)
Remove a service from the cluster.
Usage:
oscar-cli service remove SERVICE_NAME... [flags]
Aliases:
remove, rm
Flags:
-c, --cluster string set the cluster
-h, --help help for remove
Global Flags:
--config string set the location of the config file (YAML or JSON)
Invoke a service synchronously (a Serverless backend in the cluster is required).
Usage:
oscar-cli service run SERVICE_NAME {--input | --text-input} [flags]
Aliases:
run, invoke, r
Flags:
-c, --cluster string set the cluster
-h, --help help for run
-i, --input string input file for the request
-o, --output string file path to store the output
-t, --text-input string text input string for the request
Global Flags:
--config string set the location of the config file (YAML or JSON)
List the logs from a service.
Usage:
oscar-cli service logs list SERVICE_NAME [flags]
Aliases:
list, ls
Flags:
-h, --help help for list
-s, --status strings filter by status (Pending, Running, Succeeded or Failed), multiple values can be specified by a comma-separated string
Global Flags:
-c, --cluster string set the cluster
--config string set the location of the config file (YAML or JSON)
Get the logs from a service's job.
Usage:
oscar-cli service logs get SERVICE_NAME JOB_NAME [flags]
Aliases:
get, g
Flags:
-h, --help help for get
-t, --show-timestamps show timestamps in the logs
Global Flags:
-c, --cluster string set the cluster
--config string set the location of the config file (YAML or JSON)
Remove a service's job along with its logs.
Usage:
oscar-cli service logs remove SERVICE_NAME {JOB_NAME... | --succeeded | --all} [flags]
Aliases:
remove, rm
Flags:
-a, --all remove all logs from the service
-h, --help help for remove
-s, --succeeded remove succeeded logs from the service
Global Flags:
-c, --cluster string set the cluster
--config string set the location of the config file (YAML or JSON)
Get a file from a service's storage provider.
The STORAGE_PROVIDER argument follows the format STORAGE_PROVIDER_TYPE.STORAGE_PROVIDER_NAME, being the STORAGE_PROVIDER_TYPE one of the three supported storage providers (MinIO, S3 or Onedata) and the STORAGE_PROVIDER_NAME is the identifier for the provider set in the service's definition.
Usage:
oscar-cli service get-file SERVICE_NAME STORAGE_PROVIDER REMOTE_FILE LOCAL_FILE [flags]
Aliases:
get-file, gf
Flags:
-c, --cluster string set the cluster
-h, --help help for get-file
Global Flags:
--config string set the location of the config file (YAML or JSON)
Put a file in a service's storage provider.
The STORAGE_PROVIDER argument follows the format STORAGE_PROVIDER_TYPE.STORAGE_PROVIDER_NAME, being the STORAGE_PROVIDER_TYPE one of the three supported storage providers (MinIO, S3 or Onedata) and the STORAGE_PROVIDER_NAME is the identifier for the provider set in the service's definition.
Usage:
oscar-cli service put-file SERVICE_NAME STORAGE_PROVIDER LOCAL_FILE REMOTE_FILE [flags]
Aliases:
put-file, pf
Flags:
-c, --cluster string set the cluster
-h, --help help for put-file
Global Flags:
--config string set the location of the config file (YAML or JSON)
List files from a service's storage provider path.
The STORAGE_PROVIDER argument follows the format STORAGE_PROVIDER_TYPE.STORAGE_PROVIDER_NAME, being the STORAGE_PROVIDER_TYPE one of the three supported storage providers (MinIO, S3 or Onedata) and the STORAGE_PROVIDER_NAME is the identifier for the provider set in the service's definition.
Usage:
oscar-cli service list-files SERVICE_NAME STORAGE_PROVIDER REMOTE_PATH [flags]
Aliases:
list-files, list-file, lsf
Flags:
-c, --cluster string set the cluster
-h, --help help for list-files
Global Flags:
--config string set the location of the config file (YAML or JSON)
Print the version.
Usage:
oscar-cli version [flags]
Aliases:
version, v
Flags:
-h, --help help for version
Help provides help for any command in the application. Simply type oscar-cli help [path to command] for full details.
Usage:
oscar-cli help [command] [flags]
Flags:
-h, --help help for help