サービス

ジャンル

職種：エンジニア

職種：ビジネス職

職種：デザイナー

職種：バックオフィス

職種：その他職種

技術

こんにちは。ITインフラ本部 SRE部の庭野です。 
今回は、私たちSRE部で運用管理しているプロジェクトの依存関係更新作業を自動化するツール、Renovateについて紹介します。

多くのプロジェクトでは、依存関係の更新が手作業で行われ、大きな負担となっています。 
Renovateを活用することにより、この更新プロセスを自動化し、開発チームがより創造的な作業に集中できるようになります。

※この記事では、Renovateのバージョン37.279.0を前提に説明しています。

<h2>Renovate とは？</h2>

Renovateは、ソフトウェアプロジェクトの依存関係を自動的に検知／更新するツールです。

※公式サイト: <a href="https://docs.renovatebot.com/" target="_blank">https://docs.renovatebot.com/</a>

ここで言う依存関係とは、私たちのプロジェクトが正しく動作するために必要な外部のコードやライブラリといったパッケージのことを意味します。

依存関係の適切な管理を怠ると、使用されている外部ライブラリが古くなり、セキュリティの脆弱性やパフォーマンスの問題を引き起こす可能性があります。

また日々のアップデートは手間がかかるため、しばしば見過ごされがちです。

そこでRenovateを使用することで、これらのライブラリの継続的な更新が自動化され、セキュリティリスクの増大を防ぎながら、手間を省くことができます。

自動化されたプロセスにより、開発チームは新しい機能の追加やバグ修正に集中できるようになり、プロジェクトの健全性を維持しつつ、セキュリティを強化することが可能です。

<h2>主な機能</h2>

Renovateは自動的にプルリクエストを作成し、依存関係の更新を提案します。

また、更新を行うタイミングを細かく設定できるため、チームのワークフローに合わせて更新作業のスケジューリングが行えます。

<h2>導入概要</h2>

DMMではGitHub Cloudの他にGitHub Enterprise Server（以降GHES）も活用しています。

GitHub CloudのRenovateはGHESではそのままでは利用できず、Self Hostedとして設定する必要があります。

本記事ではRenovate Botをセットアップする具体的な手順には触れず、Renovateが提供する主要な機能とそのメリットに焦点を当てて説明します。

GHESでRenovateを利用する場合、事前に用意したRenovate Botをオーガニゼーションに追加する必要があります。

Renovateを有効にしたいリポジトリで、以下のようにRenovate Botからのアクセスを許可します。

<img alt="" height="433" src="https://image.dmm-corp.com/vlrxdlt37a3la52pz0p5mowq8a8o" width="800" />

これにより、Renovate Botが初めて実行されたとき、Renovateの実行に必要なrenovate.jsonファイルを含む初期設定プルリクエストが自動的に作成されます。

このプルリクエストをマージすることで、Renovateによる基本的な依存関係の更新設定が完了します。

<ul>
	<li>作成されたプルリクエスト</li>
</ul>

<img alt="" height="140" src="https://image.dmm-corp.com/np19uiahwrc6edn4ep2oekqo2rjo" width="492" />

<ul>
	<li>プルリクエストの内容</li>
</ul>

<img alt="" height="836" src="https://image.dmm-corp.com/y5ag5ry3cddy6s8i45zt20llobj2" width="800" />

ここまでのプロセスはシンプルで、わずか数ステップで完了します。

次に、実際にRenovateをどのように設定して使用するかを見てみましょう。

<h2>実践的な使用例</h2>

初期設定のrenovate.jsonのままでは期待した動作にならないことがほとんどです。

<pre>
<code class="language-json">{
 "$schema": "https://docs.renovatebot.com/renovate-schema.json"
}</code></pre>

以下は、Renovateのカスタマイズが必要となる一般的なシナリオです。

