Quick Start

What's New?

Find out in our blog post

Migration From v2

v3 is not intended to introduce significant breaking changes for most users. Please read the "Known issues" and "Breaking changes" to determine if you might be impacted.

Known Issues

• Some users are reporting that the UI attempts to open all listing workflows in all namespaces, even if the user does not have access. To work-around - append the correct namespace in the URL.
• OpenShift does not appear to support the coordination API which is mandatory for leader election. #5638 #5306
• Archiving of logs no longer works. #5639

Breaking Changes

chore(server): Enable TLS by default. Resolves #5205 (#5212)

The server now starts with TLS enabled by default if a key is available. This can be disabled using --secure=false.

If you have an ingress, you may need to add the appropriate annotations:(varies by ingress):

alb.ingress.kubernetes.io/backend-protocol: HTTPS
nginx.ingress.kubernetes.io/backend-protocol: HTTPS

Argo CLI

Mac

Available via curl

# Download the binary
curl -sLO https://github.com/argoproj/argo/releases/download/v3.0.2/argo-darwin-amd64.gz

# Unzip
gunzip argo-darwin-amd64.gz

# Make binary executable
chmod +x argo-darwin-amd64

# Move binary to path
mv ./argo-darwin-amd64 /usr/local/bin/argo

# Test installation
argo version

Linux

Available via curl

# Download the binary
curl -sLO https://github.com/argoproj/argo/releases/download/v3.0.2/argo-linux-amd64.gz

# Unzip
gunzip argo-linux-amd64.gz

# Make binary executable
chmod +x argo-linux-amd64

# Move binary to path
mv ./argo-linux-amd64 /usr/local/bin/argo

# Test installation
argo version

Argo Controller

kubectl create namespace argo
kubectl apply -n argo -f https://raw.githubusercontent.com/argoproj/argo-workflows/v3.0.2/manifests/install.yaml

Since v3.0.1

• Update manifests to v3.0.2
• fix binary build
• fix: Build argosay binary if it doesn't exist
• fix(executor): More logs for PNS sidecar termination. #5627 (#5683)
• build: Specify Dockerfile version (#5689)
• fix: Only save memoization cache when node succeeded (#5711)
• fix(controller): Fix cron timezone support. Fixes #5653 (#5712)
• fix(ui): Fix showWorkflows button. Fixes #5645 (#5693)
• fix(ui): Fix YAML/JSON toggle. Fixes #5690 (#5694)
• fix(cli): Validate cron on update. Fixes #5691 (#5692)
• fix(executor): Ignore not existing metadata. Fixes #5656 (#5695)
• fix(controller): Correct bug for repository ref without default key. Fixes #5646 (#5660)
• fix(ui): strip inner quotes from argoToken (#5677)
• fix: git clone on non-default branch fails (Fixes #5629) (#5630)
• fix: Default ARGO_SECURE=true. Fixes #5607 (#5626)
• fix: Make task/step name extractor robust (#5672)
• fix: Surface error during wait timeout for OSS artifact driver API calls (#5601)
• fix(ui): Fix editor. Fixes #5613 Fixes #5617 (#5620)
• fix(ui): various ui fixes (#5606)
• fix(controller): Workflow hangs indefinitely during ContainerCreating if the Pod or Node unexpectedly dies (#5585)
• feat(ui): let workflow dag and node info scroll independently (#5603)
• fix: parse username from git url when using SSH key auth (#5156)
• fix(controller): Consider nested expanded task in reference (#5594)

Contributors

• Alex Collins
• Iven
• Michael Ruoss
• Saravanan Balasubramanian
• Simon Behar
• Vladimir Ivanov
• Yuan Tang
• kennytrytek
• tczhao