クローン

このトピックで学ぶ「クローン」について、MacとWindowsで大きく操作方法が異なります。Windowsユーザーの方は「Windowsでの操作手順」のタブから、操作手順をご確認ください。動画および「書き起こし」タブの内容はMacでの操作手順となっております。

要約書き起こし Windowsでの操作手順

リポジトリ
- https://github.com/megane9988/mgnknowledge-learn-git
SourceTreeはGitHubのアカウントを登録することが可能
アカウントに紐付いたリポジトリは一覧され、ワンクリックでクローンできる
その際に秘密鍵を作成
- クリップボードにコピー
GitHubに登録を行う
- Setting → SSH and GPG keys
know_hostsの作成
- 一度CUIにてGitHubからCloneし、known_hostsファイルを作成しておく

$ git clone

ホームディレクトリの.sshフォルダ内に4つのファイルが追加されている
- config
  - SSH接続のための情報
- known_hosts
  - フィンガープリント
- {ユーザー名}-GitHub
  - 秘密鍵
- {ユーザー名}-GitHub.pub
  - 公開鍵

リモートリポジトリからローカルリポジトリへファイルをダウンロードするクローンを行います。画面を共有します。

はい、というわけで、今フォークしましたリポジトリがここにあります。megane9988のリポジトリからmeganein9988のリポジトリへフォークした状態ですね。

こちらは皆さんの名前のアカウントになっていると思います。この状態で、このリポジトリをそのままローカルの方にダウンロードしてくる、このクローンという作業を行います。

ちょっとここですね、秘密鍵の設定とか色々と大変なんで、順番に作業を行っていきましょう。

SourceTree から GitHub のアカウントを連携する

まずはSourceTreeをもとに作業を行います。SourceTreeを開いたら、ひとまず、もし何かしらウインドウが開いてるとしたら、こちらは閉じていただいて、このブックマークウィンドウを表示してください。

その中の、この右側の、この歯車マーク、歯車マークの中をクリックしてアカウントをクリックしてください。ここですね。はい、アカウントです。もしくはSourceTreeの環境設定の中からもアカウントへと到達できます。

今は、一番最初にこのアプリケーションを立ち上げる時に登録した bitbucket のアカウントが一つ入ってる状況かと思います。ここに「まずは GitHub と連携してアカウントを登録する」という事から行います。

追加のボタンをクリックします。追加ですね。追加をクリックして、そしてここのホストの部分を GitHub にします。 GitHub。認証（タイプ）は OAuth のままで結構です。そしてプロトコルは SSH のままにしておいてくださいね。アカウントの接続をクリックします。すると、ブラウザが立ち上がり、このように「Authorize SourcetreeForMac」という形で「SourceTreeとMacをつなげますよ」という風に書かれます。なのでここでクリックを押しましょう。はい、これで「もう一度SourceTreeを開きますよ」という風に言われますので、これでひとまず接続がされました。

公開鍵を作成する

はい。ここで、昔はですね、これで終わりだったんですけども、今現在…、今は2020年の12月なんですけども、この状態ではですね、Read only となってまして、プルとか、そのリポジトリを参照するとこまではできるんですが、それに対するプッシュができない状態になってますので、ここで一手間加えたいと思います。

SSHキーの作成

まずはプロトコル：SSH ということで、公開鍵を、このGitHubとの接続のために作ります。「キーを生成」をクリックします。はい。「キーを生成」をクリックして、ここで公開鍵というのを作りますね。今回ここはパスフレーズは無しで作ります。ここでパスフレーズが必要かどうかっていうのは、よりセキュリティを高めるかどうかっていう事なんですけども、その辺りはご自身にお任せします。今回、私の方では、ひとまず無しでやりたいと思います。で、「SourceTreeに SSH の設定の変更を許可をします」って言うことのチェックするのを確認して、作成を押します。はい、そしたらここにですね「meganein9988-Github.pub」っていう鍵ができたよっていうのができて「クリップボードにコピー」というのが出てきます。こちらも何のことやらさっぱり分からないと思うんですが、1回コピーしてください。コピーしましょう。これ（クリップボードにコピー）クリックしといてくださいね。そして保存をクリックします。

はい、そうするとこのように OAuth で SSH で接続ができました。ここまでアカウントが表示されれば OK です。一旦バツを押して戻ってきて、ここのリモートのタブの方に来ると、ここに GitHub という新しいタブですね、出来上がって、これまでの、今、自分で管理のあるリポジトリが一覧されます。

今はmeganein9988のアカウントでは、先ほどフォークした「mgnknowledge-learn-git」のものだけがありますので、これが一つだけ表示されています。で、このクローンを押すと、これでダウンロードできるはずなんです…が、ここがぐるぐるぐるぐる回ってずっとできないんですね。えーと、ちょっと私のやり方が間違ってるのかもしれませんが、現状、出来なかったので、これを、できる手法を発見しました。

