2.3 KiB
GitHub Actions Toolkit
The GitHub Actions ToolKit provides a set of packages to make creating actions easier and drive consistency.
Packages
The toolkit provides five separate packages. See the docs for each action.
| Package | Description |
|---|---|
| @actions/core | Core functions for getting inputs, setting outputs, setting results, logging, secrets and environment variables |
| @actions/exec | Functions necessary for running tools on the command line |
| @actions/io | Core functions for CLI filesystem scenarios |
| @actions/tool-cache | Functions necessary for downloading and caching tools |
| @actions/github | An Octokit client hydrated with the context that the current action is being run in |
Creating an Action with the Toolkit
Actions run in a container or on the host machine.
Choosing an action type: Outlines the differences and why you would want to create a JavaScript or a container based action.
Hello World JavaScript Action: Illustrates how to create a simple hello world javascript action.
JavaScript Action Walkthrough: Walkthrough creating a JavaScript Action with tests, linting, workflow, publishing, and versioning.
TypeScript Action Walkthrough: Walkthrough creating a TypeScript Action with compilation, tests, linting, workflow, publishing, and versioning.
Docker Action Walkthrough: Create an action that is delivered as a container and run with docker.
Docker Action Walkthrough with Octokit: Create an action that is delivered as a container which uses the toolkit. This example uses the GitHub context to construct an Octokit client.
Versioning: Recommendations on versioning, releases and tagging your action.
Contributing
We welcome contributions. See how to contribute.