34 lines
2 KiB
Markdown
34 lines
2 KiB
Markdown
# Linux 알림 환경 준비 가이드
|
|
|
|
마지막 확인일: 2026-06-02
|
|
|
|
에이전트가 Linux 알림 구현과 smoke 검증을 마무리하려면 Linux runner와 데스크톱 알림 환경 선택이 필요하다. 이 문서는 사용자가 무엇을 준비해야 하는지 정리한 가이드이며, 사용자가 직접 이 문서만 보고 테스트를 실행할 필요는 없다.
|
|
|
|
## 준비할 항목
|
|
|
|
| 항목 | 준비 내용 |
|
|
|---|---|
|
|
| Linux runner | 로컬 장비, VM, remote desktop, headless 전용 runner 중 하나를 정하거나 visible smoke 보류 여부를 정한다. |
|
|
| 배포판 | Ubuntu, Debian, Fedora 등 배포판과 버전을 정한다. |
|
|
| 데스크톱 세션 | GNOME/KDE/XFCE/기타 환경과 X11/Wayland/headless 여부를 정한다. |
|
|
| 알림 경로 | D-Bus notifications, XDG Desktop Portal, libnotify, debug injection 전용 중 하나를 선택한다. |
|
|
| 의존성 | 에이전트가 필요한 system package를 설치해도 되는지 정한다. |
|
|
| 조작 책임 | runner가 원격이면 UI prompt/click을 누가 처리할지 정한다. |
|
|
| 증거 위치 | 민감값을 제거한 로그, 스크린샷, 실행 메모를 어디에 남길지 정한다. |
|
|
|
|
## tracked 파일에 넣지 말아야 할 값
|
|
|
|
- 비공개 host name, user name, private endpoint, auth token, channel name, server URL
|
|
- 장비를 식별할 수 있는 session detail, private package repository credential, device token, signing key
|
|
|
|
## 준비 후 에이전트가 할 수 있는 일
|
|
|
|
- 선택된 범위에 따라 Linux platform registration과 host scaffold를 추가한다.
|
|
- native notification/action bridge를 구현한다.
|
|
- 선택된 desktop notification path를 설정한다.
|
|
- routing check를 실행하고, 허용된 경우 visible notification smoke를 수행한다.
|
|
- 민감값을 제거한 증거를 task 기록 또는 비공개 실행 메모에 남긴다.
|
|
|
|
## 현재 저장소 상태
|
|
|
|
Linux는 아직 등록되지 않았고 plugin 또는 test-host scaffold도 없다. Smoke 작업을 시작하려면 먼저 platform scaffold와 위의 환경 선택이 필요하다.
|