윈도우 환경의 VSCode에서 github 리파지토리를 연동해서 사용할때 아이디/패스워드를 생략하기 위해 SSH 공개키/개인키를 이용해서 접속하는 방법을 설명해 보겠다.
발단
VSCode에서 golang 개발을 하고 있는데 노트북과 데스크탑을 왔다갔다하니 소스코드 공유를 위해서 github를 쓰고 있다.
소스코드 공유를 해야되니 개발 도중의 코드도 자주 푸시할 수밖에 없는데 리모트에 뭐할 때마다 아이디/패스워드를 입력하라고 해서 너무 귀찮다.
그래서 알아보니 리파지토리를 HTTPS가 아니라 SSH를 사용해서 공개키/개인키를 사용해서 접속하면 아이디/패스워드 입력을 안해도 된다고 해서 그렇게 설정하니 너무너무 편하다.
SSH로 리파지토리 접속
먼저 기존에 사용하고 있던 공개키/개인키가 있으면 공개키를 github에 등록하고, 개인키는 윈도우의 유저폴더(c:\Users\USER_ID) 디렉토리 아래 .ssh 폴더에 넣으면 된다.
만들어 둔 공개키/개인키가 없으면 다음 순서대로 진행해서 만들자.
공개키/개인키 작성은 아래 커맨드를 입력하면 된다. -C 옵션 뒤에는 보통 이메일 주소 같은걸 쓰면 되는데, github에서 사용하는 메일주소를 넣자.
1
ssh-keygen-trsa-b4096-C"test@gmail.com"
그 다음은 엔터 3번만 누르면 된다. 첫번째는 개인키 파일명인데 디폴트로 하기 위해서 엔터, 두번째와 세번째는 공개키/개인키에 패스워드 설정하기인데 그걸 생략하기 위해서 공개키/개인키 방식을 쓰는거니 입력하지 말고 엔터를 눌러 생략하자.
1
2
3
4
5
6
Generating public/privatersa key pair.
Enter file inwhich tosave the key(/c/Users/USER_ID/.ssh/id_rsa):
Enter passphrase(empty forno passphrase):
Enter same passphrase again:
Your identification has been saved in/c/Users/USER_ID/.ssh/id_rsa
Your publickey has been saved in/c/Users/USER_ID/.ssh/id_rsa.pub
ssh-keygen을 실행한 .ssh 폴더에 id_rsa(개인키 파일)과 id_rsa.pub(공개키 파일)이 만들어진다.
github.com에 공개키를 등록
github에 로그인해서 오른쪽 위에 아이콘을 클릭하면 설정(Settings)이 나온다. 선택해서 설정 화면으로 이동. SSH and GPG keys 메뉴를 클릭하고 마지막으로 New SSH key 버튼을 누른다.
Title은 적당히 아무거나 넣고, Key 부분에 공개키인 id_rsa.pub 파일을 열어서(메모장으로 열면 됨) 내용을 전체 복사한 다음 붙여넣으면 된다.
이걸로 github에 공개키 등록은 끝났다.
VSCode에서 github 리파지토리 SSH로 연동
기존에 사용하던 리파지토리를 지우고 SSH 주소로 다시 등록한다.
github 리파지토리에서 SSH 주소를 복사한다.
Use SSH 링크를 누르면
SSH 접속 주소가 나온다. 오른쪽 옆에 아이콘을 눌러서 복사하자.
우선 기존 등록된 git remote add origin 커맨드로 등록한 https 주소를 해제하자.
VSCode에서 로컬 리파지토리 경로에 폴더에서 터미널을 열고, 아래 커맨드를 실행한다. (.git 폴더가 있는 폴더에서 커맨드를 실행하면 된다. 일반 윈도우 커맨드창에서 실행해도 됨)
다운로드 해보면 7z 실행파일인다. 실행해서 적당한 폴더를 선택해서 압축을 푼다. 여기선 c:\dev\git 에 압축을 풀겠다.
윈도우의 환경변수에 git 의 실행파일 디렉토리를 PATH 에 추가한다. 유저 환경변수나 시스템 환경변수, 둘 중 아무데나 추가해도 된다.
윈도우10에서 환경변수 화면으로 이동하는 방법
화면 왼쪽 아래에 윈도우 마크에서 마우스 오른쪽 클릭 -> 시스템 클릭 -> 오른쪽에 시스템 정보 클릭 -> 왼쪽에 시스템의 상세설정 -> 화면 아래쪽에 환경변수 버튼 클릭
PATH 항목을 편집해 git/cmd 디렉토리를 추가하자.
vscode git에 파일 올리기
git 실행파일을 환경변수 PATH 에 추가하고 vscode 를 실행해서 왼쪽 소스컨트롤 버튼을 눌러보면 아래 이미지와 같이 표시된다.
vscode 익스플로러에 열려 있는 폴더(go_work)가 git 리파지토리를 가지고 있지 않다는 내용이다. 리파지토리 초기화 버튼을 누르자.
아래와 같이 변경된 파일이 표시 된다.
플러스(+) 아이콘을 눌러서 변경된 파일을 스테이지에 올리자.
스테이지에 파일이 올라간 상태.
윗쪽 체크 아이콘을 눌러서 커밋하자.
커밋 메시지를 입력하라는데 적당히 입력하자.
메시지 입력하고 ENTER 키를 누르면 아래와 같이 에러가 난다.
윈도우 커맨드창이든 vscode 에서 연 커맨드창(하단 TERMINAL 탭)이든 아래 내용을 입력해서 user.name과 user.email을 등록하자. github.com 에 등록된 유저명을 사용하는게 좋을 것이다.
1
2
git config--globaluser.name'elmitash'
git config--globaluser.email'elmitash@gmail.com'
vscode 터미널에서 입력
다시 커밋해보면 에러가 안나오고 잘 된다.
github 에 올리기
github 에서 리파지토리를 만들자. 여기서 go_test 란 이름으로 만들었다.
여기서 두가지 옵션이 있는데.
하나는 go_work 아래 go_test 폴더를 통째로 github 에 올리는 방법과, go_test 아래 test.go 파일만 올리는 방법이 있다. 리파지토리 하나에 여러 폴더를 올릴 경우에는 전자가 좋을것이고, 리파지토리 하나에 하나의 폴더(프로젝트)의 내용을 올리고 싶으면 후자가 좋다.
c:\dev\go_work 에서 커맨드창을 열어서 아래 명령을 실행한다. go_test 폴더를 github 의 go_test 리파지토리에 등록한다.
c:\dev\go_work 에 있는 .git 폴더를 지우고, go_test 폴더로 이동해서 git init 를 실행한 후, 아래 명령을 실행하면, test.go 파일을 go_test 리파지토리에 등록한다.
64비트 윈도우용 압축파일인 go1.14.2.windows-amd64.zip 파일을 다운로드 받아서 적당한 곳에 압축을 풀자. (이 글에서는 c:\dev\go 에 압축을 풀어둔 상태로 설명한다.)
윈도우의 환경변수에 go 의 실행파일 디렉토리를 PATH 에 추가한다. 유저 환경변수나 시스템 환경변수, 둘 중 아무데나 추가해도 된다.
윈도우10에서 환경변수 화면으로 이동하는 방법
화면 왼쪽 아래에 윈도우 마크에서 마우스 오른쪽 클릭 -> 시스템 클릭 -> 오른쪽에 시스템 정보 클릭 -> 왼쪽에 시스템의 상세설정 -> 화면 아래쪽에 환경변수 버튼 클릭
아래 이미지대로 PATH 항목을 편집해 go/bin 디렉토리를 추가하자.
gopath 설정
gopath는 go 에서 사용하는 모든 외부 라이브러리를 보관하는 장소이다. go 코드를 작성하면서 import 하는 외부 라이브러리도 이곳에 다운로드해서 저장한다.
기본적으로 유저 폴더 아래에 go 폴더(c:\user\USER_ID\go)가 지정되는 것 같은데, 나는 유저 폴더 밑에 뭘 두는게 싫어서(다른 폴더가 많아서 찾아보기가 힘들어) c:\dev\go_path 로 지정하겠다.
마찬가지로 윈도우 환경변수에 gopath 란 이름으로 디렉토리 절대경로를 설정한다.
64비트 윈도우용 압축파일은 .zip 옆에 64 bit 링크를 클릭하면 다운로드 된다. 마찬가지로 적당한 곳에 압축을 풀자. (이 글에서는 c:\dev\vscode 에 압축을 풀어둔 상태로 설명한다.)
vscode를 실행하고 왼쪽에 확장기능에서 go 를 설치한다.
인스톨이 끝나면 Ctrl + Shift + P 키를 눌러서 명령창을 열어 go install 로 검색해서 Go: Install/Update Tools 를 선택해서 나오는 모든걸 다 설치한다.
체크 클릭해서 전부 체크하고 오른쪽 OK 버튼을 눌러서 설치 시작.
아래 콘솔창에 설치내용이 표시된다.
마지막에 All tools successfully installed. You are ready to Go :). 가 표시되면 완료.
여기까지하면 vscode 에서 고언어로 코딩할 수 있는 준비가 끝났다.
hello go 작성 테스트
c:\dev\go_work 경로로 소스를 저장할 디렉토리를 만들고, vscode 에서 이 폴더를 워크스페이스로 연다.
vscode 왼쪽 제일 윗 아이콘을 클릭해서 익스플로러를 열고, 익스플로러 빈 공간에서 마우스 오른쪽 버튼으로 메뉴를 열어서 Add Folder to Workspace 를 선택하고 go_work 디렉토리를 선택하면 된다.
익스프롤러에 go_work 가 표시될텐데 마우스 커서를 올리면 파일생성, 폴더생성, 새로고침, 폴더접기 아이콘이 표시된다.
폴더 생성하기로 go_test 폴더를 작성하자. c:/dev/go_work/go_test 경로로 디렉토리가 생성된다.
go_test 를 선택하고 파일생성 아이콘을 눌러서 test.go 란 이름으로 go 파일을 만들고 열어서 아래처럼 코딩을 한다.
1
2
3
4
5
6
7
packagemain
import"fmt"
func main(){
fmt.Println("hello go!")
}
작성 후에 F5 버튼을 누르면 코드가 실행된다. 실행 결과는 아래 DEBUG CONSOLE 에 표시된다.
