- SSHキーペアの生成: まず、SSHキーペアを生成する必要があります。以下のコマンドを使用して、SSHキーペアを生成します。
$ ssh-keygen -t rsa -b 4096 -C "[email protected]"
このコマンドを実行すると、秘密鍵(id_rsa
)と公開鍵(id_rsa.pub
)が生成されます。
- 公開鍵をGitHubに追加: 次に、生成された公開鍵をGitHubに追加する必要があります。GitHubのウェブサイトにログインし、以下の手順に従って公開鍵を追加します。
- GitHubの右上にあるユーザーアイコンをクリックし、「Settings」を選択します。
- 左側のメニューから「SSH and GPG keys」を選択します。
- 「New SSH key」ボタンをクリックします。
- キーペアの公開鍵(
id_rsa.pub
)の中身をコピーし、GitHubのフォームに貼り付けます。 - 鍵にタイトルを付けて「Add SSH key」をクリックします。
これで、GitHubに公開鍵が追加されました。
- SSH接続のテスト: 接続が正しく設定されているかどうかを確認するために、以下のコマンドを使用してSSH接続をテストします。
$ ssh -T [email protected]
接続が正常に確立されると、メッセージ「Hi username! You've successfully authenticated...」が表示されます。
トラブルシューティング:
-
エラー: "Permission denied (publickey)"
- 問題: SSH接続が失敗しました。公開鍵が正しく設定されていない可能性があります。
- 解決策: 公開鍵がGitHubに正しく追加されていることを確認してください。また、秘密鍵(
id_rsa
)が正しい場所に保存されていることを確認してください。
-
エラー: "Agent admitted failure to sign"
- 問題: SSHエージェントが正しく設定されていない可能性があります。
- 解決策: SSHエージェントを起動し、秘密鍵を追加します。以下のコマンドを使用します。
$ eval "$(ssh-agent -s)" $ ssh-add ~/.ssh/id_rsa
-
エラー: "Host key verification failed"
- 問題: GitHubのホストキーが変更された可能性があります。
- 解決策: 以下のコマンドを使用して、既知のホストキーを削除します。
$ ssh-keygen -R github.com
以上がGitHub SSHのセットアップ方法とトラブルシューティングに関する詳細な説明です。これらの手順とコード例を含めたブログ投稿を作成することができます。