Quick Start

What's New?

Find out in our blog post

Argo CLI

Mac

Available via curl

# Download the binary
curl -sLO https://github.com/argoproj/argo/releases/download/v3.0.0-rc3/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.0-rc3/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/v3.0.0-rc3/manifests/install.yaml

Changes

Since v3.0.0-rc2

• Merge branch 'master' into release-3.0
• chore: Add missing CLI short docstrings (#5175)
• fix: Specify where in YAML validation error occurred (#5174)
• fix: Fix node filters in UI (#5162)
• feat(controller): Support pod GC strategy based on label selector on pods (#5090)
• docs: Add DLR to USERS.md (#5157)
• fix(executor): Do not make unneeded get pod when no sidecars (#5161)
• fix: Better message formating for nodes (#5160)
• fix: send periodic keepalive packets on eventstream connections (#5101)
• fix: Append the error message prior to offloading node status (#5043)
• build: Fix build of argocli (#5150)
• feat: Support automatically create OSS bucket if not exists (#5133)
• feat(controller): Use different container runtime executors for each workflow. Close #4254 (#4998)
• feat: Add argo submit --verify hidden flag. Closes #5136 (#5141)
• feat: added lint from stdin (#5095)
• feat(server): Write an audit log entry for SSO users (#5145)
• fix: Revert the unwanted change in example (#5139)
• fix: Multiple UI fixes (#5140)
• feat(ui): Surface result and exit-code outputs (#5137)
• test: Enhanced e2e tests (#5128)
• build: Fix path to golangci-lint binary (#5131)
• feat: Build dev-* branches as engineering builds (#5129)
• fix(ui): add a tooltip for commonly truncated fields in the events pane (#5062)
• feat: Support pgzip as an alternative (de)compression implementation (#5108)
• docs: Update workflow-controller-configmap workflowRestrictions example doc (#5109)
• chore: Add SHA256 checksums to release (#5122)
• Update manifests to v3.0.0-rc2
• Merge branch 'master' into release-3.0
• fix(executor): Fix S3 policy based auth. Fixes #5110 (#5111)
• Merge branch 'master' into release-3.0
• fix: Invalid OpenAPI Spec (Issue 4817) (#4831)
• chore: More opinionated linting (#5072)
• feat: Add checker to ensure that env variable doc is up to date (#5091)
• feat(controller): Logs Kubernetes API requests (#5084)
• build: Fix path to openapi-gen binary (#5089)
• feat(executor): Minimize the number of Kubernetes API requests made by executors (#4954)
• fix: Do not create pods under shutdown strategy (#5055)
• fix: Synchronization lock handling in Step/DAG Template level (#5081)
• docs: Add document for environment variables (#5080)
• docs: Add Jungle to USERS.md (#5096)
• feat(ui): Display pretty cron schedule (#5088)
• fix: Revert "fix(controller): keep special characters in json string when … … 19da392 …use withItems (#4814)" (#5076)
• fix: Prefer to break labels by '-' in UI (#5083)
• docs: Add community video to README (#5087)
• fix(controller): Fix creator dashes (#5082)
• feat(controller): Add podMetadata field to workflow spec. Resolves #4985 (#5031)
• feat(controller): Add retry policy to support retry only on transient errors (#4999)
• chore: Update links to argo-workflows documentation (#5070)
• docs: Add Vispera to USERS.md (#5047)
• build: Simpler Docker build (#5057)
• fix(executor): Correct usage of time.Duration. Fixes #5046 (#5049)
• feat(executor): Add user agent to workflow executor (#5014)
• chore!: Remove deprecated fields (#5035)
• fix: Invalid URL for API Docs (#5063)
• feat: Allow to specify grace period for pod GC (#5033)
• chore: Move paths to /argo-workflows/ (#5059)
• fix: Use React state to avoid new page load in Workflow view (#5058)
• fix: Don't allow graph container to have its own scroll (#5056)
• Update manifests to v3.0.0-rc1
• fix(cli): Add insecure-skip-verify for HTTP1. Fixes #5008 (#5015)
• chore: Reuse LookupEnvDurationOr to parse duration from environment variables (#5032)
• M is demonstrably not less than 1 in the examples (#5021)
• feat(controller): configurable terminationGracePeriodSeconds (#4940)
• Fix golang build (#5039)
• feat: DAG render options panel float through scrolling (#5036)
• fix: Skip the Workflow not found error in Concurrency policy (#5030)
• fix(ui): Display all node inputs/output in one tab. Resolves #5027 (#5029)
• feat(executor): Log verb kind statusCode for executor Kubernetes API requests (#4989)
• fix: Unmark daemoned nodes after stopping them (#5005)
• Video (#5019)
• docs: Add a note for docker executors regarding outputs.result (#5017)
• fix(ui): Fix event-flow hidden nodes (#5013)
• build: Upgrade Golang to v1.15 (#5009)
• build: Upgrade argoexec base image to debian:10.7-slim (#5010)
• feat(executor): Upgrade kubectl to v1.19 (#5011)
• test: Delete TestDeletingRunningPod (#5012)
• feat: Set CORS headers (#4990)
• feat(ui): Node search tool in UI Workflow viewer (#5000)
• fix: Fail DAG templates with variables with invalid dependencies (#4992)
• chore: Set Go mod to v3 (#4978)
• fix: Coalesce UI filtering menus (#4972)
• docs: Add Couler, SQLFlow, and Kubeflow to USERS.md (#4964)
• feat: Configurable retry backoff settings when retrying API calls (#4979)
• test: Fix TestDeletingRunningPod (#4996)
• fix(controller): Revert prepending ExecutorScriptSourcePath which brought a breaking change in args handling (#4884)
• fix(controller): Adds PNS_PRIVILEGED, fixed termination bug (#4983)
• fix: Use button in side panel links (#4977)
• docs: Fix broken docs (#4967)
• fix: Surface the underlying error on wait timeout. (#4966)
• fix: Correct usage of wait.ExponentialBackoff (#4962)
• docs: Specify states to ensure clean state when releaseing (#4963)
• docs: Update running-locally.md (#4961)
• fix(server): Fix missing logs bug (#4960)
• ci: Run all executors on CI (#4957)
• feat(server): add ServiceAccount info to api/v1/userinfo and ui user tab (#4944)
• Added Astraea (#4855)
• fix(controller): report OOM when wait container OOM (#4930)
• feat: Support retry on transient errors during executor status checking (#4946)
• docs: Remove miscreant line in argo.md (#4821)
• docs: Update security docs (#4743)
• chore: Remove self-referential replace directive in go.mod (#4959)
• docs: Improve Documents Around Inputs (#4900)
• feat(crds): Update CRDs to apiextensions.k8s.io/v1 (#4918)
• feat(server): Add Prometheus metrics. Closes #4751 (#4952)
• chore: Set Go mod to /v2 (#4916)
• fix(cli): Allow full node name in node-field-selector (#4913)
• fix(cli): Update the map-reduce example, fix bug. (#4948)
• feat: Check the workflow is not being deleted for Synchronization workflow (#4935)
• docs: add Devtron labs to USERS.md (#4939)
• fix(ui): v3 UI tweaks (#4933)
• build: Faster make start, faster smoke jobs (#4926)
• fix(ui): fix object-editor text render issue (#4921)
• feat: support K8S json patch (#4908)
• chore: Introduce WorkflowPhase (#4856)
• fix(controller): Report reconciliation errors better (#4877)
• feat(controller)!: Key-only artifacts. Fixes #3184 (#4618)
• fix(ui): objecteditor only runs onChange when values are modified (#4911)
• build: Inline Argo Events CRD URLs to reduce build errors (#4902)
• fix(ui): Fix workflow refresh bug (#4906)
• fix: Mutex not being released on step completion (#4847)
• fix(ui): UI bug fixes (#4895)
• feat: Support specifying the pattern for transient and retryable errors (#4889)
• build: on a dev branch automatically start the UI (#4896)
• Revert "feat(cli): add selector and field-selector option to the stop command. (#4853)"
• feat(cli): add selector and field-selector option to the stop command. (#4853)
• fix(workflow-event-bindings): removing unneeded ':' in protocol (#4893)
• fix(ui): Show non-pod nodes (#4890)
• fix(controller): Consider processed retry node in metrics. Fixes #4846 (#4872)
• feat(controller): optional database migration (#4869)
• feat(ui): Argo Events API and UI. Fixes #888 (#4470)
• fix(controller): make creator label DNS compliant. Fixes #4880 (#4881)
• fix(controller): Fix node status when daemon pod deleted but its children nodes are still running (#4683)
• fix: Do not error on duplicate workflow creation by cron (#4871)
• build: sudoless make codegen -B (#4866)
• fix(controller): Add matrix tests for node offload disabled. Resolves #2333 (#4864)
• feat: Expose exitCode to step level metrics (#4861)
• feat(controller): k8s_request_total and workflow_condition metrics (#4811)
• feat: Publish images on Quay.io (#4860)
• feat: Publish images to Quay.io (#4854)
• refactor: upgrade kube client version to v0.19.6. Fixes #4425, #4791 (#4810)
• feat: Worker busy and active pod metrics (#4823)
• fix: Preserve the original slice when removing string (#4835)
• fix(controller): keep special characters in json string when use withItems (#4814)
• feat(controller): Retry pod creation on API timeout (#4820)
• build: Fix lint (#4837)
• chore: Bump OSS Go SDK to v2.1.5 (#4834)
• feat(controller): Add retry on different host (#4679)
• fix: Metrics documentation (#4829)
• chore: add missing phase option to node cli command (#4825)
• fix(crds): Inline WorkflowSteps schema to generate valid OpenAPI spec (#4828)
• feat(controller): Adding Eventrecorder on LeaderElection
• fix(controller): Various v2.12 fixes. Fixes #4798, #4801, #4806 (#4808)
• fix: Memoize Example (Issue 4626) (#4818)
• feat: Customize workfow metadata from event data (#4783)
• chore: Remove redundant "from" in log message (#4813)
• fix: load all supported authentication plugins for k8s client-go (#4802)
• fix(executor): Do not delete local artifacts after upload. Fixes #4676 (#4697)
• docs: Clarify PNS security (#4789)
• test: Fix TestDeletingRunningPod (#4779)
• refactor(ui): replace node-sass with sass (#4780)
• chore(example): Add watch timeout and print out workflow status message (#4740)
• fix(server): Do not silently ignore sso secret creation error (#4775)
• feat(controller): unix timestamp support on creationTimestamp var (#4763)
• feat(controller): Rate-limit workflows. Closes #4718 (#4726)
• Change argo-server crt/key owner (#4750)
• fix(controller): Support default database port. Fixes #4756 (#4757)
• refactor(controller): Enhanced pod clean-up scalability (#4728)
• test: Improved e2e test robustness (#4758)
• feat: Add a minimal prometheus server manifest (#4687)
• fix(ui): Remove unused Heebo files. Fixes #4730 (#4739)
• fix(controller): Fixes resource version misuse. Fixes #4714 (#4741)
• fix(controller): Requeue when the pod was deleted. Fixes #4719 (#4742)
• fix(controller): Fixed workflow stuck with mutex lock (#4744)
• feat(controller): Enhanced TTL controller scalability (#4736)
• fix(executor): Always check if resource has been deleted in checkResourceState() (#4738)
• fix(executor): Copy main/executor container resources from controller by value instead of reference (#4737)
• docs: Update SSO docs to explain how to use the Argo CD Dex instance with Argo Workflows Server (#4729)
• fix(ui): Fix YAML for workflows with storedWorkflowTemplateSpec. Fixes #4691 (#4695)
• fix: Allow Bearer token in server mode (#4735)
• fix(executor): Deal with the pod watch API call timing out (#4734)
• feat(controller): Pod deletion grace period. Fixes #4719 (#4725)
• docs: minor typo fix (#4727)
• feat(controller): Add Prometheus metric: workflow_ttl_queue (#4722)
• chore: Update stress test files. (#4721)
• fix(controller): Fix incorrect main container customization precedence and isResourcesSpecified check (#4681)
• fix(ui): Fix "Using Your Login". Fixes #4707 (#4708)
• feat(server): Support email for SSO+RBAC. Closes #4612 (#4644)
• fix(controller): Fixed RBAC on leases (#4715)
• fix(controller): Fixed Leader election name (#4709)
• fix(test): Fixed Flaky e2e tests TestSynchronizationWfLevelMutex and TestResourceTemplateStopAndTerminate/ResourceTemplateStop (#4688)
• fix(controller): Fix the RBAC for leader-election (#4706)
• ci: Pin kustomize version (#4704)
• chore: direct users to ask questions on GitHub discussions (#4701)
• fix(controller): Increate default EventSpamBurst in Eventrecorder (#4698)
• feat(controller): HA Leader election support on Workflow-controller (#4622)
• fix: Consider optional artifact arguments (#4672)
• feat(controller): Use deterministic name for cron workflow children (#4638)
• fix(controller): Only patch status.active in cron workflows when syncing (#4659)
• test: Add test for aggrgate parameters (#4682)
• fix(ui): Fixed reconnection hot-loop. Fixes #4580 (#4663)
• feat: Support per-output parameter aggregation (#4374)
• feat(controller): Allow to configure main container resources (#4656)
• fix(controller): Cleanup the synchronize pending queue once Workflow deleted (#4664)
• feat(ui): Make it easy to use SSO login with CLI. Resolves #4630 (#4645)
• feat(ui): add countdown to cronWorkflowList Closes #4636 (#4641)
• feat(ui): Add parameter value enum support to the UI. Fixes #4192 (#4365)
• docs: adding more information about terminate and stop process. Fixes: #4454. (#4653)
• feat: Add shorthanded option -A for --all-namespaces (#4658)
• fix(ui): DataLoaderDropdown fix input type from promise to function that (#4655)
• feat(ui): Replace 3 buttons with drop-down (#4648)
• fix(controller): Deal with hyphen in creator. Fixes #4058 (#4643)
• fix(manifests): Drop capabilities, add CNCF badge. Fixes #2614 (#4633)
• feat(ui): Add links to init and wait logs (#4642)
• feat(executor): Auto create s3 bucket if not present. Closes #3586 (#4574)
• feat(controller): Support .AnySucceeded / .AllFailed for TaskGroup in depends logic. Closes #3405 (#3964)
• fix: Count Workflows with no phase as Pending for metrics (#4628)
• feat(executor): More informative log when executors do not support output param from base image layer (#4620)
• fix(ui): Fix Snyk issues (#4631)
• fix(ui): Reference secrets in EnvVars. Fixes #3973 (#4419)
• fix: derive jsonschema and fix up issues, validate examples dir… (#4611)
• fix(argo-server): fix global variable validation error with reversed dag.tasks (#4369)
• fix: Fix TestCleanFieldsExclude (#4625)
• feat(ui): Add columns--narrower-height to AttributeRow (#4371)
• fix(server): Correct webhook event payload marshalling. Fixes #4572 (#4594)
• fix: Perform fields filtering server side (#4595)
• fix: Null check pagination variable (#4617)
• feat(controller): Enhanced artifact repository ref. See #3184 (#4458)
• fix(executor): Fixed waitMainContainerStart returning prematurely. Closes #4599 (#4601)
• fix(docs): Bring minio chart instructions up to date (#4586)
• fix(controller): Prevent tasks with names starting with digit to use either 'depends' or 'dependencies' (#4598)
• docs: Minor typo fix (#4610)
• refactor: Use polling model for workflow phase metric (#4557)
• docs: Add JSON schema for IDE validation (#4581)
• fix(executor): Handle sidecar killing in a process-namespace-shared pod (#4575)
• fix(server): serve artifacts directly from disk to support large artifacts (#4589)
• fix(server): use the correct name when downloading artifacts (#4579)
• feat(controller): Retry transient offload errors. Resolves #4464 (#4482)
• docs: Fix a typo in example (#4590)
• feat(controller): Make MAX_OPERATION_TIME configurable. Close #4239 (#4562)
• docs: Updated kubectl apply command in manifests README (#4577)

Contributors

• Alastair Maw
• Alex Capras
• Alex Collins
• Alexey Volkov
• Amim Knabben
• Arthur Outhenin-Chalandre
• BOOK
• Basanth Jenu H B
• Daisuke Taniwaki
• Dylan Hellems
• Florian
• Huan-Cheng Chang
• Isaac Gaskin
• J.P. Zivalich
• Jesse Suen
• Kaan C. Fidan
• Ken Kaizu
• Kristoffer Johansson
• Marcin Gucki
• Maximilian Roos
• Michael Albers
• Nelson Rodrigues
• Noah Hanjun Lee
• Paavo Pokkinen
• Paul Brabban
• Roi Kramer
• RossyWhite
• Saravanan Balasubramanian
• Simeon H.K. Fitch
• Simon Behar
• Simon Frey
• Song Juchao
• Stefan Gloutnikov
• Stéphane Este-Gracias
• Takayoshi Nishida
• Tomáš Coufal
• Trevor Wood
• Viktor Farcic
• Wylie Hobbs
• Yuan Tang
• aletepe
• bei-re
• bellevuerails
• cocotyty
• dherman
• drannenberg
• ermeaney
• fsiegmund
• hermanhobnob
• joyciep
• kennytrytek
• lonsdale8734
• makocchi
• markterm
• nishant-d
• saranyaeu2987
• tczhao
• zhengchenyu