サービス

技能：エンジニア

技能：デザイナー

技能：ビジネス職

技能：バックオフィス

ジャンル

<h3 id="はじめに">はじめに</h3>

こんにちは、プラットフォーム事業本部の石垣雅人(<a href="https://twitter.com/i35_267" target="_blank">@i35_267</a>)です。 
現在は、DMM.comのサービスで利用されるプラットフォーム基盤でPO(ProductOwner)をしております。

今回は、『プロジェクト管理ツール』について『ZenHub』を利用することになった経緯とその運用方法について記載していきます。

<a href="https://www.zenhub.com/">https://www.zenhub.com/</a>

<h3 id="ZenHubとは">ZenHubとは</h3>

ZenHubの公式サイトにある『<a href="https://help.zenhub.com/support/solutions/articles/43000010778-what-is-zenhub-an-intro-to-zenhub-in-github" target="_blank">What is ZenHub？</a>』には、下のように述べられています。

<blockquote>
ZenHub is not your typical GitHub Issue tracker. For one, every feature is crafted specifically for fast-moving software teams. Rather than forcing teams to leave GitHub and jump into another tool (resulting in double work, informational silos, and missed updates), it transforms GitHub into a fully featured project management platform. 
Wasted time spent context switching is eliminated. And because everything is fuelled by your GitHub Issues and Pull Requests, you&#39;re always working from the most up-to-date data possible. It&#39;s the fullest possible integration where you already work. 
<a href="https://help.zenhub.com/support/solutions/articles/43000010778-what-is-zenhub-an-intro-to-zenhub-in-github" target="_blank">What is ZenHub? Using ZenHub for project management in GitHub</a>
</blockquote>

つまり、ZenHubはGitHub Issueを追跡するだけのものではなく、GitHub IssueおよびPull Requestsを軸として、別のツールへの切り替えや二重更新などの『ムダ』から解放され、すべてが高速になるようなプロジェクト管理プラットフォームです。

&nbsp;

<h4 id="a">スクラム開発における親和性</h4>

&nbsp;

プロジェクト管理ツールには開発手法との親和性が強く求められます。 
今回『ZenHub』を導入したチームではスクラム開発手法を取り入れているため、下記の機能が最低限必要でした。

<ol>
	<li>Product Backlog Itemが作成できる。</li>
	<li>Storyが作成できる。</li>
	<li>Storyに対してProduct Backlog Itemを紐づけることができる。</li>
	<li>スプリントが作成できる。</li>
	<li>Burndown chartsおよびVelocity Trackingが可視化できる。</li>
</ol>

まず、これらの基準を満たすものとして<a href="https://ja.atlassian.com/" target="_blank">Atlassian</a>製の<a href="https://ja.atlassian.com/software/jira" target="_blank">JIRA</a>か、今回述べるZenHubに落ち着きました。 
そして、次にポイントになったのが、『チケット管理』と『リポジトリ管理』の親和性でした。

たとえば、Atlassianの<a href="https://ja.atlassian.com/software/bitbucket" target="_blank">BitBucket</a>をリポジトリ管理に利用している場合にはJIRAや<a href="https://ja.atlassian.com/software/trello" target="_blank">Trello</a>。一方、GitHubを使っているのであれば、ZenHubのようなチケットからリポジトリのコミット履歴やPull Requestが確認できたり、チケットとリポジトリで相互リンクの関係を作れていたりすることが重要だと考えております。

今回は、リポジトリ管理としてGitHubを利用するというチーム方針のため、ZenHubを採用する形となりました。 
公式サイトにもJIRAとの比較がありますのでご覧ください。

<a href="https://www.zenhub.com/jira-alternative">https://www.zenhub.com/jira-alternative</a>

<h3 id="Agile-Concepts-in-GitHub-and-ZenHub">Agile Concepts in GitHub and ZenHub</h3>

ZenHubにはAgile開発に必要な機能が揃っています。 
上で述べた<a href="https://inside.hatenablog.jp/entry/2018/09/05/zenhub-github#a">スクラム開発における親和性</a>の5項目が、ZenHubではどのようなツールで提供されているのか見ていきます。

