WSL2 Ubuntu環境にSourceTreeを導入してAWS CodeCommitを使ってみた

はじめに

• ローカル環境(WSL)で管理しているソースをSourceTreeで管理する手順を整理しました
• リモートリポジトリはAWS CodeCommitになります

動作環境・前提条件

• OS

  • Windows 11 23H2

• WSL

  • VERSION 2
  • Ubuntu 24.04.1 LTS

• その他

  • AWSアカウントが発行済であること
  • VSCodeがインストール済であること
  • AWS CodeCommitの認証情報に使用するIAMユーザに適切な権限が割り当てられていること

環境構築手順

1. SourceTree導入

1-1. SourceTree for windowsダウンロード

• 下記のサイトからダウンロード
• https://www.sourcetreeapp.com/

2-1. セットアップ

• スキップ
  

• Mercurial未選択
  
  

• Author、メールアドレスは任意
  

• SSHキーを読み込みますか？→いいえ
  

2. AWS CodeCommitリポジトリ作成

2-1. CodeCommitリポジトリを作成

• リポジトリ名、説明は任意
  
  

2-2. URLクローン(HTTPS)を控える

• URLのクローン＞HTTPSのクローンを押下

3. AWS CodeCommit の HTTPS Git 認証情報

3-1. CodeCommit認証に使用するIAMユーザのGit認証情報を生成

• IAM>git認証で使用するIAMユーザ>セキュリティ認証情報>AWS CodeCommit の HTTPS Git 認証情報
  
  

3-2. 認証クレデンシャルを控える

• 認証情報をダウンロード

4. SourceTreeを使ってソースをクローンする

4-1. SourceTreeにGit認証情報を入力

• New tab>Clone>元パス/URL

  • 2-2.で控えたURLを記載(入力後はカーソルを下の行にずらす)
    

  • CredentialHelperSelector(ポップアップで表示)

    • managerを選択

  • git Credential Manager(ポップアップで表示)

    • 3.2で控えた認証情報を記載

      • 余談ですが、認証に使用するIAMユーザに対してMFA必須のポリシー等を割り当てたりしていると、認証に失敗します(考えてみれば当たり前ですが…)
        

    • リポジトリタイプが「これはGitリポジトリです」と表示されていればOK

  • 保存先のパス

    • wslで管理しているォルダ群はwindowsエクスプローラーからでも確認可能
      • エクスプローラで \wsl$ と入力
        • 保存先のパスを指定

  • クローンを押下

  • 以下のエラーが表示されます
    

4-2. WSL使用時に発生するエラーの解消

• SourceTreeのターミナルからgitを開く

• 下記のコマンドを入力（全ディレクトリ許可の場合）

  
   git config --global --add safe.directory '*'
  
  

• 変更が反映されたか確認

  • windeowsエクスプローラー>C:\Users<user>.gitconfigの内容が下記であること

    
    [safe]
    directory = *
    
    

    • 以上で設定は完了です！
    • SourceTreeのクローンをクリックするとソースがクローンできます

参考資料

https://zenn.dev/na9/articles/07077a4ef54187#sourcetree%E3%82%92wsl%E3%81%A7%E5%88%A9%E7%94%A8%E3%81%99%E3%82%8B%E9%9A%9B%E3%81%AE%E3%82%A8%E3%83%A9%E3%83%BC%E3%81%AE%E8%A7%A3%E6%B6%88

https://tech.willserver.asia/2021/11/29/%E3%80%90aws%E3%80%91aws-codecommit%E3%82%92sourcetree%E3%81%A7%E4%BD%BF%E3%81%88%E3%82%8B%E3%82%88%E3%81%86%E3%81%AB%E3%81%99%E3%82%8Bwindows/#toc5

おわりに・まとめ

• 前回に引き続き環境構築系の記事なりました
• 元々手元に手順をメモしているので、記事に起こすまでがスムーズで書きやすかったです