DEV Community

Maybe this useless workflow isn’t so useless after all?

Thai Pangsakulyanont on August 27, 2020

My Workflow You probably know about The Most Useless Machine: Let’s build it in GitHub Actions! Submission Category: ...

Read full post

Michael Currin • Sep 30 '20

Would the new workflow dispatch trigger be a good alternative? You can make an action run on that event and exclude pushes etc. And you can trigger via UI button

github.blog/changelog/2020-07-06-g...

Thai Pangsakulyanont • Oct 5 '20 • Edited

Yup, I would use workflow_dispatch when I want to run tasks on the default branch.

(In fact, I have an article on this feature 😁)

Add this `.yml` file to your repo to give it a GitHub Actions-based shell

Thai Pangsakulyanont ・ Aug 19 ・ 2 min read

#actionshackathon #github #opensource

However, if I want to run tasks in context of a PR (or an issue) I think I’d still prefer a label approach.

Michael Currin • Oct 5 '20

Okay great thanks. I haven't used workflow dispatch yet so I'll check that out

Karen Efereyan • Sep 26 '20

Congrats Thai. I have zero knowledge of github actions though. Any resource you'd recommend?

Thai Pangsakulyanont • Oct 3 '20 • Edited

Thanks!

There are many helpful resources on DEV.to but in my opinion the most important resource is GitHub’s official documentation.

You can think of GitHub Actions as like having a brand new computer that can automate things for you based on what happens and what's inside your GitHub Repository. To automate things in your computer you would write shell scripts. So it’s good to also learn the common command-line tools.

For example, consider the command I showed in this post:

curl -X DELETE "https://api.github.com/repos/$GITHUB_REPOSITORY/issues/${{ github.event.issue.number || github.event.pull_request.number }}/labels/useless?access_token=${{ secrets.GITHUB_TOKEN }}"

You can’t find that command in GitHub Docs, but crafting that command takes these knowledge:

Knowledge about GitHub Actions
- that GitHub provides $GITHUB_REPOSITORY environment variable
- that GitHub provides the github.event and secrets contexts available as expressions
- that GitHub provides the GITHUB_SECRET secret and that it can be used with GitHub’s API (with some restrictions)
Knowledge about GitHub’s API
- that the DELETE /repos/{owner}/{repo}/issues/{issue_number}/labels/{name} endpoint removes a label from an issue
Knowledge about GitHub’s system
- that pull requests are also issues, and therefore the API endpoints that work with issues also work with pull requests
Knowledge about making an HTTP request from the command line
- that curl is a commonly available command (other commands can be used too, but I just chose curl because that’s what I’m most familiar with).
  - that -X is used to specify the HTTP method.
Knowledge about shell script
- that we can put environment variables inside double-quoted strings

As you can see just learning from the official documentation may not be enough.

But unlike other systems that requires some setup on a 3rd party service, with GitHub Actions, all you need is a repository and a workflow file. Getting my hands dirty is the most effective way for me to learn something. So, I recommend creating small projects/repositories to try out GitHub Actions on. Here are some of mine:

github-actions-web-page-screenshot... In this project I want to try to make GitHub Actions take a screenshot of a web page.
github-actions-tsc-problem-matcher... In this project I want to set up GitHub Actions so that it displays compile-time errors in the “Files Changed” tab.
action-rotating-light In this project I want to ban a certain word/emoji from the project. For example I picked 🚨 as the forbidden emoji because I use it to mark code as “still unfinished, need to come back and fix this before merging.”

dezren • Apr 28 '21

this comment could be a post in itself, the documentation is great and very accurate but real examples of how we should use it seem a bit lacking. great posts thanks for making them