42 lines
4.2 KiB
Markdown
42 lines
4.2 KiB
Markdown
# Channel Wiki: #skic-v1-playground
|
|
_Channel ID: 1527398768608284703_
|
|
_Created: 2026-07-23 18:22 UTC_
|
|
_Last sync: 2026-08-12 00:37 UTC_
|
|
|
|
## Purpose
|
|
SKIC playground projects and their Gitea-hosted build/publishing workflows.
|
|
|
|
## Key Decisions
|
|
- **CONFIRMED (2026-08-11):** the Gitea Actions runner—not Hermes locally—must install dependencies and build the `skic-v1-playground/documentation` Docusaurus site after repository changes are pushed.
|
|
- **CONFIRMED publication contract:** generated files for a repository are published under `/gondor-v1-gitea-pages/<organization>/<repository>/`; the corresponding public URL is `https://pages.apps.lego-cloud.eu/<organization>/<repository>/`.
|
|
- **CONFIRMED runner mount:** the Pages dataset source `/mnt/lego-cloud-v1-2025-11-28/gondor-v1-gitea-pages` is mounted into job containers at `/gondor-v1-gitea-pages`. The source must also be allowed by the runner's `container.valid_volumes`; only the mount destination changed during troubleshooting.
|
|
- **CONFIRMED Docker execution (2026-08-11):** ordinary Actions jobs can use the host Docker daemon through `/var/run/docker.sock`; Docker client `29.6.2-1`, Engine `29.0.4`, `docker version`, and `docker info` were verified in run `2328`. Do not add Docker-in-Docker by default. The runner did not apply requested privileged mode (`Privileged:false`), so its `docker:dind` service could not start.
|
|
|
|
## Active Topics
|
|
- **Documentation Pages deployment — COMPLETE/VERIFIED:** repository <https://gitea.lego-cloud.eu/skic-v1-playground/documentation> now builds and publishes through Gitea Actions.
|
|
- Docusaurus is configured for URL `https://pages.apps.lego-cloud.eu` and base path `/skic-v1-playground/documentation/`.
|
|
- Final successful run: <https://gitea.lego-cloud.eu/skic-v1-playground/documentation/actions/runs/2326> at commit `acbc8f75a6eb9c3d28427a7d248111415c9ceda6`.
|
|
- Live site: <https://pages.apps.lego-cloud.eu/skic-v1-playground/documentation/> — HTTP 200 for the page and a static asset; browser rendering of “SKIC Playground” was verified.
|
|
|
|
## Key Context
|
|
- Initial runner failures established three reusable constraints: `pnpm-workspace.yaml` must contain a valid `packages` field; job images cannot be assumed to contain `rsync`; and a path visible only inside an ephemeral job container is not a publication target.
|
|
- The workflow now validates the repository path and persistent Pages mount so missing infrastructure fails explicitly instead of reporting false publication success.
|
|
- The working publish destination for this repository is `/gondor-v1-gitea-pages/skic-v1-playground/documentation/`.
|
|
- Reusable guidance was recorded in `gitea-repository-operations` and `gitea-docusaurus-projects`. For another Docusaurus repository, use both skills; for an application repository without documentation hosting, use `gitea-repository-operations` alone; add `gondor-v1-nodes` only when diagnosing or changing the Pages service.
|
|
|
|
## People & Roles
|
|
- Lego (`root_at_skic`) — specified the Pages path/URL contract, corrected ownership of build execution to the Gitea runner, and applied the runner mount destination change.
|
|
- Hermes — updated and pushed the Docusaurus/workflow configuration, triggered actual Gitea Actions runs, diagnosed runner failures, and verified final publication.
|
|
|
|
## Action Items
|
|
- No open deployment action from this exchange. Revalidate Gitea Actions and the public URL after future runner mount or Pages infrastructure changes.
|
|
|
|
## Source anchor
|
|
- Latest processed human message: `1536839098277437601` (2026-08-11 20:49 UTC), asking whether DinD was needed when Docker was already available. Confirmed answer: no; use the mounted host socket directly.
|
|
- Docker trial directive: `1536837959054266448` (2026-08-11 20:45 UTC).
|
|
- Skill-update/request-for-reuse-guidance directive: `1536834910902554684` (2026-08-11 20:33 UTC).
|
|
- Latest processed human message: `1536834135262503083` (2026-08-11 20:30 UTC), requesting an immediate rebuild and publish; run 2326 subsequently completed successfully.
|
|
- Initial directive: `1536821956744188027` (2026-08-11 19:41 UTC).
|
|
- Runner-execution correction: `1536822550615691284` (2026-08-11 19:44 UTC).
|
|
- Mount-destination instruction: `1536832761896378448` (2026-08-11 20:24 UTC).
|