こんにちは、@yshr10icです。
2020/9/18に「GitHub CLI 1.0」がリリースされました。
ターミナルからGitHubを操作することができるということなので、少し触ってみたいと思います。
前提条件
筆者の環境は以下となります。
- PC:MacBook Pro(13-inch, 2020, Four Thunderbolt 3 ports)
- OS:macOS Catalina(バージョン:10.15.6)
- ターミナル:iTerm2 Build 3.3.12
- Homebrew:2.5.1
- Git:2.26.2
ドキュメント
GitHub CLIの情報は以下にまとまっています。
GitHubリポジトリ
インストール方法
マニュアル
GitHub CLI 1.0のインストール
さっそく、「GitHub CLI 1.0」をインストールしていきたいと思います。
Macの場合、HomebrewまたはMacPortsからインストールすることができます。
今回はHomebrewからインストールしたいと思います。
ターミナルを起動し、以下のコマンドを実行します。
brew install gh
コマンドを実行すると、以下のようにインストールが開始されます。
![](https://yshr10ic.com/wp-content/uploads/2020/09/zsh-1024x271.png)
正常にインストールされたか、バージョンを確認してみます。
gh --version
![](https://yshr10ic.com/wp-content/uploads/2020/09/zsh-1-300x65.png)
正しくインストールできていることが確認できました。
ログイン
続いて、GitHubにログインしたいと思います。
gh auth login
とコマンドを打つと、GitHub.comかGitHub Enterprise Serverのどちらにログインするか、聞かれます。
![](https://yshr10ic.com/wp-content/uploads/2020/09/gh-1024x80.png)
今回は、GitHub.comにログインします。
続いて、ログイン方法について聞かれます。WEBブラウザまたは認証トークンでのログインが選択できます。
![](https://yshr10ic.com/wp-content/uploads/2020/09/gh-1-1024x110.png)
今回はWEBブラウザでのログインにします。
ワンタイムパスワードが生成されるので、ワンタイムパスワードをコピーし、Enterボタンを押します。
![](https://yshr10ic.com/wp-content/uploads/2020/09/gh-2-1024x128.png)
アクティベーション画面がWEBブラウザに表示されるので、先ほどコピーしたワンタイムパスワードを貼り付け、「Continue」ボタンを押します。
権限を聞かれるので、「Authorize github」ボタンを押します。
![](https://yshr10ic.com/wp-content/uploads/2020/09/Authorize_application-1024x610.png)
パスワードを入力して、「Confirm password」ボタンを押します。
![](https://yshr10ic.com/wp-content/uploads/2020/09/Confirm_password-1024x388.png)
これで、認証に成功です。
![](https://yshr10ic.com/wp-content/uploads/2020/09/Device_Activation-1-1024x347.png)
ターミナルに戻ってEnterを押すと、デフォルトのGitの接続方法をHTTPSまたはSSHで聞かれます。
今回はSSHを選択します。
![](https://yshr10ic.com/wp-content/uploads/2020/09/zsh-2-1024x217.png)
これでログインは完了です!
GitHub CLIを使ってみる
リポジトリ操作
まずはテスト用のリポジトリを作成していきたいと思います。
gh repo create <repo-name>
今回は、リポジトリ名をgithub-cli-test
とし、description
も追加しています。
gh repo create github-cli-test -d "GitHub CLI 1.0 test repository"
上記コマンドを実行するといくつか選択肢が表示されますが、今回はパブリックリポジトリを選択し、カレントディレクトリにプロジェクトを作成するを選択しました。
![](https://yshr10ic.com/wp-content/uploads/2020/09/zsh-3-1024x167.png)
しっかりとリポジトリが作成されていますね。
![](https://yshr10ic.com/wp-content/uploads/2020/09/Your_Repositories-1024x238.png)
次に作成したリポジトリの情報を見てみたいと思います。
gh repo view <repo-name>
![](https://yshr10ic.com/wp-content/uploads/2020/09/zsh-4-1024x164.png)
先ほどdescription
で指定した内容が取得できています。ただ、READMEがないよ、というメッセージが出ているので、READMEを作成してもう一度試してみたいと思います。
![](https://yshr10ic.com/wp-content/uploads/2020/09/zsh-5-1024x297.png)
README.mdの内容が正しく取得できました。
ターミナルの背景色のせいで、見にくくなってしまっていますが、「## 概要」の下にも文章が表示されています。
イシュー操作
続いてイシューを作ってみたいと思います。
gh issue create --title "イシュー作成テスト" --body "GitHub CLIからのイシュー作成" --label "bug"
![](https://yshr10ic.com/wp-content/uploads/2020/09/zsh-6-1024x158.png)
![](https://yshr10ic.com/wp-content/uploads/2020/09/Issues_·_yshr10ic_github-cli-test-1024x366.png)
きちんと作成されていますね!
次に作成されたイシューを一覧表示で見てみたいと思います。
gh issue list
上記コマンドでデフォルトでは30件までのイシューを一覧で取得することができます。
また、オプションを指定することによって、ラベルでのフィルタや取得件数の変更などをすることができます。
# ラベルがdocumentationのイシューを取得する
gh issue list -l documentation
![](https://yshr10ic.com/wp-content/uploads/2020/09/zsh-7-1024x339.png)
プルリク操作
続いてプルリクを作成していきたいと思います。
プルリクを作成するために、pr-test
ブランチを作成し、sample.txt
を追加しました。
![](https://yshr10ic.com/wp-content/uploads/2020/09/yshr10ic_github-cli-test_at_pr-test-1024x384.png)
gh pr create --base main --title "GitHub CLI プルリクテスト" --body "プルリクのテストです。"
![](https://yshr10ic.com/wp-content/uploads/2020/09/zsh-8-1024x154.png)
![](https://yshr10ic.com/wp-content/uploads/2020/09/Pull_requests_·_yshr10ic_github-cli-test-1024x367.png)
次に作成されたプルリクを一覧表示で見てみたいと思います。
gh pr list
![](https://yshr10ic.com/wp-content/uploads/2020/09/zsh-9-1024x188.png)
まとめ
本記事では、GitHub CLIを使ってリポジトリ操作やイシュー操作、プルリク操作を試してみました。
コマンドは非常に簡単で分かりやすいとは思うものの、イシューやプルリクに関してはコメントなどを複数行書いたりするので、コマンドラインからは操作するのは難しいという印象を受けました。
ただ、何らかの条件によりイシューやプルリクを自動クローズするなど、自動化処理に関してはもしかしたら使えるものになるかもしれないですね。
Git・GitHubに関するおすすめの本やサイト
(2024/07/27 10:21:45時点 Amazon調べ-詳細)
(2024/07/27 10:21:46時点 Amazon調べ-詳細)
(2024/07/27 10:21:47時点 Amazon調べ-詳細)
(2024/07/27 10:21:47時点 Amazon調べ-詳細)