manage git repositories for task and workflow configuration
The repository command performs operations on the repositories used for task and workflow configuration.
A valid workflow configuration repository must contain the directories tasks and workflows in its master branch.
When referencing a repository, the clone method should never be prepended. Supported repo backends and their expected format are:
- https: [hostname]/[repo_path]
- ssh: [hostname]:[repo_path]
- local [repo_path] (local repo entries are ephemeral and will not survive a core restart)
Examples of valid repository identifiers:
github.com/AliceO2Group/ControlWorkflows (https)
gitlab.cern.ch/tmrnjava/AliECS_conf/ (https)
alio2-cr1-hv-gw01.cern.ch:/opt/git/ControlWorkflows (ssh)
/home/flp/git/ControlWorkflows (local filesystem - (*entry does not survive a core restart*))
By default, all short task and workflow names are assumed to be in the default repository (see coconut repo list command).
Any workflow from any repository can be loaded by providing a full and unique path, e.g. the following two are different workflows:
github.com/AliceO2Group/ControlWorkflows/workflows/readout-qc-1
gitlab.cern.ch/tmrnjava/AliECS_conf/workflows/readout-qc-1
By default a workflow is loaded from its state at HEAD in the master branch. A request to load a workflow can further be qualified with a branch, tag or commit hash:
readout-qc-1@readout-testing
gitlab.cern.ch/tmrnjava/AliECS_conf/workflows/readout-qc-1@5c7f1c1f
Make sure to run coconut repo refresh if you make changes to a configuration repository.
-h, --help help for repository
--config string optional configuration file for coconut (default $HOME/.config/coconut/settings.yaml)
--config_endpoint string configuration endpoint used by AliECS core as PROTO://HOST:PORT (default "apricot://127.0.0.1:32101")
--endpoint string AliECS core endpoint as HOST:PORT (default "127.0.0.1:32102")
--nocolor disable colors in output
--nospinner disable animations in output
-v, --verbose show verbose output for debug purposes
- coconut - O² Control and Configuration Utility
- coconut repository add - add a new git repository
- coconut repository default - set a git repository as default
- coconut repository default-revision - set default global and per-repository revision
- coconut repository list - list git repositories
- coconut repository refresh - refresh git repositories
- coconut repository remove - remove a git repository