1. Product Backlog Itemが作成できる。 
ZenHubにおけるProduct Backlog Itemは、GitHubでいうIssueにあたります。 
Issueについては、GitHub上からでもZenHub上からでも作成できます。もちろん作成されたissueはGitHub,ZenHubの両方から閲覧可能です。

<img alt="" height="267" src="https://image.dmm-corp.com/2xxs24dyolo26kjtkhq91p5ha514" width="700" />

<img alt="" height="401" src="https://image.dmm-corp.com/v5qflez8gru1eev74jllxffp3vv4" width="700" />

※上 : GitHub / 下 : ZenHub

&nbsp;

2. Storyが作成できる。 
3. Storyに対してProduct Backlog Itemを紐づけることができる。 
スクラム開発では、ユーザストーリーをベースにひとつのストーリーが完了するまでに必要なProduct Backlog Itemを紐づけられるべきです。 一般的にこのような仕組みは『Epic』という機能で補完されます。もちろんZenHubにも『Epic』機能があります。

<img alt="" height="452" src="https://image.dmm-corp.com/25l6dcaxbhexkgnh76uyisaz9mu6" width="700" />

引用 :&nbsp;<a href="https://help.zenhub.com/support/solutions/articles/43000010341" target="_blank">Using Epics in ZenHub for projects and user stories</a>

4. スプリントが作成できる。 
スクラム開発をするうえで『スプリント』機能は必須です。 ZenHubでは『Milestone』機能が提供されて一定期間のタイムボックスを選択してスプリントが作成できます。

<img alt="" height="474" src="https://image.dmm-corp.com/1zemo3kuf4u7n1g9o1q24csvwz31" width="700" />

参考 :&nbsp;<a href="https://help.zenhub.com/support/solutions/articles/43000010361" target="_blank">Create GitHub Milestones across a multi-repo Board</a>

5. Burndown chartsおよびVelocity Trackingが可視化できる。 
スプリントの経過や成果について、Burndown chartsおよびVelocity Trackingを利用しますが、ZenHubにもしっかりと備わっています。

<img alt="" height="500" src="https://image.dmm-corp.com/ffz7jslptrtd55uo4luu92qxxatv" width="700" />

引用 :&nbsp;<a href="https://help.zenhub.com/support/solutions/articles/43000010356" target="_blank">Creating Burndown charts in ZenHub using GitHub Milestones</a>

<img alt="" height="980" src="https://image.dmm-corp.com/5os98rcpc2qzsuadtikf4t8c3vu2" width="500" />

引用 :&nbsp;<a href="https://help.zenhub.com/support/solutions/articles/43000010358" target="_blank">Using Velocity charts in ZenHub</a>

<h3 id="Development-Process">Development Process</h3>

続いて、ZenHubを利用した開発プロセスについて、チームの事例を記載していきます。

全体図

<img alt="" height="525" src="https://image.dmm-corp.com/hh4m9qx8tqfd0b6osfc4cxw1o6ro" width="700" />

プロセス 
1. Organizationの中で基本操作しています。 
2. Product Backlog Itemの可視化のため、専用の『backlog』というGitHubリポジトリを用意して、その中にZenHubのBoradを用意します。 
3. PO(ProductOwner)は、普段どおり『backlog』に対してProduct Backlogを作っていきます。 
4. ScrumTeamのDeveloperは、対象リポジトリ(ex.api, infra, lambda)に対してバグや改善ポイントをIssueとして発行していきます。 
5. ZenHubのBoardには、Organizationと紐づくリポジトリのIssueをMergeする機能があります。『backlog』のBoardに指定したリポジトリのIssueがすべて可視化できるようにします。※詳細は、&nbsp;<a href="https://medium.com/@i35_267/zenhub-x-github-%E8%A4%87%E6%95%B0%E3%83%AA%E3%83%9D%E3%82%B8%E3%83%88%E3%83%AA%E3%82%92%E3%83%9E%E3%83%BC%E3%82%B8%E3%81%97%E3%81%A6-%E3%81%B2%E3%81%A8%E3%81%A4%E3%81%AEboard%E3%81%A7issue%E3%82%92%E4%B8%80%E5%85%83%E7%AE%A1%E7%90%86%E3%81%97%E3%82%88%E3%81%86-8403c7e39876" target="_blank">『ZenHub x GitHub』複数リポジトリをマージして、ひとつのBoardでIssueを一元管理しよう！</a>を御覧ください。

