SourceTree セットアップガイド#

このガイドでは、GUI ツールである SourceTree を使用して TechHive Academy の Gitea リポジトリを管理する手順を説明します。

[!NOTE] ターミナルでの操作を希望される方は Git セットアップガイド (CLI) を参照してください。

1. SourceTree のインストール#

SourceTree 公式サイト からインストーラーをダウンロードし、インストールを完了させてください。

2. SSH キーの準備#

SourceTree で SSH を利用する場合、事前に SSH キーを作成して Gitea に登録しておく必要があります。手順は CLI 版ガイドの SSH キーの生成と登録 を参照してください。

3. SourceTree への SSH キー登録 (macOS)#

1. SourceTree の設定を開く メニューバーの SourceTree > Settings (または Preferences) を開きます。
2. アカウント情報の確認 Accounts タブに Gitea サーバーが登録されている必要はありませんが、SSH キーが OS のキーチェーンに追加されていることを確認してください。
3. SSH キーの指定 通常、SourceTree は ~/.ssh/id_ed25519 や ~/.ssh/id_rsa を自動的に認識します。

4. リポジトリのクローン#

1. 新規リポジトリを追加 SourceTree のメイン画面で「新規...」をクリックし、「URL からクローン」を選択します。
2. ソース URL を入力 Gitea のプロジェクトページから取得した SSH URL（例: git@gitea.example.com:username/repo.git）を入力します。 ※ HTTPS URL を使用すると、macOS のキーチェーンの影響で認証エラーが発生しやすいため、SSH を強く推奨します。
3. 保存先の指定 ローカルの保存先パスを指定して「クローン」をクリックします。

5. 個別ユーザー設定 (マルチアカウント対応)#

SourceTree でリポジトリごとにユーザー名やメールアドレスを変更する手順です。

1. クローンしたリポジトリを SourceTree で開きます。
2. 画面右上の「設定」(リポジトリ設定) をクリックします。
3. 「高度な設定」または「詳細」タブにある「ユーザー情報」のチェックを外し、TechHive Academy 用のユーザー名とメールアドレスを入力します。

6. 基本的な操作方法#

• コミット: 「ファイルステータス」から変更したファイルを選択して「インデックスに追加」し、コメントを入力して「コミット」をクリックします。
• プッシュ: 画面上部の「プッシュ」ボタンをクリックし、対象のブランチ（通常は main）を選択して実行します。
• プル: 他の人の更新を取り込む場合は「プル」をクリックします。

7. トラブルシューティング#

• 「ソース URL が正しくありません」と表示される: SSH キーが Gitea に登録されているか再度確認してください。また、公開キーではなく秘密キー（.pub が付いていない方）が SourceTree の参照先にあるか確認してください。
• パスワードを何度も求められる: SSH エージェントにキーが登録されていない可能性があります。ターミナルで ssh-add -K ~/.ssh/id_ed25519 を実行してみてください。