<p>こんにちは！<br>
SREチームの宮原（<a href="https://twitter.com/TakashiMiyahara" rel="nofollow">@TakashiMiyahara</a>）です🙋</p>
<p>本日は、<a href="https://www.wantedly.com/companies/classi/post_articles/145844" rel="nofollow"><code>Classi株式会社さん</code></a> や <a href="https://tech.medpeer.co.jp/entry/2018/10/24/180932" rel="nofollow"><code>メドピア株式会社さん</code></a> で取り組まれている「整地部」が、クラッソーネにも誕生したよ！というお話しです。</p>
<h2 id="%F0%9F%94%8D-%E6%95%B4%E5%9C%B0%E9%83%A8%E3%81%A8%E3%81%AF%EF%BC%9F"><a class="header-anchor-link" href="#%F0%9F%94%8D-%E6%95%B4%E5%9C%B0%E9%83%A8%E3%81%A8%E3%81%AF%EF%BC%9F" rel="nofollow"></a> 🔍 整地部とは？</h2>
<p>プロダクト開発部の有志が毎週金曜日に集合し、モブプロ形式で以下のような取り組みを実施する活動になります。</p>
<ul>
<li>肥大化したクラスやモデル・コントローラーをキレイに整える</li>
<li>業務サポート・効率改善ツールの作成</li>
<li>新しくリリースされたSaaSの機能を試してみる</li>
</ul>
<p>こちらの活動は <strong>業務時間中</strong> に実施しています。</p>
<h2 id="%F0%9F%92%A1-%E3%81%8D%E3%81%A3%E3%81%8B%E3%81%91"><a class="header-anchor-link" href="#%F0%9F%92%A1-%E3%81%8D%E3%81%A3%E3%81%8B%E3%81%91" rel="nofollow"></a> 💡 きっかけ</h2>
<p>各チームとディスカッションすると、「肥大化したクラス等の見通しが悪く、意図せず破壊的な変更が入りそうで怖い」や「新しい技術を皆で共有したい」など、様々なコメントをいただいたことが、きっかけです。</p>
<p>議論しながらコードを修正し、少しずつ僕らのプロダクトをより良いものにできる活動として、晴れて「整地部」爆誕したのであります。</p>
<h2 id="%F0%9F%8F%97%EF%B8%8F-%E9%80%B2%E3%82%81%E6%96%B9"><a class="header-anchor-link" href="#%F0%9F%8F%97%EF%B8%8F-%E9%80%B2%E3%82%81%E6%96%B9" rel="nofollow"></a> 🏗️ 進め方</h2>
<p>クラッソーネでは、以下のよう形で開催しています。</p>
<ol>
<li>開催の通知とお題の募集を行う</li>
<li>活動記録用のNotionのページを作成する</li>
<li>Discordに集合</li>
<li>実施するお題を決める</li>
<li>ドライバーとナビゲーターをアサインする</li>
<li>ドライバーがエディターを共有</li>
<li>開発開始</li>
<li>成果物を作成（Pull Requestやドキュメントなど）</li>
<li>レビュワーをアサイン</li>
<li>振り返りを実施し、活動記録を記入</li>
<li>プロダクト開発部へ活動記録を共有</li>
<li>解散</li>
</ol>
<p>※ 朝会で①②番を実施し、夕方に③から実施するようにしています。<br>
※ ドライバーは挙手制にしています。</p>
<h2 id="%E2%9C%8F%EF%B8%8F-%E6%96%B9%E9%87%9D"><a class="header-anchor-link" href="#%E2%9C%8F%EF%B8%8F-%E6%96%B9%E9%87%9D" rel="nofollow"></a> ✏️ 方針</h2>
<ul>
<li>成果物を作成する</li>
<li>Next Actionを決める</li>
</ul>
<p>上記の2点は、活動記録に記録するようにしています。<br>
<img src="/images/posts/create-seichi-bu/image01.png" alt=""></p>
<h2 id="%F0%9F%97%A3%EF%B8%8F-%E5%8F%82%E5%8A%A0%E8%80%85%E3%81%AE%E5%A3%B0"><a class="header-anchor-link" href="#%F0%9F%97%A3%EF%B8%8F-%E5%8F%82%E5%8A%A0%E8%80%85%E3%81%AE%E5%A3%B0" rel="nofollow"></a> 🗣️ 参加者の声</h2>
<p>参加した開発チームメンバーから、感想をいただきました。</p>
<blockquote>
<p>クラスやメソッドの実装方法で自分の中で特に理由なくNGにしていた書き方が普通にアリなんだということがわかって良かった。他言語版もやってみたい。</p>
</blockquote>
<blockquote>
<p>「ここまではベストプラクティス、ここからは好みも入る」みたいなボーダーを参加者で確認し合える点はよいなと感じました。あと楽しかった。</p>
</blockquote>
<blockquote>
<p>「私ならこう書きます」的な知見が知れてよかった。JavaScript版もやってみたい。</p>
</blockquote>
<blockquote>
<p>シンプルに楽しかったですね。コードレビューだと伝えづらい「僕ならこう書く」を伝えあえて、相互理解とか違った書き方とか知れていいですね。</p>
</blockquote>
<blockquote>
<p>1人でやると「お作法的にこれでいいんだっけ？」みたいなところで悩んだりしがちだったが、普段からJSやTSを触っているメンバーにツッコミ・突っつきボイスを入れてもらいながら作業できてとても学びがあった。</p>
</blockquote>
<p>好意的な感想をたくさん頂けて嬉しかったです。<br>
日々の開発においても、モブプロ・ペアプロが、より活発に実施されるようになることを期待しています。</p>
<h2 id="%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB"><a class="header-anchor-link" href="#%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB" rel="nofollow"></a> おわりに</h2>
<p>プロダクトをより良くする活動がクラッソーネに誕生し、技術的負債に立ち向かう大きな一歩になったと感じています。<br>
「整地部」の活動は始まったばかりですが、より良いプロダクトを開発・維持していくために、活動していきます。</p>
<p>クラッソーネでは、プロダクトとチームの双方をより良く改善していけるエンジニアを募集中です！<br>
ご興味ある方はぜひ採用サイトをご覧ください！</p>
<p><div class="embed-zenn-link"><iframe src="https://card.zenn.dev/?url=https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></div><a href="https://www.crassone.co.jp/recruit/engineer/" style="display: none" rel="nofollow">https://www.crassone.co.jp/recruit/engineer/</a></p>



こんにちは！
SREチームの宮原（@TakashiMiyahara）です🙋

本日は、Classi株式会社さん や メドピア株式会社さん で取り組まれている「整地部」が、クラッソーネにも誕生したよ！というお話しです。

🔍 整地部とは？
プロダクト開発部の有志が毎週金曜日に集合し、モブプロ形式で以下のような取り組みを実施する活動になります。

肥大化したクラスやモデル・コントローラーをキレイに整える
業務サポート・効率改善ツールの作成
新しくリリースされたSaaSの機能を試してみる

こちらの活動は 業務時間中 に実施しています。

💡 きっかけ
各チームとディスカッションすると、「肥大化したクラス等の見通しが悪く、意図せず破壊的な変更が入りそうで怖い」や「新しい技術を皆で共有したい」など、様々なコメントをいただいたことが、きっかけです。

議論しながらコードを修正し、少しずつ僕らのプロダクトをより良いものにできる活動として、晴れて「整地部」爆誕したのであります。

🏗️ 進め方
クラッソーネでは、以下のよう形で開催しています。

開催の通知とお題の募集を行う
活動記録用のNotionのページを作成する
Discordに集合
実施するお題を決める
ドライバーとナビゲーターをアサインする
ドライバーがエディターを共有
開発開始
成果物を作成（Pull Requestやドキュメントなど）
レビュワーをアサイン
振り返りを実施し、活動記録を記入
プロダクト開発部へ活動記録を共有
解散

※ 朝会で①②番を実施し、夕方に③から実施するようにしています。
※ ドライバーは挙手制にしています。

✏️ 方針
成果物を作成する
Next Actionを決める

上記の2点は、活動記録に記録するようにしています。

🗣️ 参加者の声
参加した開発チームメンバーから、感想をいただきました。

> クラスやメソッドの実装方法で自分の中で特に理由なくNGにしていた書き方が普通にアリなんだということがわかって良かった。他言語版もやってみたい。

> 「ここまではベストプラクティス、ここからは好みも入る」みたいなボーダーを参加者で確認し合える点はよいなと感じました。あと楽しかった。

