Git + GitHub con SSH: 단계별 가이드
카테고리
프로그래밍/소프트웨어 개발
서브카테고리
DevOps
대상자
- 초보 개발자에게 SSH 설정 방법을 쉽게 설명
- 중간 수준 개발자에게 보안 강화 및 자동화 기능 제공
- 프로페셔널 개발 환경에서의 실무 적용 가능성 강조
핵심 요약
- SSH 키 생성은
ssh-keygen -t ed25519 -C "이메일"
명령어로 수행 (코드 형식 강조) - SSH 에이전트에 키 추가는
ssh-add ~/.ssh/id_ed25519
명령어 사용 (코드 형식 강조) - GitHub에 키 업로드 후
git clone git@github.com:유저/리포.git
(SSH URL 사용)
섹션별 세부 요약
1. SSH 키 존재 확인
- ls ~/.ssh
명령어로 id_ed25519
및 .pub
파일 존재 여부 확인
- 파일이 없으면 다음 단계에서 생성
2. SSH 키 생성
- ssh-keygen -t ed25519 -C "이메일"
명령어 실행
- 기본 파일명 id_ed25519
사용 또는 커스텀 이름 지정
3. SSH 에이전트 실행 및 키 추가
- eval "$(ssh-agent -s)"
명령어로 에이전트 시작
- ssh-add ~/.ssh/id_ed25519
명령어로 키 추가 (파일명 맞춤)
4. GitHub에 키 업로드
- cat ~/.ssh/id_ed25519.pub
명령어로 공개 키 복사
- GitHub > Settings > SSH and GPG keys > New SSH key 메뉴에서 키 등록
5. SSH 설정 파일 구성 (선택 사항)
- code ~/.ssh/config
명령어로 파일 편집
- 복수 키 사용 시 Host github
섹션에 IdentityFile
경로 및 IdentitiesOnly yes
설정
6. 오류 해결: "Permission denied (publickey)"
- ssh -vT git@github.com
명령어로 디버깅 로그 확인
- 정확한 키 사용 여부 확인 후 ssh -T github
명령어로 테스트
7. SSH URL 사용
- HTTPS 대신 git clone git@github.com:유저/리포.git
형식의 SSH URL 사용
- 기존 HTTPS URL은 git remote set-url origin git@github.com:유저/리포.git
로 변경
결론
- SSH 설정 시
git@github.com
형식의 URL 사용이 필수이며, 에이전트 설정과 키 파일 경로 확인으로 오류 예방이 가능하다. - 복수 키 사용 시
~/.ssh/config
파일 구성이 권장되며, 정기적인 키 검증으로 보안 강화가 필요하다.