remote-git-dev-workflow은(는) 무엇을 하나요?
Remote Git Dev Workflow는 Codex 스킬로, 안전하고 재사용 가능한 협업 워크플로를 구축하기 위해 설계되었습니다: 로컬 머신에서 개발하고, GitHub 또는 GitLab을 중앙 저장소로 사용하며, 원격 서버에서 실행 및 검증을 수행합니다.
개요
이 스킬은 로컬 개발 환경과 원격 서버 간의 격차를 해소하여 개발자가 다음을 수행할 수 있도록 합니다:
- 로컬에서 코드를 작성하고 변경 사항을 커밋합니다.
- 변경 사항을 중앙 Git 저장소(GitHub/GitLab)에 푸시합니다.
- 원격 서버가 자동으로 코드를 가져와서 실행하거나 테스트를 수행합니다.
주요 기능
| 기능 | 설명 |
|---|---|
| 자동 배포 | 푸시 이벤트 시 원격 서버에서 코드 가져오기 및 실행 |
| 안전한 인증 | SSH 키를 사용한 서버 액세스 |
| 재사용 가능 | 다양한 프로젝트에서 사용 가능한 표준 워크플로 |
| 플랫폼 독립적 | GitHub 및 GitLab 모두 지원 |
사전 요구 사항
- 로컬 머신에 설치된 Git
- GitHub 또는 GitLab 계정
- SSH로 액세스 가능한 원격 서버 (Linux 권장)
- Codex 환경
설정 방법
1단계: 로컬 Git 저장소 초기화
git init
git remote add origin <your-repo-url>
2단계: SSH 키 설정
로컬 머신에서 SSH 키를 생성하고 원격 서버에 추가합니다:
ssh-keygen -t rsa -b 4096 -C "[email protected]"
ssh-copy-id user@remote-server
3단계: 서버 측 설정
원격 서버에 Git 후크 스크립트를 생성합니다:
# 예: post-receive 후크
#!/bin/bash
export DEPLOY_DIR="/path/to/deploy"
git --work-tree=$DEPLOY_DIR checkout -f
cd $DEPLOY_DIR
./run.sh # 사용자 정의 실행 스크립트
4단계: Codex에 워크플로 등록
이 스킬을 Codex 프로젝트의 SKILL.md 파일에 추가합니다.
환경 변수
| 변수 | 설명 |
|---|---|
REMOTE_HOST | 원격 서버 호스트네임 |
REMOTE_USER | SSH 사용자 이름 |
REPO_URL | Git 저장소 URL |
DEPLOY_PATH | 서버의 배포 디렉토리 |
보안 고려 사항
- SSH 키는 안전하게 저장하고 절대 저장소에 커밋하지 마십시오.
- 환경 변수와
.env파일을 사용하여 민감한 정보를 관리하십시오. - 서버 측 스크립트는 최소 권한 원칙을 따라 실행 권한을 제한하십시오.
문제 해결
- SSH 연결 실패: 키가 올바르게 설정되었는지 확인하고
ssh -v user@host로 디버그합니다. - Git 푸시 거부: 저장소 권한과 원격 URL을 확인합니다.
- 스크립트 실행 오류: 서버 측 스크립트에 실행 권한(
chmod +x)이 있는지 확인합니다.
라이선스
이 스킬은 MIT 라이선스 하에 제공됩니다. 자세한 내용은 저장소의 LICENSE 파일을 참조하십시오.