> 「私ならこう書きます」的な知見が知れてよかった。JavaScript版もやってみたい。

> シンプルに楽しかったですね。コードレビューだと伝えづらい「僕ならこう書く」を伝えあえて、相互理解とか違った書き方とか知れていいですね。

> 1人でやると「お作法的にこれでいいんだっけ？」みたいなところで悩んだりしがちだったが、普段からJSやTSを触っているメンバーにツッコミ・突っつきボイスを入れてもらいながら作業できてとても学びがあった。

好意的な感想をたくさん頂けて嬉しかったです。
日々の開発においても、モブプロ・ペアプロが、より活発に実施されるようになることを期待しています。

おわりに
プロダクトをより良くする活動がクラッソーネに誕生し、技術的負債に立ち向かう大きな一歩になったと感じています。
「整地部」の活動は始まったばかりですが、より良いプロダクトを開発・維持していくために、活動していきます。

クラッソーネでは、プロダクトとチームの双方をより良く改善していけるエンジニアを募集中です！
ご興味ある方はぜひ採用サイトをご覧ください！

https://www.crassone.co.jp/recruit/engineer/


クラッソーネに整地部が誕生したよ

<p>こんにちは！最近、ランニングを始めた、SREチームの宮原（<a href="https://twitter.com/TakashiMiyahara" rel="nofollow">@TakashiMiyahara</a>）です🙋</p>
<p>クラッソーネのIAM周りを整理し <code>シンプルかつセキュア</code> な設計に変更しましたので、こちらをご紹介したいと思います。</p>
<h2 id="%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB"><a class="header-anchor-link" href="#%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" rel="nofollow"></a> はじめに</h2>
<p>以前は環境ごとに開発者用のIAM Userが用意し、それぞれのIAM Userでサインインしていました。<br>
また、それぞれのIAM Userに強い権限が付与されていました。</p>
<p><img src="/images/posts/change-to-a-simple-and-secure-iam-configuration/iam-switchrole-before.svg" alt=""></p>
<h2 id="%E8%AA%B2%E9%A1%8C"><a class="header-anchor-link" href="#%E8%AA%B2%E9%A1%8C" rel="nofollow"></a> 課題</h2>
<p>前述の構成には、以下のような課題があると考えました🙋</p>
<ul>
<li>IAM Userの数が多く、管理・運用が煩雑になりやすい</li>
<li>IAM Userの権限が強力であり、秘匿情報が漏洩した場合のリスクが大きい</li>
<li>利用者毎にアクセス境界・権限管理が存在せず、意図せず事故が発生するリスクが大きい</li>
</ul>
<p>上記の課題を解決するために、今回実施した変更内容は、主に以下の3点になります。</p>
<ul>
<li>サインイン・アカウントの切り替えを簡単にする</li>
<li>必要な人に、必要なだけの権限を付与する</li>
<li>IAM Userの数を必要最低限にする</li>
</ul>
<h2 id="%E9%80%B2%E3%82%81%E6%96%B9"><a class="header-anchor-link" href="#%E9%80%B2%E3%82%81%E6%96%B9" rel="nofollow"></a> 進め方</h2>
<p>IAM周りに大きな変更を入れるため、SREチーム内で設計するだけではなく、AWSのサポート・SAの方に設計や移行手順をレビューしていただき、安全に移行できるように進めました🙋</p>
<ol>
<li>SREチーム内でゴールとなるIAM構成と移行手順を設計</li>
<li>AWSのサポート・SAの方に設計と移行手順をレビュー</li>
<li>レビュー結果を設計と移行手順にフィードバック</li>
<li>移行手順に準じて、移行を実施</li>
</ol>
<h2 id="%E3%82%B9%E3%82%A4%E3%83%83%E3%83%81%E3%83%AD%E3%83%BC%E3%83%AB%E3%81%AE%E5%B0%8E%E5%85%A5"><a class="header-anchor-link" href="#%E3%82%B9%E3%82%A4%E3%83%83%E3%83%81%E3%83%AD%E3%83%BC%E3%83%AB%E3%81%AE%E5%B0%8E%E5%85%A5" rel="nofollow"></a> スイッチロールの導入</h2>
<p>まず、スイッチロールを利用して、必要な環境の必要な権限を委任できるようにしました🙋<br>
今回は、読み取り専用・開発用・管理用の権限用のIAM Roleを新規作成しました。</p>
<p><img src="/images/posts/change-to-a-simple-and-secure-iam-configuration/iam-switchrole-after.svg" alt=""></p>
<p><code>ロールの切り替え</code> から利用したいロールへ変更できるようになります。<br>
<img src="/images/posts/change-to-a-simple-and-secure-iam-configuration/role-change.png" alt=""><br>
この時に、表示名・色については、各自が自由に設定できます。<br>
僕の場合は、以下のように表示名と色を分けています。<br>
<img src="/images/posts/change-to-a-simple-and-secure-iam-configuration/switchrole.png" alt=""></p>
<p>また、開発環境へサインインした後で、本番環境の必要な権限へスイッチロールも行えるようにしました。<br>
これにより、環境を切り替えるために一度サインアウトする必要なくなり、開発者体験が向上します🤩</p>
<p>この状態では、誰でも強い権限を利用できてしまうため、権限管理の観点からは好ましくはありません。</p>
<h2 id="%E5%BF%85%E8%A6%81%E3%81%AA%E4%BA%BA%E3%81%AB%E3%80%81%E5%BF%85%E8%A6%81%E3%81%AA%E3%81%A0%E3%81%91%E3%81%AE%E6%A8%A9%E9%99%90%E3%82%92%E4%BB%98%E4%B8%8E%E3%81%99%E3%82%8B"><a class="header-anchor-link" href="#%E5%BF%85%E8%A6%81%E3%81%AA%E4%BA%BA%E3%81%AB%E3%80%81%E5%BF%85%E8%A6%81%E3%81%AA%E3%81%A0%E3%81%91%E3%81%AE%E6%A8%A9%E9%99%90%E3%82%92%E4%BB%98%E4%B8%8E%E3%81%99%E3%82%8B" rel="nofollow"></a> 必要な人に、必要なだけの権限を付与する</h2>
<p>前述の通り、誰でも強い権限を利用できてしまうため、意図しない破壊的な操作が発生するリスクがあります。</p>
<p>クラッソーネでは、役割に応じてスイッチロールで利用できる権限を、以下のように割り当てました🙋</p>
<table>
<thead>
<tr>
<th>役割</th>
<th>権限</th>
</tr>
</thead>
<tbody>
<tr>
<td>SRE</td>
<td>管理者権限、開発者権限、読み取り専用権限</td>
</tr>
<tr>
<td>開発チーム リーダー</td>
<td>管理者権限、開発者権限、読み取り専用権限</td>
</tr>
<tr>
<td>開発チーム メンバー</td>
<td>開発者権限、読み取り専用権限</td>
</tr>
<tr>
<td>経理担当者</td>
<td>読み取り専用権限</td>
</tr>
</tbody>
</table>
<p>下記のように、必要な人に必要なだけの権限を付与し、AWSの操作を行えるようにしました。</p>
<p><img src="/images/posts/change-to-a-simple-and-secure-iam-configuration/iam-switchrole-after-gen2.svg" alt=""></p>
<p>IAM UserのID/PWやMFAを利用して、AWSへサインインしますが、このIAM Userも減らせそうですね。<br>
別のIDプロバイダーの情報を利用して、AWSへサインインできるようになれば、IAM Userの管理コストも減らせそうです。</p>
<h2 id="%E3%82%B7%E3%83%B3%E3%82%B0%E3%83%AB%E3%82%B5%E3%82%A4%E3%83%B3%E3%82%AA%E3%83%B3%E3%82%92%E5%B0%8E%E5%85%A5%E3%81%97%E3%80%81iam-user%E3%81%AE%E6%95%B0%E3%82%92%E5%BF%85%E8%A6%81%E6%9C%80%E4%BD%8E%E9%99%90%E3%81%AB%E3%81%99%E3%82%8B"><a class="header-anchor-link" href="#%E3%82%B7%E3%83%B3%E3%82%B0%E3%83%AB%E3%82%B5%E3%82%A4%E3%83%B3%E3%82%AA%E3%83%B3%E3%82%92%E5%B0%8E%E5%85%A5%E3%81%97%E3%80%81iam-user%E3%81%AE%E6%95%B0%E3%82%92%E5%BF%85%E8%A6%81%E6%9C%80%E4%BD%8E%E9%99%90%E3%81%AB%E3%81%99%E3%82%8B" rel="nofollow"></a> シングルサインオンを導入し、IAM Userの数を必要最低限にする</h2>
<p>クラッソーネでは正社員のクルーは、Google Workspacesのアカウントを所持しています。<br>
こちらのアカウントを利用して、AWSへシングルサインオンできるようにしてみました🙋</p>
<p><img src="/images/posts/change-to-a-simple-and-secure-iam-configuration/iam-design.svg" alt=""></p>
<p>Google Workspacesアカウントを持っているクルーは、<code>Google アプリ</code> 一覧から <code>Amazon Web Service</code> を選択し、クラッソーネのAWSアカウントへSSOできるようになります。<br>
<img src="/images/posts/change-to-a-simple-and-secure-iam-configuration/google-apps-aws.png" alt=""></p>
<p>SSOできる方のIAM Userは不要になるため、IAM Userの整理を行いました。<br>
また、SSOした時点・IAM Userにサインインした時点では、読み取り専用の権限に限定しています。<br>
これにより、不用意にIAM Userの秘匿情報が漏洩するリスク、漏洩しても即座に破壊的な変更を実行させにくい体制に変更できました🙌</p>
<h2 id="%E7%B5%90%E6%9E%9C"><a class="header-anchor-link" href="#%E7%B5%90%E6%9E%9C" rel="nofollow"></a> 結果</h2>
<p>今回の取り組みで、以下の点を実施できました。</p>
<ul>
<li>IAM Userの数を、必要最低限にできた</li>
<li>役割に応じて、必要な権限を割り当てることができた</li>
<li>AWSへのサインインや権限の変更を簡単に行えるようにした</li>
</ul>
<p>IAMの運用や構成は、事業のフェーズや開発組織の規模によって、ベストプラクティスは変わっていくると考えています。<br>
今回は、将来の事業や組織の拡大を見据えつつ、セキュリティ強化も兼ねて実施しました。</p>
<p>さらに発展、改善する余地は、まだまだあると考えていますので、他社さんとも積極的に情報交換したいと思っています✨</p>
<h2 id="%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB"><a class="header-anchor-link" href="#%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB" rel="nofollow"></a> おわりに</h2>
<p>クラッソーネでは、プロダクトとチームの双方をより良く改善していけるエンジニアを募集中です！</p>
<p><div class="embed-zenn-link"><iframe src="https://card.zenn.dev/?url=https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></div><a href="https://www.crassone.co.jp/recruit/engineer/" style="display: none" rel="nofollow">https://www.crassone.co.jp/recruit/engineer/</a></p>



