argoproj-labs / training-material

Argo Workflows Killercoda Training Material

Open the material on Killercoda here.

Maintainers

• Tim Collins, Pipekit
• Caelan Urquhart, Pipekit

Thank you to the following for their outsized contributions to this course:

• Alex Collins, Intuit
• Yuan Tang, Akuity

Contributing

Changes are propagated to Killercoda's CDN once committed to the main branch. So this means your changes must be on main to be seen. This means you will need to fork this repo and set up your own Killercoda scenario in order to preview your changes.

If you open a PR with major changes to the code or assets (i.e. not just changing text or fixing typos), please include a link to your version of the Killercoda course (if possible) so we can preview it before merging.

Tips:

• Killercoda can take a few minutes to replicate changes, so it can be easier to link to assets than to embed them.
• Once you've created a Creator account with Killercoda, you can see when changes were pulled by looking at your scenarios page. You can also manually trigger the webhook from this page to view your updates on main.

Killercoda docs:

• FAQ
• For course creators
• For students

training-material's Issues

Killercoda is unusably slow

Not much we can do about it but I thought I'd raise an issue for awareness.

The automated installation is taking 10 mins (if it succeedes at all). Locally it takes 30s. Typically it would take 1 minute in killercoda normally.

Templates Scenario needs to be updated for Hooks

Nice tutorials but the last part of the Templates scenario demonstrates onExit.
The doc say onExit is "DEPRECATED: Use Hooks[exit].Template instead."

502 Bad gateway

The argo with the link not working 502 Bad gateway

Unable to access UI in the getting started lab

Can't access the URL because of HTTP/HTTPS variance.

`To check this is working correctly, you can curl the info API:

curl -kv http://localhost:2746/api/v1/info

You should see HTTP/1.1 200 OK.`

expected behavior:
access it without issues

actual behavior:
can't access it

ref: https://www.katacoda.com/argoproj/courses/argo-workflows/getting-started

Make a course for setting up SSO

Hello,

It be great if there was a course that shows how to set up SSO. Possibly, the connecting to an Argo CD Dex (https://argoproj.github.io/argo-workflows/argo-server-sso-argocd/).

I just have been struggling with the SSO, and thought this would be good for training. I think the thing I am having the most issues now is with the service accounts and how those are deployed and how users are attached to them.

A training course that showed this would be very helpful!

There seems to be an issue with the serviceaccounts/role/rolebindings

When following along with the tutorial the workflows fail because of the argo default serviceaccount not having the right rolebinding.

NAMESPACE   NAME                STATUS   AGE   MESSAGE
argo        hello               Error    20m   Error (exit code 1): pods "hello" is forbidden: User "system:serviceaccount:argo:default" cannot patch resource "pods" in API group "" in the namespace "argo"
argo        hello-world-mhq7x   Error    13m   Error (exit code 1): pods "hello-world-mhq7x" is forbidden: User "system:serviceaccount:argo:default" cannot patch resource "pods" in API group "" in the namespace "argo"

Repo needs linting

Python Scenario fails

I realize this is a "work in progress" but I was not able to even start. The install of couler fails:

controlplane $ pip3 install git+https://github.com/couler-proj/[email protected]
Collecting git+https://github.com/couler-proj/[email protected]
  Cloning https://github.com/couler-proj/couler (to revision v0.1.1rc8-stable) to /tmp/pip-req-build-yj7xv69q
Collecting Deprecated
  Downloading Deprecated-1.2.12-py2.py3-none-any.whl (9.5 kB)
...
Successfully built couler wrapt
Installing collected packages: wrapt, Deprecated, websocket-client, docker, pyyaml, oauthlib, requests-oauthlib, pyasn1, rsa, cachetools, pyasn1-modules, google-auth, python-dateutil, urllib3, kubernetes, pyaml, couler
  Attempting uninstall: pyyaml
    Found existing installation: PyYAML 3.12
ERROR: Cannot uninstall 'PyYAML'. It is a distutils installed project and thus we cannot accurately determine which files belong to it which would lead to only a partial uninstall.
WARNING: You are using pip version 20.2.4; however, version 21.2.4 is available.
You should consider upgrading via the '/usr/bin/python3.8 -m pip install --upgrade pip' command.

controlplane $ python3 coin_flip_example.py
Traceback (most recent call last):
  File "coin_flip_example.py", line 1, in <module>
    import couler.argo as couler
ModuleNotFoundError: No module named 'couler'

Example workflows don't work

First of all I just want to thank you for your service..

I'm trying to learn argo and was trying out this katacoda scenario.

I followed the katacoda instructions (as in I pressed the buttons in the sidepane to enter the commands), but the workflows did not complete successfully?

My environment:

• I use a VPN
• I'm on a macbook and use Chrome as the browser.

Just thought I'd let someone know.

Thanks again!

Can't exit from the VIM editor in the web terminal

Hi, all, thanks for your work first.

I met a problem that when I try to finish the exercise by using the VIM editor to change an example, I can't find a way to save and exit the VIM editor.
More specifically, after I enter the insert mode and make some change, I can't exit to the normal mode by press [Esc], since I just lost the focus of the web terminal.

If you already know this issue, please teach me how to resolve this problem.
Or, hope this issue can help you make this project better.

Dependency Dashboard

This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Open

These updates have all been created already. Click a checkbox below to force a retry/rebase of any.

• chore(deps): update oxsecurity/megalinter action to v7.11.1

Detected dependencies

github-actions

.github/workflows/megalinter.yml

• actions/checkout v4
• oxsecurity/megalinter v7.11.0
• actions/upload-artifact v4

kubernetes

argo-workflows/api/assets/hello-workflowtemplate.yaml

argo-workflows/getting-started/assets/hello-workflow.yaml

argo-workflows/inputs-and-outputs/assets/artifacts-workflow.yaml

argo-workflows/inputs-and-outputs/assets/input-parameters-workflow.yaml

argo-workflows/inputs-and-outputs/assets/parameters-workflow.yaml

argo-workflows/reuse/assets/hello-workflowtemplate.yaml

argo-workflows/templates/assets/container-workflow.yaml

argo-workflows/templates/assets/dag-workflow.yaml

argo-workflows/templates/assets/exit-handler-workflow.yaml

argo-workflows/templates/assets/template-tag-workflow.yaml

argo-workflows/templates/assets/with-items-workflow.yaml

argo-workflows/templates/assets/with-sequence-workflow.yaml

config/argo-events/minio-sensor.yaml

config/argo-events/sa.yaml

• ClusterRole rbac.authorization.k8s.io/v1
• ClusterRoleBinding rbac.authorization.k8s.io/v1

config/argo-workflows/canary-workflow.yaml

config/argo-workflows/patchpod.yaml

• Role rbac.authorization.k8s.io/v1
• RoleBinding rbac.authorization.k8s.io/v1

config/minio/minio.yaml

• groundnuty/k8s-wait-for v2.0
• Deployment apps/v1
• ClusterRole rbac.authorization.k8s.io/v1
• ClusterRoleBinding rbac.authorization.k8s.io/v1

regex

argo-workflows/getting-started/cli.md

• argoproj/argo-workflows v3.5.6

argo-workflows/getting-started/install.md

• argoproj/argo-workflows v3.5.6

argo-workflows/install.sh

• argoproj/argo-workflows v3.5.6

argo-workflows/argo-events/install-events.md

• argoproj/argo-events v1.9.1

---

• Check this box to trigger a request for Renovate to run again on this repository