インストール - GitHub CLIのソースを表示

== 概要 ==
GitHub CLI (gh) は、GitHubの機能をコマンドラインから直接操作できる公式ツールである。<br>
<br>
プルリクエストやIssueの管理、リポジトリ操作等、GitHubの主要機能をターミナルから実行できる。<br>
Go言語で記述されており、Windows、MacOS、Linuxの主要プラットフォームで動作する。<br>
<br>
主要な仕様を以下に示す。<br>
* 開発言語
*: Go
* ライセンス
*: MIT
* サポート対象OS
*: Windows、MacOS、Linux
* サポート対象GitHub
*: GitHub.com、GitHub Enterprise Cloud、GitHub Enterprise Server 2.20以上
<br>
主要機能は以下の通りである。<br>
* PR / Issue管理
*: プルリクエストおよびIssueの作成、表示、レビュー操作をコマンドラインから実行できる
* リポジトリ操作
*: リポジトリのクローン、フォーク、閲覧等の操作を実行できる
* GitHub Enterprise対応
*: GitHub Enterprise CloudおよびGitHub Enterprise Server 2.20以上に対応している
* Copilotコードレビュー統合
*: GitHub Copilotによるコードレビュー機能と統合されている
<br><br>

== Windows ==
Windows向けのインストール方法として、WinGet、MSIインストーラ、Chocolatey、Scoopの4種類がある。<br>
公式が推奨する方法はWinGetを使用したインストールである。<br>
<br>
==== WinGet ====
WinGetはMicrosoftが提供する公式パッケージマネージャーであり、最も推奨されるインストール方法である。<br>
<br>
 <syntaxhighlight lang="powershell">
 winget install --id GitHub.cli
 
 # アップグレード
 winget upgrade --id GitHub.cli
 </syntaxhighlight>
