GitHub Action Rerunner

• 사용해보기
• GitHub

실패한 GitHub Actions를 팀원들이 직접 재실행할 수 있도록 권한을 위임하는 웹 애플리케이션입니다.

🎯 왜 만들었나요?

GitHub Actions가 실패했을 때, 재실행하려면 해당 레포지토리에 대한 Write 권한이 필요합니다. 하지만 보안상의 이유로 모든 팀원에게 Write 권한을 주기는 어렵습니다.

GitHub Action Rerunner는 이 문제를 해결합니다. 레포지토리 소유자가 토큰을 등록하면, 팀원들은 자신에게 할당된 PR의 실패한 Action만 재실행해 레포지토리에 대한 직접적인 권한 없이도 CI/CD를 다시 돌릴 수 있습니다!

✨ 주요 기능

레포지토리 소유자 (Owner)

• 📦 개인 및 조직 레포지토리 등록
• 🔑 GitHub Personal Access Token 등록 (암호화 저장)
• 🔗 공유 가능한 고유 링크 생성
• 👀 모든 실패한 PR 확인 및 재실행
• ⚙️ 레포지토리 설정 관리

팀원 (Assignee)

• 📋 자신에게 할당된 PR 목록 확인
• 🔄 실패한 GitHub Action 원클릭 재실행
• 📊 워크플로우 상태 실시간 확인

계정 관리

• 🔐 GitHub OAuth 로그인
• 👥 여러 GitHub 계정 연동 지원
• 🔀 계정 간 쉬운 전환

🛠 기술 스택

• Frontend: Next.js 16 (App Router), React 19, Tailwind CSS 4
• Backend: Next.js API Routes
• Authentication: NextAuth.js v5 (GitHub OAuth)
• Database: PostgreSQL + Prisma ORM
• GitHub API: Octokit

🚀 직접 배포하기

현재 프로젝트는 이미 배포되어 있으나, 민감한 토큰을 다루기 때문에 직접 배포하시고 싶다면 아래 가이드를 참고하세요.

1. Repository pull

저장소를 받아옵니다.

2. 환경 변수 설정

.env 파일을 생성하고 다음 값을 설정하세요:

# DB (PostgreSQL)
DATABASE_URL="postgresql://..."
DIRECT_URL="postgresql://..."

# NextAuth.js
AUTH_SECRET="use `npx auth secret`"
AUTH_GITHUB_ID="your-github-oauth-app-id"
AUTH_GITHUB_SECRET="your-github-oauth-app-secret"

# Token Encryption (32자)
ENCRYPTION_KEY="your-32-character-encryption-key"

3. GitHub OAuth App 생성

1. GitHub Developer Settings에서 OAuth App 생성
2. Authorization callback URL: http://localhost:3000/api/auth/callback/github
3. Client ID와 Client Secret을 환경 변수에 설정

4. 개발 서버 실행

# 의존성 설치
pnpm install

# Prisma 클라이언트 생성
npx prisma generate

# 데이터베이스 마이그레이션
npx prisma migrate dev

# 개발 서버 실행
pnpm dev

http://localhost:3000에서 확인하세요.

📖 사용 방법

레포지토리 등록 (소유자)

1. GitHub으로 로그인
2. 대시보드 → 레포지토리 등록
3. 등록할 레포지토리 선택
4. 설정 페이지에서 Personal Access Token 등록
   • Token에 repo 및 actions 권한 필요
5. 생성된 링크를 팀원들과 공유

Action 재실행 (팀원)

1. 공유받은 링크로 접속
2. GitHub으로 로그인
3. 자신에게 할당된 PR 목록 확인
4. 실패한 워크플로우 옆 "Rerun" 버튼 클릭

🔒 보안

• Personal Access Token은 AES-256-GCM으로 암호화되어 저장됩니다.
• 팀원은 자신에게 할당된 PR의 Action만 재실행할 수 있습니다.
• 모든 API 요청은 세션 기반 인증을 거칩니다.