<ul>
	<li>パッケージがリリースされてから指定日数はプルリクエストを作成せずに様子を見たい</li>
	<li>指定日にだけ依存関係を更新したい</li>
	<li>一度のRenovate実行で作成されるプルリクエスト数を制限したい</li>
	<li>一度に保持できるプルリクエスト数を制限したい</li>
	<li>プルリクエスト作成時に自動的に担当者アサイン／レビュアーアサインを行いたい</li>
</ul>

こういった場合は、以下のようにrenovate.jsonをカスタマイズすることで、これらの要望に応えることができます。

<pre>
<code class="language-json">{
 "$schema": "https://docs.renovatebot.com/renovate-schema.json",
 "extends": [
 "config:best-practices",
 ":label(renovate)",
 ":timezone(Asia/Tokyo)"
 ],
 "configMigration": true,
 "minimumReleaseAge": "7 days",
 "prHourlyLimit": 5,
 "prConcurrentLimit": 10,
 "schedule": [
 "after 10am and before 5pm every weekday"
 ],
 "assignees": [
 "&lt;user-name&gt;"
 ],
 "reviewers": [
 "&lt;user-name&gt; or &lt;team-name&gt;"
 ]
}</code></pre>

それぞれのパラメータについて確認してみましょう。

<table border="1" cellpadding="1" cellspacing="1" style="width:500px;">
	<tbody>
		<tr>
			<td>パラメータ</td>
			<td>説明</td>
		</tr>
		<tr>
			<td>$schema</td>
			<td>スキーマのURL。</td>
		</tr>
		<tr>
			<td>extends</td>
			<td>ベースとなる設定。</td>
		</tr>
		<tr>
			<td>configMigration</td>
			<td>設定の移行を有効にするかどうか。</td>
		</tr>
		<tr>
			<td>minimumReleaseAge</td>
			<td>パッケージがリリースされてから指定日数はプルリクエストを作成せずに様子を見る設定。</td>
		</tr>
		<tr>
			<td>prHourlyLimit</td>
			<td>一度のRenovate実行で作成されるプルリクエスト数を制限する設定。0は無制限。</td>
		</tr>
		<tr>
			<td>prConcurrentLimit</td>
			<td>一度に保持できるプルリクエスト数を制限する設定。0は無制限。</td>
		</tr>
		<tr>
			<td>schedule</td>
			<td>指定日にだけ依存関係を更新する設定。</td>
		</tr>
		<tr>
			<td>assignees</td>
			<td>プルリクエスト作成時に自動的に担当者アサインを行う設定。</td>
		</tr>
		<tr>
			<td>reviewers</td>
			<td>プルリクエスト作成時に自動的にレビュアーアサインを行う設定。</td>
		</tr>
	</tbody>
</table>

これらを設定することで期待する動作が実現できます。

さらに応用的な使用例として、以下のような検出も行うことが可能です。

<ul>
	<li>パッケージやディレクトリ単位でグルーピング更新</li>
</ul>

<pre>
<code class="language-json">{
 "$schema": "https://docs.renovatebot.com/renovate-schema.json",
 "packageRules": [
 {
 "matchManagers": [
 "terraform"
 ],
 "additionalBranchPrefix": "{{packageFileDir}}-",
 "commitMessageSuffix": "({{packageFileDir}})",
 "groupName": "terraform",
 "addLabels": [
 "terraform"
 ]
 }
 ]
}</code></pre>

<ul>
	<li>Amazon ECRで管理しているプライベートリポジトリ内コンテナのイメージタグ更新</li>
</ul>

<pre>
<code class="language-json">{
 "$schema": "https://docs.renovatebot.com/renovate-schema.json",
 "hostRules": [
 {
 "hostType": "docker",
 "matchHost": "&lt;AWS Account ID&gt;.dkr.ecr.&lt;Region Name&gt;.amazonaws.com",
 "username": "AKIAXXXXXXXXXXXXXXXX",
 "encrypted": {
 "password": "wcFMA/XXXXXXXXXXX..."
 }
 }
 ]
}</code></pre>

<ul>
	<li>GitHub Packageのバージョン更新</li>
</ul>