こんにちは！最近、ランニングを始めた、SREチームの宮原（@TakashiMiyahara）です🙋

クラッソーネのIAM周りを整理し シンプルかつセキュア な設計に変更しましたので、こちらをご紹介したいと思います。

はじめに
以前は環境ごとに開発者用のIAM Userが用意し、それぞれのIAM Userでサインインしていました。
また、それぞれのIAM Userに強い権限が付与されていました。

課題
前述の構成には、以下のような課題があると考えました🙋
IAM Userの数が多く、管理・運用が煩雑になりやすい
IAM Userの権限が強力であり、秘匿情報が漏洩した場合のリスクが大きい
利用者毎にアクセス境界・権限管理が存在せず、意図せず事故が発生するリスクが大きい

上記の課題を解決するために、今回実施した変更内容は、主に以下の3点になります。
サインイン・アカウントの切り替えを簡単にする
必要な人に、必要なだけの権限を付与する
IAM Userの数を必要最低限にする

進め方
IAM周りに大きな変更を入れるため、SREチーム内で設計するだけではなく、AWSのサポート・SAの方に設計や移行手順をレビューしていただき、安全に移行できるように進めました🙋

SREチーム内でゴールとなるIAM構成と移行手順を設計
AWSのサポート・SAの方に設計と移行手順をレビュー
レビュー結果を設計と移行手順にフィードバック
移行手順に準じて、移行を実施

スイッチロールの導入
まず、スイッチロールを利用して、必要な環境の必要な権限を委任できるようにしました🙋
今回は、読み取り専用・開発用・管理用の権限用のIAM Roleを新規作成しました。

ロールの切り替え から利用したいロールへ変更できるようになります。

この時に、表示名・色については、各自が自由に設定できます。
僕の場合は、以下のように表示名と色を分けています。

また、開発環境へサインインした後で、本番環境の必要な権限へスイッチロールも行えるようにしました。
これにより、環境を切り替えるために一度サインアウトする必要なくなり、開発者体験が向上します🤩

この状態では、誰でも強い権限を利用できてしまうため、権限管理の観点からは好ましくはありません。

必要な人に、必要なだけの権限を付与する
前述の通り、誰でも強い権限を利用できてしまうため、意図しない破壊的な操作が発生するリスクがあります。

クラッソーネでは、役割に応じてスイッチロールで利用できる権限を、以下のように割り当てました🙋

|役割|権限|
|---|---|
|SRE|管理者権限、開発者権限、読み取り専用権限|
|開発チーム リーダー|管理者権限、開発者権限、読み取り専用権限|
|開発チーム メンバー|開発者権限、読み取り専用権限|
|経理担当者|読み取り専用権限|

下記のように、必要な人に必要なだけの権限を付与し、AWSの操作を行えるようにしました。

IAM UserのID/PWやMFAを利用して、AWSへサインインしますが、このIAM Userも減らせそうですね。
別のIDプロバイダーの情報を利用して、AWSへサインインできるようになれば、IAM Userの管理コストも減らせそうです。

シングルサインオンを導入し、IAM Userの数を必要最低限にする
クラッソーネでは正社員のクルーは、Google Workspacesのアカウントを所持しています。
こちらのアカウントを利用して、AWSへシングルサインオンできるようにしてみました🙋

Google Workspacesアカウントを持っているクルーは、Google アプリ 一覧から Amazon Web Service を選択し、クラッソーネのAWSアカウントへSSOできるようになります。

SSOできる方のIAM Userは不要になるため、IAM Userの整理を行いました。
また、SSOした時点・IAM Userにサインインした時点では、読み取り専用の権限に限定しています。
これにより、不用意にIAM Userの秘匿情報が漏洩するリスク、漏洩しても即座に破壊的な変更を実行させにくい体制に変更できました🙌

結果
今回の取り組みで、以下の点を実施できました。
IAM Userの数を、必要最低限にできた
役割に応じて、必要な権限を割り当てることができた
AWSへのサインインや権限の変更を簡単に行えるようにした

IAMの運用や構成は、事業のフェーズや開発組織の規模によって、ベストプラクティスは変わっていくると考えています。
今回は、将来の事業や組織の拡大を見据えつつ、セキュリティ強化も兼ねて実施しました。

さらに発展、改善する余地は、まだまだあると考えていますので、他社さんとも積極的に情報交換したいと思っています✨

おわりに

クラッソーネでは、プロダクトとチームの双方をより良く改善していけるエンジニアを募集中です！

https://www.crassone.co.jp/recruit/engineer/

シンプルかつセキュアなIAMの運用へ移行した話

