GitHubとSourcetreeで開発環境を構築する

PC

はじめに

PCを新調したので、改めて職場と同じ環境を構築する際の手順を記載する。
GitHubアカウントとSourcetreeを紐づけてSSH接続でアクセス出来るようにするところまでをゴールとする。

前提

  • GitHubアカウントを持っている。
  • Sourcetreeをインストール済み。
  • 作業OSはWindows。

作業の流れ

  1. SSH秘密鍵・公開鍵作成
  2. GitHubにSSH公開鍵登録
  3. SourcetreeにGitHubアカウント連携
  4. SourcetreeにSSH秘密鍵登録

SSH秘密鍵・公開鍵作成

コマンドプロンプトorPowerShellを起動して以下コマンドを実行する。

下記の様に聞かれるが、何も入力せずにEnterをクリック
(作成オプションはデフォルト、パスフレーズ無し)

下記の様に表示され、「C:\Users\{Windowsユーザー名}\.ssh」フォルダにid_rsaid_rsa.pubファイルが作成されていれば完了。

id_rsaファイルが秘密鍵、id_rsa.pubが公開鍵です。
秘密鍵はローカルに保存し、公開しないように気を付けること。

参考:SSHは公開鍵・秘密鍵を使って楽にする

GitHubにSSH公開鍵登録

GitHubにログインし、画面右上のユーザーアイコンクリック>Settingsをクリックする。

左メニューのSSH and GPG keysをクリック>Nes SSH keyをクリックする。

Titleに適当な名前、Keyに先ほど作成したid_rsa.pubの中身をコピーして貼り付けてAdd SSH keyをクリックする。

下記の様にSSHキーが作成されていれば設定完了。

SourcetreeにGitHubアカウント連携

Sourcetreeを下記からダウンロードしてインストールする。
https://www.sourcetreeapp.com/

インストールが完了したらSourcetreeを起動する。

上部メニューのツール>オプションをクリックする。

認証タブを開き、追加をクリックする。

  1. Host>ホスティングサービスでGitHubを選択。
  2. 優先するプロトコルでSSHを選択。
  3. Credentials>認証でOAuthを選択。
  4. Credentials>OAuthトークンを再読み込みをクリックする。
  5. OKをクリックする。

設定したGitHubアカウントが追加されていれば連携完了。

SourcetreeにSSH秘密鍵登録

上部メニューのツール>オプションをクリックする。

全般タブを開き、SSHクライアントの設定>SSHキーに先ほど作成したid_rsaファイルのパスを指定する。(手順通りであれば「C:\Users\{Windowsユーザー名}\.ssh\id_rsa」となるはず。)
SSHクライアントでOpenSSHを指定する。
設定したらOKをクリックする。

タブでGitHubアカウントのリモートリポジトリをクローンし、SSH接続でアクセス出来るか確認する。
クローンが作成されれば環境構築完了。

GitHubアカウントにリポジトリがない場合は作成してください。

【おまけ】リポジトリの作成方法

GiHub側で作成、ターミナルで作成、Sourcetreeから作成等方法は沢山ありますが、今回はSourcetreeから作成する。

NewTab>Createを表示してリポジトリを作成する。

指定したパスに空のリポジトリが作成される。
(今回の例では「D:\Repos\TestRepository」が作成される。)

上部メニューのリモートをクリックする。

GitHubアカウントページが表示され、作成したリポジトリのダッシュボードが表示されればリポジトリの作成完了。

まとめ

以上、GitHubとSourcetreeで開発環境を構築する手順でした。

PC開発
凡人プログラマーのブログ

コメント