<pre>
<code class="language-json">{
 "$schema": "https://docs.renovatebot.com/renovate-schema.json",
 "hostRules": [
 {
 "hostType": "npm",
 "matchHost": "https://npm.pkg.github.com/",
 "encrypted": {
 "token": "wcFMA/XXXXXXXXXXX..."
 }
 }
 ],
 "npmrc": "@&lt;Organization Name&gt;:registry=https://npm.pkg.github.com/"
}</code></pre>

パラメータの詳細については、公式ドキュメント: <a href="https://docs.renovatebot.com/config-overview/" target="_blank">https://docs.renovatebot.com/config-overview/</a>を参照してください。

また、暗号化（encrypted）については <a href="https://github.com/renovatebot/renovate/blob/main/docs/usage/getting-started/private-packages.md#adminbot-config-vs-userrepository-config-for-self-hosted-users" target="_blank">こちら</a> を参照してください。

<h2>ベストプラクティスと注意点</h2>

Renovateを最大限に活用するためには、どの依存関係に自動更新を適用するか慎重に選択することが重要です。

不必要に多くの自動更新を設定すると、それぞれの更新について確認・テストが必要となり、管理が大変になるからです。

<h2>まとめ</h2>

Renovateを使うことで、プロジェクトの依存関係を簡単に最新の状態に保つことができます。

これにより、セキュリティを強化し、開発の効率を高めることが期待できます。

この記事を通じて、Renovateがどのようにプロジェクトの依存関係を最新の状態に保ち、セキュリティリスクを軽減し、開発の効率を高めるかを理解していただけたと思います。

自動化により時間を節約し、開発チームがより重要なタスクに集中できるようになるため、Renovateの積極的な活用をお勧めします。

手間いらずで最新保守 Renovateによる依存関係の自動化術

facebook

twitter

DMM TV

DMMブックス

DMM pictures

DMM GAMES

DMMオンクレ

DMMスクラッチ

DMMくじ

DMM Factory

ぷらさぷ ～＋SURPRISE～

DMMオンラインサロン

DMMいろいろレンタル

DMM DVD／CDレンタル

DMM通販

DMMオンラインクリニック

デジタルコミック事業

DMMチャットブースト

DMM英会話

DMM FX

DMMかりゆし水族館

ベルリング

ハッシャダイソーシャル

ヤンキーインターン

シント=トロイデンVV

DMM 地方創生

DMM.make 3Dプリント

DMM.make PRODUCTS

Seamoon Protcol by DMM Crypto

DMMバヌーシー

DMM EV ON

DMM WEBCAMP

DMMぱちタウン

DMM競輪

Waitinglist

Algoage

DMMポイントクラブ

社会課題

エンターテインメント

動画

電子書籍

アニメ

ゲーム

アプリゲーム

コミュニティ

オンラインサロン

PCゲーム

通販

レンタル

オンラインイベント

ビジネスソリューション

教育

英会話

水族館

ハードウェア・プロダクト

救急車両

消防車両

モノづくり施設

サッカー

スポーツ

地方創生

VR体験

Web3

生成AI

研究開発

アプリ

ブロックチェーン

プラットフォーム

横断開発

社会インフラ

アミューズメント

ダイバーシティ

同人

Webエンジニア

フロントエンドエンジニア

バックエンドエンジニア

サーバーサイドエンジニア

モバイルエンジニア

SRE・インフラエンジニア

情報システム

データ・AI・機械学習エンジニア

エンジニアリングマネージャー

テックリード

プロジェクトマネージャー・ディレクター

プロダクトマネージャー

事業開発・経営企画

営業

マーケティング・プロモーション

企画・プロデュース

ゲーム企画・プロデュース

コンテンツ制作・編集

カスタマーサポート・運営

データ分析・ストラテジー

UI・UXデザイナー

Webデザイナー

2Dデザイナー・イラストレーター

デザインマネージャー

デザインリード

手間いらずで最新保守 Renovateによる依存関係の自動化術

シェア