<p>こんにちは、大胸筋の育成に励んでいる、SREチームの宮原（<a href="https://twitter.com/TakashiMiyahara" rel="nofollow">@TakashiMiyahara</a>）です🙋<br>
今日は、GitHub Actionsによる<code>tfsec</code>の実行時間を大幅に改善できたTipsを紹介したいと思います。</p>
<h2 id="tfsec%E3%81%A8%E3%81%AF%EF%BC%9F"><a class="header-anchor-link" href="#tfsec%E3%81%A8%E3%81%AF%EF%BC%9F" rel="nofollow"></a> tfsecとは？</h2>
<p><a href="https://aquasecurity.github.io/tfsec/" rel="nofollow">tfsec</a>は、Terraform向けの静的解析ツールです。<br>
実装内容がセキュリティ的にベストプラクティスに沿っているかなどを指摘してくれるため、Terraformでコードを書く方には強く導入をおすすめします。</p>
<p>tfsecに関しては、<a href="https://qiita.com/reireias" rel="nofollow">@reireiasさん</a>が詳しく紹介してくれていますので、下記の記事も併せて確認いただければと思います✨<br style="display: none">
<div class="embed-zenn-link"><iframe src="https://card.zenn.dev/?url=https%3A%2F%2Fqiita.com%2Freireias%2Fitems%2F71671cc516424421f7f3" frameborder="0" scrolling="no" loading="lazy"></iframe></div><a href="https://qiita.com/reireias/items/71671cc516424421f7f3" style="display: none" rel="nofollow">https://qiita.com/reireias/items/71671cc516424421f7f3</a></p>
<h2 id="ci%E3%81%A7%E5%AE%9F%E8%A1%8C%E3%81%99%E3%82%8B%E3%81%AB%E3%81%AF"><a class="header-anchor-link" href="#ci%E3%81%A7%E5%AE%9F%E8%A1%8C%E3%81%99%E3%82%8B%E3%81%AB%E3%81%AF" rel="nofollow"></a> CIで実行するには</h2>
<p>tfsecを実行してくれるGitHub Actionsはいくつか公開されております。</p>
<p><img src="/images/posts/how_tfsec-pr-commenter-action_was_introduced_to_significantly_reduce_the_execution_time_of_terraform_security_scans/tfsec-actions.png" alt="tfsec-actions"></p>
<p>クラッソーネでは、<a href="https://github.com/triat/terraform-security-scan" rel="nofollow">terraform-security-scan</a>を利用して、Pull Request作成時にtfsecを実行していました🙋</p>
<p>現在は、<a href="https://github.com/aquasecurity/tfsec-pr-commenter-action" rel="nofollow">tfsec-pr-commenter-action</a>を利用しています。</p>
<h2 id="terraform-security-scan%E3%82%92%E5%88%A9%E7%94%A8%E3%81%97%E3%81%9F%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC%E3%81%AE%E8%AA%B2%E9%A1%8C"><a class="header-anchor-link" href="#terraform-security-scan%E3%82%92%E5%88%A9%E7%94%A8%E3%81%97%E3%81%9F%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC%E3%81%AE%E8%AA%B2%E9%A1%8C" rel="nofollow"></a> terraform-security-scanを利用したワークフローの課題</h2>
<p><code>terraform-security-scan</code>の実行に90~150秒ほど要していることが、ワークフローの課題になっていました。</p>
<p><img src="/images/posts/how_tfsec-pr-commenter-action_was_introduced_to_significantly_reduce_the_execution_time_of_terraform_security_scans/tfsec-slow.png" alt="tfsec-slow"></p>
<p>ワークフローの速度が改善できれば、Pull Requestのコードレビューまでに時間も短縮でき、より早く新しい機能などを開発チームやユーザー様に提供できます。<br>
このために、高速化する手がかりがないかActionの実装を調べていました。</p>
<h2 id="tfsec-pr-commenter-action%E3%81%A8%E3%81%AE%E5%87%BA%E4%BC%9A%E3%81%84"><a class="header-anchor-link" href="#tfsec-pr-commenter-action%E3%81%A8%E3%81%AE%E5%87%BA%E4%BC%9A%E3%81%84" rel="nofollow"></a> tfsec-pr-commenter-actionとの出会い</h2>
<p>ふと<code>terraform-security-scan</code>の<a href="https://github.com/triat/terraform-security-scan/blob/6d991b2a612a44fb3068cc74ff51323dcdf99658/README.md" rel="nofollow">README</a>を確認すると、以下のようなインフォメーションを発見し、<code>tfsec-pr-commenter-action</code>の存在を知りました。</p>
<p><img src="/images/posts/how_tfsec-pr-commenter-action_was_introduced_to_significantly_reduce_the_execution_time_of_terraform_security_scans/terraform-security-scan-readme-warning.png" alt="terraform-security-scan-readme-warning"></p>
<p><code>tfsec-pr-commenter-action</code>は、tfsecを開発・メンテナンスしている <a href="https://www.aquasec.com/" rel="nofollow">Aqua Security</a>社が開発しているActionのようです。<br>
<code>tfsec</code>の開発元がリリースしているActionなら、もしかして高速に動作するかも？と淡い期待を胸に、それぞれActionを利用するワークフローを実装し、実行時間や使用感などを比較してみました🙋</p>
<h2 id="%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC%E3%81%AE%E5%AE%9F%E8%A3%85%E4%BE%8B"><a class="header-anchor-link" href="#%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC%E3%81%AE%E5%AE%9F%E8%A3%85%E4%BE%8B" rel="nofollow"></a> ワークフローの実装例</h2>
<p><code>terraform-security-scan</code>と<code>tfsec-pr-commenter-action</code>、それぞれのワークフローの実装例を以下の通りです。</p>
<h3 id="terraform-security-scan%E3%82%92%E5%88%A9%E7%94%A8%E3%81%99%E3%82%8B%E5%A0%B4%E5%90%88%E3%81%AE%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC"><a class="header-anchor-link" href="#terraform-security-scan%E3%82%92%E5%88%A9%E7%94%A8%E3%81%99%E3%82%8B%E5%A0%B4%E5%90%88%E3%81%AE%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC" rel="nofollow"></a> <code>terraform-security-scan</code>を利用する場合のワークフロー</h3>

      <div class="code-block-container">
        
        <pre class="language-yml"><code class="language-yml"><span class="token key atrule">name</span><span class="token punctuation">:</span> tfsec

<span class="token key atrule">on</span><span class="token punctuation">:</span>
  <span class="token key atrule">pull_request</span><span class="token punctuation">:</span>
    <span class="token key atrule">types</span><span class="token punctuation">:</span> <span class="token punctuation">[</span>synchronize<span class="token punctuation">,</span> opened<span class="token punctuation">]</span>
    <span class="token key atrule">paths</span><span class="token punctuation">:</span>
      <span class="token punctuation">-</span> <span class="token string">"dev/**"</span>

<span class="token key atrule">jobs</span><span class="token punctuation">:</span>
  <span class="token key atrule">tfsec</span><span class="token punctuation">:</span>
    <span class="token key atrule">runs-on</span><span class="token punctuation">:</span> ubuntu<span class="token punctuation">-</span>latest
    <span class="token key atrule">steps</span><span class="token punctuation">:</span>
      <span class="token punctuation">-</span> <span class="token key atrule">name</span><span class="token punctuation">:</span> Clone repo
        <span class="token key atrule">uses</span><span class="token punctuation">:</span> actions/checkout@master
      <span class="token punctuation">-</span> <span class="token key atrule">name</span><span class="token punctuation">:</span> Terraform security scan
        <span class="token key atrule">uses</span><span class="token punctuation">:</span> triat/terraform<span class="token punctuation">-</span>security<span class="token punctuation">-</span>scan@master
        <span class="token key atrule">with</span><span class="token punctuation">:</span>
          <span class="token key atrule">tfsec_actions_working_dir</span><span class="token punctuation">:</span> dev
        <span class="token key atrule">env</span><span class="token punctuation">:</span>
          <span class="token key atrule">GITHUB_TOKEN</span><span class="token punctuation">:</span> $<span class="token punctuation">{</span><span class="token punctuation">{</span> secrets.GITHUB_TOKEN <span class="token punctuation">}</span><span class="token punctuation">}</span>
</code></pre>

      </div>
      <h3 id="tfsec-pr-commenter-action%E3%82%92%E5%88%A9%E7%94%A8%E3%81%99%E3%82%8B%E5%A0%B4%E5%90%88%E3%81%AE%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC"><a class="header-anchor-link" href="#tfsec-pr-commenter-action%E3%82%92%E5%88%A9%E7%94%A8%E3%81%99%E3%82%8B%E5%A0%B4%E5%90%88%E3%81%AE%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC" rel="nofollow"></a> <code>tfsec-pr-commenter-action</code>を利用する場合のワークフロー</h3>

      <div class="code-block-container">
        
        <pre class="language-yml"><code class="language-yml"><span class="token key atrule">name</span><span class="token punctuation">:</span> tfsec

<span class="token key atrule">on</span><span class="token punctuation">:</span>
  <span class="token key atrule">pull_request</span><span class="token punctuation">:</span>
    <span class="token key atrule">types</span><span class="token punctuation">:</span> <span class="token punctuation">[</span>synchronize<span class="token punctuation">,</span> opened<span class="token punctuation">]</span>
    <span class="token key atrule">paths</span><span class="token punctuation">:</span>
      <span class="token punctuation">-</span> <span class="token string">"dev/**"</span>

