argoproj/argo-site

Argoproj - Get stuff done with Kubernetes

What is Argoproj?

Argoproj is a collection of tools for getting work done with Kubernetes.

• Argo Workflows - Container-native Workflow Engine
• Argo CD - Declarative GitOps Continuous Delivery
• Argo Events - Event-based Dependency Manager
• Argo Rollouts - Progressive Delivery with support for Canary and Blue Green deployment strategies

Also argoproj-labs is a separate GitHub org that we setup for community contributions related to the Argoproj ecosystem. Repos in argoproj-labs are administered by the owners of each project. Please reach out to us on the Argo slack channel if you have a project that you would like to add to the org to make it easier to others in the Argo community to find, use, and contribute back.

Community Blogs and Presentations

Project specific community blogs and presentations are at

• Argo Workflows
• Argo CD
• Argo Events
• Argo Rollouts

Adopters

Each Argo sub-project maintains its own list of adopters. Those lists are available in the respective project repositories:

• Argo Workflows
• Argo CD
• Argo Events
• Argo Rollouts

Contributing

To learn about how to contribute to Argoproj, see our contributing documentation. Argo contributors must follow the CNCF Code of Conduct.

For help contributing, visit the #argo-contributors channel in CNCF Slack.

To learn about Argoproj governance, see our community governance document.

Project Resources

• Argo Community Meeting Calendar
  • ICS file
• Argo GitHub: https://github.com/argoproj
• Argo website: https://argoproj.github.io
• Argo Slack: https://argoproj.github.io/community/join-slack

argo-site's Issues

Link for Argo CD documantation is not available

The link of "go to the complete documentation" at the bottom of the page is unavailable.

Migrate to Google Analytics 4 (GA4)

This issue is part of a CNCF-wide effort to upgrade project websites to GA4 since Google has deprecated Universal Analytics (UA). For more details, see:

• cncf/techdocs#108, including reference to:
  • A suggested migration process,
    which we've used to migrate a few CNCF projects already.

Tasks: stages 1, 2 & 3

• Create a GA4 site tag under the CNCF projects account.
  The new GA4 stream measurement ID is: G-5Z1VTPDL73
• Connect the following UA IDs from the GA4 web data stream:
  • Main site - UA-105170809-1
  • Blog - UA-105170809-1 - same as main site
  • CD - UA-105170809-2
  • cd.apps.argoproj.io - UA-105170809-6, console. The site ID appears in argo-cd-cm.yaml. Look into GA4 for React apps. @alexmt says it isn't required
  • Events - UA-105170809-9
  • Rollouts - UA-105170809-3
  • Workflows - UA-105170809-7
• Register domains for cross-domain tracking:
  • Exactly match domain name: argo-cd.readthedocs.io
  • Exactly match domain name: argoproj.github.io -- all projects other than CD are served from this domain
• Use GA4 site tag via gtag.js:
  • Main site - UA-105170809-1 - #107
  • CD
    • Prerequisite: argoproj/argo-cd#10850
    • argoproj/argo-cd#11291
    • argoproj/argo-cd#11323
    • 2.4
    • 2.3
    • 1.8?
  • Events - UA-105170809-9 - argoproj/argo-events#2237
  • Rollouts - UA-105170809-3 - argoproj/argo-rollouts#2299
  • Workflows - UA-105170809-7 - argoproj/argo-workflows#9766
• Confirm that the GA4 site tag is receiving events from:
  • Main site
  • CD
  • Events
  • Rollouts
  • Workflows
• Confirm that the UA site tag(s) are still receiving events:
  • Main site - UA-105170809-1
  • CD
  • Events - UA-105170809-9
  • Rollouts - UA-105170809-3
  • Workflows - UA-105170809-7

Later

• #118

/cc @nate-double-u @caniszczyk

---

Current website analytics info:

