본문 바로가기
인간은 어떻게 배울까

[git] 터미널에서 깃헙 cli 설치 -> 인증 토큰 -> 클론 하기

by 개발하는 아인 2023. 8. 1.

환경: Mac(m1) zsh

 

깃헙 cli 설치 및 인증, 저장소 클론하기

 

1. gh 설치

gh는 깃헙 cli입니다. 터미널에서도 깃헙을 사용할 수 있게 해줍니다.

 

설치를 위해 터미널을 열고 아래와 같이 입력합니다.

 

brew install gh

 

gh와 git은 다릅니다.

brew install git 은 git을 설치하는 구문입니다.

gh는 github for cli로 터미널 환경에서 깃헙을 이용할 수 있는 프로그램입니다.

 

아래와 같이 gh의 설치가 시작됩니다.

 

 

2. gh 토큰 인증

설치가 끝나면, 인증을 해주어야 합니다.

2021년까지는 깃헙 id와 비번으로 인증이 됐었는데 요즘은 토큰으로 인증방식이 변경됐어요.

 

아래 링크를 클릭해서 깃헙 토큰 발행 페이지로 이동합니다. 물론 로그인 해주시구요.

 

https://github.com/settings/tokens

 

GitHub: Let’s build from here

GitHub is where over 100 million developers shape the future of software, together. Contribute to the open source community, manage your Git repositories, review code like a pro, track bugs and fea...

github.com

 

 

 

 

 

아니면 아래처럼 오른쪽 상단의 본인 프로필을 클릭하고 뜨는 팝업메뉴에서 Settings로 이동, Developer Settings -> Personal access tokens -> Tokens (classic) 으로 이동해도 됩니다.

 

 

아래처럼 토큰 생성 버튼을 클릭합니다. 

이 때 토큰이 Fine-grained tokens(베타 버전)와 기존의 classic Tokens 이렇게 2가지가 있는데, 저는 약간... Beta에 대한 알러지가 있어서 안전하게 classic을 선택했습니다.

 

(Fine-grained tokens는 찾아보니 이런 내용이 있네요. https://velog.io/@siontama/Github-Fine-grained-tokens-%EC%82%AC%EC%9A%A9%EC%8B%9C-%EC%A3%BC%EC%9D%98%EC%82%AC%ED%95%AD)

 

 

Note에는 대충 아무 내용을 써주고, 그 아래 Expiration에서는 기한 설정을 해주는데 보안상으로는 짧게 하는 것이 좋다지만 저는 때마다 다시 발급받기 귀찮아서 그냥 무제한으로 했습니다.

 

 

 

 

Select scopes에서는 최소한 아래와 같이는 설정해주시는 게 좋습니다.

터미널 창에서 gh로 인증을 시도할 때 최소한으로 아래와 같은 설정을 요구하기 때문입니다.

'repo', 'read:org', 'workflow' 이렇게 세개를 체크해줍니다.

 

 

맨 아래로 내려가서 토큰 생성 버튼을 클릭합니다.

 

 

 

그럼 아래와 같이 토큰이 생성되어 표시될 텐데 copy 버튼을 클릭하여 안전한 곳에 잘 저장해두는 것이 좋습니다. 생성할 때 한번만 나타나고 이후 다시 확인할 수 없거든요.

 

 

 

이제 터미널 창으로 돌아가 깃헙 인증을 하겠습니다.

터미널창에 아래와 같이 입력합니다.

gh auth login

 

그럼 아래와 같이 어디에 로그인할지 물어봅니다.

GitHub.com으로 선택해줍니다.

HTTPS를 선택합니다.

Y를 입력하고

 

브라우저 연동 로그인과 토큰 입력 둘 중 선택하라고 하는데

기껏 토큰 인증받은 게 있으니 토큰을 입력하도록 하겠습니다. Paste an authentication token 을 선택합니다.

그럼 아래와 같이 토큰 입력을 요구하는 메세지가 뜹니다. 아까 복사해둔 토큰을 여기에 붙여넣기합니다.

 

성공적으로 인증되었습니다.

 

 

 

 

3. gh로 저장소 클론하기

저는 지금 공부중인 책 'Node.js 백엔드 개발자 되기'의 강의 자료 저장소를 클론하려 합니다.

해당 저장소의 주소는 https://github.com/wapj/jsbackend 입니다.

위 저장소를 git으로 클론하는 명령어는 다음과 같습니다.

git clone https://github.com/wapj/jsbackend

 

우리가 방금 설치한 gh로 클론하는 방법은 다음과 같습니다. github.com 이후의 주소만 입력합니다.

gh repo clone wapj/jsbackend

 

둘 중 무엇을 쓰던 상관없습니다.

 

이렇게 gh 설치부터 인증, 클론까지 해보았습니다.