39 captures
19 Feb 2020 - 03 Jan 2024
Sep OCT Nov
04
2019 2020 2021
success
fail

About this capture

COLLECTED BY

Collection: Save Page Now

TIMESTAMPS

The Wayback Machine - http://web.archive.org/web/20201004082513/https://lab.github.com/githubtraining/github-actions:-writing-javascript-actions
  


Learning Lab  
For Organizations  Teach on Learning Lab  
Sign in  







GitHub Actions: Writing JavaScript Actions  




Learn how to write your own GitHub JavaScript Action! This course will empower you to begin automating customized tasks unique to your workflow.  
Start free course   Join 747 others!  


social preview







GitHub Actions is a powerful platform that empowers your team to go from code to cloud all from the comfort of your own repositories.
Over the duration of this course you will learn the skills needed to begin using and customizing GitHub Actions to fit your unique workflow scenarios.

What you'll learn


In this course you will learn how to:

●Consume actions within a workflow file
●Create custom JavaScript based actions
●Publish your newly created action to the marketplace

You'll know the answers to questions like:

●What is a workflow?
●What are actions?
●What is action metadata?
●What are GitHub Actions capable of?

What you'll build


screenshot of a pull request in the course with instructions on how to fetch a joke from the API, a second screenshot of a workflow running and outputting the joke: "Guy told me today he did not know what cloning is. I told him, that makes 2 of us."
In this course you will build three actions that each accomplish different tasks designed to demonstrate the flexibility of creating and consuming JavaScript Based Actions.
First, you will start with the traditional "Hello World!" program which will teach you where to find the output of a workflow run. You will then modify this "Hello World!" action to accept input parameters which allow the action to be more dynamic. 
Second, you will write an action that call upon an external API to retrieve a fact about cats and prints it to the workflows output. You will then modify this cat fact action to set the retrieved data as output for another action in the workflow to consume.
Lastly, you will write a third action that will open an issue in your repository making the cat fact available to everyone. You will learn how to use the output of previous actions as input for current actions in this step.

Prerequisites


We first recommend taking the following courses:

●Hello, GitHub Actions! to learn the basics of how GitHub Actions work
●GitHub Actions: Continuous Integration to dive deeper into a workflow file

Projects used


This makes use of the following open source projects. Consider exploring these repos and maybe even making contributions!

●GitHub Actions Toolkit, a multipurpose JavaScript library for writing actions

Audience


Developers, DevOps Engineers, students, teams
  
Steps to complete this course  20




Setup a workflow file


Create a pull request to add a workflow
 






Run a workflow


Wait for GitHub to run the workflow and report back the results
 






Prep the workflow


Prepare the workflow for your future action
 






Add an Action reference


Add an Action reference to the workflow file
 






On to your development environment


Lets prepare your environment to start writing Actions
 






Creating the Action metadata


Create an action.yml file and add necessary metatdata for our Action
 






Create the Action entrypoint


Add code to main.js file
 






Exploring your input parameters


View the results of adding input parameter
 






Integrating Actions with external APIs


Write a new Action that calls an external API
 






Prevent the workflow from running


Comment out the lines in the workflow to prevent unwanted runs
 






Install dependencies for the second action


Create a directory for your new action dependencies
 






Create your new Action metadata


Add action.yml file for new joke action
 






Create your Actions JavaScript files


Add joke.js and main.js to your Action
 






Use the joke Action in a workflow


Edit the workflow file to now use the newly created joke Action
 






Having Actions tell a joke... or two


Wait for your Action to present you with a joke
 






Write the final Action


Create an Action that consumes output from another Action and uses Octokit
 






Add third Actions metadata


Create the metadata for the third Action
 






Add third Actions JavaScript files


Create the JavaScript files for the third Action
 






Trigger the third Action


Add a pull request label to trigger the workflow
 






Wrapping things up


Final notes before you go
 





Tags


JavaScript

API

Actions toolkit

GitHub Secrets

Workflows
 

Share  this course  

Average time to complete

473 minutes
  

Free

All public courses on Learning Lab are free.
  

Get help

Post on the GitHub Community Forum
  
Latest release


 


Learning Paths that include this course







DevOps with GitHub Actions  


byThe GitHub Training Team  
Learn how to do DevOps on GitHub with the power of GitHub Actions! This path will guide you through...
  








Users who took this course also took







GitHub Actions: Publish to GitHub Packages  


byThe GitHub Training Team  
This course will walk you through using GitHub Actions to get your code in a deployable state once...
  






GitHub Actions: Continuous Integration  


byThe GitHub Training Team  
Learn how to create workflows that enable you to use Continuous Integration (CI) for your projects.
  






GitHub Actions: Hello World  


byThe GitHub Training Team  
Create a GitHub Action and use it in a workflow.
  















What is GitHub Learning Lab?


Learn new skills by completing fun, realistic projects in your very own GitHub repository.
  

Ready to start learning?

  Start GitHub Actions: Writing JavaScript Actions  









●© 2020 GitHub, Inc.
●Contact GitHub
●Blog
●About
  


●Community
●Help Center
●API
●Terms