From d359af3fff227f77b342ee52282eed99cc1e605c Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 13 Nov 2026 18:15:53 -0500 Subject: [PATCH] I4: inventory of third-party actions; pin the ones in this repo - docs/ci-cd/actions-inventory.md lists every `uses:` in the DevOps, Gaming and claude repos, which of those workflows run on this Gitea, and what needs a mirror (only actions/checkout today). - deployLibvirt.yaml: pin actions/checkout (v4.4.0) and dawidd6/action-ansible-playbook (v2.8.0) to commit SHAs. - Bump the gitea role for the same pin in its demo workflow. Refs #46 Co-Authored-By: Claude Opus 5.5 --- .gitea/workflows/deployLibvirt.yaml | 4 +- docs/ci-cd/actions-inventory.md | 87 +++++++++++++++++++++++++++++ 2 files changed, 89 insertions(+), 2 deletions(-) create mode 100644 docs/ci-cd/actions-inventory.md diff --git a/.gitea/workflows/deployLibvirt.yaml b/.gitea/workflows/deployLibvirt.yaml index cafc177..9503214 100644 --- a/.gitea/workflows/deployLibvirt.yaml +++ b/.gitea/workflows/deployLibvirt.yaml @@ -4,7 +4,7 @@ jobs: deploy: runs-on: ubuntu-latest steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0 - name: Install Ansible run: | @@ -13,7 +13,7 @@ jobs: python3 -m pip install ansible - name: Run playbook - uses: dawidd6/action-ansible-playbook@v2 + uses: dawidd6/action-ansible-playbook@c97d71562fcba83cc1ea0602d5a77013427f7571 # v2.8.0 with: playbook: libvirtGuests.yaml key: ${{secrets.SSH_PRIVATE_KEY}} diff --git a/docs/ci-cd/actions-inventory.md b/docs/ci-cd/actions-inventory.md new file mode 100644 index 0000000..42fe4c1 --- /dev/null +++ b/docs/ci-cd/actions-inventory.md @@ -0,0 +1,87 @@ +# Third-party actions inventory (I4) + +Inventory of every `uses:` in workflow files across the DevOps, Gaming and +`claude` repos, taken on 2026-11-13 from each repo's default branch. Refs: #46. + +## How Gitea picks workflows + +Gitea 1.27 reads workflows from `.gitea/workflows/` if that directory exists, +and only otherwise from `.github/workflows/`. A repo with both runs only the +`.gitea/` ones. So `.github/` workflows in forks of GitHub projects run here +only when the repo has no `.gitea/workflows/`. + +## Workflows that run on this Gitea + +| Repo | Workflow | Action | Ref | +|---|---|---|---| +| DevOps/software-infrastructure | `deployLibvirt.yaml` (no trigger yet, see D7 #75) | `actions/checkout` | pinned `11d5960…` (v4.4.0) | +| | | `dawidd6/action-ansible-playbook` | pinned `c97d715…` (v2.8.0) | +| DevOps/ansible-role-gitea | `demo.yaml` | `actions/checkout` | pinned `11d5960…` (v4.4.0) | +| Gaming/ashlar | `ashlar-checks.yaml` | `actions/checkout` | `v4` | +| Gaming/luanti_game_strata | `test.yml` | `actions/checkout` | `v4` | +| claude/vitals | `ci.yml` | `actions/checkout` | `v4` | +| DevOps/helm-pixelfed (upstream fork) | `renovate.yml`, hourly schedule | `tibdex/github-app-token`, `actions/checkout`, `renovatebot/github-action` | tags | +| | `ci-helm-lint-test.yml`, `helm-docs.yaml`, `release.yml` | `actions/checkout`, `azure/setup-helm`, `helm/chart-testing-action`, `helm/kind-action`, `jessebot/helm-docs-action`, `helm/chart-releaser-action` | tags | + +No other repo in these owners has a workflow file (`claude/tidewall` has none +on its default branch). + +## Workflows that never run here + +These are upstream `.github/workflows/` with no `.gitea/workflows/` beside +them, and no recorded runs. They target GitHub (GitHub Apps, Pages, +releases, macOS and Windows runners) and wouldn't work on this runner as written. + +| Repo | Actions referenced | +|---|---| +| DevOps/ansible-role-nvidia-driver | `actions/checkout@v2`, `robertdebock/molecule-action@2.7.2` | +| DevOps/truecharts | 73 refs, mostly SHA-pinned upstream (`actions/checkout`, `azure/setup-helm`, `helm/chart-testing-action`, `actions/setup-python`, `nolar/setup-k3d-k3s`, `dorny/paths-filter`, others) | +| Gaming/luanti_mod_3d_armor_minimized | `actions/checkout@v1/v3`, `leafo/gh-actions-lua`, `leafo/gh-actions-luarocks`, `peaceiris/actions-gh-pages` | +| Gaming/luanti-wasm | `actions/checkout@v3` | +| Gaming/ashlar `.github/` (shadowed by `.gitea/`) | `actions/checkout@v6`, `actions/cache@v5`, `actions/upload-artifact@v6`, `hendrikmuhs/ccache-action`, `ilammy/msvc-dev-cmd`, `seanmiddleditch/gha-setup-ninja@master`, `softprops/action-gh-release` | + +## What needs a mirror + +**Now: one action, `actions/checkout`.** Every in-scope workflow uses it, and +nothing else is needed today. + +- `dawidd6/action-ansible-playbook`: no mirror. D7 (#75) should call + `ansible-playbook` directly from the shared CI tools image (G1, #49) instead. +- `helm-pixelfed`'s workflows: no mirror. They're upstream GitHub workflows + that can't work here, and the Renovate one fails every hour on the shared + runner. Disable them instead (see #46). +- Workflows that never run: no mirror. + +**Later, decided when the issue is worked:** + +| Likely action | For | Alternative without a mirror | +|---|---|---| +| `actions/cache` | G8 (#56) | none practical, mirror it then | +| `docker/login-action`, `docker/setup-buildx-action`, `docker/build-push-action` | P2 (#62) | plain `docker login` / `docker buildx` in `run:` steps | +| `actions/upload-artifact`, `actions/download-artifact` | soak logs, releases | `run:` steps posting to the package registry | + +Preferred rule for new workflows: use `run:` steps and the CI tools image +where a few shell lines will do; mirror an action only when that's +impractical. + +## Pinning rule + +Pin every `uses:` to a full commit SHA with the version in a comment: + +```yaml +- uses: actions/checkout@11d5960a326750d5838078e36cf38b85af677262 # v4.4.0 +``` + +A mirror keeps upstream commit SHAs, so pins made now stay valid when +`DEFAULT_ACTIONS_URL` moves to Gitea or the refs change to full URLs. + +To refresh the inventory: + +```sh +# from a directory of clones of the DevOps, Gaming and claude repos +for d in */; do + git -C "$d" ls-tree -r --name-only HEAD \ + | grep -E '^\.(gitea|github)/workflows/.*\.ya?ml$' \ + | while read -r f; do git -C "$d" show "HEAD:$f" | grep -nE '^\s*-?\s*uses:' | sed "s|^|$d$f:|"; done +done +```