<span class="token key atrule">jobs</span><span class="token punctuation">:</span>
  <span class="token key atrule">tfsec</span><span class="token punctuation">:</span>
    <span class="token key atrule">runs-on</span><span class="token punctuation">:</span> ubuntu<span class="token punctuation">-</span>latest
    <span class="token key atrule">steps</span><span class="token punctuation">:</span>
      <span class="token punctuation">-</span> <span class="token key atrule">name</span><span class="token punctuation">:</span> Clone repo
        <span class="token key atrule">uses</span><span class="token punctuation">:</span> actions/checkout@master
      <span class="token punctuation">-</span> <span class="token key atrule">name</span><span class="token punctuation">:</span> Terraform security scan
        <span class="token key atrule">uses</span><span class="token punctuation">:</span> tfsec/tfsec<span class="token punctuation">-</span>pr<span class="token punctuation">-</span>commenter<span class="token punctuation">-</span>action@main
        <span class="token key atrule">with</span><span class="token punctuation">:</span>
          <span class="token key atrule">working_directory</span><span class="token punctuation">:</span> dev
          <span class="token key atrule">github_token</span><span class="token punctuation">:</span> $<span class="token punctuation">{</span><span class="token punctuation">{</span> secrets.GITHUB_TOKEN <span class="token punctuation">}</span><span class="token punctuation">}</span>
</code></pre>

      </div>
      <h2 id="%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC%E3%81%AE%E5%AE%9F%E8%A1%8C%E6%99%82%E9%96%93"><a class="header-anchor-link" href="#%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC%E3%81%AE%E5%AE%9F%E8%A1%8C%E6%99%82%E9%96%93" rel="nofollow"></a> ワークフローの実行時間</h2>
<p><code>tfsec-pr-commenter-action</code>を利用するワークフローの方が高速であることがわかりました🙋</p>
<h3 id="before"><a class="header-anchor-link" href="#before" rel="nofollow"></a> Before</h3>
<blockquote>
<p><code>terraform-security-scan-comment</code>を利用してtfsecを実行した場合です。</p>
</blockquote>
<p><img src="/images/posts/how_tfsec-pr-commenter-action_was_introduced_to_significantly_reduce_the_execution_time_of_terraform_security_scans/tfsec_before.png" alt="tfsec_before"></p>
<h3 id="after"><a class="header-anchor-link" href="#after" rel="nofollow"></a> After</h3>
<blockquote>
<p><code>tfsec-pr-commenter-action</code>を利用してtfsecを実行した場合です。</p>
</blockquote>
<p><img src="/images/posts/how_tfsec-pr-commenter-action_was_introduced_to_significantly_reduce_the_execution_time_of_terraform_security_scans/tfsec_after.png" alt="tfsec_after"></p>
<h2 id="%E8%AD%A6%E5%91%8A%E3%81%8C%E3%81%82%E3%81%A3%E3%81%9F%E5%A0%B4%E5%90%88%E3%81%AE%E3%82%B3%E3%83%A1%E3%83%B3%E3%83%88%E4%BE%8B"><a class="header-anchor-link" href="#%E8%AD%A6%E5%91%8A%E3%81%8C%E3%81%82%E3%81%A3%E3%81%9F%E5%A0%B4%E5%90%88%E3%81%AE%E3%82%B3%E3%83%A1%E3%83%B3%E3%83%88%E4%BE%8B" rel="nofollow"></a> 警告があった場合のコメント例</h2>
<p>どちらのワークフローでも重要度やリファレンスのURLなどの情報が、Pull Requestにコメントされることがわかりました🙋</p>
<h3 id="before-2"><a class="header-anchor-link" href="#before-2" rel="nofollow"></a> Before</h3>
<blockquote>
<p><code>terraform-security-scan-comment</code>を利用してtfsecを実行した場合です。</p>
</blockquote>
<p><img src="/images/posts/how_tfsec-pr-commenter-action_was_introduced_to_significantly_reduce_the_execution_time_of_terraform_security_scans/terraform-security-scan-comment.png" alt="terraform-security-scan-comment"></p>
<h3 id="after-2"><a class="header-anchor-link" href="#after-2" rel="nofollow"></a> After</h3>
<blockquote>
<p><code>tfsec-pr-commenter-action</code>を利用してtfsecを実行した場合です。</p>
</blockquote>
<p><img src="/images/posts/how_tfsec-pr-commenter-action_was_introduced_to_significantly_reduce_the_execution_time_of_terraform_security_scans/tfsec-pr-commenter-action-comment.png" alt="tfsec-pr-commenter-action-comment"><br>
（reviewedとしてコメントされるため、指摘された行などが分かりやすいと感じました✨）</p>
<h2 id="%E3%81%BE%E3%81%A8%E3%82%81"><a class="header-anchor-link" href="#%E3%81%BE%E3%81%A8%E3%82%81" rel="nofollow"></a> まとめ</h2>
<p><code>tfsec-pr-commenter-action</code>は、<code>terraform-security-scan</code>よりも<strong>高速</strong>にtfsecを実行できるため、「ワークフローの実行時間を改善したい」という課題を解決できることが分かりました🙌<br>
GitHub Actionsで<code>tfsec</code>を実行する際には、<code>tfsec-pr-commenter-action</code>を利用すると、より心地よく開発できるようになると思います！<br>
ぜひ、活用してみてください🙋</p>
<h2 id="%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB"><a class="header-anchor-link" href="#%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB" rel="nofollow"></a> おわりに</h2>
<p>クラッソーネでは、プロダクトとチームの双方をより良く改善していけるエンジニアを募集中です！</p>
<p><div class="embed-zenn-link"><iframe src="https://card.zenn.dev/?url=https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></div><a href="https://www.crassone.co.jp/recruit/engineer/" style="display: none" rel="nofollow">https://www.crassone.co.jp/recruit/engineer/</a></p>



こんにちは、大胸筋の育成に励んでいる、SREチームの宮原（@TakashiMiyahara）です🙋
今日は、GitHub Actionsによるtfsecの実行時間を大幅に改善できたTipsを紹介したいと思います。

tfsecとは？
tfsecは、Terraform向けの静的解析ツールです。
実装内容がセキュリティ的にベストプラクティスに沿っているかなどを指摘してくれるため、Terraformでコードを書く方には強く導入をおすすめします。

tfsecに関しては、@reireiasさんが詳しく紹介してくれていますので、下記の記事も併せて確認いただければと思います✨
https://qiita.com/reireias/items/71671cc516424421f7f3

CIで実行するには
tfsecを実行してくれるGitHub Actionsはいくつか公開されております。

tfsec-actions

クラッソーネでは、terraform-security-scanを利用して、Pull Request作成時にtfsecを実行していました🙋

現在は、tfsec-pr-commenter-actionを利用しています。

terraform-security-scanを利用したワークフローの課題
terraform-security-scanの実行に90~150秒ほど要していることが、ワークフローの課題になっていました。

tfsec-slow

ワークフローの速度が改善できれば、Pull Requestのコードレビューまでに時間も短縮でき、より早く新しい機能などを開発チームやユーザー様に提供できます。
このために、高速化する手がかりがないかActionの実装を調べていました。

tfsec-pr-commenter-actionとの出会い
ふとterraform-security-scanのREADMEを確認すると、以下のようなインフォメーションを発見し、tfsec-pr-commenter-actionの存在を知りました。

terraform-security-scan-readme-warning

tfsec-pr-commenter-actionは、tfsecを開発・メンテナンスしている Aqua Security社が開発しているActionのようです。
tfsecの開発元がリリースしているActionなら、もしかして高速に動作するかも？と淡い期待を胸に、それぞれActionを利用するワークフローを実装し、実行時間や使用感などを比較してみました🙋

ワークフローの実装例
terraform-security-scanとtfsec-pr-commenter-action、それぞれのワークフローの実装例を以下の通りです。

terraform-security-scanを利用する場合のワークフロー
name: tfsec

on:
  pull_request:
    types: [synchronize, opened]
    paths:
      "dev/**"

jobs:
  tfsec:
    runs-on: ubuntu-latest
    steps:
      name: Clone repo
        uses: actions/checkout@master
      name: Terraform security scan
        uses: triat/terraform-security-scan@master
        with:
          tfsecactionsworking_dir: dev
        env:
          GITHUBTOKEN: ${{ secrets.GITHUBTOKEN }}

tfsec-pr-commenter-actionを利用する場合のワークフロー
name: tfsec

on:
  pull_request:
    types: [synchronize, opened]
    paths:
      "dev/**"

jobs:
  tfsec:
    runs-on: ubuntu-latest
    steps:
      name: Clone repo
        uses: actions/checkout@master
      name: Terraform security scan
        uses: tfsec/tfsec-pr-commenter-action@main
        with:
          working_directory: dev
          githubtoken: ${{ secrets.GITHUBTOKEN }}

