久しぶりにGithubを使おうとして躓いたのでメモ

背景

数年前にGithubに登録したもののしばらく使用しておらず、久しぶりに使おうとして躓いたので今さらながら備忘録として残します。

Git、Githubとは

Gitはバージョン管理を行うためのツールであり、GithubはGitを利用した、リモートリポジトリを提供しているwebサービスです。

詳細は省略します。

Githubに登録する

以下のサイトからGithubに登録します。
登録済みの場合はログインします。

https://github.com/

秘密鍵、公開鍵を作成する

ローカルからGithubに接続するためには、Githubに自分の公開鍵を設定し、対となる秘密鍵はローカル環境に保持します。

鍵を保持するディレクトリに移動します。

$ cd ~/.ssh

鍵を作成します。

$ $ssh-keygen -t rsa
Generating public/private rsa key pair.
Enter file in which to save the key (/Users/(username)/.ssh/id_rsa):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:

何か聞かれたら、そのままEnterキーを3回押せばOKです。
これで、id_rsa(秘密鍵)、id_rsa.pub(公開鍵)が作成されます。
2行目、3行目はパスフレーズの設定ですが、ここでは未入力でOKです。

別の名前で作成したい場合は、1行目でキー名を指定します。
(ここでは「id_rda_git」を指定)

$ $ssh-keygen -t rsa
Generating public/private rsa key pair.
Enter file in which to save the key (/Users/(username)/.ssh/id_rsa): id_rsa_git
Enter passphrase (empty for no passphrase):
Enter same passphrase again:

Githubに公開鍵を追加する

Githubにログイン後、右上のプロフィールのプルダウンから「Settings」を選択します。
表示されたページの左側のメニューから「SSH And GPG Keys」を選択し、「New SSH Key」をクリックします。
f:id:attsun55:20200229142107p:plain

「title」に公開鍵名(任意の名称)、「key」に公開鍵(id_rsa.pubまたは自分が作成したもの)の中身を入れます。

接続を確認する

ターミナルで以下のように入力します。

$ ssh -T git@github.com

以下のように返ってきたら接続成功です。
Hi (account名)! You've successfully authenticated, but GitHub does not provide shell access.

このとき、鍵の名前を指定している場合は接続に失敗します。
その場合は、~/.ssh/configを作成し、以下のように記載します。

Host github github.com
  HostName github.com
  IdentityFile ~/.ssh/id_rsa_git ← 指定した鍵の名前
  User git

もう一度接続するとうまくいくはずです。

$ ssh -T github

これで、Githubへプッシュしたり、Githubからクローンを作成することができます。