act-commando: opties en 11 voorbeelden

Dit deel is nog niet vertaald. Je ziet de Engelse tekst.

Wat het doet

Changing a workflow and pushing again and again to see if it works is slow. act reads .github/workflows/*.yml and runs the jobs locally in Docker containers that look like the GitHub runners. You see errors in seconds.

Not everything is the same as on GitHub (for example OIDC to the cloud and some services), but builds, tests, linters and scripts work well.

Zo schrijf je het

act [EVENT] [OPTIONS]

Opties 13

Meest gebruikt

Options

EVENT: The event to simulate: push (default), pull_request, workflow_dispatch …
-j, --job NAME: Run only this job.
-l, --list: List the jobs and workflows.
-W, --workflows PATH: Use this workflow file or folder.
-n, --dryrun: Show what would run.
-s NAME=VALUE / --secret-file FILE: Give secrets.
--var NAME=VALUE / --var-file FILE: Give repository variables.
-e, --eventpath FILE: JSON file with the event payload.
-P ubuntu-latest=IMAGE: Choose the runner image.
--matrix KEY:VALUE: Run only one matrix entry.
--container-architecture linux/amd64: Needed on Apple Silicon for some images.
-v: Verbose output.
--input NAME=VALUE: Inputs for workflow_dispatch.

Voorbeelden 11

$ als gewone gebruiker# als root (of met sudo)

1List the jobs
```
$act -l
```
2Run the push workflows
```
$act
```
3Run one job of a pull request workflow
```
$act pull_request -j test
```
4Give a secret
```
$act -s GITHUB_TOKEN="$(gh auth token)"
```

5Secrets from a file (never commit it)

$cat .secrets
NPM_TOKEN=xxxx
$act --secret-file .secrets

6Dry run
```
$act -n
```

7A bigger runner image (more tools inside)

$act -P ubuntu-latest=catthehacker/ubuntu:full-latest

8One matrix entry only
```
$act -j test --matrix node:22
```

9A manual workflow with inputs

$act workflow_dispatch --input environment=staging

10A custom event payload (for example a tag push)

$cat event.json
{ "ref": "refs/tags/v1.4.0" }
$act push -e event.json

11On a Mac with Apple Silicon

$act --container-architecture linux/amd64

Let op

Add .secrets and .vars to .gitignore.
Steps with if: ${{ !env.ACT }} are a way to skip things that only work on GitHub.
The default small image misses many tools; jobs that pass locally can still fail on GitHub (and the other way).

Bestanden

.actrc: Default options (for example the runner images).
.secrets / .vars: Local secrets and variables.

Exitcodes

`0`	All jobs passed.
`1`	A job failed.

`act`

Wat het doet

Zo schrijf je het

Opties 13

Options

Voorbeelden 11

1List the jobs

2Run the push workflows

3Run one job of a pull request workflow

4Give a secret

5Secrets from a file (never commit it)

6Dry run

7A bigger runner image (more tools inside)

8One matrix entry only

9A manual workflow with inputs

10A custom event payload (for example a tag push)

11On a Mac with Apple Silicon

Let op

Bestanden

Exitcodes

Volledige handleiding

act

Wat het doet

Zo schrijf je het

Opties 13

Options

Voorbeelden 11

1List the jobs

2Run the push workflows

3Run one job of a pull request workflow

4Give a secret

5Secrets from a file (never commit it)

6Dry run

7A bigger runner image (more tools inside)

8One matrix entry only

9A manual workflow with inputs

10A custom event payload (for example a tag push)

11On a Mac with Apple Silicon

Let op

Bestanden

Exitcodes

Verwante commando's

Gebruikt in deze lessen

Volledige handleiding

`act`