ワークフローの実行時間
tfsec-pr-commenter-actionを利用するワークフローの方が高速であることがわかりました🙋

Before
> terraform-security-scan-commentを利用してtfsecを実行した場合です。

tfsec_before

After
> tfsec-pr-commenter-actionを利用してtfsecを実行した場合です。

tfsec_after

警告があった場合のコメント例
どちらのワークフローでも重要度やリファレンスのURLなどの情報が、Pull Requestにコメントされることがわかりました🙋

Before
> terraform-security-scan-commentを利用してtfsecを実行した場合です。

terraform-security-scan-comment

After
> tfsec-pr-commenter-actionを利用してtfsecを実行した場合です。

tfsec-pr-commenter-action-comment
（reviewedとしてコメントされるため、指摘された行などが分かりやすいと感じました✨）

まとめ
tfsec-pr-commenter-actionは、terraform-security-scanよりも高速にtfsecを実行できるため、「ワークフローの実行時間を改善したい」という課題を解決できることが分かりました🙌
GitHub Actionsでtfsecを実行する際には、tfsec-pr-commenter-actionを利用すると、より心地よく開発できるようになると思います！
ぜひ、活用してみてください🙋

おわりに

クラッソーネでは、プロダクトとチームの双方をより良く改善していけるエンジニアを募集中です！

https://www.crassone.co.jp/recruit/engineer/


tfsec-pr-commenter-actionを導入して、terraformのセキュリティスキャンの実行時間を大幅に短縮した話

<p>こんにちは、最近 リングフィットアドベンチャー で レベル100 になった、SREチームの宮原（<a href="https://twitter.com/TakashiMiyahara" rel="nofollow">@TakashiMiyahara</a>）です🙋</p>
<p>SREチームでは、<a href="https://www.terraform.io/" rel="nofollow">Terraform</a>によるインフラのコード化を進めています。<br>
既存のリソースをTerraform管理下に置く場合は、<a href="https://www.terraform.io/cli/commands/import" rel="nofollow">importコマンド</a>を利用して、リソースの情報を<code>terraform.state</code>に取り込むことが多いのではないでしょうか。</p>
<p>先日、CloudWatch Dashboardのインポート作業中に、<a href="https://registry.terraform.io/providers/hashicorp/aws/4.11.0/docs/resources/cloudwatch_dashboard" rel="nofollow">aws_cloudwatch_dashboard</a> のドキュメントに不備を見つけ、パッチを送ったところ、初めてマージされました🙌<br>
ここでは、パッチがマージされるまでの経緯をお伝えします。</p>
<h2 id="%E7%99%BA%E8%A6%8B%E3%81%97%E3%81%9F%E3%83%89%E3%82%AD%E3%83%A5%E3%83%A1%E3%83%B3%E3%83%88%E3%81%AE%E4%B8%8D%E5%82%99"><a class="header-anchor-link" href="#%E7%99%BA%E8%A6%8B%E3%81%97%E3%81%9F%E3%83%89%E3%82%AD%E3%83%A5%E3%83%A1%E3%83%B3%E3%83%88%E3%81%AE%E4%B8%8D%E5%82%99" rel="nofollow"></a> 発見したドキュメントの不備</h2>
<blockquote>
<p>terraform import [options] ADDRESS ID</p>
</blockquote>
<p>importコマンドは、上記のような構造になっているのですが、ドキュメントの例では <code>ID</code> に該当する箇所が表示されていませんでした。<br>
<img src="/images/posts/miyahara_is_first_contribution_to_terraform-provider-aws/before.png" alt="report_an_issue"></p>
<h2 id="%E5%A0%B1%E5%91%8A%E6%96%B9%E6%B3%95"><a class="header-anchor-link" href="#%E5%A0%B1%E5%91%8A%E6%96%B9%E6%B3%95" rel="nofollow"></a> 報告方法</h2>
<p>不備を見つけたので、 <code>HashiCorp AWS Provider team</code> へ報告します。<br>
Terraformのドキュメントページには、<a href="https://github.com/hashicorp/terraform-provider-aws/issues" rel="nofollow">Report an Issue</a>というリンクが用意されています。<br>
（ドキュメントページから、Repositoryへの導線が分かりやすくて、とても良い開発者体験でした✨）</p>
<p><img src="/images/posts/miyahara_is_first_contribution_to_terraform-provider-aws/report_an_issue.png" alt="report_an_issue"></p>
<h2 id="%E8%B5%B7%E7%A5%A8%E3%81%97%E3%81%9Fissue"><a class="header-anchor-link" href="#%E8%B5%B7%E7%A5%A8%E3%81%97%E3%81%9Fissue" rel="nofollow"></a> 起票したissue</h2>
<p>実際に起票したissueはこちらになります。<br style="display: none">
<div class="embed-zenn-link"><iframe src="https://card.zenn.dev/?url=https%3A%2F%2Fgithub.com%2Fhashicorp%2Fterraform-provider-aws%2Fissues%2F24355" frameborder="0" scrolling="no" loading="lazy"></iframe></div><a href="https://github.com/hashicorp/terraform-provider-aws/issues/24355" style="display: none" rel="nofollow">https://github.com/hashicorp/terraform-provider-aws/issues/24355</a></p>
<p>New issue &gt; Bug Report を選択して、issueを作りました🙋<br>
<img src="/images/posts/miyahara_is_first_contribution_to_terraform-provider-aws/new_issues_bug_report.png" alt="new_issues_bug_report"></p>
<p>issueのdescriptionに、本件を修正する場合のdiffを書いていたこともあり、<a href="https://github.com/DrFaust92" rel="nofollow">DrFaust92</a>さんから、「PR is appreciated!」というメンションを頂いたので、早速PR作成に取り掛かりました😁</p>
<h2 id="%E4%BD%9C%E6%88%90%E3%81%97%E3%81%9F%E3%83%91%E3%83%83%E3%83%81"><a class="header-anchor-link" href="#%E4%BD%9C%E6%88%90%E3%81%97%E3%81%9F%E3%83%91%E3%83%83%E3%83%81" rel="nofollow"></a> 作成したパッチ</h2>
<p>修正対応のPRはこちらです。<br style="display: none">
<div class="embed-zenn-link"><iframe src="https://card.zenn.dev/?url=https%3A%2F%2Fgithub.com%2Fhashicorp%2Fterraform-provider-aws%2Fpull%2F24373" frameborder="0" scrolling="no" loading="lazy"></iframe></div><a href="https://github.com/hashicorp/terraform-provider-aws/pull/24373" style="display: none" rel="nofollow">https://github.com/hashicorp/terraform-provider-aws/pull/24373</a></p>
<p>DrFaust92さん、メンテナーの<a href="https://github.com/ewbankkit" rel="nofollow">ewbankkit</a>さんにレビューいただいて、無事マージされました🙌<br>
コミュニティに迎え入れてくれたメンテナーの皆様、ありがとうございます✨</p>
<blockquote>
<p>2022年4月28日に、<a href="https://github.com/hashicorp/terraform-provider-aws/tree/v4.12.0" rel="nofollow">v4.12.0</a>がリリースされました。<br>
このバージョンから、<a href="https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/cloudwatch_dashboard#import" rel="nofollow">importコマンド</a> の例が修正されてます🙋</p>
</blockquote>
<h2 id="%E6%84%9F%E6%83%B3"><a class="header-anchor-link" href="#%E6%84%9F%E6%83%B3" rel="nofollow"></a> 感想</h2>
<p>業務で使用しているOSSをメンテナンスするのは業務の延長線上にあると考えてます。<br>
今回は、簡単なドキュメントの一部修正でしたが、Terraformのコードの変更・修正にも積極的に参加していきたいと思いました！</p>
<h2 id="%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB"><a class="header-anchor-link" href="#%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB" rel="nofollow"></a> おわりに</h2>
<p>クラッソーネでは、プロダクトとチームの双方をより良く改善していけるエンジニアを募集中です！</p>
<p><div class="embed-zenn-link"><iframe src="https://card.zenn.dev/?url=https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></div><a href="https://www.crassone.co.jp/recruit/engineer/" style="display: none" rel="nofollow">https://www.crassone.co.jp/recruit/engineer/</a></p>



こんにちは、最近 リングフィットアドベンチャー で レベル100 になった、SREチームの宮原（@TakashiMiyahara）です🙋

