ci
무료GitHub Actions, Renovate, the two-branch release model, signing, and promotion. Use when changing workflows, dependency policy, or releasing.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
projectbluefin/finpilot1292026년 10월 26일 업데이트
무료GitHub에 공개
overview
Architecture, repository layout, and file map for this template. Use when orienting to the repository, tracing how the image is assembled, or deciding which skill covers a task.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
projectbluefin/finpilot스타 129(GitHub 129 + cccskills 0)
실행 점수 미검증
설치 방법 보기포함된 파일(1)
- SKILL.md2.9 KB
SKILL.md(원문)
설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.
Overview
This repository builds a bootc operating system image by assembling OCI layers rather than by modifying an existing image. Bluefin, Aurora, and Bluefin LTS are built the same way, so the desktop configuration here is the one they ship.
How the image is assembled
The Containerfile is the source of truth, and it is deliberately verbose. It
defines three things:
-
Context stage (
ctx) — combines the localbuild/andcustom/directories with files pulled from two OCI images:ghcr.io/projectbluefin/common— the shared desktop configuration, branding, and the Brew/Flatpak/ujust plumbingghcr.io/ublue-os/brew— the Homebrew integration
-
Base image — the
FROMline. It defaults to Fedora Silverblue and is the only place the base is chosen.just buildreads the image name and tag from it; the Fedora major is read from the base image itself during the build. -
Phases — each build script runs in its own
RUNblock, in the order the Containerfile names them. build/README.md lists them.
Layout
| Path | Holds |
|---|---|
Containerfile | Image assembly: identity, base image, and phases. |
Justfile | Build, VM, release, and test recipes. |
build/ | Build-time scripts: the phases, helpers, and the .example catalogue. |
custom/brew/ | Brewfiles, installed at runtime. |
custom/flatpaks/ | Flatpak preinstall declarations, installed on first boot. |
custom/ujust/ | ujust recipes. |
custom/files/ | System files overlaid onto /. |
custom/config/ | Per-user config seeded into /etc/skel/.config/. |
iso/ | Installer ISO and disk-image configuration. |
tests/ | contract/ (interfaces the image must satisfy) and template/ (this repository's build wiring). |
.github/ | Workflows, Renovate config, issue templates. |
Which skill
| I need to… | Load |
|---|---|
| Understand the repository, or find the right skill | overview |
| Fork it and reach a first green build | onboarding |
| Add or remove a package, app, or command | customize |
| Change the Containerfile, Justfile, or a build phase | build |
| Change a workflow, Renovate, or the release model | ci |
| Fix something broken, or check before a pull request | troubleshooting |
Upstream
The template consumes Project Bluefin's shared infrastructure rather than copying it:
projectbluefin/common— the shared runtime layer and the lifecycle label workflowprojectbluefin/actions— the reusable workflows for image build, promotion, sync, PR validation, and Renovateublue-os/brew— the Homebrew integration
Changes stay in this repository. ublue-os/* is read-only.
리뷰
아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.
댓글
로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.
아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.
같은 저장소의 스킬
Decide where a package, app, or command belongs — dnf5 at build time, Homebrew, Flatpak, or ujust — and how each is validated. Use when adding or removing something from the image.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
projectbluefin/finpilot1292026년 10월 26일 업데이트
Bootstrap a new image from this template: rename the project, enable Actions and Renovate, protect the branch, and reach a first green build. Use when forking the template or when setup has stalled.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
projectbluefin/finpilot1292026년 10월 26일 업데이트
Symptom to cause to fix for build, CI, and runtime failures, plus the pre-commit checklist. Use when something is broken or before opening a pull request.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
projectbluefin/finpilot1292026년 10월 26일 업데이트