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.1/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.1/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.1/manifests/install.yaml

Since v3.0.0

• Update manifests to v3.0.1
• fix: Switch InsecureSkipVerify to true (#5575)
• fix(controller): clean up before insert into argo_archived_workflows_labels (#5568)
• fix(executor): GODEBUG=x509ignoreCN=0 (#5562)
• fix: Reference new argo-workflows url in in-app links (#5553)

Contributors

• Alex Collins
• BOOK
• Simon Behar
• Tim Collins