Skip to content

Commit 93b8b8b

Browse files
committed
Use self-hosted runner for ESP-Matter builds
Workflow: - Switch esp-matter-build job to self-hosted runner - Use [self-hosted, ubuntu-latest] for runner selection - Prevents 'No space left on device' errors on GitHub-hosted runners - ESP-Matter builds require ~50GB+ due to large submodule tree Documentation: - Add 'Self-Hosted Runners' section to github-actions-standards.mdc - Document when to use self-hosted runners (large submodules, disk space) - Document runner requirements (Docker, Buildx, 50GB+ free space)
1 parent 46e3193 commit 93b8b8b

File tree

2 files changed

+22
-1
lines changed

2 files changed

+22
-1
lines changed

.cursor/rules/github-actions-standards.mdc

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -198,6 +198,27 @@ jobs:
198198
- Login condition: `if: github.repository_owner == 'jethome-iot' && github.ref_name == 'master'`
199199
- Push condition: `push: ${{ github.repository_owner == 'jethome-iot' && github.ref_name == 'master' }}`
200200

201+
### Self-Hosted Runners
202+
203+
For large builds that may exceed GitHub-hosted runner disk space (e.g., ESP-Matter with large submodule trees), use self-hosted runners:
204+
205+
```yaml
206+
jobs:
207+
<image-name>-build:
208+
runs-on: [self-hosted, ubuntu-latest] # Use self-hosted runner
209+
timeout-minutes: 60
210+
```
211+
212+
**When to use self-hosted runners:**
213+
- Builds with large git submodules (ESP-Matter, etc.)
214+
- Builds that consistently fail with "No space left on device"
215+
- Builds requiring more than ~14GB disk space
216+
217+
**Runner requirements:**
218+
- Docker and Docker Buildx installed
219+
- Sufficient disk space (50GB+ free recommended for large builds)
220+
- Runner labels: `self-hosted`, `ubuntu-latest` (or appropriate OS label)
221+
201222
### Version Handling
202223

203224
- Define versions directly in matrix strategy

.github/workflows/esp-idf.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,7 @@ jobs:
7878
IDF_BASE_TAG=${{ matrix.idf_base_tag }}
7979
8080
esp-matter-build:
81-
runs-on: ubuntu-latest
81+
runs-on: [self-hosted, ubuntu-latest]
8282
timeout-minutes: 60
8383
needs: esp-idf-build
8484
if: github.repository_owner == 'jethome-iot' || github.event_name == 'workflow_dispatch'

0 commit comments

Comments
 (0)