SREチームでは、Terraformによるインフラのコード化を進めています。
既存のリソースをTerraform管理下に置く場合は、importコマンドを利用して、リソースの情報をterraform.stateに取り込むことが多いのではないでしょうか。

先日、CloudWatch Dashboardのインポート作業中に、awscloudwatchdashboard のドキュメントに不備を見つけ、パッチを送ったところ、初めてマージされました🙌
ここでは、パッチがマージされるまでの経緯をお伝えします。

発見したドキュメントの不備
> terraform import [options] ADDRESS ID

importコマンドは、上記のような構造になっているのですが、ドキュメントの例では ID に該当する箇所が表示されていませんでした。
reportanissue

報告方法
不備を見つけたので、 HashiCorp AWS Provider team へ報告します。
Terraformのドキュメントページには、Report an Issueというリンクが用意されています。
（ドキュメントページから、Repositoryへの導線が分かりやすくて、とても良い開発者体験でした✨）

reportanissue

起票したissue
実際に起票したissueはこちらになります。
https://github.com/hashicorp/terraform-provider-aws/issues/24355

New issue > Bug Report を選択して、issueを作りました🙋
newissuesbug_report

issueのdescriptionに、本件を修正する場合のdiffを書いていたこともあり、DrFaust92さんから、「PR is appreciated!」というメンションを頂いたので、早速PR作成に取り掛かりました😁

作成したパッチ
修正対応のPRはこちらです。
https://github.com/hashicorp/terraform-provider-aws/pull/24373

DrFaust92さん、メンテナーのewbankkitさんにレビューいただいて、無事マージされました🙌
コミュニティに迎え入れてくれたメンテナーの皆様、ありがとうございます✨

>2022年4月28日に、v4.12.0がリリースされました。
>このバージョンから、importコマンド の例が修正されてます🙋

感想
業務で使用しているOSSをメンテナンスするのは業務の延長線上にあると考えてます。
今回は、簡単なドキュメントの一部修正でしたが、Terraformのコードの変更・修正にも積極的に参加していきたいと思いました！

おわりに

クラッソーネでは、プロダクトとチームの双方をより良く改善していけるエンジニアを募集中です！

https://www.crassone.co.jp/recruit/engineer/

terraform-provider-awsに初めてコントリビュートした話

