Skip to content

Commit 5b14f2f

Browse files
jackluo923jackluo923
committed
feat: pre-cache GitHub Actions and tools to eliminate download delays
Add comprehensive caching to runner image for both actions and runtime tools, eliminating download timeouts and speeding up workflow execution. ## Action Archive Cache Pre-cache commonly used GitHub Actions in /home/runner/action-archive-cache/ **How it works:** - Runner checks ACTIONS_RUNNER_ACTION_ARCHIVE_CACHE before downloading - Format: {owner}_{repo}/{SHA}.tar.gz - If found: unpacks cached tar.gz (instant) - If not found: downloads from GitHub API (slow, can timeout) **Actions cached (18 versions):** - docker/build-push-action: v5, v6 - docker/login-action: v2, v3 - docker/metadata-action: v4, v5 - actions/checkout: v3, v4 - actions/setup-java: v3, v4 - actions/upload-artifact: v3, v4 - actions/download-artifact: v3, v4 - dorny/paths-filter: v2, v3 ## Tool Cache Pre-install runtime tools in /opt/hostedtoolcache/ **How it works:** - setup-* actions check RUNNER_TOOL_CACHE for pre-installed tools - Format: /opt/hostedtoolcache/{tool}/{version}/{arch}/.complete - If found: use immediately (instant) - If not found: download and install (200-500 MB, 2-5 min per tool) **Tools cached:** - Java: 8.0.442, 17.0.13 (Temurin distribution) - Python: 3.9, 3.10, 3.11 - Node.js: 20.x LTS ## Benefits **Speed:** - Action downloads: 10-30 sec saved per workflow - Tool setup: 2-5 min saved per tool (first use) - Eliminates 100-second timeout errors **Reliability:** - Works offline or with network issues - No dependency on GitHub API availability **Flexibility:** - Multiple versions supported (v3-v6) - Compatible across different workflows ## Implementation **Files:** - cache_github_actions.sh: Clones and packages actions - cache_tools.sh: Runs setup-* actions to install tools - Dockerfile: Sets env vars, runs cache scripts **Environment variables:** - ACTIONS_RUNNER_ACTION_ARCHIVE_CACHE=/home/runner/action-archive-cache - AGENT_TOOLSDIRECTORY=/opt/hostedtoolcache **Size impact:** - Action cache: ~200-500 MB - Tool cache: ~1-1.5 GB - Total: ~1.5-2 GB (acceptable for self-hosted runners) **Usage:** Completely automatic - workflows transparently use cached content without any modifications required.
1 parent 487b494 commit 5b14f2f

File tree

3 files changed

+172
-1
lines changed

3 files changed

+172
-1
lines changed

‎Dockerfile‎

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,8 @@ FROM myoung34/github-runner-base:latest
33
LABEL maintainer="[email protected]"
44

55
ENV AGENT_TOOLSDIRECTORY=/opt/hostedtoolcache
6-
RUN mkdir -p /opt/hostedtoolcache
6+
ENV ACTIONS_RUNNER_ACTION_ARCHIVE_CACHE=/home/runner/action-archive-cache
7+
RUN mkdir -p /opt/hostedtoolcache /home/runner/action-archive-cache
78

89
ARG GH_RUNNER_VERSION="2.329.0"
910

@@ -19,6 +20,18 @@ RUN chmod +x /actions-runner/install_actions.sh \
1920
&& rm /actions-runner/install_actions.sh \
2021
&& chown runner /_work /actions-runner /opt/hostedtoolcache
2122

23+
# Pre-cache commonly used GitHub Actions to avoid download timeouts
24+
COPY cache_github_actions.sh /actions-runner/
25+
RUN chmod +x /actions-runner/cache_github_actions.sh \
26+
&& /actions-runner/cache_github_actions.sh \
27+
&& rm /actions-runner/cache_github_actions.sh
28+
29+
# Pre-cache tools (Java, Python, Node) to avoid downloads on first workflow run
30+
COPY cache_tools.sh /actions-runner/
31+
RUN chmod +x /actions-runner/cache_tools.sh \
32+
&& /actions-runner/cache_tools.sh \
33+
&& rm /actions-runner/cache_tools.sh
34+
2235
COPY token.sh entrypoint.sh app_token.sh /
2336
RUN chmod +x /token.sh /entrypoint.sh /app_token.sh
2437

