wehub-resource-sync
3e779be6f3
OBS 배포 가이드 (WinPodX)
openSUSE Build Service에 WinPodX를 올려서 Tumbleweed, Fedora, Leap용 RPM을 자동 빌드하고, GitHub Release에 첨부하는 절차입니다.
- 프로젝트: https://build.opensuse.org/package/show/home:Kernalix7/winpodx
- GitHub Actions 연동: 토큰(
OBS_TOKEN) 한 개만 필요, 비밀번호 불필요
1. 초기 세팅 (최초 1회, 로컬)
1-1. osc 설치 & 로그인
sudo zypper install osc # openSUSE
sudo dnf install osc # Fedora
sudo apt install osc # Ubuntu/Debian
osc ls home:Kernalix7
# 첫 실행 시 ~/.oscrc 생성 프롬프트: apiurl=https://api.opensuse.org, user=Kernalix7
1-2. 패키지 파일 업로드
OBS 는 RPM 만 담당합니다. Debian / Ubuntu .deb 는 공용 OBS 의
debtransform 제약 때문에 GitHub Actions (.github/workflows/debs-publish.yml)
에서 dpkg-buildpackage 로 빌드해 Release 에 직접 첨부합니다.
debian/ 디렉터리는 프로젝트 루트에 있고 Actions 가 그대로 사용합니다.
AppImage 는 Python + Qt + FreeRDP + Podman 의존성이 커 번들 이점이 없어
지원하지 않습니다.
cd /tmp
osc checkout home:Kernalix7 winpodx
cd home:Kernalix7/winpodx
PRJ=~/Desktop/00_Personal_Project/00G_winpodx
cp $PRJ/packaging/rpm/winpodx.spec .
cp $PRJ/packaging/obs/_service .
osc add winpodx.spec _service
osc ci -m "winpodx: rpm recipes"
osc ci 가 _service 체인을 서버에서 실행 → GitHub main HEAD에서
tarball을 가져오고, @PARENT_TAG@로 버전을 자동 해석합니다.
1-2-1. spec 을 언제 다시 업로드 해야 하는가
tar_scm + set_version 조합이 Version: 줄을 자동 갱신 하므로 일반적인
릴리즈(태그 push)에는 osc ci 가 필요 없습니다. spec 의 %changelog
는 의도적으로 GitHub Release 를 가리키는 단일 포인터만 두어, 버전별
노트를 수동으로 유지할 필요가 없게 했습니다.
osc ci 가 실제로 필요한 경우:
BuildRequires추가/삭제 (예: 새 Python 버전 대응, 누락된 의존성)%files섹션 변경 (설치 파일 목록 변경)- 배포판 매크로 분기 로직 수정 (
suse_version/fedora조건) Requires/Recommends의존성 변경
단순 버전 번호 상승 (0.1.1 → 0.1.2 등) 은 태그 push 만으로 끝.
1-3. 빌드 대상 배포판 추가
웹 UI 패키지 페이지의 Repositories 탭에서 Add repository. 전 배포판 커버:
- RPM: openSUSE Tumbleweed, Leap 15.6, Leap 16.0, Slowroll,
Fedora 42, Fedora 43 (모두 x86_64 만, spec 이
noarch)
Debian_12 / Debian_13 / xUbuntu_25.04 / xUbuntu_25.10 / xUbuntu_26.04 리포와
AppImage 리포는 비활성화 하세요. .deb 는 GitHub Actions,
AppImage 는 지원 안 함.
Factory ARM/PowerPC/RISCV/zSystems 는 noarch 라 중복이므로 꺼두는 걸 권장. RISCV 는 현재 상당수 패키지가 queue 에서 blocked 상태라 빌드가 몇 주씩 걸릴 수 있습니다.
1-3-1. 배포판별 주의사항
- Leap 16.0:
python311이 빠졌습니다. spec 이suse_version >= 1600조건으로python313을 자동 사용합니다 (최근 Tumbleweed 도 여기 포함). - Fedora 42:
python3-pluggy/python3-pluggy1.3선택 충돌이 있어 spec 에서python3-pluggy를 명시적으로 pin 했습니다.
1-4. 첫 빌드 확인
osc results home:Kernalix7 winpodx
osc buildlog home:Kernalix7 winpodx openSUSE_Tumbleweed x86_64
모두 succeeded 확인.
2. GitHub Actions 연동
2-1. OBS 토큰 발급 (runservice 전용)
로컬에서 한 번만:
osc token --create --operation runservice home:Kernalix7 winpodx
출력된 토큰 문자열을 복사.
2-2. GitHub Secret 등록
리포 → Settings → Secrets and variables → Actions → New repository secret:
| 이름 | 값 |
|---|---|
OBS_TOKEN |
위에서 발급받은 토큰 |
비밀번호는 등록하지 않습니다. 토큰은 runservice 작업만 허용되어
다른 프로젝트나 계정 설정은 건드릴 수 없습니다.
3. 릴리즈 자동화 흐름
.github/workflows/obs-publish.yml이 담당합니다.
- GitHub에서 새 태그(
v0.2.0) 푸시 →release.yml실행 → GitHub Release 생성 - Release publish 이벤트로
obs-publish.yml자동 시작 - OBS
trigger/runservice호출 (OBS_TOKEN) →_service가 main 최신을 가져와@PARENT_TAG@로winpodx-0.2.0.tar.gz생성 후 빌드 - 공용 API
/build/{project}/_result로 30초마다 상태 폴링 (최대 60분) - 빌드 성공 시
download.opensuse.org에서 RPM 직접 다운로드 gh release upload로 같은 Release에 RPM 첨부
4. 최종 사용자 설치
openSUSE (zypper):
zypper addrepo https://download.opensuse.org/repositories/home:/Kernalix7/openSUSE_Tumbleweed/home:Kernalix7.repo
zypper refresh
zypper install winpodx
Fedora (dnf5 — Fedora 41+):
dnf config-manager addrepo --from-repofile=https://download.opensuse.org/repositories/home:/Kernalix7/Fedora_43/home:Kernalix7.repo
dnf install winpodx
Fedora ≤40 (dnf4, EOL):
dnf config-manager --add-repo https://download.opensuse.org/repositories/home:/Kernalix7/Fedora_41/home:Kernalix7.repo
dnf install winpodx
저장소 URL은 OBS 패키지 페이지의 Download package 링크에서 확인 가능합니다.
5. 주의: main 브랜치 추적 방식
_service의 <param name="revision">main</param> 때문에 OBS는 태그가 아닌
main HEAD를 가져옵니다. 버전은 @PARENT_TAG@로 최신 도달 가능 태그가
들어갑니다. 태그 푸시 직후 main에 새 커밋이 들어가면 tarball 내용이
태그 시점과 달라질 수 있으니, 릴리즈는 태그 → Actions 트리거가 끝난 뒤에
다음 작업을 하세요.
태그 단위로 정확히 고정하고 싶다면 _service의 revision을 해당 태그로
수동 교체(osc ci)해야 하며, 이 경우 비밀번호 기반 인증이 필요합니다.