GitHub にSSHキーを登録する

まずはここの、SourceTreeのこの URL をコピーします。あ…いや、やめよう。ちょっと待ってくださいね。そうじゃなくて、今せっかくコピーしましたから、今コピーしたのを、何かって言うと、鍵の内容をコピーしましたね。貼り付けるとこんなやつ。クリップボードにコピーって…、まずこの鍵を登録します。はい、鍵を登録します。この鍵の文字列を GitHub 上に登録します。はい。

で、 GitHub に行きます。GitHub に行ったら、ここの自分のマークのプロファイルの中の Settings。はい、Settings に来たら、ここのアプリケーションをクリックして…あ、じゃないや、 SSH & GPG Keys ですね、ここをクリックします。はい。ごめんなさいね、色々間違いで。ここに「New SSH key」なりますのでクリックしましょう。はい、そしたら、ここ（Key）に、ぴっと貼り付けます。貼り付けました。これがね、鍵の、公開鍵の内容ですね。これ（Title）はSourceTreeとかってしときましょうか。ここ、何でもいいんですけども、分かりやすいようにしときましょう。SourceTree用の鍵ですよって形で、この名前を決めて、先ほどのを貼り付けたらAdd SSH keyという風にしときます。

これで公開鍵、秘密鍵による SSH のログイン用の認証みたいなことが、 SSH 接続と言いまして、サーバーと接続する際に、こっちに持ってる鍵と向こうに登録した鍵が合うと、ちゃんとログインできますよって仕組みが SSH 接続ではよく使われるんですけども、その登録が必ず必要になります。これをまず行いました、というとこですね。まずここ大事。鍵を登録します。

known_hostsファイルを生成する

鍵を登録したら、今度はここのですね、自分のリポジトリ…プロファイルの中の、自分のフォークした方のリポジトリですね、自分のリポジトリのこの「Code」の中から、今ね、おそらくみなさんは最初 HTTPS になってると思うんで、ここ SSH をクリックします。はい。で、これをコピーします。これ。これね。コピーですね。これをコピーしておきます。

git@github.com:ユーザーアカウント/mgnknowledge-learn-git.git

このコピーの、この URL っていうのは、ここをクローンした時のここと同じはずです。ここね、この github meganein…なにがし某っていうので、ここも同じですね。GitHubの…なにがし某、という感じになってます。

一旦、CUIからクローンする

これをコピーしたら、今度は CUI 、私の場合は iTerm2 ですけども、 CUI ツールを開けます。アップデートが来てますけども、一旦今は、後で教えてね、としておきましょうか。で、ここで SSH とコマンド打っていただいて、 SSH…、あ、違うな…ごめんなさいね、あ、これでいいか。こうするとどうなる？駄目って言われるか、そうか。じゃあ git クローン、これ（先ほどコピーしたもの）、ていう風にします。もう一回やりましょうか。デスクトップとかに行って頂いた方がいいですね。

cd で、デスクトップに行って頂いて、とクローンでこれ貼り付けます。

cd Desktop
git clone git@github.com:ユーザーアカウント/mgnknowledge-learn-git.git

そうすると、今これ何がどうなったかって言いますと、コマンドラインで Git を操作したんです。で、git clone っていうことは、「この Git の向こう側からクローンして、ファイルを今、デスクトップ側にコピーしてくださいね」っていう事をしました。

そうすると、初めてこの時に鍵認証による SSH 接続が実施され、その時に必ず一番最初だけ「fingerprint」と言って、Unknown…いや、「known_hosts」ってファイルが生成されるんです。何のことやらわからないでしょ（笑）分かんないなりに良いんで、やってください。

大丈夫ですかって聞かれてます。「これを追加しますか」っていうことで、本当に接続するって聞かれてるので、そこは yes か no なので、フィンガープリント本当に作りますか？で、yes で Enter を押します。すると、これで繋がって、今 done となりました。これは、もう既にクローン成功してます。

open .

はい。オープンにすると、ここですね。「mgnknowledge-learn-git」はデスクトップに今クローンしたので、デスクトップにその内容が来ていてダウンロードできています。

で、これでいいんですけども、うんと、ちょっと意味がわからないと思うので、一旦これは無視しましょう。一旦削除していただいても結構です。もしルートディレクトリでやっちゃった場合には…あ、ホームディレクトリですね。画面立ち上がってどこでやった場合には、ホームディレクトリにその内容があるはずなので、それを一旦削除します。

今、何がしたかったかと言うと、このホームディレクトリにおいて、「.ssh」というフォルダが新たに出来ているのが分かります。そして、この中に、今ですね、合計四つのファイルが増えています。一つは config、そして known_hosts、そして meganein9988-Github と meganein9988-Github.pub っていうのがありますね。この下の二つが秘密鍵と公開鍵と呼ばれるものです。