‎cache_github_actions.sh‎

Lines changed: 74 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,74 @@
1+
#!/bin/bash -ex
2+
# Pre-cache commonly used GitHub Actions to avoid download timeouts
3+
#
4+
# The runner uses ACTIONS_RUNNER_ACTION_ARCHIVE_CACHE to find pre-cached actions.
5+
# Format: {owner}_{repo}/{SHA}.tar.gz
6+
#
7+
# When a workflow uses an action, the runner:
8+
# 1. Checks this cache directory for the action and specific commit SHA
9+
# 2. If found: unpacks the cached tar.gz (instant, no download)
10+
# 3. If not found: downloads from GitHub API (slow, can timeout)
11+
#
12+
# This cache eliminates download timeouts and speeds up workflow starts.
13+
14+
CACHE_DIR="/home/runner/action-archive-cache"
15+
mkdir -p "$CACHE_DIR"
16+
cd "$CACHE_DIR"
17+
18+
# Helper function to cache an action
19+
# Usage: cache_action owner repo ref
20+
cache_action() {
21+
local owner=$1
22+
local repo=$2
23+
local ref=$3
24+
25+
echo "Caching ${owner}/${repo}@${ref}..."
26+
27+
# Create directory following {owner}_{repository} naming convention
28+
local action_dir="${owner}_${repo}"
29+
mkdir -p "$action_dir"
30+
31+
# Clone the repo and get the commit SHA for the ref
32+
local temp_dir=$(mktemp -d)
33+
git clone --depth=1 --branch "$ref" "https://github.com/${owner}/${repo}.git" "$temp_dir"
34+
local sha=$(cd "$temp_dir" && git rev-parse HEAD)
35+
36+
# Create tar.gz with the action content (exclude .git)
37+
tar -czf "${action_dir}/${sha}.tar.gz" -C "$temp_dir" --exclude=.git .
38+
39+
# Clean up
40+
rm -rf "$temp_dir"
41+
42+
echo " ✓ Cached ${owner}/${repo}@${ref} (SHA: ${sha})"
43+
}
44+
45+
# Cache Docker actions (frequently timeout due to size)
46+
cache_action docker build-push-action v5
47+
cache_action docker build-push-action v6
48+
cache_action docker login-action v2
49+
cache_action docker login-action v3
50+
cache_action docker metadata-action v4
51+
cache_action docker metadata-action v5
52+
53+
# Cache GitHub official actions
54+
cache_action actions checkout v3
55+
cache_action actions checkout v4
56+
cache_action actions setup-java v3
57+
cache_action actions setup-java v4
58+
cache_action actions upload-artifact v3
59+
cache_action actions upload-artifact v4
60+
cache_action actions download-artifact v3
61+
cache_action actions download-artifact v4
62+
63+
# Cache third-party actions
64+
cache_action dorny paths-filter v2
65+
cache_action dorny paths-filter v3
66+
67+
# Set ownership to runner user
68+
chown -R runner:runner "$CACHE_DIR"
69+
70+
echo ""
71+
echo "✓ GitHub Actions cache complete"
72+
echo "Cached in: $CACHE_DIR"
73+
du -sh "$CACHE_DIR"
74+
echo "Total cached actions: $(find "$CACHE_DIR" -name "*.tar.gz" | wc -l)"

