GitHub Actions 셋업 가이드

00 Prerequisites

사전 준비 — 답해주실 두 가지

지금 채팅창에 답해주세요

GitHub 계정 — 있으세요? 있으면 사용자명(username) 알려주세요. 없으면 "없어"라고만
저장소 이름 — bodycody-onstudio로 할까요? 다른 이름 원하시면 알려주세요

이 두 가지 답이 오면 제가 즉시 다음 단계 안내해드립니다. 아래는 미리 보시고 어떤 흐름인지 파악만 하셔도 좋아요.

01 Step 1

GitHub 계정 + gh CLI 설치

1-A. GitHub 계정 (없으신 경우)

github.com/signup 접속
이메일·사용자명·비밀번호 입력 (사용자명은 영문 사용)
이메일 인증 → 계정 생성 완료
무료 plan 선택 (Free)

1-B. gh CLI 설치 (터미널 명령 한 줄)

Claude 채팅창에 그대로 붙여넣기:

터미널 명령

!brew install gh

1~2분 소요. brew가 없으면 먼저 brew 설치 후 다시 실행. (brew는 macOS 표준 패키지 매니저)

왜 gh CLI? GitHub 명령줄 도구. 이걸 쓰면 저장소 만들기·시크릿 등록·코드 푸시까지 제가 자동으로 처리할 수 있어요. 웹 UI로 일일이 누르는 것보다 훨씬 빠릅니다.

02 Step 2

gh 인증 + 저장소 생성

2-A. gh 인증 (사용자가 직접 한 번만)

브라우저 자동 인증 흐름이라 사용자 직접 진행 필요. 채팅창에 그대로 붙여넣기:

터미널 명령

!gh auth login

그러면 대화형 질문이 뜹니다. 답변:

What account do you want to log into? → GitHub.com 선택 (Enter)
What is your preferred protocol for Git operations? → HTTPS 선택
Authenticate Git with your GitHub credentials? → Y
How would you like to authenticate? → Login with a web browser 선택
화면에 8자리 코드 표시 → Enter 누르면 브라우저 열림 → 코드 입력 → Authorize

2-B. 저장소 생성 + 푸시 (제가 처리)

인증 성공하면 "인증 됐어"라고 답해주세요. 그러면 제가 다음을 자동 실행합니다:

gh repo create bodycody-onstudio --private --source=. --push — private 저장소 생성 + 코드 푸시

03 Step 3

시크릿 등록 (자격증명을 GitHub에 안전하게)

저장소가 만들어지면 GitHub Secrets에 7개 값을 등록해야 합니다. 이건 제가 gh secret set 명령으로 자동 처리할 거예요.

시크릿 이름	값 (현재 .env에 있는 것)
`BODYCODI_ID`	habitstudio@bodycodi.com
`BODYCODI_PW`	(현재 비밀번호)
`ONSTUDIO_ID`	01073282587
`ONSTUDIO_PW`	(현재 비밀번호)
`NAVER_MAIL_ADDR`	midbar_@naver.com
`NAVER_APP_PW`	V9FKQJ9LKKNV
`REPORT_TO`	midbar_@naver.com

🔒 시크릿은 어떻게 안전하게?
GitHub Secrets는 한 번 등록하면 다시 읽을 수 없고 (마스킹됨), Actions 워크플로 안에서만 사용. 코드에는 절대 노출 안 됨. 로그에 출력하려 해도 자동으로 ***로 가려집니다.

04 Step 4

첫 실행 테스트

모든 셋업 끝나면 GitHub Actions 탭에서 워크플로를 수동 트리거해 첫 실행을 테스트합니다. 제가 gh workflow run으로 자동 처리.

실행 예상

2~3분 (Python 설치 + Chromium 다운로드 + 실행)

검증

메일 도착 확인 + GitHub Actions 로그 그린 체크

예상 가능한 첫 실패
GitHub 서버는 미국에 있어서 한국 SaaS(바디코디·온스튜디오)에서 "이상한 위치 로그인" 보안 경고가 뜰 수 있어요. 만약 실패하면 두 가지 방법이 있습니다:

각 서비스의 보안 설정에서 "외부 IP 로그인 허용"
한국 클라우드 서비스(Naver Cloud, KakaoCloud)로 옮기거나 옵션 A로 fallback

실패하면 같이 분석해서 해결 방안 찾아봅니다.

05 Step 5

launchd 비활성화 (전환 마무리)

GitHub Actions가 매일 정상 작동 확인되면, 로컬 launchd를 비활성화합니다. 안 그러면 매일 메일을 두 통씩 받게 됩니다.

권장

GitHub Actions 첫 1~2일 정상 작동 확인 후 launchd 끄기

명령

launchctl unload ~/Library/LaunchAgents/com.midbar.bodycody-onstudio.plist
rm ~/Library/LaunchAgents/com.midbar.bodycody-onstudio.plist

06 Now

지금 바로 답해주세요

채팅창에 두 가지만 알려주시면 시작합니다

GitHub 계정 있으세요? 있으면 username / 없으면 "없어"
저장소 이름 — bodycody-onstudio 그대로 OK?

예: "있어 username은 midbar" 예: "없어 만들어줘"