argopm

argopm is a package manager for Argo Workflows. It enables developers to distribute and consume argo workflow templates as reusable modules.

Usually, these templates are declared in multiple YAML files and have to be manually applied to the cluster when making changes, doing this becomes very tedious with a growing number of templates.

That's why we built argopm. It allows you to bundle your workflow templates as npm packages so you can distribute and consume them using the amazing tooling already present in the Javascript ecosystem.

With argopm you can also add other k8s resources like configmaps, secrets etc to your package. It also supports adding grafana dashboards right into your package. There is also support for uploading static files to the artifactory ( available for AWS S3)

Getting Started

Prerequisites

Node.js > v18.20.3

Installation

argopm is available on NPM. You can install it globally in your node environment using npm or yarn.

npm i -g argopm

yarn add -g argopm

Quickstart

To create a new package with argopm, create a directory for your package, cd into that directory and run argopm init . to scaffold a default package.

mkdir sample-package && cd sample-package
argopm init .

Once this succeeds, you'll see the following contents in your package

.
├── README.md
├── configmaps
│   ├── README.md
│   └── default.yaml
├── cronworkflows
│   ├── README.md
│   └── default.yaml
├── dashboards
│   └── grafana
│       └── observability.json
├── index.js
├── package.json
├── pipelines
│   ├── README.md
│   └── default.yaml
├── secrets
│   ├── README.md
│   └── default.yaml
├── static
│   ├── README.md
│   └── data.json
└── templates
    ├── README.md
    └── default.yaml

8 directories, 16 files

You can then run argopm install . to install this package to the kubernetes cluster your current context is set to.

Usage

You can use the --help flag to get info about various commands.

argopm <command>

Commands:
  argopm install <package>          Install a package. Package name can be of the format package@version                            [aliases: i]
  argopm info <package> [template]  Get info of the installed package or a specific template in the package
  argopm run <package> [template]   Run the package or the package template. Pass in arguments using --
  argopm uninstall <package>        Uninstall a package. Uninstalls all dependencies associated with the package.                [aliases: u, r]
  argopm init [package_name]        Initializes an Argo package inside the current working directory
  argopm list                       List all the packages installed in the namespace                                                [aliases: l]

Options:
      --version    Show version number                                                                                                 [boolean]
  -n, --namespace  Kubernetes namespace. Packages will be installed in this namespace                                 [string] [default: "argo"]
  -r, --registry   Argo Package Registry                                                        [string] [default: "https://packages.atlan.com"]
  -c, --cluster    Install the template at cluster level                                                              [boolean] [default: false]
      --help       Show help                                                                                                           [boolean]

Contributing

Refer to CONTRIBUTING.md for more information on contributing code, docs and tests to argopm.

License

The project is licensed under the MIT License, see the LICENSE file for details.

Discussion and Support

Q&A: Github Discussions
You can also reach out to engineering@atlan.com

atlanhq / argopm

readme