This is an automated email from the ASF dual-hosted git repository.
sbp pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/tooling-docs.git
The following commit(s) were added to refs/heads/main by this push:
new 3440884 Add some notes about running the Pelican GHA locally
3440884 is described below
commit 3440884f01a17c3f25bb646f34baea6243db7d79
Author: Sean B. Palmer <s...@miscoranda.com>
AuthorDate: Fri Jul 25 16:07:20 2025 +0100
Add some notes about running the Pelican GHA locally
---
develop/pelican-gha.md | 19 +++++++++++++++++++
1 file changed, 19 insertions(+)
diff --git a/develop/pelican-gha.md b/develop/pelican-gha.md
new file mode 100644
index 0000000..625644e
--- /dev/null
+++ b/develop/pelican-gha.md
@@ -0,0 +1,19 @@
+# Pelican GHA
+
+To test Pelican GitHub Actions, install
[`act`](https://github.com/nektos/act). `act` is a Go program which runs GitHub
Actions locally. You can [install it from
Nix](https://search.nixos.org/packages?channel=unstable&show=act&from=0&size=50&sort=relevance&type=packages&query=act),
from your preferred package manager, or from Go source.
+
+You will need a GitHub PAT. Read the [instructions for issuing a fine-grained
PAT](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens#creating-a-fine-grained-personal-access-token).
Get one from [your PAT settings
page](https://github.com/settings/personal-access-tokens) once logged in to
GitHub.
+
+The PAT is necessary because the Pelican GHA reads from this repository. You
will therefore need to issue a PAT which has public read access to all
repositories. Choose a suitable expiry date; long expiries for read only PATs
are probably fine.
+
+Run the Pelican GHA using:
+
+```shell
+DOCKER_HOST=unix:///.../docker.sock act \
+ --container-architecture linux/amd64 \
+ --container-daemon-socket - \
+ -s GITHUB_TOKEN \
+ push
+```
+
+You don't need to specify the container architecture if you're already using
`linux/amd64`.
---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscr...@tooling.apache.org
For additional commands, e-mail: commits-h...@tooling.apache.org
