はじめに

※この記事は現在Railsチュートリアルに取り組んでいる方向けの記事です。

先日、生徒さんから

「RailsチュートリアルのBitbucketの設定でつまづいてしまいました。。。」

と質問されました。

無事に解決できたのですが、せっかくなのでその解決方法をまとめようと思い、記事にすることにしました。

生徒さんからいただいた質問の内容

======
【ご質問】
@ウェブ系ウシジマくん

RailsチュートリアルのBitbucketの設定でつまづいてしまいましたので、アドバイスを頂戴したく。

◯つまづいた箇所
Bitbucketへのリポジトリ追加とプッシュができない

◯エラーログ


ec2-user:~/environment (master) $ cd hello_app
ec2-user:~/environment/hello_app (master) $ git remote add origin git@bitbucket.org:ec2-user/hello_app.git
fatal: remote origin already exists.
ec2-user:~/environment/hello_app (master) $ git remote rm origin
ec2-user:~/environment/hello_app (master) $ git remote add origin git@bitbucket.org:ec2-user/hello_app.git
ec2-user:~/environment/hello_app (master) $ git push -u origin master
Permission denied (publickey).
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.

◯試したこと
・一旦rmで消去して、もう一度同じ手順でプッシュしてみる
・ユーザー名が違うかと思い、確認したが合っている
・ git push -u origin --all とコマンド入力してみる

◯参考にしたURL
http://pyoonn.hatenablog.com/entry/2014/10/29/191744
https://qiita.com/katsukii/items/c3df0653ac07d41fe03f

以上です。よろしくお願いいたします

=======

なにかわからないことがあったときに、このような形で質問されると、答える側も回答しやすいですね。

闇雲に、

「なんかエラーがでました。。」

と言われても、原因を究明するのに時間がかかってしまいますし。

まずは現在がリモートリポジトリにどんなURLが登録されているかを確認

Permission denied (publickey). となる場合、大抵はSSH接続が正しくできていないことが多いですね。

とりあえずは、一旦以下のコマンドを入力して、まずは、現在のリモートリポジトリの状況を確認してましょう。

$ git remote -v

すると、以下のような表示がされると思います。

$ git remote -v
origin  git@bitbucket.org:ec2-user/hello_app.git (fetch)
origin  git@bitbucket.org:ec2-user/hello_app.git (push)

ここからわかることは、とりあえずリモートリポジトリにはちゃんとURLが登録されていて、存在しているということです。

エラーの原因は公開鍵と秘密鍵に不整合が起きているため

SSH接続は鍵という概念があって、公開鍵である id_rsa.pub を登録すると、pushする際に自分だけローカルに持っている秘密鍵と照合し、それぞれのユーザーを認識するような仕組みをとっています。

今回生徒さんからご質問いただいたエラーは、その公開用の鍵と秘密鍵の整合性があっていないのが原因ですね。

sshディレクトリ配下のファイルを確認してみる

エラーの原因がわかったところで、解消に向けてコマンドを叩いていきましょう。

まずはターミナルで次のコマンドを実行します。

$ ls ~/.ssh

実行結果を確認してみてください。もし、表示が

authorized_keys  known_hosts

とだけになっていたら、あなたはまだ公開鍵と秘密鍵を作成していないことになります。

ということで、次のコマンドを使って、それぞれの鍵を作成しましょう。

$ ssh-keygen -t rsa -C "hoge@example.com"

すると、いろいろと聞かれるので、必要事項を入力します。

ec2-user:~/environment $ ssh-keygen -t rsa -C "hoge@example.com"
Generating public/private rsa key pair.
Enter file in which to save the key (/home/ec2-user/.ssh/id_rsa): hoge
Enter passphrase (empty for no passphrase): 
Enter same passphrase again:
Your identification has been saved in hoge.
Your public key has been saved in hoge.pub.
The key fingerprint is:
SHA256:/Wm/wQl1So7ugK1dPmbLwg3Bjg+hbr/knnhW+2Q6f3E hoge@example.com
The key's randomart image is:
+---[RSA 2048]----+
|                 |
|                 |
|         .    o .|
|        ..o  = o |
|       .S+..o o  |
|      . oo+o +..E|
|     .  o=o+O +o |
|      o+o+*@=... |
|     ..=B.oBB+o. |
+----[SHA256]-----+

項目	意味
Enter file in which to save the key	公開鍵のファイル名を入力。そのままEnterを押すと、`id_rsa` という名前になる。(すでにあった場合は、上書きしていいかと聞かれる)
Enter passphrase (empty for no passphrase)	秘密鍵用のパスワード。そのままEnterを押すと、パスワードなしになる。
Enter same passphrase again	確認用なので秘密鍵用のパスワードを再入力

無事に作成できたら、下記のコマンドを実行しましょう。

$ cat ~/.ssh/id_rsa.pub

すると、次のような暗号化された文字列が返ってきます。

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDGIpyz/3d8VYW8lKsx46wQ4VmnnT318h867KemwKnfBknfRi9Xq9nFLexoLNJTdgFNlzUkls90UshG6C2QOZpEVgBCpeE9xhde3hnahFPoR8RltwrsyzX8CHrItK2ZmUOsrQjC/Sy4ZTEUZeLDK472FeuBElJ3ukPOG1hDeVaDS3bYJyKy1T+MSOX7tXfwcyQNDHzko+5luJWEVkciV1aoJ3vflAm3XKdrZ1q/eY+7wf8yThD6a1jWtqsPfP/2WZ3fbmBW7CX8XVzSDbO3DFmorZuwpXFGXOqd8nGFtZnbL3jOxuRsBosgkaTnD2/5ZjaPpZ7dO78XO1gziv2JXxGr hoge@example.com

これをコピーして、Bitbucketに登録します。

Bitbucketに公開鍵を登録

Bitbucketにログインしたあと、以下のGif画像の手順にしたがって、SSH鍵を登録するページまで遷移してください。

先程コピーした公開鍵を Key の部分にはりつけてましょう。

label はわかりやすい名前であればなんでもOKです。

pushしてみる

それでは、もう一度、pushしてみましょう！

$ git push -u origin master

エラーが発生せずにpushできたら完璧です！

お疲れ様でした！