こんにちは。イオンスマートテクノロジー株式会社（通称AST）でSREの林 aka もりはやです。
当社は各種コードのリポジトリの一つとしてAzure DevOpsのAzure Reposを活用しています。（他にGitHubもあります）
Azure ReposにはWeb上での編集や各種Commit・Blame・PRなど十分以上のコードの置き場としての機能があり便利に利用できています。ただし、後述する課題を感じて手元にcloneするモチベーションが湧き簡単な工夫をしたため紹介します。
TL;DR
こんなコマンドを使ってまとめてcloneするコマンドを生成しました。
# gitコマンド用
$ az repos list --org <Organization Name> --project <Project Name> | jq -r '.[] | select(.isDisabled == false) | .sshUrl' | sed -E 's/^/git clone /g'
# ghqコマンド用
$ az repos list --org <Organization Name> --project <Project Name> | jq -r '.[] | select(.isDisabled == false) | .sshUrl' | sed -E 's/^/ghq get /g'
これによって以下の様なコマンドのリストを作成できるため、あとは {} などのサブシェルで一気に流すも良し、一行ずつ丁寧に流すも良しです。
git clone git@ssh.dev.azure.com:v3/<Organization Name>/<Projcet Name>/<Repo Name A>
git clone git@ssh.dev.azure.com:v3/<Organization Name>/<Projcet Name>/<Repo Name B>
git clone git@ssh.dev.azure.com:v3/<Organization Name>/<Projcet Name>/<Repo Name C>
...
課題：検索機能が少々物足りない
リポジトリとして十分以上の機能を持つAzure Reposですが、特定キーワードでのコードの横断検索などを行う時に思い通りの結果を得られないことがありました。
具体的には以下のような記述へ辿り着くために Standard や Stan* で検索すればHitします。しかし Stan や tanda や *tanda* などの単語として意味をなさない文字列での検索ではHitしない状況でした。
# Standard Hoge Moge Project
echo "Standard and more"
日頃からVisual Studio Codeでの作業や、ターミナルの grep などで文字列検索に慣れている身としてはこの検索精度には物足りなさを感じていました。
対策:ローカルにまとめてcloneする
対策として、各Azure Reposからにローカルにcloneすることにしました。ブラウザのAzure Reposの画面から一つずつclone用のURLを取得して実行していくことも可能ですが、その数が多くなるとなかなかの手間になります。
当社(AST)も規模の大きいシステムを扱っており、Azure DevOpsのOrganizationの中に複数のProjectがあり、それぞれのProjectが複数のRepo(Azure Repos)を持ちます。中にはSREチームが主に扱うProjectが存在し、SREチームのメンバーとしてはそのProject内のほぼすべてのRepoを扱っていくことになるため、まとめてcloneしたいモチベーションが発生しました。
一括作業ならCLIが便利です。そのため az コマンドを用いて一括で取得する方法を検討し、以下のコマンドで実現しました。
# gitコマンド用
$ az repos list --org <Organization Name> --project <Project Name> | jq -r '.[] | select(.isDisabled == false) | .sshUrl' | sed -E 's/^/git clone /g'
# ghqコマンド用
$ az repos list --org <Organization Name> --project <Project Name> | jq -r '.[] | select(.isDisabled == false) | .sshUrl' | sed -E 's/^/ghq get /g'
簡単なコマンド解説
-
az repos list: MS Learnにある通り、プロジェクトのGitリポジトリの一覧を表示するコマンドです -
--org, --project:az repos listに対してそれぞれOrganizationとProjectを指定するオプションです。az devops configureを利用してデフォルトを事前設定すれば省略できます(MSLearn参照)。 -
jq:azコマンドはデフォルトで結果をJSONで返却するためjqコマンドを利用して必要な情報を取得します。最近ではjenvを使うとフィルタを組み立てしやすいです -
-r:jqコマンドのオプションである-rはロングオプションで--raw-outputと指定できる通り、'"'を表示せずに結果を表示します。見た目がスッキリする目的で指定していますが必須ではありません -
select(.isDisabled == false): これは工夫の一つです。Azure ReposではRepoをDisableの状態にすることができます。DisabledとなったRepoからはcloneすることができないため、リストから除外する必要があるための条件式です(cloneエラーを気にせず流すこともできますが、心臓に良くないため） -
.sshUrl: cloneするためのURLをJSONの結果から取得します。 (httpsを使う人はremoteUrlを利用するのかもしれませんが私は基本的にssh派です) -
sed -E 's/^/git clone /g': 取得したURLの先頭にgit cloneの文字列を挿入します。私はghqを愛用しているため's/^/ghq get /g'としました
まとめ
以上、Azure Reposから一つずつcloneする手間をCLIでまとめてできるようにした話でした。
これによってAzure Reposを使う案件で新しいProjectに携わることになっても、シュッと関連するReposをローカルに持ってくることができる様になりました。入社したばかりの私的には大変便利なためブログで紹介いたしました。それでは皆さんEnjoy Azure！！
絶賛採用中です！！
私たちイオンスマートテクノロジーではエンジニアをはじめとした様々な職種を積極的に採用中です！
これから益々面白いフェーズへ突入していく最中ですので、興味のある方は是非カジュアル面談などで話を聞いてください！
Discussion