Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion src/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@
- [MacPorts](./installation/macports.md)
- [Nix](./installation/nix.md)
- [Scoop](./installation/scoop.md)
- [Winget](./installation/winget.md)
- [WinGet](./installation/winget.md)
- [Usage guide](./usage/index.md)
- [Runners](./usage/runners.md)
- [Custom container engine](./usage/custom_engine.md)
Expand Down
2 changes: 1 addition & 1 deletion src/installation/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,7 +67,7 @@ go build -ldflags "-X main.version=$(git describe --tags --dirty --always | sed
- [Nix/NixOS](./nix.md) (`Linux`, `macOS`)
- [MacPorts](./macports.md) (`macOS`)
- [Scoop](./scoop.md) (`Windows`)
- [Winget](./winget.md) (`Windows`)
- [WinGet](./winget.md) (`Windows`)

### Packaging status

Expand Down
4 changes: 2 additions & 2 deletions src/installation/winget.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# [Winget](https://learn.microsoft.com/en-us/windows/package-manager/) (Windows)
# [WinGet](https://learn.microsoft.com/en-us/windows/package-manager/) (Windows)

[![Winget package](https://repology.org/badge/version-for-repo/winget/act-run-github-actions.svg)](https://repology.org/project/act-run-github-actions/versions)
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

[![WinGet package](https://repology.org/badge/version-for-repo/winget/act-run-github-actions.svg)](https://repology.org/project/act-run-github-actions/versions)

```shell
winget install nektos.act
Expand Down
2 changes: 1 addition & 1 deletion src/not_supported.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ Here is a list of features that is (yet) to be implemented or is decided as not
- `concurrency` is ignored
- `run-name` is ignored
- Step summary not processed
- Values written in each step to the file pointed by `GITHUB_STEP_SUMMARY`, `$GITHUB_STEP_SUMMARY` and `$env:GITHUB_STEP_SUMMARY` are discarded, each step has it's own empty step summary file at the beginning
- Values written in each step to the file pointed by `GITHUB_STEP_SUMMARY`, `$GITHUB_STEP_SUMMARY` and `$env:GITHUB_STEP_SUMMARY` are discarded, each step has its own empty step summary file at the beginning
- Problem matcher ignored
- Annotations ignored
- Incomplete `github` context
Expand Down
18 changes: 9 additions & 9 deletions src/usage/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -85,7 +85,7 @@ act -W '.github/workflows/checks.yml'

## Jobs

> By default `act` will run **all jobs** in **all workflows** that are triggerred by `push` event
> By default `act` will run **all jobs** in **all workflows** that are triggered by `push` event

```shell=sh
act -j 'test'
Expand All @@ -110,7 +110,7 @@ Example:

To run `act` with repository variables that are accessible inside the workflow via `${{ vars.VARIABLE }}`, you can enter them interactively or load them from a file. The following options are available for providing github repository variables:

- `act --var VARIABLE=somevalue` - use `somevalue` as the value for `VARIABLE`.
- `act --var VARIABLE=some-value` - use `some-value` as the value for `VARIABLE`.
- `act --var-file my.variables` - load variables values from `my.variables` file.
- The variables file format is the same as `.env` format

Expand All @@ -126,7 +126,7 @@ When inserting sensitive data in your terminal, it might be saved as plain text

---

- `act -s MY_SECRET=somevalue` - use `somevalue` as the value for `MY_SECRET`.
- `act -s MY_SECRET=some-value` - use `some-value` as the value for `MY_SECRET`.
- `act -s MY_SECRET` - check for an environment variable named `MY_SECRET` and use it if it exists. If the environment variable is not defined, prompt the user for a value. **This is recommended way of typing/pasting a secret into terminal, as `act` will provide secure input prompt for you to type/paste your secret which will not be saved in your shell history file.**
- `act --secret-file my.secrets` - load secrets values from `my.secrets` file.
- secrets file format is the same as `.env` format
Expand All @@ -139,7 +139,7 @@ If your workflow depends on this token, you need to create a [personal access to
act -s GITHUB_TOKEN=[insert token or leave blank and omit equals for secure input]
```

If [GitHub CLI](https://cli.github.com/) is installed, the [`gh auth token`](https://cli.github.com/manual/gh_auth_token) command can be used to autmatically pass the token to act
If [GitHub CLI](https://cli.github.com/) is installed, the [`gh auth token`](https://cli.github.com/manual/gh_auth_token) command can be used to automatically pass the token to act

```bash
act -s GITHUB_TOKEN="$(gh auth token)"
Expand Down Expand Up @@ -231,7 +231,7 @@ jobs:

### via input or input-file flag

- `act --input NAME=somevalue` - use `somevalue` as the value for `NAME` input.
- `act --input NAME=some-value` - use `some-value` as the value for `NAME` input.
- `act --input-file my.input` - load input values from `my.input` file.
- input file format is the same as `.env` format

Expand Down Expand Up @@ -295,18 +295,18 @@ Similarly if we just wanted to trigger this workflow for node 10 and macos-lates
This will trigger the workflow to use the following matrix configurations only:
- `os: macos-latest, node 10`

Note that using the `--matrix` flag you can't add new values (for e.g. running the above workflow for node 20). It will simply ignore it. Moreover, the `exclude` field in the workflow will take precedance over the `--matrix` flag (for e.g. running the above workflow for only macos-latest and node 4 will result in no matrix configuration being used)
Note that using the `--matrix` flag you can't add new values (for e.g. running the above workflow for node 20). It will simply ignore it. Moreover, the `exclude` field in the workflow will take precedence over the `--matrix` flag (for e.g. running the above workflow for only macos-latest and node 4 will result in no matrix configuration being used)

## Action Offline Mode

If you want to speed up running act and using cached actions and container images you can enable this mode.

- stops pulling existing images
- stops failing if an action has been cached and you cannot connect to GitHub
- pulls non existent actions and images
- pulls nonexistent actions and images
- act will work offline if it has at least ran once while you are online
- get rid of unnecessary timeouts when you have an unstable connection to GitHub or Container registries
- workaround rate limit problems
- work around rate limit problems

```sh
act --action-offline-mode
Expand All @@ -327,7 +327,7 @@ or a `.actrc` file in your cwd like

to enable this feature use the cli flag `--artifact-server-path $PWD/.artifacts`.

While enabled these values are also available in `run` steps, which doesn't match `actions/runner` aka GitHub Actions where their are blank.
While enabled these values are also available in `run` steps, which doesn't match `actions/runner` aka GitHub Actions where they are blank.

Currently `actions/upload-artifact@v3` and `actions/upload-artifact@v4` together with `actions/download-artifact@v3` and `actions/download-artifact@v4` should be able to upload and download their artifacts within the current workflow run.

Expand Down
4 changes: 2 additions & 2 deletions src/usage/runners.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ In order for `act` to run your workflows locally, it must run a container for th
[micro]: https://hub.docker.com/_/buildpack-deps
[docker_images]: https://github.com/catthehacker/docker_images

If you want to run Windows and macOS based platforms and you are running act within that specfic environment you can opt out of docker and run them directly on your host system.
If you want to run Windows and macOS based platforms and you are running act within that specific environment you can opt out of docker and run them directly on your host system.

Here are some examples
```sh
Expand Down Expand Up @@ -62,7 +62,7 @@ act -P ubuntu-18.04=nektos/act-environments-ubuntu:18.04 -P ubuntu-latest=ubuntu

### Using local runner images

The `--pull` flag is set to true by default due to a breaking on older default docker images. This would pull the docker image everytime act is executed.
The `--pull` flag is set to true by default due to a breaking on older default docker images. This would pull the docker image every time act is executed.

Set `--pull` to false if a local docker image is needed
```sh
Expand Down