で、秘密鍵の方が拡張子がない方で、.pub ってなってんのが公開鍵の方です。公開鍵の内容が、今、コピーされたもので…、う～ん、ややこしい～！でも、こういうものですから一旦覚えときましょ。この中身がさっきコピーしたやつですね。「クリップボードにコピーする」って言ってやったものがこれです。 GitHub 上に貼り付けたものがこれです。それと、それに伴ってもう一個あるのが、この meganein9988-Github 秘密鍵と呼ばれるものですね。

で、実際に接続する時には、接続情報をもとに接続しに行きます。そしたら向こう側に公開鍵というもの、これ（meganein9988-Github.pub）が登録されています。そして自分の中には秘密鍵があります。この二つの鍵が合うから接続できます。接続できるからこそ GitHub から Git のファイルをダウンロードできる、クローンできるという流れになります。

で、その時に1度目の接続の際にこの「fingerprint」と呼ばれる known_hosts というファイルが出来上がります。

どうやら、この生成が SourceTree だけではできないらしいんです。で、一度、この iTerm2 を使って接続を行いました。更に、この config というファイルには、この meganein9988-Github という風に書いてありますけども、要は SSH での接続する時の、接続情報が書かれています。これは SSH接続の時に、configファイルの中に書いていると簡単に SSH による接続ができる、というものなんですけども、ここも、話がややこしくなりますので、一旦は、もう、このまま「こういうものだ」という風に覚えておいてください。はい。で、ここまでの設定が終わりました。ご苦労様でした。ここね、凄く大変でした。私も悩みました。

SourceTree に戻ってクローンする

そして、これで、この状態でクローンを押すと、今度は、ここほら、ここは「これは git リポジトリです」って、今までずっとぐるぐるぐるぐるしてたのがちゃんと git のリポジトリとして認識されます。これでやっと準備が整ったということになります。

クローンする場所を指定して、クローンする

そうしましたら、これをダウンロードしたいので、クローンにしたいので、これをですね、フォルダとして、好きなとこで結構です。私はデスクトップにしますけども、新規フォルダとして、ここですねにしますが、別に「書類」の中に作っていただけでも結構ですし、また別のとこに作っていただくでも結構です。ここにダウンロードされる、クローンされるということになりまして、必ず空のフォルダーにしておきましょう。中にファイルが入ってるとややこしくなりますので、空のフォルダをどこかに作って頂いて、その中にクローンを実施してください。

はい、これでやっと、この元々の GitHub から保存するのは、デスクトップの、ローカルリポジトリーとして設定する「/Desktop/mgnknowledge-learn-git」というところで、名前を「mgnknowledge-learn-git」ということでクローンしますよ、ということになります。「高度なオプション」の中の一応ありますけども、もうそのまま、何もしなくても大丈夫です。クローンをクリックします。そうするとここにインジケーターが進みだして、ほどなく画面がぴょっと開くということになります。…ここまで来たら大成功です。皆さんも上手く出来るといいんですが、どうでしょうか。これ大変。ここね、多分ね、ひょっとしたら一番難しいかもしれませんので、頑張って下さい。

そして、ひょっとすると、ずっとこの、初めて外部のサービス GitHub を使いましたし、外部のサービスへの SSH の接続を行ったりもしましたから、もしかすると GitHub の仕様によって、このやり方で接続ができなくなる事もあるかもしれませんし、もっと言うとSourceTreeがバージョンアップされた結果、もっと簡単にクローンできるようになるかもしれません。

で、なるべく都度都度アップデートして行こうと思いますが、現時点においては、この方法が、どうやら正しかったと思いますので、こちらの方法を一手一手、作業していただければと思います。

そして、やっと終わって何が来たかと言うと、これですね。はい。先ほどまでに、これは GitHub 上でコミットされていたものがどんどんと並んでいます。なので、私がコミットしたものが皆さんのローカルのリポジトリにも降りてきているはずです。こんな感じ。

はい。で、更にデスクトップの中身を見てみると、今、デスクトップにクローンしましたからね、ここにファイルがあって、この中身を見てみるとこんな感じ。 README.md があって README.md とは別に people っていうフォルダがあって、people というフォルダの中にmegane9988.md というものがあります。

これからですね、プルリクエストをやって頂くんですけども、ここにご自身の名前のフォルダを作って、ご自身の名前のファイルを作って頂いて、それをコミットし、プルリクエストして頂くという作業を行っていただく予定です。

長くなりましたけども、えーと、クローンのところでした。難しかったかもしれません。頑張ってみてください。なるべくテキストでもサポートするように致します。