From 17421deebb00dfcfafc9dec498818e4fcd6e82ad Mon Sep 17 00:00:00 2001 From: ejseqera Date: Tue, 9 Jan 2024 23:04:51 -0500 Subject: [PATCH] docs: add initial docs about running dumps tool --- README.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/README.md b/README.md index 6817c6e..151068c 100644 --- a/README.md +++ b/README.md @@ -208,7 +208,18 @@ compute-envs: file-path: './compute-envs/my_aws_compute_environment.json' # required overwrite: True ``` +## YAML Dump Feature +**Note: This is an experimental feature and is under active development. It may not be fully stable is subject to further change and improvements in future releases. If you encounter issues using this feature or want to provide feedback, please feel free to contribute via [GitHub Issues](https://github.com/seqeralabs/seqera-kit/issues) or [Pull Requests](https://github.com/seqeralabs/seqera-kit/pulls).** +To generate definitions for objects and entities that exist within a Workspace on Seqera Platform in YAML format, you can use the `seqerakit dump` command. + +To use this feature, specify the Workspace name or ID for which you want to generate YAML files for, and optionally, a prefix for your YAML filenames (this defaults to the Workspace): +```bash +seqerakit dump --workspace --prefix +``` +This command will generate YAML definitions for entities (i.e. Pipelines, Compute Environments) in the specified Workspace. These definitions can be used to compare to YAML files initially used to create entities and analyze changes, or to maintain provenance and IaC of the current state of objects in the Platform. + +*Note*: This feature currently only supports emitting YAML definitions for Compute Environments and Pipelines. ## Quick start