GitHub 프로젝트 자동 배포 셸 스크립트
로컬 프로젝트를 익명화된 한국어 문서와 함께 GitHub에 단일 repo로 자동 업로드하는 헬퍼 스크립트
개요
여러 개인/사이드 프로젝트를 GitHub에 정리할 때 반복되는 작업을 자동화합니다. Claude Code CLI를 호출해 소스를 분석하고 익명화된 한국어 README를 자동 생성해 docs/README.md에 넣은 뒤, 소스와 함께 단일 GitHub repo로 업로드합니다. 회사·파트너·제품명 등 고유명사는 금지 키워드로 차단하며, 이미 존재하는 repo는 skip해 멱등성을 보장합니다. AWS 키, PEM, Slack 토큰 등 credential 패턴을 러프하게 스니핑하고, public 업로드 시 명시 확인을 요구해 실수를 방지합니다.
담당 역할
프로젝트 배포 자동화 워크플로우 설계 및 셸 스크립트 전체 구현. Claude Code CLI 통합, GitHub API 연동, 안전장치(금지어 필터, credential 스니핑, 멱등성) 구현.
아키텍처 다이어그램
레포지토리 분석 결과를 바탕으로 자동 생성된 구조도입니다.
자동 배포 워크플로우
로컬 소스 디렉터리부터 GitHub repo 생성·push까지 전체 단계를 보여주는 흐름도
안전장치 구조
민감 정보 노출을 막기 위한 다층 방어 메커니즘
기술스택
각 기술을 이 프로젝트에서 어떤 용도로 썼는지 정리했습니다.
언어
- Shell전체 자동화 로직과 워크플로우 구현
도구
- Claude Code CLI소스 코드 분석 및 익명화된 한국어 README 자동 생성
- GitHub CLIrepo 존재 확인, 생성, push 작업 자동화
- Git소스 커밋 및 히스토리 관리
핵심 포인트
- Claude Code를 헤드리스 모드로 호출해 소스 코드를 분석하고 익명화된 문서 자동 생성
- 금지 키워드 자체 검증과 credential 패턴 스니핑으로 민감 정보 노출 방지
- 멱등성 보장: 이미 존재하는 repo는 skip하고, 기존 git history가 있으면 보존
- dry-run, 인터랙티브 확인, 커스텀 금지어 등 안전장치와 유연한 옵션 제공
- 소스와 문서를 단일 repo로 통합해 관리 복잡도 감소 (마이그레이션 가이드 포함)
문제와 해결
문제Claude가 소스를 읽는 과정에서 파일 수정이나 네트워크 호출로 부작용이 발생할 위험
해결도구 허용 리스트(Read, Bash:ls|cat|head|find|grep|wc|file)로 제한해 관찰만 가능하게 통제
문제public repo로 실수로 업로드해 credential이나 회사명이 노출될 가능성
해결금지 키워드 self-check, credential 패턴 스니핑, public 업로드 시 명시 확인 프롬프트로 다층 방어
문제이미 배포한 프로젝트를 재실행할 때 중복 생성이나 히스토리 손실 문제
해결gh api로 repo 존재 확인 후 skip, 기존 .git이 있으면 history 보존하고 docs만 추가 커밋
레포지토리 정보
- 생성
- 2026년 7월 26일
- 최근 커밋
- 2026년 7월 27일
- 크기
- 14 KB
- 라이선스
- MIT
언어 구성
- Shell100.0%
이 문서는 2026년 7월 28일 에 자동 분석으로 생성되었습니다.