<p>こんにちは、最近プロダクトマネージャーに入門している宮原です🙋<br>
2022年1月から株式会社クラッソーネ プロダクト開発部にJoinしました🙌<br>
本エントリでは、SREチーム立ち上げと、その中で大活躍している<code>Github Projects（beta）を利用したタスク管理</code> についてご紹介します。</p>
<h2 id="%E3%81%93%E3%82%8C%E3%81%BE%E3%81%A7%E4%BD%95%E3%82%92%E3%81%97%E3%81%A6%E3%81%8D%E3%81%9F%E3%81%AE%E3%81%8B"><a class="header-anchor-link" href="#%E3%81%93%E3%82%8C%E3%81%BE%E3%81%A7%E4%BD%95%E3%82%92%E3%81%97%E3%81%A6%E3%81%8D%E3%81%9F%E3%81%AE%E3%81%8B" rel="nofollow"></a> これまで何をしてきたのか</h2>
<blockquote>
<ul>
<li>学部〜修士：信号処理やComputer Visionを学び、Human Computer Interactionの研究に従事</li>
<li>1社目(新卒)：電機メーカー子会社の生産技術部門にて、画像検査やロボット制御などの開発を担当</li>
<li>2社目：ヘルステックベンチャーにて、Ruby on Rails で医師向けコミュニティサイトの開発</li>
</ul>
</blockquote>
<p>ハードウェア制御やWebアプリケーション開発・インフラ構築などを行なってきました。</p>
<h2 id="%E3%81%A9%E3%82%93%E3%81%AA%E3%81%93%E3%81%A8%E3%82%92%E3%81%97%E3%81%A6%E3%81%84%E3%82%8B%E3%81%AE%E3%81%8B"><a class="header-anchor-link" href="#%E3%81%A9%E3%82%93%E3%81%AA%E3%81%93%E3%81%A8%E3%82%92%E3%81%97%E3%81%A6%E3%81%84%E3%82%8B%E3%81%AE%E3%81%8B" rel="nofollow"></a> どんなことをしているのか</h2>
<p>0→1でSREチームを立ち上げています🙋</p>
<h3 id="%E5%85%A5%E7%A4%BE%E5%BE%8C%E3%81%AB%E8%A1%8C%E3%81%A3%E3%81%9F%E3%81%93%E3%81%A8"><a class="header-anchor-link" href="#%E5%85%A5%E7%A4%BE%E5%BE%8C%E3%81%AB%E8%A1%8C%E3%81%A3%E3%81%9F%E3%81%93%E3%81%A8" rel="nofollow"></a> 入社後に行ったこと</h3>
<ul>
<li>既存のCI/CDやAWS等のリソースの把握</li>
<li>SREチームの開発スプリント決めやカンバン作成</li>
<li>SREチームのレビューフローの構築</li>
<li>インシデントレベルやオンコール対応フローの検討</li>
<li>IaCを実現するためのツール選定</li>
<li>プロダクトごとのダッシュボードをDatadogに整備</li>
</ul>
<h2 id="github-projects-(beta)%E3%82%92%E5%88%A9%E7%94%A8%E3%81%97%E3%81%9F%E3%82%BF%E3%82%B9%E3%82%AF%E7%AE%A1%E7%90%86"><a class="header-anchor-link" href="#github-projects-(beta)%E3%82%92%E5%88%A9%E7%94%A8%E3%81%97%E3%81%9F%E3%82%BF%E3%82%B9%E3%82%AF%E7%AE%A1%E7%90%86" rel="nofollow"></a> Github Projects (beta)を利用したタスク管理</h2>
<p>SREチームでは、<code>Github Projects (beta)</code>を利用してタスク管理を行なっています。<br>
以下のように、実際の開発ではGithubで完結しております。</p>
<ul>
<li>大枠のタスクをMilestoneに登録</li>
<li>細かな粒度のタスクをIssuesに登録しMilestoneと紐付け</li>
<li>Projectsにカンバンボードを作成しIssuesを管理</li>
<li>Issueに対応するPull Requestを作成</li>
</ul>
<p><code>Github Projects</code> では行えなかったストーリーポイントの設定や、イテレーションの管理などが行えるようになっており、より便利にGithub上でタスクの進捗管理が行えそうなため導入してみました🙌</p>
<h3 id="field"><a class="header-anchor-link" href="#field" rel="nofollow"></a> Field</h3>
<p>利用できるFieldは、LabelsやMilestoneだけじゃなく、独自のFieldを追加できます。<br>
Issueをいつ対応したのかを管理するために、Iteration Fieldを追加してみました。</p>
<ol>
<li>レイアウトをTableに変更</li>
<li>ヘッダー右端の<code>+</code>アイコンを選択</li>
<li><code>New field</code>を選択</li>
<li><code>Iteration</code>を選択</li>
<li>開始日と間隔を入力</li>
</ol>
<table>
<thead>
<tr>
<th>手順</th>
<th>画像</th>
</tr>
</thead>
<tbody>
<tr>
<td>3</td>
<td><img src="/images/posts/entry-miyahara/new_field.png" alt="新しいfieldの追加"></td>
</tr>
<tr>
<td>4</td>
<td><img src="/images/posts/entry-miyahara/select_type.png" alt="fieldの種類の選択肢"></td>
</tr>
<tr>
<td>5</td>
<td><img src="/images/posts/entry-miyahara/set_iteration.png" alt="Iterationの設定"></td>
</tr>
</tbody>
</table>
<h3 id="views"><a class="header-anchor-link" href="#views" rel="nofollow"></a> Views</h3>
<p>Milestone・Status・Iterationなど、まとめたいFieldごとのViewを作成しています。</p>
<h3 id="milestone-view"><a class="header-anchor-link" href="#milestone-view" rel="nofollow"></a> Milestone View</h3>
<p><img src="/images/posts/entry-miyahara/milestone.png" alt="Milestoneボード"></p>
<h3 id="status-view"><a class="header-anchor-link" href="#status-view" rel="nofollow"></a> Status View</h3>
<p><img src="/images/posts/entry-miyahara/status.png" alt="Statusボード"></p>
<h3 id="iteration-view"><a class="header-anchor-link" href="#iteration-view" rel="nofollow"></a> Iteration View</h3>
<p>独自のFieldとして追加したIteration fieldでグルーピングも行えます。<br>
現在のIterationには <code>Current</code> と表示され、見つけやすいです。<br>
<img src="/images/posts/entry-miyahara/iteration.png" alt="Iterationボード"></p>
<h2 id="%E3%81%93%E3%81%BC%E3%82%8C%E8%A9%B1"><a class="header-anchor-link" href="#%E3%81%93%E3%81%BC%E3%82%8C%E8%A9%B1" rel="nofollow"></a> こぼれ話</h2>
<p>みなさま、<code>Githubアカウント</code> 及び <code>Organization</code> の多要素認証はお済みでしょうか？<br>
先日、クラッソーネのOrganizationに対して多要素認証を必須にする変更を実施しました🙋</p>
<blockquote>
<p>僕『これでOrganizationがよりセキュアになったな (　-`ω-)✧ﾄﾞﾔｯ』<br>
.<br>
.<br>
.<br>
メンバー『どなたか権限のある方クラッソーネのorganizationに私を招待していただけないでしょうか...😢』<br>
.<br>
.<br>
.<br>
僕『ごめんなさい〜😱』</p>
</blockquote>
<p>多要素認証が未設定だったメンバーがOrganizationから外れてしまうという事象が発生しました。</p>
<p>Organizations &gt; settings &gt; Authentication security &gt; Two-factor authentication に、以下のような記述があります。</p>
<blockquote>
<p>Members, billing managers, and outside collaborators who do not have two-factor authentication enabled for their personal account will be removed from the organization and will receive an email notifying them about the change.</p>
</blockquote>
<p>実施前に、注意書きを流し読みしなければ防げた問題でした💦<br>
多要素認証を実施することでセキュアになりますが、勢いで対応すると僕のようになりますので、みなさまお気をつけください。<br>
（「同じことは失敗はしないぞ」という不退転の決意を込めて、こちらに残しました）</p>
<h2 id="%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB"><a class="header-anchor-link" href="#%E3%81%8A%E3%82%8F%E3%82%8A%E3%81%AB" rel="nofollow"></a> おわりに</h2>
<p>SREチーム立ち上げの取り組みとしてご紹介するTipsは、沢山ございます！<br>
次回は、DatadogのNotebookに障害調査方法をまとめるTipsについてご紹介したいと思います🙋</p>
<p>クラッソーネでは一緒に働く仲間を募集しています🙌<br>
一緒に日本の空き家問題にエンジニアリングで参加してみませんか？<br>
ご応募をお待ちしております！</p>
<p><div class="embed-zenn-link"><iframe src="https://card.zenn.dev/?url=https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></div><a href="https://www.crassone.co.jp/recruit/engineer/" style="display: none" rel="nofollow">https://www.crassone.co.jp/recruit/engineer/</a></p>
<h2 id="%E5%8F%82%E8%80%83%E6%96%87%E7%8C%AE"><a class="header-anchor-link" href="#%E5%8F%82%E8%80%83%E6%96%87%E7%8C%AE" rel="nofollow"></a> 参考文献</h2>
<ul>
<li><a href="https://en.wikipedia.org/wiki/Computer_vision" rel="nofollow">Computer Vision</a></li>
<li><a href="https://en.wikipedia.org/wiki/Human%E2%80%93computer_interaction" rel="nofollow">Human Computer Interaction</a></li>
<li><a href="https://docs.github.com/ja/issues/trying-out-the-new-projects-experience/about-projects" rel="nofollow">Github Projects (beta)</a></li>
</ul>



こんにちは、最近プロダクトマネージャーに入門している宮原です🙋
2022年1月から株式会社クラッソーネ プロダクト開発部にJoinしました🙌
本エントリでは、SREチーム立ち上げと、その中で大活躍しているGithub Projects（beta）を利用したタスク管理 についてご紹介します。

これまで何をしてきたのか

> - 学部〜修士：信号処理やComputer Visionを学び、Human Computer Interactionの研究に従事
> - 1社目(新卒)：電機メーカー子会社の生産技術部門にて、画像検査やロボット制御などの開発を担当
> - 2社目：ヘルステックベンチャーにて、Ruby on Rails で医師向けコミュニティサイトの開発

ハードウェア制御やWebアプリケーション開発・インフラ構築などを行なってきました。

どんなことをしているのか

0→1でSREチームを立ち上げています🙋

入社後に行ったこと
既存のCI/CDやAWS等のリソースの把握
SREチームの開発スプリント決めやカンバン作成
SREチームのレビューフローの構築
インシデントレベルやオンコール対応フローの検討
IaCを実現するためのツール選定
プロダクトごとのダッシュボードをDatadogに整備

Github Projects (beta)を利用したタスク管理
SREチームでは、Github Projects (beta)を利用してタスク管理を行なっています。
以下のように、実際の開発ではGithubで完結しております。

大枠のタスクをMilestoneに登録
細かな粒度のタスクをIssuesに登録しMilestoneと紐付け
Projectsにカンバンボードを作成しIssuesを管理
Issueに対応するPull Requestを作成

Github Projects では行えなかったストーリーポイントの設定や、イテレーションの管理などが行えるようになっており、より便利にGithub上でタスクの進捗管理が行えそうなため導入してみました🙌

Field
利用できるFieldは、LabelsやMilestoneだけじゃなく、独自のFieldを追加できます。
Issueをいつ対応したのかを管理するために、Iteration Fieldを追加してみました。

レイアウトをTableに変更
ヘッダー右端の+アイコンを選択
New fieldを選択
Iterationを選択
開始日と間隔を入力

|手順|画像|
|---|---|
|3|新しいfieldの追加|
|4|fieldの種類の選択肢|
|5|Iterationの設定|

Views
Milestone・Status・Iterationなど、まとめたいFieldごとのViewを作成しています。

Milestone View

Milestoneボード

Status View

Statusボード

Iteration View
独自のFieldとして追加したIteration fieldでグルーピングも行えます。
現在のIterationには Current と表示され、見つけやすいです。
Iterationボード

こぼれ話
みなさま、Githubアカウント 及び Organization の多要素認証はお済みでしょうか？
先日、クラッソーネのOrganizationに対して多要素認証を必須にする変更を実施しました🙋

> 僕『これでOrganizationがよりセキュアになったな (　-`ω-)✧ﾄﾞﾔｯ』
.
.
.
メンバー『どなたか権限のある方クラッソーネのorganizationに私を招待していただけないでしょうか...😢』
.
.
.
僕『ごめんなさい〜😱』

多要素認証が未設定だったメンバーがOrganizationから外れてしまうという事象が発生しました。

Organizations > settings > Authentication security > Two-factor authentication に、以下のような記述があります。

>Members, billing managers, and outside collaborators who do not have two-factor authentication enabled for their personal account will be removed from the organization and will receive an email notifying them about the change.

実施前に、注意書きを流し読みしなければ防げた問題でした💦
多要素認証を実施することでセキュアになりますが、勢いで対応すると僕のようになりますので、みなさまお気をつけください。
（「同じことは失敗はしないぞ」という不退転の決意を込めて、こちらに残しました）

おわりに

SREチーム立ち上げの取り組みとしてご紹介するTipsは、沢山ございます！
次回は、DatadogのNotebookに障害調査方法をまとめるTipsについてご紹介したいと思います🙋

クラッソーネでは一緒に働く仲間を募集しています🙌
一緒に日本の空き家問題にエンジニアリングで参加してみませんか？
ご応募をお待ちしております！

https://www.crassone.co.jp/recruit/engineer/

参考文献

Computer Vision
Human Computer Interaction
Github Projects (beta)


クラッソーネ開発者ブログ

宮原崇志が執筆した記事

クラッソーネに整地部が誕生したよ

シンプルかつセキュアなIAMの運用へ移行した話

tfsec-pr-commenter-actionを導入して、terraformのセキュリティスキャンの実行時間を大幅に短縮した話

terraform-provider-awsに初めてコントリビュートした話

クラッソーネに入社し、Github Projects（beta）を駆使してSREチームを立ち上げてる話

宮原 崇志が執筆した記事

クラッソーネに整地部が誕生したよ

シンプルかつセキュアなIAMの運用へ移行した話

tfsec-pr-commenter-actionを導入して、terraformのセキュリティスキャンの実行時間を大幅に短縮した話

terraform-provider-awsに初めてコントリビュートした話

クラッソーネに入社し、Github Projects（beta）を駆使してSREチームを立ち上げてる話

宮原崇志が執筆した記事