이미지를 GitHub 저장소에 업로드하고 URL을 반환한다. Use when user says '/upload-img', '이미지 올려줘', 'PNG 업로드', or wants to upload performance test result images to GitHub.
이미지를 GitHub에 업로드하고 URL을 반환한다.
raw.githubusercontent.com URL은 private 레포에서 GitHub wiki 렌더러가 로드하지 못한다.
wiki에 이미지를 삽입할 경우 반드시 아래 wiki 레포 직접 커밋 방식을 사용한다.
wiki 레포 자체에 이미지를 커밋하면 상대 경로로 참조 가능하고, wiki 렌더러가 인증 없이 제공한다.
# wiki 레포 클론 (최초 1회)
git clone https://github.com/{owner}/{repo}.wiki.git /tmp/wiki-repo
# 이미지 복사
cp <이미지파일> /tmp/wiki-repo/perf-results/<폴더명>/
# 커밋 & 푸시
cd /tmp/wiki-repo
git add . && git commit -m "docs: 이미지 추가" && git push
wiki 마크다운에서 참조:
이 방식은 public/private 레포 모두 작동한다.
.env 파일에 설정 필요:
GITHUB_TOKENGITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxx
토큰 권한: Contents → Read and Write (Fine-grained PAT 기준)
/upload-img <이미지파일> [저장경로]
인자 파싱
<이미지파일>: 필수. 로컬 파일 경로[저장경로]: 선택. 생략 시 perf-results/YYYY-MM-DD/<파일명> 자동 생성스크립트 실행
./scripts/upload-img.sh <이미지파일> [저장경로]
# 자동 경로
./scripts/upload-img.sh docs/perf-reports/2026-03-12-action-E2-2b/api-response-time.png
# 경로 직접 지정
./scripts/upload-img.sh grafana.png perf-results/E2-2b/grafana.png
출력:
완료
URL: https://raw.githubusercontent.com/kssumin/alarm/main/perf-results/...
마크다운:
| 오류 | 원인 | 해결 |
|---|---|---|
GITHUB_TOKEN이 설정되지 않았습니다 | .env 누락 | .env에 토큰 추가 |
파일을 찾을 수 없습니다 | 경로 오류 | 파일 경로 확인 |
업로드 실패 | 권한/네트워크 | 토큰 권한(Contents R/W) 확인 |
jq: command not found | jq 미설치 | brew install jq |