Hera is a Python framework for constructing and submitting Argo Workflows. The main goal of Hera is to make Argo Workflows more accessible by abstracting away some setup that is typically necessary for constructing Argo workflows.
Project description
Hera
Hera is a Python framework for constructing and submitting Argo Workflows. The main goal of Hera is to make the Argo ecosystem accessible by simplifying workflow construction and submission.
See the Quick Start guide to start using Hera to orchestrate your Argo Workflows!
The Argo was constructed by the shipwright Argus,
and its crew were specially protected by the goddess Hera.
Links
PyPi stats for hera
PyPi stats for hera-workflows
⚠ Note ⚠ The
hera-workflowspackage is deprecated since the project renamed to Hera for V5. Please install from theheraPyPi package.
Hera at a glance
Steps diamond
from hera.workflows import Steps, Workflow, script
@script()
def echo(message: str):
print(message)
with Workflow(
generate_name="single-script-",
entrypoint="steps",
) as w:
with Steps(name="steps") as s:
echo(name="A", arguments={"message": "I'm a step"})
with s.parallel():
echo(name="B", arguments={"message": "We're steps"})
echo(name="C", arguments={"message": "in parallel!"})
echo(name="D", arguments={"message": "I'm another step!"})
w.create()
DAG diamond
from hera.workflows import DAG, Workflow, script
@script()
def echo(message: str):
print(message)
with Workflow(
generate_name="dag-diamond-",
entrypoint="diamond",
) as w:
with DAG(name="diamond"):
A = echo(name="A", arguments={"message": "A"})
B = echo(name="B", arguments={"message": "B"})
C = echo(name="C", arguments={"message": "C"})
D = echo(name="D", arguments={"message": "D"})
A >> [B, C] >> D
w.create()
See the examples for a collection of Argo workflow construction and submission via Hera!
Requirements
Hera requires an Argo server to be deployed to a Kubernetes cluster. Currently, Hera assumes that the Argo server sits behind an authentication layer that can authenticate workflow submission requests by using the Bearer token on the request. To learn how to deploy Argo to your own Kubernetes cluster you can follow the Argo Workflows guide!
Another option for workflow submission without the authentication layer is using port forwarding to your Argo server
deployment and submitting workflows to localhost:2746 (2746 is the default, but you are free to change it). Please
refer to the documentation of Argo Workflows to see the
command for port forward!
Note Since the deprecation of tokens being automatically created for ServiceAccounts and Argo using Bearer tokens in place, it is necessary to use
--auth=serverand/or--auth=clientwhen setting up Argo Workflows on Kubernetes v1.24+ in order for hera to communicate to the Argo Server.
Authenticating in Hera
There are a few ways to authenticate in Hera - read more in the
authentication walk through - for now, with the argo cli tool installed, this
example will get you up and running:
from hera.workflows import Workflow, Container
from hera.shared import global_config
from hera.auth import ArgoCLITokenGenerator
global_config.host = "http://localhost:2746"
global_config.token = ArgoCLITokenGenerator
with Workflow(generate_name="local-test-", entrypoint="c") as w:
Container( name="c", image="docker/whalesay", command=["cowsay", "hello"])
w.create()
Installation
Note Hera went through a name change - from
hera-workflowstohera. This is reflected in the published Python package. If you'd like to install versions prior to5.0.0, you have to usehera-workflows. Hera currently publishes releases to bothheraandhera-workflowsfor backwards compatibility purposes.
| Source | Command |
|---|---|
| PyPi | pip install hera |
| PyPi | pip install hera-workflows |
| Conda | conda install -c conda-forge hera-workflows |
| GitHub repo | python -m pip install git+https://github.com/argoproj-labs/hera --ignore-installed/pip install . |
Optional dependencies
yaml
- Install via
hera[yaml] - PyYAML is required for the
yamloutput format, which is accessible viahera.workflows.Workflow.to_yaml(*args, **kwargs). This enables GitOps practices and easier debugging.
Presentations
- Argo Workflows and Events Community Meeting 20 Oct 2021 - Hera introductory presentation
- Argo Workflows and Events Community Meeting 15 June 2022 - Hera project update
- KubeCon/ArgoCon EU 2023 - Scaling gene therapy with Argo Workflows and Hera
- Unsticking ourselves from Glue - Migrating PayIt's Data Pipelines to Argo Workflows and Hera
Blogs
- Hera introduction and motivation
- Dyno is scaling gene therapy research with cloud-native tools like Argo Workflows and Hera
Contributing
See the contributing guide!
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file hera_workflows-5.9.0.tar.gz.
File metadata
- Download URL: hera_workflows-5.9.0.tar.gz
- Upload date:
- Size: 266.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.8.18
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | dc2c0ba72ab519eed5b3a68ee0f93881a96a71446a5f986d480adccbb5c11c39 |
|
| MD5 | 05b90fe43ea00c582f9252b83a3d38e9 |
|
| BLAKE2b-256 | a77188cd614bcb8a6a185c779001ecf4650401c151690f88f5aa1156c4f20391 |
File details
Details for the file hera_workflows-5.9.0-py3-none-any.whl.
File metadata
- Download URL: hera_workflows-5.9.0-py3-none-any.whl
- Upload date:
- Size: 309.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.8.18
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 9cccfc396181dcf7ab8e9125a33b194048eba6bd876a12f06baf49fe8b619bb8 |
|
| MD5 | 576a646152ec422e80c2eab3caf025b2 |
|
| BLAKE2b-256 | 8b30d88542ff07a7d4deba7b31320aa761b4c7f18982176ac821947f98c5c1c0 |
