To see how Argo Workflows work, you can install it and run examples of simple workflows.
Before you start you need a Kubernetes cluster and
kubectl set up to be able to access that cluster. For the purposes of getting up and running, a local cluster is fine. You could consider the following local Kubernetes cluster options:
Alternatively, if you want to try out Argo Workflows and don't want to set up a Kubernetes cluster, try the Killercoda course.
Development vs. Production
These instructions are intended to help you get started quickly. They are not suitable for production. For production installs, please refer to the installation documentation.
Install Argo Workflows¶
To install Argo Workflows, navigate to the releases page and find the release you wish to use (the latest full release is preferred).
Scroll down to the
Controller and Server section and execute the
Below is an example of the install commands, ensure that you update the command to install the correct version number:
kubectl create namespace argo
kubectl apply -n argo -f https://github.com/argoproj/argo-workflows/releases/download/v<<ARGO_WORKFLOWS_VERSION>>/quick-start-minimal.yaml
Install the Argo Workflows CLI¶
You can more easily interact with Argo Workflows with the Argo CLI.
Submit an example workflow¶
Submit via the CLI¶
argo submit -n argo --watch https://raw.githubusercontent.com/argoproj/argo-workflows/main/examples/hello-world.yaml
--watch flag used above will allow you to observe the workflow as it runs and the status of whether it succeeds.
When the workflow completes, the watch on the workflow will stop.
You can list all the Workflows you have submitted by running the command below:
argo list -n argo
You will notice the Workflow name has a
hello-world- prefix followed by random characters. These characters are used
to give Workflows unique names to help identify specific runs of a Workflow. If you submitted this Workflow again,
the next Workflow run would have a different name.
argo get command, you can always review the details of a Workflow run. The output for the command below will
be the same as the information shown when you submitted the Workflow:
argo get -n argo @latest
@latest argument to the CLI is a shortcut to view the latest Workflow run that was executed.
You can also observe the logs of the Workflow run by running the following:
argo logs -n argo @latest
Submit via the UI¶
Forward the Server's port to access the UI:
kubectl -n argo port-forward service/argo-server 2746:2746
Navigate your browser to https://localhost:2746.
- Note: The URL uses
http. Navigating to
httpwill result in a server-side error.
- Due to the self-signed certificate, you will receive a TLS error which you will need to manually approve.
- Note: The URL uses
+ Submit New Workflowand then
Edit using full workflow options
- You can find an example workflow already in the text field. Press
+ Createto start the workflow.