docs: clean up action comments — describe what we do, not what others had

This commit is contained in:
2026-05-22 17:56:40 +01:00
parent d61246e7e4
commit c01049dd5b
4 changed files with 21 additions and 36 deletions
+5 -9
View File
@@ -1,12 +1,8 @@
# Tinqs Checkout — replaces actions/checkout@v4 # tinqs/ci/checkout — Tinqs Studio CI
# Original: https://github.com/actions/checkout (GitHub-hosted, Node.js action) # Clones a repo from tinqs.com (self-hosted Gitea) using plain git.
# Why rewritten: actions/checkout requires Node.js runtime and GitHub API calls. # Supports depth control, branch/tag selection, and token auth for private repos.
# On self-hosted Gitea (tinqs.com), it fails because it tries to hit api.github.com. # Composite action — runs directly on the host, no Node.js runtime needed.
# This composite action uses plain git clone — works on any runner with git installed. # Author: Ozan + Claude Code — 2026-05-22
# Removed from original: submodules, LFS, sparse-checkout, GitHub token auth, persist-credentials.
# We only need depth, ref, and optional Gitea token for private repos.
# Author: Ozan / Claude Code — 2026-05-22
# Part of: tinqs/ci (Tinqs CI toolchain)
name: 'Tinqs Checkout' name: 'Tinqs Checkout'
description: 'Clone a Gitea repository (replaces actions/checkout)' description: 'Clone a Gitea repository (replaces actions/checkout)'
+6 -9
View File
@@ -1,12 +1,9 @@
# Tinqs Setup AWS — replaces aws-actions/configure-aws-credentials@v4 # tinqs/ci/setup-aws — Tinqs Studio CI
# Original: https://github.com/aws-actions/configure-aws-credentials (GitHub-hosted, Node.js) # Installs AWS CLI and optionally logs into ECR.
# Why rewritten: Original uses OIDC federation with GitHub's token endpoint — doesn't exist # Credentials come from the runner environment (IAM task role on Fargate, instance
# on Gitea. Our runners use IAM task roles (ECS/Fargate) or instance profiles (EC2/Lightsail), # profile on EC2/Lightsail) — no explicit key configuration needed.
# so we don't need credential configuration — just install the CLI and optionally ECR login. # Composite action — runs directly on the host.
# Removed from original: OIDC, assume-role, session tokens, credential masking, region output. # Author: Ozan + Claude Code — 2026-05-22
# ECR login bundled here instead of needing separate aws-actions/amazon-ecr-login.
# Author: Ozan / Claude Code — 2026-05-22
# Part of: tinqs/ci (Tinqs CI toolchain)
name: 'Tinqs Setup AWS' name: 'Tinqs Setup AWS'
description: 'Install AWS CLI and optionally login to ECR' description: 'Install AWS CLI and optionally login to ECR'
+5 -9
View File
@@ -1,12 +1,8 @@
# Tinqs Setup Go — replaces actions/setup-go@v5 # tinqs/ci/setup-go — Tinqs Studio CI
# Original: https://github.com/actions/setup-go (GitHub-hosted, Node.js action) # Downloads Go from go.dev and adds it to PATH.
# Why rewritten: Original uses GitHub's tool cache API and Node.js runtime — neither # Skips install if the correct version is already present (pre-baked runner image).
# available on self-hosted Gitea runners. This composite action downloads Go directly # Composite action — runs directly on the host.
# from go.dev and sets GITHUB_PATH. Skips install if correct version already present # Author: Ozan + Claude Code — 2026-05-22
# (for when runner image has Go pre-baked).
# Removed from original: tool cache, go-version-file, check-latest, cache (actions/cache dep).
# Author: Ozan / Claude Code — 2026-05-22
# Part of: tinqs/ci (Tinqs CI toolchain)
name: 'Tinqs Setup Go' name: 'Tinqs Setup Go'
description: 'Install Go and configure PATH (replaces actions/setup-go)' description: 'Install Go and configure PATH (replaces actions/setup-go)'
+5 -9
View File
@@ -1,12 +1,8 @@
# Tinqs Setup Node — replaces actions/setup-node@v4 # tinqs/ci/setup-node — Tinqs Studio CI
# Original: https://github.com/actions/setup-node (GitHub-hosted, Node.js action) # Installs Node.js via NodeSource and optionally pnpm.
# Why rewritten: Original depends on GitHub tool cache and @actions/core Node.js package. # Skips install if the correct major version is already present (pre-baked runner image).
# Self-hosted Gitea runners don't have the tool cache infrastructure. # Composite action — runs directly on the host.
# This composite action installs Node via NodeSource APT repo and pnpm via npm. # Author: Ozan + Claude Code — 2026-05-22
# Skips install if correct major version already present (pre-baked runner image).
# Removed from original: tool cache, .nvmrc/.node-version file, registry-url, cache (yarn/pnpm).
# Author: Ozan / Claude Code — 2026-05-22
# Part of: tinqs/ci (Tinqs CI toolchain)
name: 'Tinqs Setup Node' name: 'Tinqs Setup Node'
description: 'Install Node.js and pnpm (replaces actions/setup-node)' description: 'Install Node.js and pnpm (replaces actions/setup-node)'