メリットとしては、GitHubリポジトリに起因してIssueを発行することで、そのIssueはどこに対してコミットすれば良いのかがまずわかります。 
また、『backlog』のような専用のBoardを用意して、それぞれのリポジトリに発行されたIssueを集約することで、一元管理できるのも大きなメリットです。

<h3 id="Product-Development-Pipelines">Product Development Pipelines</h3>

作業を可視化するためのパイプラインについてです。 
ZenHubではデフォルトのレーンを提供しています。

<img alt="" height="193" src="https://image.dmm-corp.com/k1wkcd4juh57n2ggzh2atelpsuyx" width="600" />

引用 :&nbsp;<a href="https://www.zenhub.com/blog/how-the-zenhub-team-uses-zenhub-boards-on-github/" target="_blank">How the ZenHub team uses kanban boards in GitHub &ndash; For beginners</a>

もちろんそのまま利用する形でも良いのですが、私たちのチームではスクラム開発用にカスタマイズしています。

<img alt="" height="600" src="https://image.dmm-corp.com/szlrmnlvicy8mi3o6o35nanwv7t1" width="700" />

<ol>
	<li>『Opportunity Backlog』 : 各リポジトリに発行されたIssueがここに積まれていきます。</li>
	<li>『Story』 : Epicを利用してユーザーストーリーに沿ったものが積まれていきます。</li>
	<li>『Story in progress』: 『Story』のレーンのなかで現在進行中のものをここに配置して、どのStoryに着手しているのかを可視化します。</li>
	<li>『Backlog』 : Opportunity Backlogから精査されたProduct Backlogをここに積んでいきます。</li>
	<li>『Doing』: 現在進行中のSprint Backlog Itemです。</li>
	<li>『Review/QA』: レビューや問い合わせ待ちのものを配置します。</li>
	<li>『Resolved』: 完了したSprint Backlog Itemについて、一度ここのレーンに持っていき、DailyScrumで皆で確認後にCloseのレーンに持っていきます。</li>
	<li>『Closed』 : 完了したSprint Backlog Itemです。</li>
</ol>

補足 
Product Backlog Itemには、Milestone, Epic, Labelsを必ず紐づけます。※Estimate, Assigneesはスプリントプランニングの際に紐づけます。 
ZenHubのフィルター機能を使って、スプリントに紐付いたSprint Backlog Itemだけを見るためです。

<h3 id="Tips">Tips</h3>

ZenHubには、他にも様々な便利な機能がありますので紹介させてください。

ショートカット機能 
ZenHub上での操作は、ほとんどショートカットコマンドが用意されています。 以下にまとめられておりまので、ぜひご覧ください。

<a href="https://qiita.com/i35_267/items/536ffbe26ed9e60083d3">https://qiita.com/i35_267/items/536ffbe26ed9e60083d3</a>

ZenHub API 
ZenHubではAPIが提供されているので、様々なカスタマイズが可能です。 
たとえば、ZenHub上でReview/QAに一定期間あるIssueを通知することなども可能です。

<a href="https://github.com/ZenHubIO/API">https://github.com/ZenHubIO/API</a>

Issueを作成するなどの処理は、ZenHubではなくGitHubのAPIで可能です。それについては以下をあわせてご覧ください。

<a href="https://docs.github.com/ja/rest?apiVersion=2022-11-28">https://docs.github.com/ja/rest?apiVersion=2022-11-28</a>

<h3 id="まとめ">まとめ</h3>

今回は、プロジェクト管理ツールとしてZenHubを紹介させていただきました。 
特にGitHubを使っている方は、ZenHubを利用することで様々なメリットを得られると思いますので、ぜひ利用してみてください。

&nbsp;

&nbsp;

『ZenHub x GitHub』を軸としたスクラム開発のプロセス設計

シェア

関連する記事