أمر act: الخيارات والأمثلة (11)

هذا الجزء لم يُترجم بعد. أنت ترى النص الإنجليزي.

ماذا يفعل

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.

طريقة الكتابة

act [EVENT] [OPTIONS]

الخيارات 13

الأكثر استخدامًا

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.

أمثلة 11

$ مستخدم عادي# بصلاحية root (أو مع 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

انتبه

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).

الملفات

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

رموز الخروج

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

`act`

ماذا يفعل

طريقة الكتابة

الخيارات 13

Options

أمثلة 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

انتبه

الملفات

رموز الخروج

الدليل الكامل

act

ماذا يفعل

طريقة الكتابة

الخيارات 13

Options

أمثلة 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

انتبه

الملفات

رموز الخروج

أوامر مرتبطة

مُستخدم في هذه الدروس

الدليل الكامل

`act`