• GA console https://analytics.google.com/analytics/web/#/report-home/a105170809w198079555p192782995
• UA site tag prefix seems to be UA-105170809 with
  • UA-105170809-1: used by ...
    • This repo? Well, it was at some point, see 8edd65d.
    • blog.argoproj.io - which seems to be a custom domain over Medium
  • UA-105170809-2 used by CD
  • UA-105170809-3 was assigned to argo-rollouts, but isn't currently used.
  • UA-105170809-7 is used by argo-workflows:
    https://github.com/argoproj/argo-workflows/blob/3a32b1b4ef30edf02340cbd92004109d1ae1c143/mkdocs.yml#L26-L28
  • UA-105170809-9 (and previously UA-105170809-2?) used by argo-events (argoproj/argo-events#1406):
    https://github.com/argoproj/argo-events/blob/38f5e249cd030935081b5c71fb8129a38e1d2ea9/mkdocs.yml#L12-L14
• The following doc sites don't appear to have GA enabled:
  • https://github.com/argoproj/argo-cd: https://argo-cd.readthedocs.io
  • https://github.com/argoproj/argo-rollouts: https://argoproj.github.io/argo-rollouts

Google Analytics migration follow up

This is a followup to:

• #102

Once the migration to GA4 has been completed and UA event processing stops:

• Remove the UA ID from
  

  argo-site/gatsby-config.js

  Line 60 in 72294d0

  trackingIds: ["G-5Z1VTPDL73", "UA-105170809-1"],

  
  Done via #119
• Ensure that GA tracking is enabled for production builds only. This applies to the main site as well as subproject sites like CD
• Ensure that GA tracking is enabled for the official sites only, not mirror sites. For an example of a mirror site, see the comment in argoproj/argo-workflows#9766 (comment)

Argo version is out of date

The examples on https://argoproj.github.io/docs/argo/demo.html still deploy Argo v2.2.1

Slack invitation link was expired

The invitation link https://argoproj.github.io/community/join-slack was expired.

This invite link is no longer active.
Please check with the person who shared it with you to see if there's a new link available.

We have to recreate the link.

https://slack.com/help/articles/201330256-Invite-new-members-to-your-workspace#share-an-invite-link

Workspace Owners and Admins can create a link that anyone can use to join their workspace.
Invite links can be used by up to 2,000 people.
You'll need to create a new link if you reach this limit.

External markdown links extension is incorrectly changed to html

Only Internal markdown links extension automatically changed to html, external links should stay untouched. Example: https://github.com/argoproj/argo/blob/master/examples/README.md had been updated to https://github.com/argoproj/argo/blob/master/examples/README.html

https://argoproj.github.io/argo/ doesn't redirect to new page

doc link in
https://argoproj.github.io/projects/argo
should be replaced by
https://argoproj.github.io/argo-workflows/

current behaviour

menu goes outside container

https://argoproj.github.io/docs/argo/examples/readme.html outdated

Page contains the outdated text:
https://github.com/argoproj/argo/blob/master/pkg/apis/workflow/v1alpha1/types.go

Should be (per https://github.com/argoproj/argo/blob/master/examples/README.md):
https://github.com/argoproj/argo/blob/master/pkg/apis/workflow/v1alpha1/workflow_types.go

Assume something missed in (cd ../go/src/github.com/argoproj/argo && git pull https://github.com/argoproj/argo.git), run './scripts/copy-docs.sh', yarn build && yarn deploy steps.

Add info about ArgoCon 2022 with the URL on argoproj.github.io and docs(?)

Let's add some info (text banner? an image banner with the help of CNCF?) about ArgoCon 2022

"ArgoCon 2022 - a vendor-neutral Argo event coming in September 2022 in SF Bay Area. Find out more!"

or something along the line 👆🏼

Slack join link no longer active.

The slack invite on the bottom of the argo workflows page https://argoproj.github.io/argo is no longer active.

Upon clicking on it I am taken to a slack page that says "This invite link is no longer active. Please check with the person who shared it with you to see if there's a new link available."

Implement new docs page navigation

Implementation new design once it is available.

cronworkflowspec. Eample has nothing to do with the subject

https://argoproj.github.io/argo-workflows/fields/#cronworkflowspec

Page overflows on mobile

On mobile, the menu causes the page size to be too wide. Overflow isn't handled properly.

Screen.Recording.2024-06-05.at.11.11.03.AM.mov

Add LF/CNCF Footer (remove Intuit logo at bottom)

See the Envoy footer as an example: https://www.envoyproxy.io/

https://github.com/cncf/foundation/blob/master/website-guidelines.md

Add ArtifactHub packages to website

As part of our ongoing efforts in encouraging better developer experience across different CNCF projects, we figured it would be nice for projects to showcase their packages hosted on ArtifactHub by embedding directly on the website.

To embed all the necessary project-related packages, kindly follow this guide. You can as well view some examples:

• Keptn integration
• Keda

Implement documents search functionality

Autogenerate the list of users from USERS.md in each subproject repos

We had a script to fetch all USERS.md from all subproject repos and then render the logos dynamically on our website. However, for our new version of website, new users need to be added manually and I don't think this gets updated much. https://github.com/argoproj/argo-site/tree/master/content/members

From @alexmt:

we did not update script after migrating to new website.
In old web site we were using logos hosted by clearbit.com so it was enough to just generate list of links. We new design we need to download image.

Just in case here is old script. https://github.com/argoproj/argo-site/blob/faf830d9e19260f69ade594a2857499fa8c31c6c/scripts/logos.sh
We definitely can modify it to work with the new website

Consider dropping yarn

NPM is being used and is sufficient as a package manager. We can also run all scripts using NPM. Why have the extra dependencies of yarn?

update links

http=>https

Per-project landing pages

Need one customized page per project hosted in argo-site.

Anchor link to heading is not working

Click the anchor link (like the 'Argo CLI' link on Examples page) does not jump to the 'Argo CLI' heading

Add Support/Training Page to Top Level Nav

Now that Argo has an official certification
https://training.linuxfoundation.org/certification/certified-argo-project-associate-capa/

... it would be great to add a top level "Training" or "Support/Training" nav item similar to

https://prometheus.io/support-training/

Consider dropping lock files

PR #64 was the first to include NPM and Yarn lock files. Was this by mistake? No other PR since then has updated the lock files. I'd consider dropping the two lock files.

Workflow types link is incorrect

The workflow type link on the Examples page is currently incorrect.
https://argoproj.github.io/docs/argo/examples/readme.html

This error has been fixed in argoproj/argo-workflows#1560, someone who has the access to this repo just need re-run the copy-docs script and deploy again

fix broken link for 3rein media

Currently link to the member "3rein" points to https://3rein.com, which returns "NS_ERROR_UNKNOWN_HOST". This link should point to https://3reinmedia.com.

Fixed in #138

Argo Workflow's Getting Started page is not found

https://argoproj.github.io/docs/argo/demo.html

NOT FOUND
You just hit a route that doesn't exist... the sadness.

The link Getting Started of https://argoproj.github.io/docs/argo/readme.html is broken.

Add API reference docs from swagger

I think it would be super useful to have API docs on the site. Like https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.13/ they should get generated from the swagger definition.