Skip to content

Commit

Permalink
docs: update doc links to readthedocs/release-3.4
Browse files Browse the repository at this point in the history
Relates to argoproj#12414

- [x] updated docs links to https://argo-workflows.readthedocs.io/en/release-3.4
- [x] updated github issues config (like we did in main) to point to latest

Signed-off-by: jmeridth <[email protected]>
  • Loading branch information
jmeridth committed Jan 5, 2024
1 parent a347233 commit 4845d3f
Show file tree
Hide file tree
Showing 455 changed files with 483 additions and 483 deletions.
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ blank_issues_enabled: false

contact_links:
- name: Have you read the docs?
url: https://argoproj.github.io/argo-workflows/
url: https://argo-workflows.readthedoc.io/en/latest
about: Much help can be found in the docs
- name: Ask a question
url: https://github.com/argoproj/argo-workflows/discussions/new
Expand Down
12 changes: 6 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,12 +21,12 @@ Argo is a [Cloud Native Computing Foundation (CNCF)](https://cncf.io/) hosted pr

## Use Cases

* [Machine Learning pipelines](https://argoproj.github.io/argo-workflows/use-cases/machine-learning/)
* [Data and batch processing](https://argoproj.github.io/argo-workflows/use-cases/data-processing/)
* [Infrastructure automation](https://argoproj.github.io/argo-workflows/use-cases/infrastructure-automation/)
* [CI/CD](https://argoproj.github.io/argo-workflows/use-cases/ci-cd/)
* [Machine Learning pipelines](https://argo-workflows.readthedocs.io/en/release-3.4/use-cases/machine-learning/)
* [Data and batch processing](https://argo-workflows.readthedocs.io/en/release-3.4/use-cases/data-processing/)
* [Infrastructure automation](https://argo-workflows.readthedocs.io/en/release-3.4/use-cases/infrastructure-automation/)
* [CI/CD](https://argo-workflows.readthedocs.io/en/release-3.4/use-cases/ci-cd/)
* ETL
* [Other use cases](https://argoproj.github.io/argo-workflows/use-cases/other/)
* [Other use cases](https://argo-workflows.readthedocs.io/en/release-3.4/use-cases/other/)

## Why Argo Workflows?

Expand All @@ -47,7 +47,7 @@ Argo is a [Cloud Native Computing Foundation (CNCF)](https://cncf.io/) hosted pr

## Documentation

[View the docs](https://argoproj.github.io/argo-workflows/)
[View the docs](https://argo-workflows.readthedocs.io/en/release-3.4/)

## Ecosystem

Expand Down
2 changes: 1 addition & 1 deletion api/openapi-spec/swagger.json
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@
],
"swagger": "2.0",
"info": {
"description": "Argo Workflows is an open source container-native workflow engine for orchestrating parallel jobs on Kubernetes. For more information, please see https://argoproj.github.io/argo-workflows/",
"description": "Argo Workflows is an open source container-native workflow engine for orchestrating parallel jobs on Kubernetes. For more information, please see https://argo-workflows.readthedocs.io/en/release-3.4/",
"title": "Argo Workflows API",
"version": "VERSION"
},
Expand Down
2 changes: 1 addition & 1 deletion cmd/argo/commands/common/get_test.go
Original file line number Diff line number Diff line change
Expand Up @@ -422,7 +422,7 @@ func Test_printWorkflowHelperNudges(t *testing.T) {

securityNudges := "This workflow does not have security context set. " +
"You can run your workflow pods more securely by setting it.\n" +
"Learn more at https://argoproj.github.io/argo-workflows/workflow-pod-security-context/\n"
"Learn more at https://argo-workflows.readthedocs.io/en/release-3.4/workflow-pod-security-context/\n"

t.Run("SecuredWorkflow", func(t *testing.T) {
output := PrintWorkflowHelper(&securedWf, GetFlags{})
Expand Down
4 changes: 2 additions & 2 deletions cmd/argo/commands/server.go
Original file line number Diff line number Diff line change
Expand Up @@ -138,7 +138,7 @@ See %s`, help.ArgoServer),
}

} else {
log.Warn("You are running in insecure mode. Learn how to enable transport layer security: https://argoproj.github.io/argo-workflows/tls/")
log.Warn("You are running in insecure mode. Learn how to enable transport layer security: https://argo-workflows.readthedocs.io/en/release-3.4/tls/")
}

modes := auth.Modes{}
Expand All @@ -149,7 +149,7 @@ See %s`, help.ArgoServer),
}
}
if reflect.DeepEqual(modes, auth.Modes{auth.Server: true}) {
log.Warn("You are running without client authentication. Learn how to enable client authentication: https://argoproj.github.io/argo-workflows/argo-server-auth-mode/")
log.Warn("You are running without client authentication. Learn how to enable client authentication: https://argo-workflows.readthedocs.io/en/release-3.4/argo-server-auth-mode/")
}

opts := apiserver.ArgoServerOpts{
Expand Down
2 changes: 1 addition & 1 deletion config/config.go
Original file line number Diff line number Diff line change
Expand Up @@ -97,7 +97,7 @@ type Config struct {
InitialDelay metav1.Duration `json:"initialDelay,omitempty"`

// The command/args for each image, needed when the command is not specified and the emissary executor is used.
// https://argoproj.github.io/argo-workflows/workflow-executors/#emissary-emissary
// https://argo-workflows.readthedocs.io/en/release-3.4/workflow-executors/#emissary-emissary
Images map[string]Image `json:"images,omitempty"`

RetentionPolicy *RetentionPolicy `json:"retentionPolicy,omitempty"`
Expand Down
2 changes: 1 addition & 1 deletion docs/argo-server-sso-argocd.md
Original file line number Diff line number Diff line change
Expand Up @@ -85,7 +85,7 @@ metadata:
data:
# SSO Configuration for the Argo server.
# You must also start argo server with `--auth-mode sso`.
# https://argoproj.github.io/argo-workflows/argo-server-auth-mode/
# https://argo-workflows.readthedocs.io/en/release-3.4/argo-server-auth-mode/
sso: |
# This is the root URL of the OIDC provider (required).
issuer: https://argo-cd.mydomain.com/api/dex
Expand Down
2 changes: 1 addition & 1 deletion docs/cli/argo_server.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ argo server [flags]

```
See https://argoproj.github.io/argo-workflows/argo-server/
See https://argo-workflows.readthedocs.io/en/release-3.4/argo-server/
```

### Options
Expand Down
8 changes: 4 additions & 4 deletions docs/lifecyclehook.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
## Introduction

A [`LifecycleHook`](https://argoproj.github.io/argo-workflows/fields/#lifecyclehook) triggers an action based on a conditional expression. It is configured either at the workflow-level or template-level, for instance as a function of the `workflow.status` or `steps.status`, respectively. A `LifecycleHook` executes during execution time and executes once.
A [`LifecycleHook`](https://argo-workflows.readthedocs.io/en/release-3.4/fields/#lifecyclehook) triggers an action based on a conditional expression. It is configured either at the workflow-level or template-level, for instance as a function of the `workflow.status` or `steps.status`, respectively. A `LifecycleHook` executes during execution time and executes once.

In other words, a `LifecycleHook` functions like an [exit handler](https://github.com/argoproj/argo-workflows/blob/master/examples/exit-handlers.yaml) with a conditional expression.

Expand All @@ -19,13 +19,13 @@ In other words, a `LifecycleHook` functions like an [exit handler](https://githu
## Supported conditions

- [Exit handler variables](https://github.com/argoproj/argo-workflows/blob/ebd3677c7a9c973b22fa81ef3b409404a38ec331/docs/variables.md#exit-handler): `workflow.status` and `workflow.failures`
- [`template`](https://argoproj.github.io/argo-workflows/fields/#template)
- [`templateRef`](https://argoproj.github.io/argo-workflows/fields/#templateref)
- [`template`](https://argo-workflows.readthedocs.io/en/release-3.4/fields/#template)
- [`templateRef`](https://argo-workflows.readthedocs.io/en/release-3.4/fields/#templateref)
- [`arguments`](https://github.com/argoproj/argo-workflows/blob/master/examples/conditionals.yaml)

## Unsupported conditions

- [`outputs`](https://argoproj.github.io/argo-workflows/fields/#outputs) are not usable since `LifecycleHook` executes during execution time and `outputs` are not produced until the step is completed.
- [`outputs`](https://argo-workflows.readthedocs.io/en/release-3.4/fields/#outputs) are not usable since `LifecycleHook` executes during execution time and `outputs` are not produced until the step is completed.

## Notification use case

Expand Down
6 changes: 3 additions & 3 deletions docs/offloading-large-workflows.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,6 @@ size limit. To resolve, either enable node status offload as described
above or look for ways to reduce the size of your workflow manifest:

- Use `withItems` or `withParams` to consolidate similar templates into a single parametrized template
- Use [template defaults](https://argoproj.github.io/argo-workflows/template-defaults/) to factor shared template options to the workflow level
- Use [workflow templates](https://argoproj.github.io/argo-workflows/workflow-templates/) to factor frequently-used templates into separate resources
- Use [workflows of workflows](https://argoproj.github.io/argo-workflows/workflow-of-workflows/) to factor a large workflow into a workflow of smaller workflows
- Use [template defaults](https://argo-workflows.readthedocs.io/en/release-3.4/template-defaults/) to factor shared template options to the workflow level
- Use [workflow templates](https://argo-workflows.readthedocs.io/en/release-3.4/workflow-templates/) to factor frequently-used templates into separate resources
- Use [workflows of workflows](https://argo-workflows.readthedocs.io/en/release-3.4/workflow-of-workflows/) to factor a large workflow into a workflow of smaller workflows
2 changes: 1 addition & 1 deletion docs/retries.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@ Use `retryPolicy` to choose which failures to retry:
- `Always`: Retry all failed steps
- `OnFailure`: Retry steps whose main container is marked as failed in Kubernetes (this is the default)
- `OnError`: Retry steps that encounter Argo controller errors, or whose init or wait containers fail
- `OnTransientError`: Retry steps that encounter errors [defined as transient](https://github.com/argoproj/argo-workflows/blob/master/util/errors/errors.go), or errors matching the `TRANSIENT_ERROR_PATTERN` [environment variable](https://argoproj.github.io/argo-workflows/environment-variables/). Available in version 3.0 and later.
- `OnTransientError`: Retry steps that encounter errors [defined as transient](https://github.com/argoproj/argo-workflows/blob/master/util/errors/errors.go), or errors matching the `TRANSIENT_ERROR_PATTERN` [environment variable](https://argo-workflows.readthedocs.io/en/release-3.4/environment-variables/). Available in version 3.0 and later.

For example:

Expand Down
4 changes: 2 additions & 2 deletions docs/walk-through/artifacts.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

**Note:**
You will need to configure an artifact repository to run this example.
[Configuring an artifact repository here](https://argoproj.github.io/argo-workflows/configure-artifact-repository/).
[Configuring an artifact repository here](https://argo-workflows.readthedocs.io/en/release-3.4/configure-artifact-repository/).

When running workflows, it is very common to have steps that generate or consume artifacts. Often, the output artifacts of one step may be used as input artifacts to a subsequent step.

Expand Down Expand Up @@ -114,7 +114,7 @@ Artifacts are packaged as Tarballs and gzipped by default. You may customize thi

## Artifact Garbage Collection

As of version 3.4 you can configure your Workflow to automatically delete Artifacts that you don't need (visit [artifact repository capability](https://argoproj.github.io/argo-workflows/configure-artifact-repository/) for the current supported store engine).
As of version 3.4 you can configure your Workflow to automatically delete Artifacts that you don't need (visit [artifact repository capability](https://argo-workflows.readthedocs.io/en/release-3.4/configure-artifact-repository/) for the current supported store engine).

Artifacts can be deleted `OnWorkflowCompletion` or `OnWorkflowDeletion`. You can specify your Garbage Collection strategy on both the Workflow level and the Artifact level, so for example, you may have temporary artifacts that can be deleted right away but a final output that should be persisted:

Expand Down
4 changes: 2 additions & 2 deletions docs/workflow-controller-configmap.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -187,7 +187,7 @@ data:
kubeletInsecure: false

# The command/args for each image, needed when the command is not specified and the emissary executor is used.
# https://argoproj.github.io/argo-workflows/workflow-executors/#emissary-emissary
# https://argo-workflows.readthedocs.io/en/release-3.4/workflow-executors/#emissary-emissary
images: |
argoproj/argosay:v2:
cmd: [/argosay]
Expand Down Expand Up @@ -334,7 +334,7 @@ data:
# SSO Configuration for the Argo server.
# You must also start argo server with `--auth-mode sso`.
# https://argoproj.github.io/argo-workflows/argo-server-auth-mode/
# https://argo-workflows.readthedocs.io/en/release-3.4/argo-server-auth-mode/
sso: |
# This is the root URL of the OIDC provider (required).
issuer: https://issuer.root.url/
Expand Down
2 changes: 1 addition & 1 deletion examples/README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,3 @@
# Documentation by Example

This has been moved to [the docs](https://argoproj.github.io/argo-workflows/walk-through/).
This has been moved to [the docs](https://argo-workflows.readthedocs.io/en/release-3.4/walk-through/).
2 changes: 1 addition & 1 deletion examples/input-artifact-s3.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ spec:
key: path/in/bucket
# Specify the bucket region. Note that if you want Argo to figure out this automatically,
# you can set additional statement policy that allows `s3:GetBucketLocation` action.
# For details, check out: https://argoproj.github.io/argo-workflows/configure-artifact-repository/#configuring-aws-s3
# For details, check out: https://argo-workflows.readthedocs.io/en/release-3.4/configure-artifact-repository/#configuring-aws-s3
region: us-west-2
# accessKeySecret and secretKeySecret are secret selectors.
# It references the k8s secret named 'my-s3-credentials'.
Expand Down
2 changes: 1 addition & 1 deletion examples/key-only-artifact.yaml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
# this example shows how to use key-only artifacts - introduced in v3.0
# https://argoproj.github.io/argo-workflows/key-only-artifacts/
# https://argo-workflows.readthedocs.io/en/release-3.4/key-only-artifacts/
apiVersion: argoproj.io/v1alpha1
kind: Workflow
metadata:
Expand Down
2 changes: 1 addition & 1 deletion examples/output-artifact-s3.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ spec:
bucket: my-bucket
# Specify the bucket region. Note that if you want Argo to figure out this automatically,
# you can set additional statement policy that allows `s3:GetBucketLocation` action.
# For details, check out: https://argoproj.github.io/argo-workflows/configure-artifact-repository/#configuring-aws-s3
# For details, check out: https://argo-workflows.readthedocs.io/en/release-3.4/configure-artifact-repository/#configuring-aws-s3
region: us-west-2

# NOTE: by default, output artifacts are automatically tarred and gzipped before saving.
Expand Down
2 changes: 1 addition & 1 deletion hack/release-notes.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ Find out on [our blog](https://blog.argoproj.io) and [changelog](https://github.

## Breaking Changes and Known Issues

Check the [upgrading guide](https://argoproj.github.io/argo-workflows/upgrading/) and search for [existing issues on GitHub](https://github.com/argoproj/argo-workflows/issues).
Check the [upgrading guide](https://argo-workflows.readthedocs.io/en/release-3.4/upgrading/) and search for [existing issues on GitHub](https://github.com/argoproj/argo-workflows/issues).

## Installation

Expand Down
2 changes: 1 addition & 1 deletion manifests/README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Argo Install Manifests

Please read [installation](https://argoproj.github.io/argo-workflows/installation/)
Please read [installation](https://argo-workflows.readthedocs.io/en/release-3.4/installation/)

2 changes: 1 addition & 1 deletion manifests/quick-start/base/agent-role.yaml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# https://argoproj.github.io/argo-workflows/workflow-rbac/
# https://argo-workflows.readthedocs.io/en/release-3.4/workflow-rbac/
apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
Expand Down
2 changes: 1 addition & 1 deletion manifests/quick-start/base/artifactgc-role.yaml
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# https://argoproj.github.io/argo-workflows/workflow-rbac/
# https://argo-workflows.readthedocs.io/en/release-3.4/workflow-rbac/
apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
Expand Down
2 changes: 1 addition & 1 deletion pkg/apiclient/_.primary.swagger.json
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@
"host": "localhost:2746",
"info": {
"title": "Argo Workflows API",
"description": "Argo Workflows is an open source container-native workflow engine for orchestrating parallel jobs on Kubernetes. For more information, please see https://argoproj.github.io/argo-workflows/",
"description": "Argo Workflows is an open source container-native workflow engine for orchestrating parallel jobs on Kubernetes. For more information, please see https://argo-workflows.readthedocs.io/en/release-3.4/",
"version": "VERSION"
},
"securityDefinitions": {
Expand Down
2 changes: 1 addition & 1 deletion pkg/apis/workflow/v1alpha1/workflow_types.go
Original file line number Diff line number Diff line change
Expand Up @@ -1155,7 +1155,7 @@ func (a *ArtifactLocation) Get() (ArtifactLocationType, error) {
} else if a.S3 != nil {
return a.S3, nil
}
return nil, fmt.Errorf("You need to configure artifact storage. More information on how to do this can be found in the docs: https://argoproj.github.io/argo-workflows/configure-artifact-repository/")
return nil, fmt.Errorf("You need to configure artifact storage. More information on how to do this can be found in the docs: https://argo-workflows.readthedocs.io/en/release-3.4/configure-artifact-repository/")
}

// SetType sets the type of the artifact to type the argument.
Expand Down
2 changes: 1 addition & 1 deletion pkg/apis/workflow/v1alpha1/workflow_types_test.go
Original file line number Diff line number Diff line change
Expand Up @@ -433,7 +433,7 @@ func TestArtifactLocation_Get(t *testing.T) {

v, err = (&ArtifactLocation{}).Get()
assert.Nil(t, v)
assert.EqualError(t, err, "You need to configure artifact storage. More information on how to do this can be found in the docs: https://argoproj.github.io/argo-workflows/configure-artifact-repository/")
assert.EqualError(t, err, "You need to configure artifact storage. More information on how to do this can be found in the docs: https://argo-workflows.readthedocs.io/en/release-3.4/configure-artifact-repository/")

v, _ = (&ArtifactLocation{Azure: &AzureArtifact{}}).Get()
assert.IsType(t, &AzureArtifact{}, v)
Expand Down
2 changes: 1 addition & 1 deletion sdks/python/client/argo_workflows/__init__.py

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion sdks/python/client/argo_workflows/api/event_service_api.py

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

Loading

0 comments on commit 4845d3f

Please sign in to comment.