<br>
インストール後は、Windows Terminalで新しいウィンドウを開く必要がある。<br>
タブの新規作成ではなく、新しいウィンドウを開くことにより、環境変数が正しく反映される。<br>
<br>
==== MSIインストーラ ====
GitHubのリリースページから、MSIインストーラをダウンロードしてインストールすることができる。<br>
<br>
対応アーキテクチャは以下の通りである。<br>
* x86 (32ビット)
* amd64 (64ビット)
* arm64 (ARM 64ビット)
<br>
インストーラは以下に示すURLから入手できる。<br>
* [https://github.com/cli/cli/releases/latest GitHub CLI リリースページ]
<br>
==== Chocolatey ====
Chocolateyはコミュニティが管理するパッケージマネージャーである。<br>
<u>GitHub CLIチームが保守するものではないことに注意が必要である。</u><br>
<br>
 <syntaxhighlight lang="powershell">
 # インストール
 choco install gh
 
 # アップグレード
 choco upgrade gh
 </syntaxhighlight>
<br>
==== Scoop ====
Scoopはコミュニティが管理するパッケージマネージャーである。<br>
<u>GitHub CLIチームが保守するものではないことに注意が必要である。</u><br>
<br>
 <syntaxhighlight lang="powershell">
 # インストール
 scoop install gh
 
 # アップグレード
 scoop update gh
 </syntaxhighlight>
<br><br>

== RHEL / SUSE ==
Linux向けのインストール方法では、リポジトリを追加してインストールする方法、バイナリを直接ダウンロードする方法、ソースコードからビルドする方法の3種類がある。<br>
<br>
==== リポジトリを追加してインストール ====
公式リポジトリを追加してパッケージマネージャーからインストールする方法が最も推奨される。<br>
<br>
===== RHEL =====
 # インストール
 sudo dnf install dnf5-plugins
 sudo dnf config-manager addrepo --from-repofile=https://cli.github.com/packages/rpm/gh-cli.repo
 sudo dnf install gh --repo gh-cli
 
 # アップグレード
 sudo dnf upgrade gh
<br>
===== SUSE =====
 # インストール
 sudo zypper addrepo https://cli.github.com/packages/rpm/gh-cli.repo
 sudo zypper ref
 sudo zypper install gh
 
 # アップグレード
 sudo zypper update gh
<br>
==== バイナリをダウンロードしてインストール ====
パッケージマネージャーを使用せずに、バイナリを直接ダウンロードしてインストールすることができる。<br>
<br>
対応アーキテクチャは以下の通りである。<br>
* x86 (x86)
*: <u>gh_*_linux_386.tar.gz</u>
* amd64 (x64)
*: <u>gh_*_linux_amd64.tar.gz</u>
* arm64 (ARM 64ビット)
*: <u>gh_*_linux_arm64.tar.gz</u>
* armv6 (ARM 32ビット)
*: <u>gh_*_linux_armv6.tar.gz</u>
<br>
# GitHub CLIのGitHubにアクセスして、バイナリをダウンロードする。
# ダウンロードしたファイルを解凍する。
#: <pre>tar xf gh_x.x.x_linux_amd64.tar.gz</pre>
# 必要ならば、任意のディレクトリにコピーする。
#: <pre>cp -r gh_x.x.x_linux_amd64/* <任意のインストールディレクトリ></pre>
# 必要ならば、~/.profileファイル等に環境変数を設定する。
#: <syntaxhighlight lang="sh">
 export PATH="/<GitHub CLIのインストールディレクトリ>/bin:$PATH"
 export MANPATH="/<GitHub CLIのインストールディレクトリ>/share/man:$MANPATH"
 </syntaxhighlight>
<br>
その他のバージョンやアーキテクチャのバイナリは、以下のページから入手できる。<br>
* [https://github.com/cli/cli/releases GitHub CLI リリースページ]
<br>
==== ソースコードからビルドしてインストール ====
ソースコードからビルドしてインストールすることができる。<br>
<br>
<u>前提条件として、Go 1.25以上のインストールが必要である。</u><br>
<br>
# リポジトリをクローンする。
#: <syntaxhighlight lang="text">
 git clone https://github.com/cli/cli.git gh-cli
 cd gh-cli
 </syntaxhighlight>
#: <br>
# GitHub CLIをビルドおよびインストールする。
#: <pre>make install prefix=/path/to/gh</pre>
#: <br>
# 必要ならば、~/.profileファイル等に環境変数を設定する。
#: <syntaxhighlight lang="sh">
 export PATH="/<GitHub CLIのインストールディレクトリ>/bin:$PATH"
 export MANPATH="/<GitHub CLIのインストールディレクトリ>/share/man:$MANPATH"
 </syntaxhighlight>
<br><br>

== MacOS ==
MacOS向けのインストール方法として、Homebrew　および　MacPortsを使用する方法がある。<br>
公式が推奨する方法はHomebrewを使用したインストールである。<br>
<br>
==== Homebrew ====
Homebrewを使用したインストールが最も推奨される方法である。<br>
<br>
 # インストール
 brew install gh
 
 # アップグレード
 brew upgrade gh
<br>
==== MacPorts ====
MacPortsはコミュニティが管理するパッケージマネージャーである。<br>
GitHub CLIチームが保守するものではないことに注意が必要である。<br>
<br>
 # インストール
 sudo port install gh
 
 # アップグレード
 sudo port selfupdate && sudo port upgrade gh
<br><br>

== インストールの確認 ==
インストール完了後に、バージョンの確認と認証の設定を行う。<br>
<br>
==== バージョンの確認 ====
インストールが正常に完了していることを確認する。<br>
<br>
 gh version
<br>
正常にインストールされている場合、以下のような出力が表示される。<br>
<br>
 gh version x.x.x (yyyy-MM-dd)
<br>
==== 認証の設定 ====
GitHub CLIを使用するには、GitHubアカウントでの認証が必要である。<br>
<br>
まず、以下に示すコマンドを実行して、インタラクティブなプロンプトに従って認証を設定する。<br>
<br>
 gh auth login
<br>
プロンプトでは以下の項目を選択する。<br>
* 接続先の選択
*: GitHub.com または GitHub Enterprise Server
* プロトコルの選択
*: HTTPS または SSH
* 認証方法の選択
*: ブラウザ認証 または トークン入力
<br>
認証が完了した後、認証状態を確認する。<br>
<br>
 gh auth status
<br><br>

== アンインストール ==
==== Windows ====
使用したインストール方法に応じて、以下の手順でアンインストールする。<br>
<br>
* WinGetの場合
*: <pre>winget uninstall --id GitHub.cli</pre>
* MSIインストーラの場合
*: [設定] - [アプリ] - [アプリと機能]からGitHub CLIを選択してアンインストールする。
* Chocolateyの場合
*: <pre>choco uninstall gh</pre>
* Scoopの場合
*: <pre>scoop uninstall gh</pre>
<br>
==== RHEL / SUSE ====
 # RHEL
 sudo dnf remove gh
 
 # SUSE
 sudo zypper remove gh
<br>
==== MacOS ====
* Homebrewの場合
*: <pre>brew uninstall gh</pre>
* MacPortsの場合
*: <pre>sudo port uninstall gh</pre>
<br><br>

== 参考リンク ==
* [https://github.com/cli/cli GitHub CLI 公式リポジトリ]
* [https://cli.github.com/manual/ GitHub CLI 公式ドキュメント]
* [https://github.com/cli/cli/releases GitHub CLI リリースページ]
<br><br>


{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:RHEL]][[カテゴリ:SUSE]]