[開発環境構築]ゼロからgit cloneするまで(ssh鍵を別名で作成)

スポンサーリンク

「git clone やり方」とかで検索すると、

git clone [クローンしたいリポジトリ名]

でOK!みたいな記事が出てくるかと思いますが、その後pushしたりすることを考えると、これだけでは不十分です。

gitの準備も含めてゼロからSSHでクローンしてくる手順を丁寧に残しておきます。



前提

使用しているパソコン:

macOS Catalina 10.15.7

プロセッサ 2.3 GHz クアッドコアIntel Core i7

WindowsやLinuxを使用している方は、適宜読み替えてください。

0.ディレクトリ作成・ターミナル立ち上げ

ここから説明するかという感じですが、初心者の方を対象としているので一応。

  1. Finderを開いて、ローカルリポジトリを作成しても良いディレクトリを作成しておきます。
  2. Terminal.appを開いて、cdで上記ディレクトリに移動しておきます。

これで準備完了!

「cdで上記ディレクトリに移動しておく」が何を意味しているかわからない方は、Linux(というかCUI)の超基本だけでも押さえておく必要があります。こちらの記事をお読みください。

1.Gitの設定

gitがインストールされていることが前提で進めようと思ったのですが、全く初めての場合も想定し、まず、gitがインストールされているかどうか確認します。

Terminal.appで、

git --version

とコマンドを叩いてみてくだい。

git version 2.24.3 (Apple Git-128)

のように、gitのバージョンが表示されたら、既にインストールされているので問題ありません。

zsh: command not found: git

みたいに、「gitなんてコマンド見つからないよ〜」と言われたら、gitがインストールされていません。

その場合、gitのインストールが必要です。

下記からインストールできます。

Gitのインストール

1-1. 名前とメールアドレスの設定

gitがインストール済みの状態で、下記コマンドを叩きます。

git config --global user.name [登録名(何でもよいです)]
git config --global user.email [メールアドレス(こちらも何でも良いです)]

慣れてる方は言わずもがなと思いますが、”[“や”]”は不要です。

今何が登録されているか?はそれぞれ下記コマンドでわかります。

git config --global user.name
git config --global user.email

ここで登録したuser.nameを後で使います。

git の設定としてはこれで以上です。

2.SSH鍵の作成

こちらは、GitHubアカウントひとつに対して、1組作成すれば十分です。2つ目のプロジェクト以降は、3-4の確認だけしてOKならOKです。

2-1. ssh鍵が保存されているディレクトリへ移動

下記コマンドを叩いて、.sshディレクトリへ移動します。

cd ~/.ssh

2-2. 名前を指定してssh鍵を作成

今回はgithub_rsaという名前で保存します。別の名前をつけたい方は以後、github_rsaの部分を適宜読み替えてください。

下記コマンドを叩きます。

ssh-keygen -t rsa -f github_rsa

パスワードは、設定しなくても作成できます。その場合は、何も押さずにエンターを押せばOKです。

その後、lsしてみると、github_rsa(秘密鍵)とgithub_rsa.pub(公開鍵)が作成されていることが確認できます。

2-3. ssh/configを編集して、ssh接続設定

vi ~/.ssh/config

などを叩いて、configファイルの中に下記追記します。

Host github.com
  IdentityFile ~/.ssh/github_rsa
  User [最初に1章で登録したuser.name]

保存して閉じます。

3.SSH鍵をGitHubに登録

3-1. SSH公開鍵をコピー

下記コマンドでSSH公開鍵をコピーできます。

cat ~/.ssh/github_rsa.pub | pbcopy

3-2. GitHubにログイン

クローンしたいGitHubのリモートリポジトリへログインします。

3-3. GitHubにSSH公開鍵を登録

右上の自分のアイコンから設定(settings)を選び、SSH公開鍵を登録します。

外部サイトですが、こちらを参考に、どうぞ。

GitHubでssh接続する手順~公開鍵・秘密鍵の生成から~

(3-4. 確認)

公開鍵が登録できたら、SSH接続ができるようになったのか、確認しましょう。

再度、自分のローカルで下記コマンドを叩きます。

ssh -T git@github.com

こんな感じで、successfully authenticatedと出てきたらOKです。

$ ssh -T git@github.com
Hi [最初に1章で登録したuser.name]! You've successfully authenticated, but GitHub does not provide shell access.

うまくいかない場合は、下記コマンドでより詳細なログが表示されます。

ssh -vT git@github.com

4.いよいよクローン

4-1 クローンしたいリポジトリに戻る

これ忘れないように!

下記コマンドを叩いて、最初にgitを登録した、ローカルリポジトリを作成したいディレクトリ内に戻ります。

cd -

4-2. クローンする

ようやく、下記コマンドを叩いて、クローンします。

git clone -b develop git@github.com:[クローンしたいレポジトリ名]

だいたい、まずはdevelopブランチに持ってくることが多いので、オプションで指定しています。

クローン完了!

参考文献

git cloneで環境構築!リポジトリをクローンしよう | 侍エンジニアブログ
この記事では「 git cloneで環境構築!リポジトリをクローンしよう 」について、誰でも理解できるように解説します。この記事を読めば、あなたの悩みが解決するだけじゃなく、新たな気付きも発見できることでしょう。お悩みの方はぜひご一読ください。

SSH接続

GitHubでssh接続する手順~公開鍵・秘密鍵の生成から~ - Qiita
GitHubにssh接続するために鍵の登録が必要になります。その手順をまとめてみます。はじめての人は手順通りに進めれば接続出来ます。久しぶりにやってうまくいかないという人の解決の糸口になるよう…

configの書き方

GitHub 接続時の ~/.ssh/config の書き方
git clone 時に秘密鍵を指定する - Qiita
git の支援が弱くて変なやり方しかない。=> GIT_SSH_COMMAND または git -c core.sshCommand が使えます。.ssh/config をいじる.ssh/co…

接続確認

githubからsshでクローンする。sshでpushする - Qiita
前提sshキーが既にある状態。sshのパスフレーズを把握していること。※sshキーの作り方は参考にした記事へ手順①githubの設定を開く…
はるすと
はるすと

最後まで読んでくださってありがとうございました!

この記事を書いた人
こもれびエンジニア

自然と自由を愛するエンジニア。2021年1月に、大手製造業設計からプログラマ(Rails, AWS)へ転職。動物や自然との触れ合いや、汗を流すのが好き。

/HSP(繊細さん)/18デリケートな象/ストレングスファインダー(1分析思考/2親密性/3学習欲/4調和性/5収集心)、テニス、合気道、登山、あいだみつを、ジブリ、ワンピース、ドラゴンボール、AWS、Ruby on Rails、アイミング

twitterをフォローして、記事にならないちょっとした豆知識もチェック!
環境構築・OS(特にLinux)
スポンサーリンク
SNSでシェア/コメントして、自分のアウトプット/発信力を高めるのにお使いください。 ↓ 各ページへジャンプ ↓
twitterをフォローして、記事にならないちょっとした豆知識もチェック!
スポンサーリンク
「そんなか」サイト

コメント

タイトルとURLをコピーしました