From 25fc3573443d6a0cb7744b29ef54c72455e63fd7 Mon Sep 17 00:00:00 2001 From: ChristopherHX Date: Sat, 30 Nov 2024 10:14:46 +0000 Subject: [PATCH] Document builtin Actions Artifacts --- src/usage/index.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/src/usage/index.md b/src/usage/index.md index 5ff7b28..e85a9cb 100644 --- a/src/usage/index.md +++ b/src/usage/index.md @@ -316,3 +316,19 @@ or a `.actrc` file in your cwd like ``` --action-offline-mode ``` + +## Action Artifacts + +**Currently is the artifacts server not started automatically with act**, this means the following env variables are blank by default. + +- `ACTIONS_RUNTIME_URL` +- `ACTIONS_RUNTIME_TOKEN` +- `ACTIONS_RESULTS_URL` + +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. + +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. + +Not supported v4 features are to download artifacts from a different run, workflow or repository by providing a GitHub Token.