<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" aria-hidden="true" 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" aria-hidden="true" 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" aria-hidden="true" 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" aria-hidden="true" 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" aria-hidden="true" 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" aria-hidden="true" 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" aria-hidden="true" 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" aria-hidden="true" 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" aria-hidden="true" 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" aria-hidden="true" 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" aria-hidden="true" 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" aria-hidden="true" rel="nofollow"></a> Views</h3>
<p>Milestone・Status・Iterationなど、まとめたいFieldごとのViewを作成しています。</p>
<h3 id="milestone-view"><a class="header-anchor-link" href="#milestone-view" aria-hidden="true" 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" aria-hidden="true" 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" aria-hidden="true" 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" aria-hidden="true" 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" aria-hidden="true" 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" aria-hidden="true" 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)


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

宮原崇志が執筆した記事

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

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

宮原 崇志が執筆した記事

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

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

宮原崇志が執筆した記事