[Git / Github] 깃허브 CLI 사용을 위한 인증 방법 (+ 설치 방법)

Github CLI

깃허브 CLI는 개발자의 불편 사항 및 의견을 반영하여 깃허브 내에서도 CLI(Command Line Interface)이다.  Pull request, issues, Action 등의 터미널에서 수행하는 CLI 기능을 깃허브 내에서 수행할 수 있도록 하는 서비스이다.

 

자세한 내용은 링크 내 공식 문서에서 확인이 가능하다.

https://docs.github.com/en/github-cli

GitHub CLI - GitHub Docs

 

Github CLI 사용하기

먼저, Github CLI를 사용하기 위해 각 운영체제에 맞게 설치한다.

 

Windows

https://cli.github.com/

GitHub CLI

 

macOS

homebrew를 설치한 후, 다음 명령을 통해 Github CLI를 설치한다.

$ brew install gh

 

Linux(Ubuntu)

다음 명령어를 순서대로 입력한다.

curl -fsSL <https://cli.github.com/packages/githubcli-archive-keyring.gpg> | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] <https://cli.github.com/packages> stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null
sudo apt update
sudo apt install gh

만약, gpg: failed to start the dirmngr '/usr/bin/dirmngr': No such file or directory 에러가 발생하면,

dirmngr 패키지를 필요로 하는 것으로 sudo apt-get install dirmngr 명령어를 수행한 뒤, 다시 설치 과정을 수행한다.

# 에러 발생 시
sudo apt-get install dirmngr

 

설치 확인하기

설치를 완료하면, git bash를 실행하여 gh 명령어를 입력하여 다음과 같은 메시지를 출력하면 설치가 완료된 것이다.

$ gh

 

로그인 하기

다음 명령어를 입력하면, 로그인 절차를 시작한다.

$ gh auth login

이후 각 절차를 이동키를 통해 다음과 같이 선택한다.

1. ? What accout do you want to log into? GitHub.com
2. ? What is your preferred protocol for Git Operations? HTTPS
3. ? Authenticate Git with your GitHub credentials? Yes
4. ? How would you like to authenticate GitHub CLI? Login with a web browser

4번 과정을 끝마치면 One-time code가 OOOO-OOOO 형태로 등장한다. 이를 꼭 메모해야 한다.

 

One-time Code

로그인 절차가 끝나면, one-time code: OOOO-OOOO

형태로 출력한다. 이 코드를 잘 메모한 뒤 엔터키를 눌러 Device Activation 인증을 수행한다.

만약, 아래 화면을 실수로 벗어났다면 당황하지 말고 https://github.com/login/device 링크로 다시 접속하여 수행한다.

 

One-time code를 입력하면 다음과 같이 깃허브 CLI 사용을 위한 인증 과정이 모두 끝난다.