‎cache_tools.sh‎

Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
#!/bin/bash -ex
2+
# Pre-cache runtime tools (Java, Python, Node) in hostedtoolcache
3+
#
4+
# When setup-* actions run (setup-java, setup-python, setup-node), they:
5+
# 1. Check RUNNER_TOOL_CACHE (or AGENT_TOOLSDIRECTORY) for pre-installed tools
6+
# 2. If found: use immediately (instant, no download)
7+
# 3. If not found: download and install (~200-500 MB, 2-5 minutes)
8+
#
9+
# This script pre-installs tools by running setup-* actions during image build.
10+
# The actions create the proper directory structure with .complete markers.
11+
#
12+
# Tool cache format: /opt/hostedtoolcache/{tool}/{version}/{arch}/.complete
13+
14+
TOOL_CACHE="/opt/hostedtoolcache"
15+
TEMP_RUNNER="/tmp/runner-toolcache-setup"
16+
17+
# Create a temporary runner environment to run setup actions
18+
mkdir -p "$TEMP_RUNNER"
19+
cd "$TEMP_RUNNER"
20+
21+
# Download a minimal GitHub Actions runner (just need the node runtime)
22+
# The setup actions are Node.js scripts that populate the tool cache
23+
GH_RUNNER_VERSION="2.329.0"
24+
ARCH="x64" # Could be arm64 for ARM builds
25+
26+
curl -sL "https://github.com/actions/runner/releases/download/v${GH_RUNNER_VERSION}/actions-runner-linux-${ARCH}-${GH_RUNNER_VERSION}.tar.gz" | tar xz
27+
28+
# Set environment for tool installation
29+
export RUNNER_TOOL_CACHE="$TOOL_CACHE"
30+
export AGENT_TOOLSDIRECTORY="$TOOL_CACHE"
31+
32+
echo "Pre-caching tools to: $TOOL_CACHE"
33+
34+
# Download and run setup actions to populate tool cache
35+
# These actions will install tools into RUNNER_TOOL_CACHE
36+
37+
# Java (using actions/setup-java)
38+
echo "Caching Java 8.0.442 and 17.0.13..."
39+
git clone --depth=1 --branch v4 https://github.com/actions/setup-java.git setup-java
40+
cd setup-java && npm install --production && cd ..
41+
42+
# Run setup-java for each version
43+
export INPUT_DISTRIBUTION="temurin"
44+
export INPUT_JAVA_VERSION="8.0.442"
45+
node setup-java/dist/setup/index.js
46+
47+
export INPUT_JAVA_VERSION="17.0.13"
48+
node setup-java/dist/setup/index.js
49+
50+
# Python (using actions/setup-python)
51+
echo "Caching Python 3.9, 3.10, 3.11..."
52+
git clone --depth=1 --branch v5 https://github.com/actions/setup-python.git setup-python
53+
cd setup-python && npm install --production && cd ..
54+
55+
for version in "3.9" "3.10" "3.11"; do
56+
export INPUT_PYTHON_VERSION="$version"
57+
node setup-python/dist/setup/index.js || echo "Warning: Python $version cache may be incomplete"
58+
done
59+
60+
# Node.js (using actions/setup-node)
61+
echo "Caching Node.js LTS (20.x)..."
62+
git clone --depth=1 --branch v4 https://github.com/actions/setup-node.git setup-node
63+
cd setup-node && npm install --production && cd ..
64+
65+
export INPUT_NODE_VERSION="20"
66+
node setup-node/dist/setup/index.js
67+
68+
# Clean up
69+
cd /
70+
rm -rf "$TEMP_RUNNER"
71+
72+
# Set ownership
73+
chown -R runner:runner "$TOOL_CACHE"
74+
75+
# Create .complete markers if missing (indicates tool is ready)
76+
find "$TOOL_CACHE" -type d -mindepth 3 -maxdepth 3 | while read dir; do
77+
[[ ! -f "$dir/.complete" ]] && touch "$dir/.complete"
78+
done
79+
80+
echo ""
81+
echo "✓ Tool cache complete"
82+
du -sh "$TOOL_CACHE"
83+
echo "Cached tools:"
84+
find "$TOOL_CACHE" -name ".complete" | sed 's|/opt/hostedtoolcache/||; s|/.complete||'

0 commit comments

Comments
 (0)