<p>こんにちは！<br />
SRE チームの宮原（<a href="https://twitter.com/TakashiMiyahara" target="_blank" rel="nofollow noopener noreferrer">@TakashiMiyahara</a>）です 🙋</p>
<p>クラッソーネではノーコードのツールとして、<a href="https://www.make.com/en" target="_blank" rel="nofollow noopener noreferrer">Make(Integromat)</a>を活用しています 💪<br />
今日は、Make で OAuth 2.0 を利用して、外部の API を操作する方法について検証しましたので、共有したいと思います。</p>
<h2 id="1.-%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB"><a class="header-anchor-link" href="#1.-%E3%81%AF%E3%81%98%E3%82%81%E3%81%AB" aria-hidden="true"></a> 1. はじめに</h2>
<p>クラッソーネでは一部の請求書発行に Misoca を利用しています。<br />
現時点では経理部のクルーが請求書を一件ずつ発行してくれていますが、効率化を図るため、API を通じて自動化できるかを検討しました。</p>
<p>今回の検証では、Make から Misoca の API を利用して請求書を発行する手順を説明します。Make や OAuth 2.0 の設定方法についても詳しく解説するので、API の接続に不安がある方でも安心して進められます。</p>
<h2 id="2.-misoca-api-%E7%94%A8%E3%81%AE%E3%82%A2%E3%83%97%E3%83%AA%E3%82%B1%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E3%81%AE%E4%BD%9C%E6%88%90"><a class="header-anchor-link" href="#2.-misoca-api-%E7%94%A8%E3%81%AE%E3%82%A2%E3%83%97%E3%83%AA%E3%82%B1%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E3%81%AE%E4%BD%9C%E6%88%90" aria-hidden="true"></a> 2. Misoca API 用のアプリケーションの作成</h2>
<p>Misoca API のドキュメントを確認すると、まず「アプリケーションの作成」が必要です。<br />
このアプリケーションは、API を通じて Misoca と通信するために必要な認証情報を提供します。<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__26c20d8c30e93" src="https://embed.zenn.studio/card#zenn-embedded__26c20d8c30e93" data-content="https%3A%2F%2Fdoc.misoca.jp%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://doc.misoca.jp/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://doc.misoca.jp/</a></p>
<p>アプリケーションの作成を行うには、以下の内容を決める必要があるようです。</p>
<ul>
<li>名称：管理しやすい名前を入力</li>
<li>コールバック URL：<a href="https://www.integromat.com/oauth/cb/oauth2" target="_blank" rel="nofollow noopener noreferrer">https://www.integromat.com/oauth/cb/oauth2</a> を入力（Make の OAuth 2.0 モジュール用）</li>
</ul>
<p><img src="/images/posts/make-oauth2-tips/image1.png" alt /></p>
<p>アプリケーションが作成されると、「アプリケーション ID」や「シークレット」が発行されます。これらは後の手順で使用するので、忘れずに控えておきましょう。</p>
<p><img src="/images/posts/make-oauth2-tips/image3.png" alt /></p>
<h2 id="3.-%E3%82%B3%E3%83%8D%E3%82%AF%E3%82%B7%E3%83%A7%E3%83%B3%E3%81%AE%E4%BD%9C%E6%88%90"><a class="header-anchor-link" href="#3.-%E3%82%B3%E3%83%8D%E3%82%AF%E3%82%B7%E3%83%A7%E3%83%B3%E3%81%AE%E4%BD%9C%E6%88%90" aria-hidden="true"></a> 3. コネクションの作成</h2>
<p>次に、Make で Misoca の API と接続するためのコネクションを作成します。</p>
<p><img src="/images/posts/make-oauth2-tips/image4.png" alt /><br />
<img src="/images/posts/make-oauth2-tips/image5.png" alt /></p>
<ol>
<li>Make で新しいシナリオを作成し、「Make an OAuth 2.0 request」モジュールを配置します。</li>
<li>「Add」から新しいコネクションを作成します。</li>
</ol>
<p>以下の設定を入力します。</p>
<table>
<thead>
<tr>
<th>項目</th>
<th>値</th>
</tr>
</thead>
<tbody>
<tr>
<td>Authorize URI</td>
<td><a href="https://app.misoca.jp/oauth2/authorize" target="_blank" rel="nofollow noopener noreferrer">https://app.misoca.jp/oauth2/authorize</a></td>
</tr>
<tr>
<td>Token URI</td>
<td><a href="https://app.misoca.jp/oauth2/token" target="_blank" rel="nofollow noopener noreferrer">https://app.misoca.jp/oauth2/token</a></td>
</tr>
<tr>
<td>Scope</td>
<td>read もしくは write</td>
</tr>
<tr>
<td>Client ID</td>
<td>Misoca のアプリケーション ID</td>
</tr>
<tr>
<td>Client Secret</td>
<td>Misoca のシークレット</td>
</tr>
</tbody>
</table>
<p>次に、Show advanced settings を開き、以下の項目を追加設定します。</p>
<table>
<thead>
<tr>
<th>項目</th>
<th>key</th>
<th>Value</th>
</tr>
</thead>
<tbody>
<tr>
<td>Authorize parameters</td>
<td>client_id</td>
<td>Misoca のアプリケーション ID</td>
</tr>
<tr>
<td></td>
<td>redirect_uri</td>
<td><a href="https://www.integromat.com/oauth/cb/oauth2" target="_blank" rel="nofollow noopener noreferrer">https://www.integromat.com/oauth/cb/oauth2</a></td>
</tr>
<tr>
<td>Access token parameters</td>
<td>client_id</td>
<td>Misoca のアプリケーション ID</td>
</tr>
<tr>
<td></td>
<td>client_secret</td>
<td>Misoca のシークレット</td>
</tr>
<tr>
<td></td>
<td>redirect_uri</td>
<td><a href="https://www.integromat.com/oauth/cb/oauth2" target="_blank" rel="nofollow noopener noreferrer">https://www.integromat.com/oauth/cb/oauth2</a></td>
</tr>
<tr>
<td>Refresh token parameters</td>
<td>client_id</td>
<td>Misoca のアプリケーション ID</td>
</tr>
<tr>
<td></td>
<td>client_secret</td>
<td>Misoca のシークレット</td>
</tr>
</tbody>
</table>
<p>設定が完了したら、OK を選択します。Misoca の承認画面が開くので、「承認」をクリックすればコネクションの作成は完了です。</p>
<p><img src="/images/posts/make-oauth2-tips/image6.png" alt /></p>
<h2 id="4.-misoca-%E3%81%AE-api-%E3%82%92%E5%91%BC%E3%81%B3%E5%87%BA%E3%81%97%E3%81%A6%E3%81%BF%E3%82%8B"><a class="header-anchor-link" href="#4.-misoca-%E3%81%AE-api-%E3%82%92%E5%91%BC%E3%81%B3%E5%87%BA%E3%81%97%E3%81%A6%E3%81%BF%E3%82%8B" aria-hidden="true"></a> 4. Misoca の API を呼び出してみる</h2>
<p>次に、作成したコネクションを使って Misoca の API を呼び出してみましょう。<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__230941bbdbbe3" src="https://embed.zenn.studio/card#zenn-embedded__230941bbdbbe3" data-content="https%3A%2F%2Fdoc.misoca.jp%2Fv3%2Fdocument.html" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://doc.misoca.jp/v3/document.html" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://doc.misoca.jp/v3/document.html</a></p>
<p>請求書一覧を取得できるエンドポイントで試してみましょう。<br />
<img src="/images/posts/make-oauth2-tips/image7.png" alt /></p>
<p>Connection には先ほど作成したコネクションを選択します。<br />
以下の内容を設定します。</p>
<table>
<thead>
<tr>
<th>項目</th>
<th>値</th>
</tr>
</thead>
<tbody>
<tr>
<td>URL</td>
<td><a href="https://app.misoca.jp/api/v3/invoices" target="_blank" rel="nofollow noopener noreferrer">https://app.misoca.jp/api/v3/invoices</a></td>
</tr>
<tr>
<td>Method</td>
<td>GET</td>
</tr>
<tr>
<td>Parse response</td>
<td>Yes</td>
</tr>
</tbody>
</table>
<p>Parse response を Yes にすると、複数のデータを自動でパースしてくれます。</p>
<p>設定が完了したら、実行してみましょう。ステータスコード 200 で応答が返ってくれば、データが正常に取得できたことになります。</p>
<p><img src="/images/posts/make-oauth2-tips/image11.png" alt /></p>
<p>Read の操作は問題ないようですね。次は Write の操作を試してみましょう。</p>
<h2 id="5.-%E8%AB%8B%E6%B1%82%E6%9B%B8%E3%82%92%E4%BD%9C%E6%88%90%E3%81%97%E3%81%A6%E3%81%BF%E3%82%8B"><a class="header-anchor-link" href="#5.-%E8%AB%8B%E6%B1%82%E6%9B%B8%E3%82%92%E4%BD%9C%E6%88%90%E3%81%97%E3%81%A6%E3%81%BF%E3%82%8B" aria-hidden="true"></a> 5. 請求書を作成してみる</h2>
<p>次は、API を使って実際に請求書を作成してみます。<br />
<img src="/images/posts/make-oauth2-tips/image8.png" alt /></p>
<table>
<thead>
<tr>
<th>項目</th>
<th>値</th>
</tr>
</thead>
<tbody>
<tr>
<td>URL</td>
<td><a href="https://app.misoca.jp/api/v3/invoice" target="_blank" rel="nofollow noopener noreferrer">https://app.misoca.jp/api/v3/invoice</a></td>
</tr>
<tr>
<td>Method</td>
<td>POST</td>
</tr>
<tr>
<td>Parse response</td>
<td>Yes</td>
</tr>
<tr>
<td>Body type</td>
<td>Raw</td>
</tr>
<tr>
<td>Content type</td>
<td>JSON(application/json)</td>
</tr>
<tr>
<td>Request content</td>
<td>下記参照</td>
</tr>
<tr>
<td>Parse response</td>
<td>Yes</td>
</tr>
</tbody>
</table>
<p>Request content の内容は以下のとおりです。<br />
送り先 ID（contact_id）が必須のため、ブラウザからテスト用のデータを作成し、この ID を使用しました。</p>
<div class="code-block-container"><pre class="language-json"><code class="language-json"><span class="token punctuation">{</span>
  <span class="token property">"invoice_number"</span><span class="token operator">:</span> <span class="token string">"19990101-002"</span><span class="token punctuation">,</span>
  <span class="token property">"issue_date"</span><span class="token operator">:</span> <span class="token string">"2024-08-23"</span><span class="token punctuation">,</span>
  <span class="token property">"subject"</span><span class="token operator">:</span> <span class="token string">"宮原のテストの請求書"</span><span class="token punctuation">,</span>
  <span class="token property">"payment_due_on"</span><span class="token operator">:</span> <span class="token string">"2024-08-24"</span><span class="token punctuation">,</span>
  <span class="token property">"contact_id"</span><span class="token operator">:</span> ******<span class="token punctuation">,</span>
  <span class="token property">"items"</span><span class="token operator">:</span> <span class="token punctuation">[</span>
    <span class="token punctuation">{</span>
      <span class="token property">"name"</span><span class="token operator">:</span> <span class="token string">"テストの金額"</span><span class="token punctuation">,</span>
      <span class="token property">"unit_price"</span><span class="token operator">:</span> <span class="token number">10000.0</span><span class="token punctuation">,</span>
      <span class="token property">"quantity"</span><span class="token operator">:</span> <span class="token number">1.0</span><span class="token punctuation">,</span>
      <span class="token property">"price"</span><span class="token operator">:</span> <span class="token number">10000</span><span class="token punctuation">,</span>
      <span class="token property">"unit_name"</span><span class="token operator">:</span> <span class="token string">""</span><span class="token punctuation">,</span>
      <span class="token property">"tax_type"</span><span class="token operator">:</span> <span class="token string">"STANDARD_TAX_10"</span><span class="token punctuation">,</span>
      <span class="token property">"excluding_withholding_tax"</span><span class="token operator">:</span> <span class="token boolean">false</span>
    <span class="token punctuation">}</span>
  <span class="token punctuation">]</span>
<span class="token punctuation">}</span>
</code></pre></div><p>この内容で実行してみましょう！請求書が作成されるでしょうか！？</p>
<p>Make にはステータスコード 201 の応答がありました。<br />
<img src="/images/posts/make-oauth2-tips/image9.png" alt /></p>
<p>ブラウザから Misoca を開いて確認してみましょう。</p>
<p><img src="/images/posts/make-oauth2-tips/image10.png" alt /></p>
<p>請求書が作成されていますね！</p>
<p>バクラクで申請された内容を経理部のクルーが承認したら、自動で請求書を作成するなどが実現できそうですね。</p>
<h2 id="6.-%E7%B5%82%E3%82%8F%E3%82%8A%E3%81%AB"><a class="header-anchor-link" href="#6.-%E7%B5%82%E3%82%8F%E3%82%8A%E3%81%AB" aria-hidden="true"></a> 6. 終わりに</h2>
<p>今回の検証で、Make から Misoca の API を使って請求書を作成できることが確認できました。Make の OAuth 2.0 モジュールを活用することで、比較的簡単に外部 API と接続できるため、同様の手順で他のサービスにも応用できるでしょう。</p>
<p>クラッソーネでは、引き続きプロダクトとチームの双方を改善していくために、共に働くエンジニアを募集しています。興味のある方はぜひご連絡ください！</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__e2ed3bce4cea2" src="https://embed.zenn.studio/card#zenn-embedded__e2ed3bce4cea2" data-content="https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.crassone.co.jp/recruit/engineer/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://www.crassone.co.jp/recruit/engineer/</a></p>



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

クラッソーネではノーコードのツールとして、Make(Integromat)を活用しています 💪
今日は、Make で OAuth 2.0 を利用して、外部の API を操作する方法について検証しましたので、共有したいと思います。

1. はじめに

クラッソーネでは一部の請求書発行に Misoca を利用しています。
現時点では経理部のクルーが請求書を一件ずつ発行してくれていますが、効率化を図るため、API を通じて自動化できるかを検討しました。

今回の検証では、Make から Misoca の API を利用して請求書を発行する手順を説明します。Make や OAuth 2.0 の設定方法についても詳しく解説するので、API の接続に不安がある方でも安心して進められます。

2. Misoca API 用のアプリケーションの作成

Misoca API のドキュメントを確認すると、まず「アプリケーションの作成」が必要です。
このアプリケーションは、API を通じて Misoca と通信するために必要な認証情報を提供します。
https://doc.misoca.jp/

アプリケーションの作成を行うには、以下の内容を決める必要があるようです。

名称：管理しやすい名前を入力
コールバック URL：https://www.integromat.com/oauth/cb/oauth2 を入力（Make の OAuth 2.0 モジュール用）

アプリケーションが作成されると、「アプリケーション ID」や「シークレット」が発行されます。これらは後の手順で使用するので、忘れずに控えておきましょう。

3. コネクションの作成

次に、Make で Misoca の API と接続するためのコネクションを作成します。

Make で新しいシナリオを作成し、「Make an OAuth 2.0 request」モジュールを配置します。
「Add」から新しいコネクションを作成します。

以下の設定を入力します。
|項目|値|
|---|---|
|Authorize URI|https://app.misoca.jp/oauth2/authorize|
|Token URI|https://app.misoca.jp/oauth2/token|
|Scope|read もしくは write|
|Client ID|Misoca のアプリケーション ID|
|Client Secret|Misoca のシークレット|

次に、Show advanced settings を開き、以下の項目を追加設定します。

| 項目                     | key           | Value                                      |
| ------------------------ | ------------- | ------------------------------------------ |
| Authorize parameters     | client_id     | Misoca のアプリケーション ID               |
|                          | redirect_uri  | https://www.integromat.com/oauth/cb/oauth2 |
| Access token parameters  | client_id     | Misoca のアプリケーション ID               |
|                          | client_secret | Misoca のシークレット                      |
|                          | redirect_uri  | https://www.integromat.com/oauth/cb/oauth2 |
| Refresh token parameters | client_id     | Misoca のアプリケーション ID               |
|                          | client_secret | Misoca のシークレット                      |

設定が完了したら、OK を選択します。Misoca の承認画面が開くので、「承認」をクリックすればコネクションの作成は完了です。

4. Misoca の API を呼び出してみる

次に、作成したコネクションを使って Misoca の API を呼び出してみましょう。
https://doc.misoca.jp/v3/document.html

請求書一覧を取得できるエンドポイントで試してみましょう。

Connection には先ほど作成したコネクションを選択します。
以下の内容を設定します。
|項目|値|
|---|---|
|URL|https://app.misoca.jp/api/v3/invoices|
|Method|GET|
|Parse response|Yes|

Parse response を Yes にすると、複数のデータを自動でパースしてくれます。

設定が完了したら、実行してみましょう。ステータスコード 200 で応答が返ってくれば、データが正常に取得できたことになります。

Read の操作は問題ないようですね。次は Write の操作を試してみましょう。

5. 請求書を作成してみる

次は、API を使って実際に請求書を作成してみます。

| 項目            | 値                                   |
| --------------- | ------------------------------------ |
| URL             | https://app.misoca.jp/api/v3/invoice |
| Method          | POST                                 |
| Parse response  | Yes                                  |
| Body type       | Raw                                  |
| Content type    | JSON(application/json)               |
| Request content | 下記参照                             |
| Parse response  | Yes                                  |

Request content の内容は以下のとおりです。
送り先 ID（contact_id）が必須のため、ブラウザからテスト用のデータを作成し、この ID を使用しました。

{
  "invoice_number": "19990101-002",
  "issue_date": "2024-08-23",
  "subject": "宮原のテストの請求書",
  "paymentdueon": "2024-08-24",
  "contact_id": **,
  "items": [
    {
      "name": "テストの金額",
      "unit_price": 10000.0,
      "quantity": 1.0,
      "price": 10000,
      "unit_name": "",
      "taxtype": "STANDARDTAX_10",
      "excludingwithholdingtax": false
    }
  ]
}

この内容で実行してみましょう！請求書が作成されるでしょうか！？

Make にはステータスコード 201 の応答がありました。

ブラウザから Misoca を開いて確認してみましょう。

請求書が作成されていますね！

バクラクで申請された内容を経理部のクルーが承認したら、自動で請求書を作成するなどが実現できそうですね。

6. 終わりに

今回の検証で、Make から Misoca の API を使って請求書を作成できることが確認できました。Make の OAuth 2.0 モジュールを活用することで、比較的簡単に外部 API と接続できるため、同様の手順で他のサービスにも応用できるでしょう。

クラッソーネでは、引き続きプロダクトとチームの双方を改善していくために、共に働くエンジニアを募集しています。興味のある方はぜひご連絡ください！

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


Make(Integromat)で公式モジュールが用意されていないサービスのAPIと連携する方法

<p>こんにちは！<br />
コーポレートエンジニアリングも兼務している SRE チームの宮原（<a href="https://twitter.com/TakashiMiyahara" target="_blank" rel="nofollow noopener noreferrer">@TakashiMiyahara</a>）です 🙋</p>
<p>開発部で利用するマシンとして M3 搭載の MacBook Pro が導入されました 🎊<br />
意気揚々と初期設定を進めていたのですが、ESET Endpoint Antivirus の導入でハマったので、その解決方法を共有します。</p>
<h2 id="1.-eset-endpoint-antivirus-%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB"><a class="header-anchor-link" href="#1.-eset-endpoint-antivirus-%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB" aria-hidden="true"></a> 1. ESET Endpoint Antivirus のインストール</h2>
<p>クラッソーネでは、ESET PROTECT Essential クラウドを導入しています。<br />
macOS 向けのライブインストーラーを作成し、こちらを利用して ESET Endpoint Antivirus をインストールしていました。</p>
<p>ライブインストーラーは、macOS Ventura がリリースされた頃に作成しており、「もしかしたら、インストーラーを作り直さないといけないかもなぁ」と感じていました。</p>
<h2 id="2.-%E3%83%A9%E3%82%A4%E3%83%96%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%A9%E3%83%BC%E3%82%92%E4%BD%BF%E3%81%A3%E3%81%9F%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB%E3%81%AB%E5%A4%B1%E6%95%97%E3%81%99%E3%82%8B"><a class="header-anchor-link" href="#2.-%E3%83%A9%E3%82%A4%E3%83%96%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%A9%E3%83%BC%E3%82%92%E4%BD%BF%E3%81%A3%E3%81%9F%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB%E3%81%AB%E5%A4%B1%E6%95%97%E3%81%99%E3%82%8B" aria-hidden="true"></a> 2. ライブインストーラーを使ったインストールに失敗する</h2>
<p>まずは、すでに作成済みのライブインストーラーを利用して、インストールを進めていきました。<br />
ライセンスが正しく反映されており、インストーラーも順調に進んでいたのですが.....</p>
<p><img src="/images/posts/eset_endpoint_antivirus_for_macos_14_tips/image1.jpg" alt="error_image" /></p>
<p>インストールに失敗しました。</p>
<h2 id="3.-%E5%8E%9F%E5%9B%A0%E3%81%AE%E8%AA%BF%E6%9F%BB"><a class="header-anchor-link" href="#3.-%E5%8E%9F%E5%9B%A0%E3%81%AE%E8%AA%BF%E6%9F%BB" aria-hidden="true"></a> 3. 原因の調査</h2>
<p>さて、原因を探ります。<br />
まずはライセンスの有効期限が正しいかを確認します。<br />
ライセンスは有効期限内であり、ここは大丈夫そうです。</p>
<p>次に、macOS Sonoma に対応しているか調べます。</p>
<p>バージョン 6 とバージョン 7 の 2 種類があるようです。</p>
<p>macOS のサポートという欄がありますね。<br />
ここを見ていきましょう。<br />
<img src="/images/posts/eset_endpoint_antivirus_for_macos_14_tips/image2.png" alt="document" /></p>
<p>はい！ここですね！<br />
バージョン 6 が macOS Sonoma に対応していませんでした！<br />
バージョン 7 から macOS Sonoma をサポートしているようです。</p>
<h2 id="4.-%E8%A7%A3%E6%B1%BA"><a class="header-anchor-link" href="#4.-%E8%A7%A3%E6%B1%BA" aria-hidden="true"></a> 4. 解決</h2>
<p>ESET Endpoint Antivirus には、バージョン 6 と 7 が共存していることがわかりました。<br />
ライブインストーラーを作成する際に、もしかしたらバージョンを選択できるかもしれないと一抹の期待を込めつつ作成に取り掛かります。</p>
<p>やりました！ビンゴです！<br />
<img src="/images/posts/eset_endpoint_antivirus_for_macos_14_tips/image3.png" alt="installer" /></p>
<p>ESET Endpoint Antivirus for macOS (V7+)を選択し、新しいライブインストーラーを作成します。</p>
<p>さて、新しいライブインストーラーを利用して ESET の導入を進めます。<br />
インストーラーの処理が順調に進んでいきます。</p>
<p>やりました！成功です！<br />
無事にインストールに成功しました。<br />
嬉しさのあまり勢い余ってインストーラーを閉じたので、スクショがありません（涙）</p>
<h2 id="5.-%E7%B5%82%E3%82%8F%E3%82%8A%E3%81%AB"><a class="header-anchor-link" href="#5.-%E7%B5%82%E3%82%8F%E3%82%8A%E3%81%AB" aria-hidden="true"></a> 5. 終わりに</h2>
<p>ESET の導入にハマって焦ったのですが、なんとか無事に導入できました。<br />
ほっと一安心です。</p>
<p>クラッソーネでは、引き続きプロダクトとチームの双方を改善していくために、共に働くエンジニアを募集しています。</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__a1a37a3be4e16" src="https://embed.zenn.studio/card#zenn-embedded__a1a37a3be4e16" data-content="https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.crassone.co.jp/recruit/engineer/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://www.crassone.co.jp/recruit/engineer/</a></p>



こんにちは！
コーポレートエンジニアリングも兼務している SRE チームの宮原（@TakashiMiyahara）です 🙋

開発部で利用するマシンとして M3 搭載の MacBook Pro が導入されました 🎊
意気揚々と初期設定を進めていたのですが、ESET Endpoint Antivirus の導入でハマったので、その解決方法を共有します。

1. ESET Endpoint Antivirus のインストール

クラッソーネでは、ESET PROTECT Essential クラウドを導入しています。
macOS 向けのライブインストーラーを作成し、こちらを利用して ESET Endpoint Antivirus をインストールしていました。

ライブインストーラーは、macOS Ventura がリリースされた頃に作成しており、「もしかしたら、インストーラーを作り直さないといけないかもなぁ」と感じていました。

2. ライブインストーラーを使ったインストールに失敗する

まずは、すでに作成済みのライブインストーラーを利用して、インストールを進めていきました。
ライセンスが正しく反映されており、インストーラーも順調に進んでいたのですが.....

error_image

インストールに失敗しました。

3. 原因の調査

さて、原因を探ります。
まずはライセンスの有効期限が正しいかを確認します。
ライセンスは有効期限内であり、ここは大丈夫そうです。

次に、macOS Sonoma に対応しているか調べます。

バージョン 6 とバージョン 7 の 2 種類があるようです。

macOS のサポートという欄がありますね。
ここを見ていきましょう。
document

はい！ここですね！
バージョン 6 が macOS Sonoma に対応していませんでした！
バージョン 7 から macOS Sonoma をサポートしているようです。

4. 解決

ESET Endpoint Antivirus には、バージョン 6 と 7 が共存していることがわかりました。
ライブインストーラーを作成する際に、もしかしたらバージョンを選択できるかもしれないと一抹の期待を込めつつ作成に取り掛かります。

やりました！ビンゴです！
installer

ESET Endpoint Antivirus for macOS (V7+)を選択し、新しいライブインストーラーを作成します。

さて、新しいライブインストーラーを利用して ESET の導入を進めます。
インストーラーの処理が順調に進んでいきます。

やりました！成功です！
無事にインストールに成功しました。
嬉しさのあまり勢い余ってインストーラーを閉じたので、スクショがありません（涙）

5. 終わりに

ESET の導入にハマって焦ったのですが、なんとか無事に導入できました。
ほっと一安心です。

クラッソーネでは、引き続きプロダクトとチームの双方を改善していくために、共に働くエンジニアを募集しています。

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


macOS SonomaでESET Endpoint Antivirusを導入するときにハマったこと

<p>こんにちは！<br />
SREチームの宮原（<a href="https://twitter.com/TakashiMiyahara" target="_blank" rel="nofollow noopener noreferrer">@TakashiMiyahara</a>）です🙋</p>
<p>クラッソーネでは、工事現場の安全をAI技術で支援しています。<br />
本日は、開発・運用している工事現場の安全確認AIシステム（crassone vista）で利用している大規模言語モデル（LLM）について、最近行った技術プラットフォームの移行経験を共有したいと思います。具体的には、OpenAIのAPIから、Azure OpenAI ServiceのAPIへの乗り換えについてです。</p>
<h2 id="%E4%B9%97%E3%82%8A%E6%8F%9B%E3%81%88%E3%81%AE%E7%B5%8C%E7%B7%AF"><a class="header-anchor-link" href="#%E4%B9%97%E3%82%8A%E6%8F%9B%E3%81%88%E3%81%AE%E7%B5%8C%E7%B7%AF" aria-hidden="true"></a> 乗り換えの経緯</h2>
<p>OpenAIのAPIからAzure OpenAI ServiceのAPIへの移行を決定した最大の理由は、前者のレートリミットの厳しさにありました。<br />
crassone vistaでは毎分カメラから画像を受け取り、AIによる判定を行っておりますが、<code>gpt-4-vision-preview</code>では一日あたり500リクエストの制約があります。10現場で稼働すると、朝のうちにレートリミットに達してしまうため、乗り換えを決断しました。</p>
<h2 id="azure-openai-service%E3%81%B8%E3%81%AE%E3%82%A2%E3%82%AF%E3%82%BB%E3%82%B9%E7%94%B3%E8%AB%8B"><a class="header-anchor-link" href="#azure-openai-service%E3%81%B8%E3%81%AE%E3%82%A2%E3%82%AF%E3%82%BB%E3%82%B9%E7%94%B3%E8%AB%8B" aria-hidden="true"></a> Azure OpenAI Serviceへのアクセス申請</h2>
<p>Azure OpenAI Serviceを利用するためには、アクセス申請が必要です。申請フォームには、AzureサブスクリプションID、メールアドレス、ユースケースなどを記入する必要があります。<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__44af3cc82ad43" src="https://embed.zenn.studio/card#zenn-embedded__44af3cc82ad43" data-content="https%3A%2F%2Fcustomervoice.microsoft.com%2FPages%2FResponsePage.aspx%3Fid%3Dv4j5cvGGr0GRqy180BHbR7en2Ais5pxKtso_Pz4b1_xUNTZBNzRKNlVQSFhZMU9aV09EVzYxWFdORCQlQCN0PWcu" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://customervoice.microsoft.com/Pages/ResponsePage.aspx?id=v4j5cvGGr0GRqy180BHbR7en2Ais5pxKtso_Pz4b1_xUNTZBNzRKNlVQSFhZMU9aV09EVzYxWFdORCQlQCN0PWcu" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://customervoice.microsoft.com/Pages/ResponsePage.aspx?id=v4j5cvGGr0GRqy180BHbR7en2Ais5pxKtso_Pz4b1_xUNTZBNzRKNlVQSFhZMU9aV09EVzYxWFdORCQlQCN0PWcu</a></p>
<p>2024年2月に私が申請した際は翌日に許可されましたが、現在は審査に10営業日程度要することがありますので、辛抱強く待つ必要があります。</p>
<h2 id="api%E3%81%AE%E4%BD%BF%E3%81%84%E6%96%B9%E3%81%AE%E9%81%95%E3%81%84"><a class="header-anchor-link" href="#api%E3%81%AE%E4%BD%BF%E3%81%84%E6%96%B9%E3%81%AE%E9%81%95%E3%81%84" aria-hidden="true"></a> APIの使い方の違い</h2>
<p>APIのエンドポイントをOpenAIからAzure OpenAIに切り替える必要があります。</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__579ecfcda324e" src="https://embed.zenn.studio/card#zenn-embedded__579ecfcda324e" data-content="https%3A%2F%2Flearn.microsoft.com%2Fja-jp%2Fazure%2Fai-services%2Fopenai%2Fhow-to%2Fswitching-endpoints" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://learn.microsoft.com/ja-jp/azure/ai-services/openai/how-to/switching-endpoints" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://learn.microsoft.com/ja-jp/azure/ai-services/openai/how-to/switching-endpoints</a></p>
<h3 id="openai%E3%81%AE%E5%A0%B4%E5%90%88"><a class="header-anchor-link" href="#openai%E3%81%AE%E5%A0%B4%E5%90%88" aria-hidden="true"></a> OpenAIの場合</h3>
<div class="code-block-container"><pre class="language-python"><code class="language-python"><span class="token keyword">import</span> os
<span class="token keyword">from</span> openai <span class="token keyword">import</span> OpenAI

client <span class="token operator">=</span> OpenAI<span class="token punctuation">(</span>
    api_key<span class="token operator">=</span>os<span class="token punctuation">.</span>getenv<span class="token punctuation">(</span><span class="token string">"OPENAI_API_KEY"</span><span class="token punctuation">)</span>
<span class="token punctuation">)</span>
</code></pre></div><h3 id="microsoft-azure-openai%E3%81%AE%E5%A0%B4%E5%90%88"><a class="header-anchor-link" href="#microsoft-azure-openai%E3%81%AE%E5%A0%B4%E5%90%88" aria-hidden="true"></a> Microsoft Azure OpenAIの場合</h3>
<div class="code-block-container"><pre class="language-python"><code class="language-python"><span class="token keyword">import</span> os
<span class="token keyword">from</span> openai <span class="token keyword">import</span> AzureOpenAI
    
client <span class="token operator">=</span> AzureOpenAI<span class="token punctuation">(</span>
    api_key<span class="token operator">=</span>os<span class="token punctuation">.</span>getenv<span class="token punctuation">(</span><span class="token string">"AZURE_OPENAI_API_KEY"</span><span class="token punctuation">)</span><span class="token punctuation">,</span>  
    api_version<span class="token operator">=</span><span class="token string">"2023-12-01-preview"</span><span class="token punctuation">,</span>
    azure_endpoint<span class="token operator">=</span>os<span class="token punctuation">.</span>getenv<span class="token punctuation">(</span><span class="token string">"AZURE_OPENAI_ENDPOINT"</span><span class="token punctuation">)</span>
<span class="token punctuation">)</span>
</code></pre></div><h2 id="gpt-4-turbo-with-vision%E3%82%92%E4%BD%BF%E3%81%86%E9%9A%9B%E3%81%AE%E5%AE%9F%E8%A3%85%E4%BE%8B"><a class="header-anchor-link" href="#gpt-4-turbo-with-vision%E3%82%92%E4%BD%BF%E3%81%86%E9%9A%9B%E3%81%AE%E5%AE%9F%E8%A3%85%E4%BE%8B" aria-hidden="true"></a> GPT-4 Turbo with Visionを使う際の実装例</h2>
<p>Chat Completion APIを呼び出す際のコード例です。deployment_nameの設定が初めての挑戦だったため、理解するまでに時間がかかりましたが、以下のように実装しました。</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__8d93393d45876" src="https://embed.zenn.studio/card#zenn-embedded__8d93393d45876" data-content="https%3A%2F%2Flearn.microsoft.com%2Fja-jp%2Fazure%2Fai-services%2Fopenai%2Fhow-to%2Fgpt-with-vision%3Ftabs%3Dpython%252Csystem-assigned%252Cresource" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://learn.microsoft.com/ja-jp/azure/ai-services/openai/how-to/gpt-with-vision?tabs=python%2Csystem-assigned%2Cresource" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://learn.microsoft.com/ja-jp/azure/ai-services/openai/how-to/gpt-with-vision?tabs=python%2Csystem-assigned%2Cresource</a></p>
<div class="code-block-container"><pre class="language-python"><code class="language-python">api_base <span class="token operator">=</span> <span class="token string">'&lt;your_azure_openai_endpoint&gt;'</span> <span class="token comment"># APIキーと一緒に発行されたエンドポイント。 https://YOUR_RESOURCE_NAME.openai.azure.com/</span>
api_key<span class="token operator">=</span><span class="token string">"&lt;your_azure_openai_key&gt;"</span> <span class="token comment"># キーとエンドポイントで発行されたキー。</span>
deployment_name <span class="token operator">=</span> <span class="token string">'&lt;your_deployment_name&gt;'</span> <span class="token comment"># Azure OpenAI Studioのデプロイ名。</span>
api_version <span class="token operator">=</span> <span class="token string">'2023-12-01-preview'</span> <span class="token comment"># 2024年4月現在はこの値。将来は変わる可能性あり。</span>

client <span class="token operator">=</span> AzureOpenAI<span class="token punctuation">(</span>
    api_key<span class="token operator">=</span>api_key<span class="token punctuation">,</span>  
    api_version<span class="token operator">=</span>api_version<span class="token punctuation">,</span>
    base_url<span class="token operator">=</span><span class="token string-interpolation"><span class="token string">f"</span><span class="token interpolation"><span class="token punctuation">{</span>api_base<span class="token punctuation">}</span></span><span class="token string">openai/deployments/</span><span class="token interpolation"><span class="token punctuation">{</span>deployment_name<span class="token punctuation">}</span></span><span class="token string">/extensions"</span></span><span class="token punctuation">,</span>
<span class="token punctuation">)</span>

response <span class="token operator">=</span> client<span class="token punctuation">.</span>chat<span class="token punctuation">.</span>completions<span class="token punctuation">.</span>create<span class="token punctuation">(</span>
    model<span class="token operator">=</span>deployment_name<span class="token punctuation">,</span>
    messages<span class="token operator">=</span><span class="token punctuation">[</span>
        <span class="token punctuation">{</span> <span class="token string">"role"</span><span class="token punctuation">:</span> <span class="token string">"user"</span><span class="token punctuation">,</span> <span class="token string">"content"</span><span class="token punctuation">:</span> <span class="token punctuation">[</span>  
            <span class="token punctuation">{</span> 
                <span class="token string">"type"</span><span class="token punctuation">:</span> <span class="token string">"text"</span><span class="token punctuation">,</span> 
                <span class="token string">"text"</span><span class="token punctuation">:</span> <span class="token string">"Describe this picture:"</span> 
            <span class="token punctuation">}</span><span class="token punctuation">,</span>
            <span class="token punctuation">{</span> 
                <span class="token string">"type"</span><span class="token punctuation">:</span> <span class="token string">"image_url"</span><span class="token punctuation">,</span>
                <span class="token string">"image_url"</span><span class="token punctuation">:</span> <span class="token punctuation">{</span>
                    <span class="token string">"url"</span><span class="token punctuation">:</span> <span class="token string">"&lt;image URL&gt;"</span>
                <span class="token punctuation">}</span>
            <span class="token punctuation">}</span>
        <span class="token punctuation">]</span> <span class="token punctuation">}</span> 
    <span class="token punctuation">]</span><span class="token punctuation">,</span>
    max_tokens<span class="token operator">=</span><span class="token number">300</span>
<span class="token punctuation">)</span>
</code></pre></div><h2 id="%E3%83%AC%E3%82%B9%E3%83%9D%E3%83%B3%E3%82%B9%E3%81%AE%E5%8F%96%E5%BE%97%E6%96%B9%E6%B3%95"><a class="header-anchor-link" href="#%E3%83%AC%E3%82%B9%E3%83%9D%E3%83%B3%E3%82%B9%E3%81%AE%E5%8F%96%E5%BE%97%E6%96%B9%E6%B3%95" aria-hidden="true"></a> レスポンスの取得方法</h2>
<p>OpenAIのAPIを利用していたときは、以下のように結果を取得していました。</p>
<div class="code-block-container"><pre class="language-python"><code class="language-python">response<span class="token punctuation">.</span>json<span class="token punctuation">(</span><span class="token punctuation">)</span><span class="token punctuation">[</span><span class="token string">'choices'</span><span class="token punctuation">]</span><span class="token punctuation">[</span><span class="token number">0</span><span class="token punctuation">]</span><span class="token punctuation">[</span><span class="token string">'text'</span><span class="token punctuation">]</span>
</code></pre></div><p>下記のAPIレスポンスのように、messageのcontentに格納されているようです。この変更に気づかずエラーになり少々ハマりました。</p>
<div class="code-block-container"><pre class="language-python"><code class="language-python">response<span class="token punctuation">.</span>choices<span class="token punctuation">[</span><span class="token number">0</span><span class="token punctuation">]</span><span class="token punctuation">.</span>message<span class="token punctuation">.</span>content
</code></pre></div><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" aria-hidden="true"></a> まとめ</h2>
<p>いくつかハマったポイントはありましたが、なんとかAzure OpenAI Serviceへ移行することができました。<br />
Microsoft Azureを業務で利用するのは初めてでしたが、OpenAIから触り始めることはAzureへ入門する良い入り口なのではと感じました。</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"></a> おわりに</h2>
<p>クラッソーネでは、引き続きプロダクトとチームの双方を改善していくために、共に働くエンジニアを募集しています。</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__e98ad8670e876" src="https://embed.zenn.studio/card#zenn-embedded__e98ad8670e876" data-content="https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.crassone.co.jp/recruit/engineer/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://www.crassone.co.jp/recruit/engineer/</a></p>



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

クラッソーネでは、工事現場の安全をAI技術で支援しています。
本日は、開発・運用している工事現場の安全確認AIシステム（crassone vista）で利用している大規模言語モデル（LLM）について、最近行った技術プラットフォームの移行経験を共有したいと思います。具体的には、OpenAIのAPIから、Azure OpenAI ServiceのAPIへの乗り換えについてです。

乗り換えの経緯
OpenAIのAPIからAzure OpenAI ServiceのAPIへの移行を決定した最大の理由は、前者のレートリミットの厳しさにありました。
crassone vistaでは毎分カメラから画像を受け取り、AIによる判定を行っておりますが、gpt-4-vision-previewでは一日あたり500リクエストの制約があります。10現場で稼働すると、朝のうちにレートリミットに達してしまうため、乗り換えを決断しました。

Azure OpenAI Serviceへのアクセス申請
Azure OpenAI Serviceを利用するためには、アクセス申請が必要です。申請フォームには、AzureサブスクリプションID、メールアドレス、ユースケースなどを記入する必要があります。
https://customervoice.microsoft.com/Pages/ResponsePage.aspx?id=v4j5cvGGr0GRqy180BHbR7en2Ais5pxKtsoPz4b1xUNTZBNzRKNlVQSFhZMU9aV09EVzYxWFdORCQlQCN0PWcu

2024年2月に私が申請した際は翌日に許可されましたが、現在は審査に10営業日程度要することがありますので、辛抱強く待つ必要があります。

APIの使い方の違い
APIのエンドポイントをOpenAIからAzure OpenAIに切り替える必要があります。

https://learn.microsoft.com/ja-jp/azure/ai-services/openai/how-to/switching-endpoints

OpenAIの場合
import os
from openai import OpenAI

client = OpenAI(
    apikey=os.getenv("OPENAIAPI_KEY")
)

Microsoft Azure OpenAIの場合
import os
from openai import AzureOpenAI

client = AzureOpenAI(
    apikey=os.getenv("AZUREOPENAIAPIKEY"),
    api_version="2023-12-01-preview",
    azureendpoint=os.getenv("AZUREOPENAI_ENDPOINT")
)

GPT-4 Turbo with Visionを使う際の実装例
Chat Completion APIを呼び出す際のコード例です。deployment_nameの設定が初めての挑戦だったため、理解するまでに時間がかかりましたが、以下のように実装しました。

https://learn.microsoft.com/ja-jp/azure/ai-services/openai/how-to/gpt-with-vision?tabs=python%2Csystem-assigned%2Cresource

apibase = '' # APIキーと一緒に発行されたエンドポイント。 https://YOURRESOURCE_NAME.openai.azure.com/
api_key="" # キーとエンドポイントで発行されたキー。
deployment_name = '' # Azure OpenAI Studioのデプロイ名。
api_version = '2023-12-01-preview' # 2024年4月現在はこの値。将来は変わる可能性あり。

client = AzureOpenAI(
    apikey=apikey,
    apiversion=apiversion,
    baseurl=f"{apibase}openai/deployments/{deployment_name}/extensions",
)

response = client.chat.completions.create(
    model=deployment_name,
    messages=[
        { "role": "user", "content": [
            {
                "type": "text",
                "text": "Describe this picture:"
            },
            {
                "type": "image_url",
                "image_url": {
                    "url": ""
                }
            }
        ] }
    ],
    max_tokens=300
)

レスポンスの取得方法
OpenAIのAPIを利用していたときは、以下のように結果を取得していました。

response.json()'choices'['text']

下記のAPIレスポンスのように、messageのcontentに格納されているようです。この変更に気づかずエラーになり少々ハマりました。

response.choices[0].message.content

まとめ
いくつかハマったポイントはありましたが、なんとかAzure OpenAI Serviceへ移行することができました。
Microsoft Azureを業務で利用するのは初めてでしたが、OpenAIから触り始めることはAzureへ入門する良い入り口なのではと感じました。

おわりに
クラッソーネでは、引き続きプロダクトとチームの双方を改善していくために、共に働くエンジニアを募集しています。

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


Azure OpenAI Serviceを使う際にハマったこと

<p>こんにちは！<br />
SREチームの宮原（<a href="https://twitter.com/TakashiMiyahara" target="_blank" rel="nofollow noopener noreferrer">@TakashiMiyahara</a>）です🙋</p>
<p>本日は、「解体工事現場を遠隔で施工管理できる仕組みを構築した」というお話を紹介します。</p>
<blockquote>
<p>国交省が公募した「令和5年度 空き家対策モデル事業」において、当社が提案した「IoTカメラと画像認識AIを用いた空き家解体の施工管理システム」の開発が採択されました。この記事では、その成果を広く一般に公表します。</p>
</blockquote>
<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" aria-hidden="true"></a> はじめに</h2>
<p>本日は、「解体工事現場を遠隔で施工管理できる仕組みを構築した」というお話を紹介します。</p>
<p>国交省が公募した「令和5年度 空き家対策モデル事業」において、当社が提案した「IoTカメラと画像認識AIを用いた空き家解体の施工管理システム」の開発が採択されました。この記事では、その成果を広く一般に公表します。</p>
<ul>
<li>IoTカメラによる工事現場の様子を定点撮影し、画像データを収集</li>
<li>収集した画像データをニアリアルタイムで表示し、モニタリング</li>
<li>収集した画像に「不安全な行動」が見つかった場合に、主任技術者に通知</li>
</ul>
<p><img src="/images/posts/mlit-akiya-reiwa6-project-for-vista/image1.png" alt="モニタリングシステムの画面" /></p>
<p>システム全体の構成は以下の通りです<br />
<img src="/images/posts/mlit-akiya-reiwa6-project-for-vista/image12.png" alt /></p>
<p>実際の仕組みについては、以下で詳しく紹介します。</p>
<h2 id="%E8%AA%B2%E9%A1%8C"><a class="header-anchor-link" href="#%E8%AA%B2%E9%A1%8C" aria-hidden="true"></a> 課題</h2>
<p>多くの工事を受注するようになったものの、工区ごとの進捗を確認するために、主任技術者のクルーが県内や県境を跨いで移動していました。移動費はもちろん、クルー自身の長時間運転による身体的な疲労も問題となっていました。1級施工管理技師などの高い専門性を持つクルーを、本来の業務ではない移動などの作業に割り当てることは、効率的な業務遂行には逆行していました。</p>
<h2 id="%E4%BB%AE%E8%AA%AC%E3%81%A8%E9%80%B2%E3%82%81%E6%96%B9"><a class="header-anchor-link" href="#%E4%BB%AE%E8%AA%AC%E3%81%A8%E9%80%B2%E3%82%81%E6%96%B9" aria-hidden="true"></a> 仮説と進め方</h2>
<p>この課題を解決するために、我々SREチームが立ち上がりました。既存の業務フローの問題点を把握し、「工事現場の様子を遠隔で確認できれば、主任技術者のクルーの負担を軽減し、コストも削減できるのではないか？」という仮説を立てました。</p>
<p>その下で以下の小仮説を設定し、1週間のスプリントで検証と開発を進めました。</p>
<ol>
<li>IoTカメラが工事現場で一定期間稼働できるか</li>
<li>IoTカメラの画像から現場の状況を確認できるか</li>
<li>工区ごとの様子を一覧できると便利か</li>
<li>「不安全行動」を自動検出し通知することが有効か</li>
</ol>
<p>IoTカメラが有効に機能すれば、主任技術者が現場に足を運ぶ頻度を減らすことが可能です。さらに、オフィスや出張先などから、担当している工区の進捗を確認できれば、現場で作業している職人さんに施工指示を遠隔地から出すこともできるようになると考えました。</p>
<h2 id="%E8%A8%BC%E6%98%8E"><a class="header-anchor-link" href="#%E8%A8%BC%E6%98%8E" aria-hidden="true"></a> 証明</h2>
<p>施工チームやパートナーの工事会社と協力し、1週間ごとのスプリントでアジャイルに検証と開発を進めました。快く検証に協力してくださった皆様に感謝の意を表します。ありがとうございました。</p>
<h3 id="%E4%BB%AE%E8%AA%ACa%EF%BC%9Aiot%E3%82%AB%E3%83%A1%E3%83%A9%E3%81%8C%E5%B7%A5%E4%BA%8B%E7%8F%BE%E5%A0%B4%E3%81%A7%E4%B8%80%E5%AE%9A%E6%9C%9F%E9%96%93%E7%A8%BC%E5%83%8D%E3%81%A7%E3%81%8D%E3%82%8B%E3%81%8B"><a class="header-anchor-link" href="#%E4%BB%AE%E8%AA%ACa%EF%BC%9Aiot%E3%82%AB%E3%83%A1%E3%83%A9%E3%81%8C%E5%B7%A5%E4%BA%8B%E7%8F%BE%E5%A0%B4%E3%81%A7%E4%B8%80%E5%AE%9A%E6%9C%9F%E9%96%93%E7%A8%BC%E5%83%8D%E3%81%A7%E3%81%8D%E3%82%8B%E3%81%8B" aria-hidden="true"></a> 仮説A：IoTカメラが工事現場で一定期間稼働できるか</h3>
<p>結論：間欠動作が可能なIoTカメラとバッテリーの利用で実現可能です。</p>
<p>解体工事現場では通常の電源を利用できないため、カメラは独立して撮影とデータの送信を継続する必要があります。この要件を満たすために、「ハイクカム LS4G」を採用しました。</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__0e7e451345836" src="https://embed.zenn.studio/card#zenn-embedded__0e7e451345836" data-content="https%3A%2F%2Fhyke-store.com%2F%3Fpid%3D167840178" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://hyke-store.com/?pid=167840178" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://hyke-store.com/?pid=167840178</a></p>
<p>現場に設置している機材の構成です。</p>
<table>
<thead>
<tr>
<th>項目</th>
<th>商品名</th>
<th>URL</th>
</tr>
</thead>
<tbody>
<tr>
<td>カメラ</td>
<td>ハイクカム LS4G</td>
<td><a href="https://hyke-store.com/?pid=167840178" target="_blank" rel="nofollow noopener noreferrer">https://hyke-store.com/?pid=167840178</a></td>
</tr>
<tr>
<td>バッテリー</td>
<td>ハイク コンプリートバッテリーケース 12V</td>
<td><a href="https://hyke-store.com/?pid=170898420" target="_blank" rel="nofollow noopener noreferrer">https://hyke-store.com/?pid=170898420</a></td>
</tr>
<tr>
<td></td>
<td>ハイク ソーラーパワーパック HC-5W10A</td>
<td><a href="https://hyke-store.com/?pid=175274500" target="_blank" rel="nofollow noopener noreferrer">https://hyke-store.com/?pid=175274500</a></td>
</tr>
<tr>
<td>三脚</td>
<td>Amazonベーシック 軽量 三脚</td>
<td><a href="https://amzn.asia/d/84pwugy" target="_blank" rel="nofollow noopener noreferrer">https://amzn.asia/d/84pwugy</a></td>
</tr>
<tr>
<td>クランプ</td>
<td>Ulanzi スーパークランプ</td>
<td><a href="https://amzn.asia/d/aX877ZA" target="_blank" rel="nofollow noopener noreferrer">https://amzn.asia/d/aX877ZA</a></td>
</tr>
<tr>
<td></td>
<td>NEEWER スーパークランプ</td>
<td><a href="https://amzn.asia/d/04HByb6" target="_blank" rel="nofollow noopener noreferrer">https://amzn.asia/d/04HByb6</a></td>
</tr>
<tr>
<td>雲台</td>
<td>SmallRig 自由雲台</td>
<td><a href="https://amzn.asia/d/5gu1CnZ" target="_blank" rel="nofollow noopener noreferrer">https://amzn.asia/d/5gu1CnZ</a></td>
</tr>
<tr>
<td>コンテナボックス</td>
<td>NTボックス #25</td>
<td><a href="https://amzn.asia/d/5gu1CnZ" target="_blank" rel="nofollow noopener noreferrer">https://amzn.asia/d/5gu1CnZ</a></td>
</tr>
<tr>
<td>SIMカード</td>
<td>ロケットモバイル 神プラン</td>
<td><a href="https://rokemoba.com/" target="_blank" rel="nofollow noopener noreferrer">https://rokemoba.com/</a></td>
</tr>
</tbody>
</table>
<p>設置例です。</p>
<table>
<thead>
<tr>
<th>屋内</th>
<th>屋外</th>
<th>屋外（足場）</th>
</tr>
</thead>
<tbody>
<tr>
<td><img src="/images/posts/mlit-akiya-reiwa6-project-for-vista/image7.jpg" alt /></td>
<td><img src="/images/posts/mlit-akiya-reiwa6-project-for-vista/image9.jpg" alt /></td>
<td><img src="/images/posts/mlit-akiya-reiwa6-project-for-vista/image8.jpg" alt /></td>
</tr>
</tbody>
</table>
<h3 id="%E4%BB%AE%E8%AA%ACb%EF%BC%9Aiot%E3%82%AB%E3%83%A1%E3%83%A9%E3%81%AE%E7%94%BB%E5%83%8F%E3%81%8B%E3%82%89%E7%8F%BE%E5%A0%B4%E3%81%AE%E7%8A%B6%E6%B3%81%E3%81%8C%E7%A2%BA%E8%AA%8D%E3%81%A7%E3%81%8D%E3%82%8B%E3%81%8B"><a class="header-anchor-link" href="#%E4%BB%AE%E8%AA%ACb%EF%BC%9Aiot%E3%82%AB%E3%83%A1%E3%83%A9%E3%81%AE%E7%94%BB%E5%83%8F%E3%81%8B%E3%82%89%E7%8F%BE%E5%A0%B4%E3%81%AE%E7%8A%B6%E6%B3%81%E3%81%8C%E7%A2%BA%E8%AA%8D%E3%81%A7%E3%81%8D%E3%82%8B%E3%81%8B" aria-hidden="true"></a> 仮説B：IoTカメラの画像から現場の状況が確認できるか</h3>
<p>結論：死角はありますが、ある程度の状況は把握可能です。</p>
<p>カメラから送られた画像を受け取り、Slackに順次流す仕組みを構築しました。</p>
<p><img src="/images/posts/mlit-akiya-reiwa6-project-for-vista/image13.png" alt /></p>
<p>クルーはSlackの専用チャンネルを定期的に確認し、現在の様子を確認できるようになりました。<br />
この方法では、過去の画像を確認するためにSlackの投稿を遡る必要があったりと手間がかかることがわかりました。</p>
<p>今回運用しているカメラは単眼のカメラになります。工事現場によっては、設置できる場所が限られてしまうため死角が発生してしまいます。<br />
この場合は、現場の職人さんに協力していただき工事の進捗に応じてカメラの位置を変えていただくことでカバーできるようになりました。<br />
将来的には、360度撮影が可能になると設置場所による制約が緩和されていくと考えています。</p>
<h3 id="%E4%BB%AE%E8%AA%ACc%EF%BC%9A%E5%B7%A5%E5%8C%BA%E3%81%94%E3%81%A8%E3%81%AE%E6%A7%98%E5%AD%90%E3%82%92%E4%B8%80%E8%A6%A7%E3%81%A7%E3%81%8D%E3%82%8B%E3%81%A8%E4%BE%BF%E5%88%A9%E3%81%8B"><a class="header-anchor-link" href="#%E4%BB%AE%E8%AA%ACc%EF%BC%9A%E5%B7%A5%E5%8C%BA%E3%81%94%E3%81%A8%E3%81%AE%E6%A7%98%E5%AD%90%E3%82%92%E4%B8%80%E8%A6%A7%E3%81%A7%E3%81%8D%E3%82%8B%E3%81%A8%E4%BE%BF%E5%88%A9%E3%81%8B" aria-hidden="true"></a> 仮説C：工区ごとの様子を一覧できると便利か</h3>
<p>結論：非常に便利です。</p>
<p>Slackの利用に加え、最新の画像を一覧表示するビューワーアプリケーションを開発しました。</p>
<table>
<thead>
<tr>
<th>機能</th>
<th>ツール名</th>
</tr>
</thead>
<tbody>
<tr>
<td>認証認可</td>
<td>Amazon Cognito</td>
</tr>
<tr>
<td>ストレージ</td>
<td>Amazon Simple Storage Service</td>
</tr>
<tr>
<td>ホスティング</td>
<td>AWS Amplify</td>
</tr>
<tr>
<td>動画作成</td>
<td>FFmpeg + AWS Lambda</td>
</tr>
<tr>
<td>フレームワーク</td>
<td>React</td>
</tr>
</tbody>
</table>
<p>FFmpeg と AWS Lambdaを利用して、タイムラプス動画の作成も行なっています。<br />
タイムラプス動画は、当日の07:00~19:00の間で作成され、最新の動画が閲覧できるようになっています。</p>
<p><img src="/images/posts/mlit-akiya-reiwa6-project-for-vista/output.gif" alt="タイムラプス動画の例" /></p>
<p>最新の静止画に加えてタイムラプス動画も併用することで、主任技術者は任意の時刻の映像を速やかに確認できるようになりました。</p>
<p>現場を担当するクルーにはiPhoneやiPadを支給し、外出先からいつでも閲覧できる体制を構築しました。<br />
オフィスには42インチ4KモニターとChromebookを利用したモニタリングコーナーを設置しました。<br />
内勤の施工チームのクルーが、オフィスにいながら現場の様子を確認できるようになりました。</p>
<p>iPadから任意の現場の様子を確認している例です。<br />
<img src="/images/posts/mlit-akiya-reiwa6-project-for-vista/image10.jpg" alt /></p>
<p>オフィスに設置したモニタリングコーナーの様子です。<br />
<img src="/images/posts/mlit-akiya-reiwa6-project-for-vista/image11.jpg" alt /></p>
<h3 id="%E4%BB%AE%E8%AA%ACd%EF%BC%9A%E3%80%8C%E4%B8%8D%E5%AE%89%E5%85%A8%E8%A1%8C%E5%8B%95%E3%80%8D%E3%82%92%E8%87%AA%E5%8B%95%E6%A4%9C%E5%87%BA%E3%81%97%E9%80%9A%E7%9F%A5%E3%81%99%E3%82%8B%E3%81%A8%E4%BE%BF%E5%88%A9%E3%81%8B"><a class="header-anchor-link" href="#%E4%BB%AE%E8%AA%ACd%EF%BC%9A%E3%80%8C%E4%B8%8D%E5%AE%89%E5%85%A8%E8%A1%8C%E5%8B%95%E3%80%8D%E3%82%92%E8%87%AA%E5%8B%95%E6%A4%9C%E5%87%BA%E3%81%97%E9%80%9A%E7%9F%A5%E3%81%99%E3%82%8B%E3%81%A8%E4%BE%BF%E5%88%A9%E3%81%8B" aria-hidden="true"></a> 仮説D：「不安全行動」を自動検出し通知すると便利か</h3>
<p>結論：非常に便利です。</p>
<p>「不安全な行動」を自動で検出し通知するシステムを開発しました。</p>
<p>クラッソーネでは、以下の様子を「不安全な行動」と判定するAIモデルを開発しました。</p>
<ul>
<li>ヘルメットを未着用である</li>
<li>ヘルメットを不完全に着用している（間にタオルを巻いているや顎紐を占めていないなど）</li>
<li>高所作業時に安全帯（フルハーネス）を未着用である</li>
</ul>
<p>人や顔検出などもモデルは既に高性能なものが公開されていますが、ヘルメットや安全帯の装着状況については全くないといった状況でした。<br />
そこで、弊社のクルーや実際の工事現場の方々にご協力いただき、学習用のデータ取集を行いました。<br />
屋内外や、ヘルメットの色や服装の種類を変えていただき、9,000枚以上の画像を収集できました。</p>
<table>
<thead>
<tr>
<th>安全帯なし</th>
<th>安全帯あり</th>
</tr>
</thead>
<tbody>
<tr>
<td><img src="/images/posts/mlit-akiya-reiwa6-project-for-vista/image2.jpg" alt /></td>
<td><img src="/images/posts/mlit-akiya-reiwa6-project-for-vista/image3.JPG" alt /></td>
</tr>
</tbody>
</table>
<p>※主任技術者の監督のもと、安全に最大限配慮し撮影を行いました。</p>
<p>作成しました判定モデルをOSSとして公開し、工事現場の安全管理にお役立てできればと考えております。<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__10aaddfbbafc" src="https://embed.zenn.studio/card#zenn-embedded__10aaddfbbafc" data-content="https%3A%2F%2Fgithub.com%2Fcrassone%2Fvista-models" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://github.com/crassone/vista-models" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://github.com/crassone/vista-models</a></p>
<p>MITライセンスにて公開しておりますので、ぜひご活用ください。</p>
<p>こちらのモデルを利用して、現場から送られてきた画像に対して逐次判定を行うようにしました。<br />
不安全な行動が見つかった場合は、その理由と対象の画像を主任技術者に向けて配信する仕組みを構築しました。</p>
<table>
<thead>
<tr>
<th>通知の例</th>
<th>通知される画像の詳細</th>
</tr>
</thead>
<tbody>
<tr>
<td><img src="/images/posts/mlit-akiya-reiwa6-project-for-vista/image4.png" alt /></td>
<td><img src="/images/posts/mlit-akiya-reiwa6-project-for-vista/image5.jpg" alt /></td>
</tr>
</tbody>
</table>
<p>※主任技術者の監督のもと、安全に最大限配慮し撮影を行いました。</p>
<p>逐次通知するもしくは、日時でレポートとして主任技術者に配信するなどして活用していきます。</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" aria-hidden="true"></a> まとめ</h2>
<p>2023年6月に始動した本プロジェクトは、多方面からのご支援のおかげで、一定の成果を出し始めています。小規模ながらも迅速にリリースを重ね、現場からの貴重なフィードバックを受け入れながら改善を進めることができました。通常、Webアプリケーションやサービスの監視、可用性、パフォーマンス向上に注力している私たちSREチームにとって、このプロジェクトは新たな挑戦でした。</p>
<p>現場の職人さんや施工チームの方々と直接コミュニケーションを取りながら、日々のディスカッションを重ねる中で、単にコードを書くだけでは得られない、開発の楽しみと充実感を味わうことができました。</p>
<p>プロジェクトを進める中で、雨の日に傘を使った際に頭部が検出できなかったり、屋外に設置したソーラーバッテリーが野生動物のフンで汚れ、発電が止まってしまうなど、リアルワールドでのデプロイメントがもたらす予期せぬ課題に直面しました。これらの経験は、私たちにとって大きな学びとなりました。</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" aria-hidden="true"></a> おわりに</h2>
<p>クラッソーネでは、引き続きプロダクトとチームの双方を改善していくために、共に働くエンジニアを募集しています。また、施工チームで活躍している平川さんのインタビュー記事もございますので、ぜひご覧ください。</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__0b65522b638b5" src="https://embed.zenn.studio/card#zenn-embedded__0b65522b638b5" data-content="https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.crassone.co.jp/recruit/engineer/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://www.crassone.co.jp/recruit/engineer/</a></p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__4db99eacec393" src="https://embed.zenn.studio/card#zenn-embedded__4db99eacec393" data-content="https%3A%2F%2Fwww.crassone.co.jp%2Fblog%2F16172%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.crassone.co.jp/blog/16172/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://www.crassone.co.jp/blog/16172/</a></p>



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

本日は、「解体工事現場を遠隔で施工管理できる仕組みを構築した」というお話を紹介します。

> 国交省が公募した「令和5年度 空き家対策モデル事業」において、当社が提案した「IoTカメラと画像認識AIを用いた空き家解体の施工管理システム」の開発が採択されました。この記事では、その成果を広く一般に公表します。

はじめに
本日は、「解体工事現場を遠隔で施工管理できる仕組みを構築した」というお話を紹介します。

国交省が公募した「令和5年度 空き家対策モデル事業」において、当社が提案した「IoTカメラと画像認識AIを用いた空き家解体の施工管理システム」の開発が採択されました。この記事では、その成果を広く一般に公表します。

IoTカメラによる工事現場の様子を定点撮影し、画像データを収集
収集した画像データをニアリアルタイムで表示し、モニタリング
収集した画像に「不安全な行動」が見つかった場合に、主任技術者に通知

モニタリングシステムの画面

システム全体の構成は以下の通りです

実際の仕組みについては、以下で詳しく紹介します。

課題
多くの工事を受注するようになったものの、工区ごとの進捗を確認するために、主任技術者のクルーが県内や県境を跨いで移動していました。移動費はもちろん、クルー自身の長時間運転による身体的な疲労も問題となっていました。1級施工管理技師などの高い専門性を持つクルーを、本来の業務ではない移動などの作業に割り当てることは、効率的な業務遂行には逆行していました。

仮説と進め方
この課題を解決するために、我々SREチームが立ち上がりました。既存の業務フローの問題点を把握し、「工事現場の様子を遠隔で確認できれば、主任技術者のクルーの負担を軽減し、コストも削減できるのではないか？」という仮説を立てました。

その下で以下の小仮説を設定し、1週間のスプリントで検証と開発を進めました。

IoTカメラが工事現場で一定期間稼働できるか
IoTカメラの画像から現場の状況を確認できるか
工区ごとの様子を一覧できると便利か
「不安全行動」を自動検出し通知することが有効か

IoTカメラが有効に機能すれば、主任技術者が現場に足を運ぶ頻度を減らすことが可能です。さらに、オフィスや出張先などから、担当している工区の進捗を確認できれば、現場で作業している職人さんに施工指示を遠隔地から出すこともできるようになると考えました。

証明
施工チームやパートナーの工事会社と協力し、1週間ごとのスプリントでアジャイルに検証と開発を進めました。快く検証に協力してくださった皆様に感謝の意を表します。ありがとうございました。

仮説A：IoTカメラが工事現場で一定期間稼働できるか
結論：間欠動作が可能なIoTカメラとバッテリーの利用で実現可能です。

解体工事現場では通常の電源を利用できないため、カメラは独立して撮影とデータの送信を継続する必要があります。この要件を満たすために、「ハイクカム LS4G」を採用しました。

https://hyke-store.com/?pid=167840178

現場に設置している機材の構成です。
|項目|商品名|URL|
|---|---|---|
|カメラ|ハイクカム LS4G|https://hyke-store.com/?pid=167840178|
|バッテリー|ハイク コンプリートバッテリーケース 12V|https://hyke-store.com/?pid=170898420|
||ハイク ソーラーパワーパック HC-5W10A|https://hyke-store.com/?pid=175274500|
|三脚|Amazonベーシック 軽量 三脚|https://amzn.asia/d/84pwugy|
|クランプ|Ulanzi スーパークランプ|https://amzn.asia/d/aX877ZA|
||NEEWER スーパークランプ|https://amzn.asia/d/04HByb6|
|雲台|SmallRig 自由雲台|https://amzn.asia/d/5gu1CnZ|
|コンテナボックス|NTボックス #25|https://amzn.asia/d/5gu1CnZ|
|SIMカード|ロケットモバイル 神プラン|https://rokemoba.com/|

設置例です。
|屋内|屋外|屋外（足場）|
|---|---|---|
||||

仮説B：IoTカメラの画像から現場の状況が確認できるか
結論：死角はありますが、ある程度の状況は把握可能です。

カメラから送られた画像を受け取り、Slackに順次流す仕組みを構築しました。

クルーはSlackの専用チャンネルを定期的に確認し、現在の様子を確認できるようになりました。
この方法では、過去の画像を確認するためにSlackの投稿を遡る必要があったりと手間がかかることがわかりました。

今回運用しているカメラは単眼のカメラになります。工事現場によっては、設置できる場所が限られてしまうため死角が発生してしまいます。
この場合は、現場の職人さんに協力していただき工事の進捗に応じてカメラの位置を変えていただくことでカバーできるようになりました。
将来的には、360度撮影が可能になると設置場所による制約が緩和されていくと考えています。

仮説C：工区ごとの様子を一覧できると便利か

結論：非常に便利です。

Slackの利用に加え、最新の画像を一覧表示するビューワーアプリケーションを開発しました。

|機能|ツール名|
|---|---|
|認証認可|Amazon Cognito|
|ストレージ|Amazon Simple Storage Service|
|ホスティング|AWS Amplify|
|動画作成|FFmpeg + AWS Lambda|
|フレームワーク|React|

FFmpeg と AWS Lambdaを利用して、タイムラプス動画の作成も行なっています。
タイムラプス動画は、当日の07:00~19:00の間で作成され、最新の動画が閲覧できるようになっています。

タイムラプス動画の例

最新の静止画に加えてタイムラプス動画も併用することで、主任技術者は任意の時刻の映像を速やかに確認できるようになりました。

現場を担当するクルーにはiPhoneやiPadを支給し、外出先からいつでも閲覧できる体制を構築しました。
オフィスには42インチ4KモニターとChromebookを利用したモニタリングコーナーを設置しました。
内勤の施工チームのクルーが、オフィスにいながら現場の様子を確認できるようになりました。

iPadから任意の現場の様子を確認している例です。

オフィスに設置したモニタリングコーナーの様子です。

仮説D：「不安全行動」を自動検出し通知すると便利か
結論：非常に便利です。

「不安全な行動」を自動で検出し通知するシステムを開発しました。

クラッソーネでは、以下の様子を「不安全な行動」と判定するAIモデルを開発しました。
ヘルメットを未着用である
ヘルメットを不完全に着用している（間にタオルを巻いているや顎紐を占めていないなど）
高所作業時に安全帯（フルハーネス）を未着用である

人や顔検出などもモデルは既に高性能なものが公開されていますが、ヘルメットや安全帯の装着状況については全くないといった状況でした。
そこで、弊社のクルーや実際の工事現場の方々にご協力いただき、学習用のデータ取集を行いました。
屋内外や、ヘルメットの色や服装の種類を変えていただき、9,000枚以上の画像を収集できました。

|安全帯なし|安全帯あり|
|--|--|
|||

※主任技術者の監督のもと、安全に最大限配慮し撮影を行いました。

作成しました判定モデルをOSSとして公開し、工事現場の安全管理にお役立てできればと考えております。
https://github.com/crassone/vista-models

MITライセンスにて公開しておりますので、ぜひご活用ください。

こちらのモデルを利用して、現場から送られてきた画像に対して逐次判定を行うようにしました。
不安全な行動が見つかった場合は、その理由と対象の画像を主任技術者に向けて配信する仕組みを構築しました。

|通知の例|通知される画像の詳細|
|--|--|
|||

※主任技術者の監督のもと、安全に最大限配慮し撮影を行いました。

逐次通知するもしくは、日時でレポートとして主任技術者に配信するなどして活用していきます。

まとめ
2023年6月に始動した本プロジェクトは、多方面からのご支援のおかげで、一定の成果を出し始めています。小規模ながらも迅速にリリースを重ね、現場からの貴重なフィードバックを受け入れながら改善を進めることができました。通常、Webアプリケーションやサービスの監視、可用性、パフォーマンス向上に注力している私たちSREチームにとって、このプロジェクトは新たな挑戦でした。

現場の職人さんや施工チームの方々と直接コミュニケーションを取りながら、日々のディスカッションを重ねる中で、単にコードを書くだけでは得られない、開発の楽しみと充実感を味わうことができました。

プロジェクトを進める中で、雨の日に傘を使った際に頭部が検出できなかったり、屋外に設置したソーラーバッテリーが野生動物のフンで汚れ、発電が止まってしまうなど、リアルワールドでのデプロイメントがもたらす予期せぬ課題に直面しました。これらの経験は、私たちにとって大きな学びとなりました。

クラッソーネは、このプロジェクトを通じて、解体工事現場におけるデジタルトランスフォーメーションを少しでも前進させることができたと感じています。工事現場で働くすべての人々がより豊かな暮らしを実現できるよう、私たちが開発したソフトウェアが一助となれば幸いです。

おわりに
クラッソーネでは、引き続きプロダクトとチームの双方を改善していくために、共に働くエンジニアを募集しています。また、施工チームで活躍している平川さんのインタビュー記事もございますので、ぜひご覧ください。

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

https://www.crassone.co.jp/blog/16172/


解体工事現場を遠隔で施工管理できる仕組みを構築したよ

<p>こんにちは、20年ぶりの完全新作となった「劇場版 機動戦士ガンダムSEED FREEDOM」を初日に見に行き、テンションが爆上がりしている、SREチームの宮原（<a href="https://twitter.com/TakashiMiyahara" target="_blank" rel="nofollow noopener noreferrer">@TakashiMiyahara</a>）です。</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" aria-hidden="true"></a> はじめに</h2>
<p>今回は、Windowsユーザーに特に役立つ情報を共有したいと思います。<br />
Windows向けのパッケージマネージャーである<code>winget</code>を利用して、「業務に必要なアプリケーションを自動でインストールし受け入れ作業を効率化する」話を紹介したいと思います。</p>
<h2 id="winget%E3%81%A8%E3%81%AF"><a class="header-anchor-link" href="#winget%E3%81%A8%E3%81%AF" aria-hidden="true"></a> wingetとは</h2>
<p>Microsoftが開発しているWindows向けのパッケージマネージャーです。<br />
wingetはWindows11と最新バージョンのWindows10にバンドルされており、Windowsユーザーであれば、特別な準備は不要ですぐに利用できます。</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__f09c8169ca304" src="https://embed.zenn.studio/card#zenn-embedded__f09c8169ca304" data-content="https%3A%2F%2Flearn.microsoft.com%2Fja-jp%2Fwindows%2Fpackage-manager%2Fwinget%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://learn.microsoft.com/ja-jp/windows/package-manager/winget/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://learn.microsoft.com/ja-jp/windows/package-manager/winget/</a></p>
<p>サードパーティ製のパッケージマネージャーには、ChocolateyやScoopといったツールもあります。</p>
<p>クラッソーネでは、wingetを活用してWindows PCのセットアップを簡易に行っています。</p>
<h2 id="winget%E3%82%92%E4%BD%BF%E3%81%A3%E3%81%A6%E3%81%BF%E3%82%88%E3%81%86"><a class="header-anchor-link" href="#winget%E3%82%92%E4%BD%BF%E3%81%A3%E3%81%A6%E3%81%BF%E3%82%88%E3%81%86" aria-hidden="true"></a> wingetを使ってみよう</h2>
<h3 id="winget%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB"><a class="header-anchor-link" href="#winget%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB" aria-hidden="true"></a> wingetコマンドのインストール</h3>
<p>コマンドプロンプトなどを起動し、下記このコマンドを実行します。</p>
<div class="code-block-container"><pre class="language-console"><code class="language-console">winget -v
</code></pre></div><p>wingetコマンドが見つからない場合は、Microsoft Storeから<a href="https://apps.microsoft.com/detail/9NBLGGH4NNS1?rtc=1&amp;hl=ja-jp&amp;gl=JP#activetab=pivot:overviewtab" target="_blank" rel="nofollow noopener noreferrer"><code>アプリ インストーラー</code></a>をダウンロードしインストールします。</p>
<p><code>アプリ インストーラー</code>導入後に、再度<code>winget -v</code>コマンドを実行してバージョン番号を取得できるか試してください。</p>
<h3 id="%E3%82%A2%E3%83%97%E3%83%AA%E3%82%B1%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E3%81%AE%E6%A4%9C%E7%B4%A2"><a class="header-anchor-link" href="#%E3%82%A2%E3%83%97%E3%83%AA%E3%82%B1%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E3%81%AE%E6%A4%9C%E7%B4%A2" aria-hidden="true"></a> アプリケーションの検索</h3>
<p>例えば<code>Slack</code>のアプリケーションを探してみましょう。<br />
検索する際は<a href="https://learn.microsoft.com/ja-jp/windows/package-manager/winget/search" target="_blank" rel="nofollow noopener noreferrer"><code>search コマンド</code></a>を利用します。</p>
<p>以下のようなコマンドを実行し、インストールしたいアプリケーションが存在するか検索できます。</p>
<div class="code-block-container"><pre class="language-console"><code class="language-console">winget search "slack"
</code></pre></div><h3 id="%E3%82%A2%E3%83%97%E3%83%AA%E3%82%B1%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB"><a class="header-anchor-link" href="#%E3%82%A2%E3%83%97%E3%83%AA%E3%82%B1%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB" aria-hidden="true"></a> アプリケーションのインストール</h3>
<p>アプリケーションをインストールする場合は<a href="https://learn.microsoft.com/ja-jp/windows/package-manager/winget/install" target="_blank" rel="nofollow noopener noreferrer"><code>install コマンド</code></a>を利用します。</p>
<div class="code-block-container"><pre class="language-console"><code class="language-console">winget install "Slack"
</code></pre></div><h2 id="%E8%A4%87%E6%95%B0%E3%81%AE%E3%82%A2%E3%83%97%E3%83%AA%E3%82%B1%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E3%82%92%E4%B8%80%E6%8B%AC%E3%81%A7%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB%E3%81%99%E3%82%8B"><a class="header-anchor-link" href="#%E8%A4%87%E6%95%B0%E3%81%AE%E3%82%A2%E3%83%97%E3%83%AA%E3%82%B1%E3%83%BC%E3%82%B7%E3%83%A7%E3%83%B3%E3%82%92%E4%B8%80%E6%8B%AC%E3%81%A7%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB%E3%81%99%E3%82%8B" aria-hidden="true"></a> 複数のアプリケーションを一括でインストールする</h2>
<p>wingetを利用して任意のアプリケーションをインストールできることがわかりました。<br />
PCの交換時などでは、複数のアプリケーションを一括でインストールしたい需要があるかと思います。</p>
<p>wingetには<a href="https://learn.microsoft.com/ja-jp/windows/package-manager/winget/export" target="_blank" rel="nofollow noopener noreferrer"><code>export コマンド</code></a>と<a href="https://learn.microsoft.com/ja-jp/windows/package-manager/winget/import" target="_blank" rel="nofollow noopener noreferrer"><code>import コマンド</code></a>が用意されています。<br />
こちらのコマンドを利用することで、一括インストールが実現できそうです。</p>
<h3 id="export-%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89"><a class="header-anchor-link" href="#export-%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89" aria-hidden="true"></a> export コマンド</h3>
<p>wingetを利用して導入したアプリケーションの情報をJSONファイルに出力することが可能です。</p>
<div class="code-block-container"><pre class="language-console"><code class="language-console">winget export installed_software_list.json
</code></pre></div><p>以下は<code>export コマンド</code>の結果をJSONファイルに出力した例です。</p>
<div class="code-block-container"><pre class="language-json"><code class="language-json"><span class="token punctuation">{</span>
	<span class="token property">"$schema"</span> <span class="token operator">:</span> <span class="token string">"https://aka.ms/winget-packages.schema.2.0.json"</span><span class="token punctuation">,</span>
	<span class="token property">"CreationDate"</span> <span class="token operator">:</span> <span class="token string">"2023-01-27T11:58:35.669-00:00"</span><span class="token punctuation">,</span>
	<span class="token property">"Sources"</span> <span class="token operator">:</span> 
	<span class="token punctuation">[</span>
		<span class="token punctuation">{</span>
			<span class="token property">"Packages"</span> <span class="token operator">:</span> 
			<span class="token punctuation">[</span>
				<span class="token punctuation">{</span>
					<span class="token property">"PackageIdentifier"</span> <span class="token operator">:</span> <span class="token string">"Discord.Discord"</span>
				<span class="token punctuation">}</span><span class="token punctuation">,</span>
				<span class="token punctuation">{</span>
					<span class="token property">"PackageIdentifier"</span> <span class="token operator">:</span> <span class="token string">"Zoom.Zoom"</span>
				<span class="token punctuation">}</span><span class="token punctuation">,</span>
				<span class="token punctuation">{</span>
					<span class="token property">"PackageIdentifier"</span> <span class="token operator">:</span> <span class="token string">"Notion.Notion"</span>
				<span class="token punctuation">}</span><span class="token punctuation">,</span>
				<span class="token punctuation">{</span>
					<span class="token property">"PackageIdentifier"</span> <span class="token operator">:</span> <span class="token string">"SlackTechnologies.Slack"</span>
				<span class="token punctuation">}</span><span class="token punctuation">,</span>
				<span class="token punctuation">{</span>
					<span class="token property">"PackageIdentifier"</span> <span class="token operator">:</span> <span class="token string">"Google.Chrome"</span>
				<span class="token punctuation">}</span><span class="token punctuation">,</span>
				<span class="token punctuation">{</span>
					<span class="token property">"PackageIdentifier"</span> <span class="token operator">:</span> <span class="token string">"Google.Drive"</span>
				<span class="token punctuation">}</span><span class="token punctuation">,</span>
				<span class="token punctuation">{</span>
					<span class="token property">"PackageIdentifier"</span> <span class="token operator">:</span> <span class="token string">"Microsoft.VisualStudioCode"</span>
				<span class="token punctuation">}</span>
			<span class="token punctuation">]</span><span class="token punctuation">,</span>
			<span class="token property">"SourceDetails"</span> <span class="token operator">:</span> 
			<span class="token punctuation">{</span>
				<span class="token property">"Argument"</span> <span class="token operator">:</span> <span class="token string">"https://cdn.winget.microsoft.com/cache"</span><span class="token punctuation">,</span>
				<span class="token property">"Identifier"</span> <span class="token operator">:</span> <span class="token string">"Microsoft.Winget.Source_8wekyb3d8bbwe"</span><span class="token punctuation">,</span>
				<span class="token property">"Name"</span> <span class="token operator">:</span> <span class="token string">"winget"</span><span class="token punctuation">,</span>
				<span class="token property">"Type"</span> <span class="token operator">:</span> <span class="token string">"Microsoft.PreIndexed.Package"</span>
			<span class="token punctuation">}</span>
		<span class="token punctuation">}</span>
	<span class="token punctuation">]</span><span class="token punctuation">,</span>
	<span class="token property">"WinGetVersion"</span> <span class="token operator">:</span> <span class="token string">"1.4.10173"</span>
<span class="token punctuation">}</span>
</code></pre></div><p>メインPC上で <code>export コマンド</code>を実行し出力されたファイルを、共有フォルダやGitHubなどで管理しておくことをおすすめします。</p>
<h3 id="import-%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89"><a class="header-anchor-link" href="#import-%E3%82%B3%E3%83%9E%E3%83%B3%E3%83%89" aria-hidden="true"></a> import コマンド</h3>
<p><code>import コマンド</code>を利用することで、<code>export コマンド</code>などで作成したJSONファイルを参照し、PCにアプリケーションをバッチインストールすることができます。</p>
<div class="code-block-container"><pre class="language-console"><code class="language-console">winget import installed_software_list.json
</code></pre></div><p>以下は実行結果の例です。<br />
すでにインストール済みのアプリケーションがある場合は、アップグレードの有無も確認してくれるようですね。</p>
<div class="code-block-container"><pre class="language-console"><code class="language-console">C:\Users\takashi miyahara&gt;winget import installed_software_list.json
既存のパッケージが既にインストールされています。インストールされているパッケージ...をアップグレードしようとしています
適用可能なアップグレードは見つかりませんでした。
パッケージは既にインストールされています: Google.Chrome
既存のパッケージが既にインストールされています。インストールされているパッケージ...をアップグレードしようとしています
適用可能なアップグレードは見つかりませんでした。
パッケージは既にインストールされています: Google.Drive
(1/5) 見つかりました Discord [Discord.Discord] バージョン 1.0.9010
このアプリケーションは所有者からライセンス供与されます。
Microsoft はサードパーティのパッケージに対して責任を負わず、ライセンスも付与しません。
ダウンロード中 https://dl.discordapp.net/distro/app/stable/win/x86/1.0.9010/DiscordSetup.exe
  ██████████████████████████████  79.4 MB / 79.4 MB
インストーラーハッシュが正常に検証されました
パッケージのインストールを開始しています...
インストールが完了しました

(2/5) 見つかりました Zoom [Zoom.Zoom] バージョン 5.13.11835
このアプリケーションは所有者からライセンス供与されます。
Microsoft はサードパーティのパッケージに対して責任を負わず、ライセンスも付与しません。
ダウンロード中 https://cdn.zoom.us/prod/5.13.4.11835/x64/ZoomInstallerFull.exe
  ██████████████████████████████  66.2 MB / 66.2 MB
インストーラーハッシュが正常に検証されました
パッケージのインストールを開始しています...
インストールが完了しました

(3/5) 見つかりました Notion [Notion.Notion] バージョン 2.0.34
このアプリケーションは所有者からライセンス供与されます。
Microsoft はサードパーティのパッケージに対して責任を負わず、ライセンスも付与しません。
ダウンロード中 https://desktop-release.notion-static.com/Notion%20Setup%202.0.34.exe
  ██████████████████████████████  94.5 MB / 94.5 MB
インストーラーハッシュが正常に検証されました
パッケージのインストールを開始しています...
インストールが完了しました

(4/5) 見つかりました Slack [SlackTechnologies.Slack] バージョン 4.28.184
このアプリケーションは所有者からライセンス供与されます。
Microsoft はサードパーティのパッケージに対して責任を負わず、ライセンスも付与しません。
ダウンロード中 https://downloads.slack-edge.com/releases/windows/4.28.184/prod/x64/SlackSetup.exe
  ██████████████████████████████   107 MB /  107 MB
インストーラーハッシュが正常に検証されました
パッケージのインストールを開始しています...
インストールが完了しました

(5/5) 見つかりました Microsoft Visual Studio Code [Microsoft.VisualStudioCode] バージョン 1.74.3
このアプリケーションは所有者からライセンス供与されます。
Microsoft はサードパーティのパッケージに対して責任を負わず、ライセンスも付与しません。
ダウンロード中 https://az764295.vo.msecnd.net/stable/97dec172d3256f8ca4bfb2143f3f76b503ca0534/VSCodeUserSetup-x64-1.74.3.exe
  ██████████████████████████████  88.7 MB / 88.7 MB
インストーラーハッシュが正常に検証されました
パッケージのインストールを開始しています...
インストールが完了しました
</code></pre></div><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" aria-hidden="true"></a> まとめ</h2>
<p>当社では、毎月新しいクルーが参加します。これまでは、必要なアプリケーションを一つずつダウンロードし、手動でインストールする必要がありました。しかし、wingetの導入に伴い、Windows PC上でのアプリケーションインストール作業を自動化することが可能になりました。結果として、新入社員の受け入れ時の業務効率化が実現し、よりスムーズなオンボーディングが可能になりました。</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"></a> おわりに</h2>
<p>クラッソーネでは、プロダクトとチームの双方をより良く改善していけるエンジニアを募集中です！</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__d55992e282d42" src="https://embed.zenn.studio/card#zenn-embedded__d55992e282d42" data-content="https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.crassone.co.jp/recruit/engineer/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://www.crassone.co.jp/recruit/engineer/</a></p>



こんにちは、20年ぶりの完全新作となった「劇場版 機動戦士ガンダムSEED FREEDOM」を初日に見に行き、テンションが爆上がりしている、SREチームの宮原（@TakashiMiyahara）です。

はじめに
今回は、Windowsユーザーに特に役立つ情報を共有したいと思います。
Windows向けのパッケージマネージャーであるwingetを利用して、「業務に必要なアプリケーションを自動でインストールし受け入れ作業を効率化する」話を紹介したいと思います。

wingetとは
Microsoftが開発しているWindows向けのパッケージマネージャーです。
wingetはWindows11と最新バージョンのWindows10にバンドルされており、Windowsユーザーであれば、特別な準備は不要ですぐに利用できます。

https://learn.microsoft.com/ja-jp/windows/package-manager/winget/

サードパーティ製のパッケージマネージャーには、ChocolateyやScoopといったツールもあります。

クラッソーネでは、wingetを活用してWindows PCのセットアップを簡易に行っています。

wingetを使ってみよう
wingetコマンドのインストール
コマンドプロンプトなどを起動し、下記このコマンドを実行します。
winget -v

wingetコマンドが見つからない場合は、Microsoft Storeからアプリ インストーラーをダウンロードしインストールします。

アプリ インストーラー導入後に、再度winget -vコマンドを実行してバージョン番号を取得できるか試してください。

アプリケーションの検索
例えばSlackのアプリケーションを探してみましょう。
検索する際はsearch コマンドを利用します。

以下のようなコマンドを実行し、インストールしたいアプリケーションが存在するか検索できます。
winget search "slack"

アプリケーションのインストール
アプリケーションをインストールする場合はinstall コマンドを利用します。
winget install "Slack"

複数のアプリケーションを一括でインストールする
wingetを利用して任意のアプリケーションをインストールできることがわかりました。
PCの交換時などでは、複数のアプリケーションを一括でインストールしたい需要があるかと思います。

wingetにはexport コマンドとimport コマンドが用意されています。
こちらのコマンドを利用することで、一括インストールが実現できそうです。

export コマンド
wingetを利用して導入したアプリケーションの情報をJSONファイルに出力することが可能です。

winget export installedsoftwarelist.json

以下はexport コマンドの結果をJSONファイルに出力した例です。
{
	"$schema" : "https://aka.ms/winget-packages.schema.2.0.json",
	"CreationDate" : "2023-01-27T11:58:35.669-00:00",
	"Sources" :
	[
		{
			"Packages" :
			[
				{
					"PackageIdentifier" : "Discord.Discord"
				},
				{
					"PackageIdentifier" : "Zoom.Zoom"
				},
				{
					"PackageIdentifier" : "Notion.Notion"
				},
				{
					"PackageIdentifier" : "SlackTechnologies.Slack"
				},
				{
					"PackageIdentifier" : "Google.Chrome"
				},
				{
					"PackageIdentifier" : "Google.Drive"
				},
				{
					"PackageIdentifier" : "Microsoft.VisualStudioCode"
				}
			],
			"SourceDetails" :
			{
				"Argument" : "https://cdn.winget.microsoft.com/cache",
				"Identifier" : "Microsoft.Winget.Source_8wekyb3d8bbwe",
				"Name" : "winget",
				"Type" : "Microsoft.PreIndexed.Package"
			}
		}
	],
	"WinGetVersion" : "1.4.10173"
}

メインPC上で export コマンドを実行し出力されたファイルを、共有フォルダやGitHubなどで管理しておくことをおすすめします。

import コマンド
import コマンドを利用することで、export コマンドなどで作成したJSONファイルを参照し、PCにアプリケーションをバッチインストールすることができます。

winget import installedsoftwarelist.json

以下は実行結果の例です。
すでにインストール済みのアプリケーションがある場合は、アップグレードの有無も確認してくれるようですね。

C:\Users\takashi miyahara>winget import installedsoftwarelist.json
既存のパッケージが既にインストールされています。インストールされているパッケージ...をアップグレードしようとしています
適用可能なアップグレードは見つかりませんでした。
パッケージは既にインストールされています: Google.Chrome
既存のパッケージが既にインストールされています。インストールされているパッケージ...をアップグレードしようとしています
適用可能なアップグレードは見つかりませんでした。
パッケージは既にインストールされています: Google.Drive
(1/5) 見つかりました Discord [Discord.Discord] バージョン 1.0.9010
このアプリケーションは所有者からライセンス供与されます。
Microsoft はサードパーティのパッケージに対して責任を負わず、ライセンスも付与しません。
ダウンロード中 https://dl.discordapp.net/distro/app/stable/win/x86/1.0.9010/DiscordSetup.exe
  ██████████████████████████████  79.4 MB / 79.4 MB
インストーラーハッシュが正常に検証されました
パッケージのインストールを開始しています...
インストールが完了しました

(2/5) 見つかりました Zoom [Zoom.Zoom] バージョン 5.13.11835
このアプリケーションは所有者からライセンス供与されます。
Microsoft はサードパーティのパッケージに対して責任を負わず、ライセンスも付与しません。
ダウンロード中 https://cdn.zoom.us/prod/5.13.4.11835/x64/ZoomInstallerFull.exe
  ██████████████████████████████  66.2 MB / 66.2 MB
インストーラーハッシュが正常に検証されました
パッケージのインストールを開始しています...
インストールが完了しました

(3/5) 見つかりました Notion [Notion.Notion] バージョン 2.0.34
このアプリケーションは所有者からライセンス供与されます。
Microsoft はサードパーティのパッケージに対して責任を負わず、ライセンスも付与しません。
ダウンロード中 https://desktop-release.notion-static.com/Notion%20Setup%202.0.34.exe
  ██████████████████████████████  94.5 MB / 94.5 MB
インストーラーハッシュが正常に検証されました
パッケージのインストールを開始しています...
インストールが完了しました

(4/5) 見つかりました Slack [SlackTechnologies.Slack] バージョン 4.28.184
このアプリケーションは所有者からライセンス供与されます。
Microsoft はサードパーティのパッケージに対して責任を負わず、ライセンスも付与しません。
ダウンロード中 https://downloads.slack-edge.com/releases/windows/4.28.184/prod/x64/SlackSetup.exe
  ██████████████████████████████   107 MB /  107 MB
インストーラーハッシュが正常に検証されました
パッケージのインストールを開始しています...
インストールが完了しました

(5/5) 見つかりました Microsoft Visual Studio Code [Microsoft.VisualStudioCode] バージョン 1.74.3
このアプリケーションは所有者からライセンス供与されます。
Microsoft はサードパーティのパッケージに対して責任を負わず、ライセンスも付与しません。
ダウンロード中 https://az764295.vo.msecnd.net/stable/97dec172d3256f8ca4bfb2143f3f76b503ca0534/VSCodeUserSetup-x64-1.74.3.exe
  ██████████████████████████████  88.7 MB / 88.7 MB
インストーラーハッシュが正常に検証されました
パッケージのインストールを開始しています...
インストールが完了しました

まとめ
当社では、毎月新しいクルーが参加します。これまでは、必要なアプリケーションを一つずつダウンロードし、手動でインストールする必要がありました。しかし、wingetの導入に伴い、Windows PC上でのアプリケーションインストール作業を自動化することが可能になりました。結果として、新入社員の受け入れ時の業務効率化が実現し、よりスムーズなオンボーディングが可能になりました。

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

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


wingetで効率化！業務アプリの自動セットアップ

<p>こんにちは、SREチームの宮原（<a href="https://twitter.com/TakashiMiyahara" target="_blank" rel="nofollow noopener noreferrer">@TakashiMiyahara</a>）です。最近、山岡家によく通っています🙋<br />
今回は、「schemaの変更をトリガーにしてER図を自動で更新する仕組み」について紹介したいと思います</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" aria-hidden="true"></a> はじめに</h2>
<p>リレーショナル・データベースを利用したWebアプリケーションを開発していると、ER図が欲しくなりますよね。<br />
ER図があることでデータベースの構造を視覚的に把握しやすくなる一方で、人の手で継続的にメンテナンスするのは少々手間かと思います。<br />
データベースの構造などに変更があった際に、自動的にER図を更新してくれれば便利なのでは？と考え、クラッソーネで導入してみました。</p>
<h2 id="%E6%BA%96%E5%82%99"><a class="header-anchor-link" href="#%E6%BA%96%E5%82%99" aria-hidden="true"></a> 準備</h2>
<p>今回はRailsアプリケーションを対象としてお話ししたいと思います。</p>
<h3 id="%E3%83%88%E3%83%AA%E3%82%AC%E3%83%BC%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6"><a class="header-anchor-link" href="#%E3%83%88%E3%83%AA%E3%82%AC%E3%83%BC%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6" aria-hidden="true"></a> トリガーについて</h3>
<p>データベースの定義に変化がある場合、Active Recordは <code>db/schema.rb</code> ファイルを更新します。<br />
<code>db/schema.rb</code> に変更があるときは即ち、データベースの定義に変化があった時だと判断できます。<br />
トリガーは、 <code>db/schema.rb</code> に変化が生じた時とします。</p>
<h3 id="er%E5%9B%B3%E3%81%AE%E4%BD%9C%E5%9B%B3%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6"><a class="header-anchor-link" href="#er%E5%9B%B3%E3%81%AE%E4%BD%9C%E5%9B%B3%E3%81%AB%E3%81%A4%E3%81%84%E3%81%A6" aria-hidden="true"></a> ER図の作図について</h3>
<p>Rubyの世界には、 <code>Rails ERD</code> というパワフルなGemが存在します。<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__761b1d86b46f3" src="https://embed.zenn.studio/card#zenn-embedded__761b1d86b46f3" data-content="https%3A%2F%2Fgithub.com%2Fvoormedia%2Frails-erd" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://github.com/voormedia/rails-erd" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://github.com/voormedia/rails-erd</a></p>
<p>Active Record の組み込みリフレクション機能を使用して、モデルがどのように関連付けられているかを把握してくれます。</p>
<p>導入はとても簡単で、Gemfileに以下の内容を追加し、<code>bundle install</code> を行います。</p>
<div class="code-block-container"><pre><code>gem 'rails-erd'
</code></pre></div><p><code>Rails ERD</code> は <code>graphviz</code> を利用しますので、お使いのディストリビューションに合わせてインストールをしてください。</p>
<div class="code-block-container"><pre><code>apt-get install -y graphviz
</code></pre></div><p>準備が整ったら下記のコマンドを実行してER図を出力します。<br />
ただし、テーブルなどが1つも存在しない場合には出力されません。</p>
<div class="code-block-container"><pre><code>bundle exec erd
</code></pre></div><h2 id="github-actions%E3%81%AE%E4%BD%9C%E6%88%90"><a class="header-anchor-link" href="#github-actions%E3%81%AE%E4%BD%9C%E6%88%90" aria-hidden="true"></a> GitHub Actionsの作成</h2>
<p><code>Rails ERD</code> を利用することでER図が作図できることがわかりました。<br />
このままでは、人の手でER図を都度都度更新する必要があります。<br />
それですと少し手間がかかりますので、GitHub Actionsを利用して自動化します。</p>
<h3 id="%E3%83%AF%E3%83%BC%E3%82%AF%E3%83%95%E3%83%AD%E3%83%BC%E3%81%AE%E4%BD%9C%E6%88%90"><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%E4%BD%9C%E6%88%90" aria-hidden="true"></a> ワークフローの作成</h3>
<p>以下に今回作成したワークフローを示します。</p>
<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> Update ER Diagram

<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">paths</span><span class="token punctuation">:</span>
      <span class="token punctuation">-</span> <span class="token string">"db/schema.rb"</span>

<span class="token key atrule">jobs</span><span class="token punctuation">:</span>
  <span class="token key atrule">update_er_diagram</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">services</span><span class="token punctuation">:</span>
      <span class="token key atrule">mysql</span><span class="token punctuation">:</span>
        <span class="token key atrule">image</span><span class="token punctuation">:</span> mysql<span class="token punctuation">:</span><span class="token number">8.2</span>
        <span class="token key atrule">env</span><span class="token punctuation">:</span>
          <span class="token key atrule">MYSQL_ALLOW_EMPTY_PASSWORD</span><span class="token punctuation">:</span> yes
        <span class="token key atrule">ports</span><span class="token punctuation">:</span>
          <span class="token punctuation">-</span> 3306<span class="token punctuation">:</span><span class="token number">3306</span>
        <span class="token key atrule">options</span><span class="token punctuation">:</span> <span class="token punctuation">&gt;</span><span class="token punctuation">-</span>
          <span class="token punctuation">-</span><span class="token punctuation">-</span>health<span class="token punctuation">-</span>cmd "mysqladmin ping"
          <span class="token punctuation">-</span><span class="token punctuation">-</span>health<span class="token punctuation">-</span>interval 10s
          <span class="token punctuation">-</span><span class="token punctuation">-</span>health<span class="token punctuation">-</span>timeout 5s
          <span class="token punctuation">-</span><span class="token punctuation">-</span>health<span class="token punctuation">-</span>retries 5
    <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> Checkout code
        <span class="token key atrule">uses</span><span class="token punctuation">:</span> actions/checkout@v2
        <span class="token key atrule">with</span><span class="token punctuation">:</span>
          <span class="token key atrule">ref</span><span class="token punctuation">:</span> $<span class="token punctuation">{</span><span class="token punctuation">{</span> github.head_ref <span class="token punctuation">}</span><span class="token punctuation">}</span>

      <span class="token punctuation">-</span> <span class="token key atrule">name</span><span class="token punctuation">:</span> Set up Ruby
        <span class="token key atrule">uses</span><span class="token punctuation">:</span> ruby/setup<span class="token punctuation">-</span>ruby@v1
        <span class="token key atrule">with</span><span class="token punctuation">:</span>
          <span class="token key atrule">bundler-cache</span><span class="token punctuation">:</span> <span class="token boolean important">true</span>

      <span class="token punctuation">-</span> <span class="token key atrule">name</span><span class="token punctuation">:</span> Install dependencies
        <span class="token key atrule">run</span><span class="token punctuation">:</span> <span class="token punctuation">|</span><span class="token scalar string">
          sudo apt-get install -y graphviz
          bundle install</span>
      <span class="token punctuation">-</span> <span class="token key atrule">name</span><span class="token punctuation">:</span> Generate ER diagram
        <span class="token key atrule">env</span><span class="token punctuation">:</span>
          <span class="token key atrule">RAILS_ENV</span><span class="token punctuation">:</span> test
        <span class="token key atrule">run</span><span class="token punctuation">:</span> <span class="token punctuation">|</span><span class="token scalar string">
          cp config/database.yml.ci config/database.yml
          bin/rails db:create || true
          bin/rails db:migrate
          bundle exec erd --filetype=png</span>
      <span class="token punctuation">-</span> <span class="token key atrule">name</span><span class="token punctuation">:</span> Commit and push if there are changes
        <span class="token key atrule">run</span><span class="token punctuation">:</span> <span class="token punctuation">|</span><span class="token scalar string">
          git config --local user.email "action@github.com"
          git config --local user.name "GitHub Action"
          git add erd.png
          git commit -m "Update ER diagram" || echo "No changes to commit"
          git push</span>
</code></pre></div><p>必要なライブラリ等をインストールしたのち、 <code>Generate ER diagram</code> という箇所でER図を出力します。<br />
この時に、READMEなどで表示しやすくするために、 <code>--filetype</code> に　<code>png</code> を指定しています。<br />
ここはお好みの <code>--filetype</code> を選んでいただければと思います。</p>
<p>最後に、自動生成された <code>erd.png</code> をリポジトリにコミットします<br />
ここで <code>action@github.com</code> を指定して操作することで、 actions-userとしてコミットできます。<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__ad65fe5314167" src="https://embed.zenn.studio/card#zenn-embedded__ad65fe5314167" data-content="https%3A%2F%2Fgithub.com%2Factions-user" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://github.com/actions-user" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://github.com/actions-user</a></p>
<p><img src="/images/posts/add-rails-erd-github-actions/image01.png" alt /></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" aria-hidden="true"></a> まとめ</h2>
<p>GitHub Actionsを活用することで、自動かつ継続的にER図のメンテナンスが行えるようになりました。</p>
<p>ER図の変更が、プルリクエストの差分に含まれることで、レビューイ・レビュワー双方が、schemaの変更が意図的なものかを確認しやすくなるかと思います。<br />
また、ER図が成長していく過程を追うことができ、これも一つの楽しみです。</p>
<p>Rails.new直後に導入すると常に最新のER図がmainブランチに存在する環境になるのでおすすめです！</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"></a> おわりに</h2>
<p>クラッソーネでは、プロダクトとチームの双方をより良く改善していけるエンジニアを募集中です！</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__784bdd466aa6" src="https://embed.zenn.studio/card#zenn-embedded__784bdd466aa6" data-content="https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.crassone.co.jp/recruit/engineer/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://www.crassone.co.jp/recruit/engineer/</a></p>



こんにちは、SREチームの宮原（@TakashiMiyahara）です。最近、山岡家によく通っています🙋
今回は、「schemaの変更をトリガーにしてER図を自動で更新する仕組み」について紹介したいと思います

はじめに
リレーショナル・データベースを利用したWebアプリケーションを開発していると、ER図が欲しくなりますよね。
ER図があることでデータベースの構造を視覚的に把握しやすくなる一方で、人の手で継続的にメンテナンスするのは少々手間かと思います。
データベースの構造などに変更があった際に、自動的にER図を更新してくれれば便利なのでは？と考え、クラッソーネで導入してみました。

準備
今回はRailsアプリケーションを対象としてお話ししたいと思います。

トリガーについて
データベースの定義に変化がある場合、Active Recordは db/schema.rb ファイルを更新します。
db/schema.rb に変更があるときは即ち、データベースの定義に変化があった時だと判断できます。
トリガーは、 db/schema.rb に変化が生じた時とします。

ER図の作図について
Rubyの世界には、 Rails ERD というパワフルなGemが存在します。
https://github.com/voormedia/rails-erd

Active Record の組み込みリフレクション機能を使用して、モデルがどのように関連付けられているかを把握してくれます。

導入はとても簡単で、Gemfileに以下の内容を追加し、bundle install を行います。
gem 'rails-erd'

Rails ERD は graphviz を利用しますので、お使いのディストリビューションに合わせてインストールをしてください。
apt-get install -y graphviz

準備が整ったら下記のコマンドを実行してER図を出力します。
ただし、テーブルなどが1つも存在しない場合には出力されません。
bundle exec erd

GitHub Actionsの作成
Rails ERD を利用することでER図が作図できることがわかりました。
このままでは、人の手でER図を都度都度更新する必要があります。
それですと少し手間がかかりますので、GitHub Actionsを利用して自動化します。

ワークフローの作成
以下に今回作成したワークフローを示します。

name: Update ER Diagram

on:
  pull_request:
    paths:
      "db/schema.rb"

jobs:
  updateerdiagram:
    runs-on: ubuntu-latest
    services:
      mysql:
        image: mysql:8.2
        env:
          MYSQLALLOWEMPTY_PASSWORD: yes
        ports:
          3306:3306
        options: >-
          --health-cmd "mysqladmin ping"
          --health-interval 10s
          --health-timeout 5s
          --health-retries 5
    steps:
      name: Checkout code
        uses: actions/checkout@v2
        with:
          ref: ${{ github.head_ref }}

      name: Set up Ruby
        uses: ruby/setup-ruby@v1
        with:
          bundler-cache: true

      name: Install dependencies
        run: |
          sudo apt-get install -y graphviz
          bundle install
      name: Generate ER diagram
        env:
          RAILS_ENV: test
        run: |
          cp config/database.yml.ci config/database.yml
          bin/rails db:create || true
          bin/rails db:migrate
          bundle exec erd --filetype=png
      name: Commit and push if there are changes
        run: |
          git config --local user.email "action@github.com"
          git config --local user.name "GitHub Action"
          git add erd.png
          git commit -m "Update ER diagram" || echo "No changes to commit"
          git push

必要なライブラリ等をインストールしたのち、 Generate ER diagram という箇所でER図を出力します。
この時に、READMEなどで表示しやすくするために、 --filetype に　png を指定しています。
ここはお好みの --filetype を選んでいただければと思います。

最後に、自動生成された erd.png をリポジトリにコミットします
ここで action@github.com を指定して操作することで、 actions-userとしてコミットできます。
https://github.com/actions-user

まとめ
GitHub Actionsを活用することで、自動かつ継続的にER図のメンテナンスが行えるようになりました。

ER図の変更が、プルリクエストの差分に含まれることで、レビューイ・レビュワー双方が、schemaの変更が意図的なものかを確認しやすくなるかと思います。
また、ER図が成長していく過程を追うことができ、これも一つの楽しみです。

Rails.new直後に導入すると常に最新のER図がmainブランチに存在する環境になるのでおすすめです！

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

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

schemaの変更をトリガーにER図を自動更新する仕組みの紹介

<p>こんにちは！<br />
SREチームの宮原（<a href="https://twitter.com/TakashiMiyahara" target="_blank" rel="nofollow noopener noreferrer">@TakashiMiyahara</a>）です🙋</p>
<p>本日は、GitHub Actionsのワークフローのトリガーとして、<code>issue_comment</code> を利用したときにハマった話をしたいと思います。</p>
<h2 id="%E3%81%8D%E3%81%A3%E3%81%8B%E3%81%91"><a class="header-anchor-link" href="#%E3%81%8D%E3%81%A3%E3%81%8B%E3%81%91" aria-hidden="true"></a> きっかけ</h2>
<p>pull requestに「deploy-qa」などのコメントを行った時に、GitHub Actionsのワークフローを実行させ、検証環境の構築を行っていました。<br />
（pull request単位の検証環境を構築するお話は、また別の記事で😁）</p>
<p>この時に何度コメントを行ってもワークフローが動かず、半日近い時間を溶かしました💦</p>
<h2 id="%E3%82%B5%E3%83%B3%E3%83%97%E3%83%AB%E3%82%B3%E3%83%BC%E3%83%89"><a class="header-anchor-link" href="#%E3%82%B5%E3%83%B3%E3%83%97%E3%83%AB%E3%82%B3%E3%83%BC%E3%83%89" aria-hidden="true"></a> サンプルコード</h2>
<p>pull requestで、コメントを行った時にPRの番号をechoで出力するワークフローです。</p>
<div class="code-block-container"><pre class="language-yml"><code class="language-yml"><span class="token key atrule">on</span><span class="token punctuation">:</span> issue_comment

<span class="token key atrule">jobs</span><span class="token punctuation">:</span>
  <span class="token key atrule">pr_commented</span><span class="token punctuation">:</span>
    <span class="token key atrule">name</span><span class="token punctuation">:</span> PR comment
    <span class="token key atrule">if</span><span class="token punctuation">:</span> $<span class="token punctuation">{</span><span class="token punctuation">{</span> github.event.issue.pull_request <span class="token punctuation">}</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">run</span><span class="token punctuation">:</span> <span class="token punctuation">|</span><span class="token scalar string">
          echo A comment on PR "$NUMBER"</span>
        <span class="token key atrule">env</span><span class="token punctuation">:</span>
          <span class="token key atrule">NUMBER</span><span class="token punctuation">:</span> $<span class="token punctuation">{</span><span class="token punctuation">{</span> github.event.issue.number <span class="token punctuation">}</span><span class="token punctuation">}</span>
</code></pre></div><p>pull requestのコメントが作成、編集、または削除されたときにワークフローを実行する場合は、<code>issue_comment</code>を利用します。<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__0558d5c8bafe" src="https://embed.zenn.studio/card#zenn-embedded__0558d5c8bafe" data-content="https%3A%2F%2Fdocs.github.com%2Fja%2Factions%2Fusing-workflows%2Fevents-that-trigger-workflows%23pull_request_comment-issue_comment-%25E3%2582%2592%25E4%25BD%25BF%25E7%2594%25A8" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://docs.github.com/ja/actions/using-workflows/events-that-trigger-workflows#pull_request_comment-issue_comment-%E3%82%92%E4%BD%BF%E7%94%A8" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://docs.github.com/ja/actions/using-workflows/events-that-trigger-workflows#pull_request_comment-issue_comment-を使用</a></p>
<p><code>github.event.issue.pull_request</code>の値を利用して、pull requestのコメントかissueのコメントかを判定しています。</p>
<h2 id="%E5%8E%9F%E5%9B%A0"><a class="header-anchor-link" href="#%E5%8E%9F%E5%9B%A0" aria-hidden="true"></a> 原因</h2>
<p>ワークフローをトリガーするイベントが<code>issue_comment</code>のワークフローファイルが、デフォルトブランチに存在しないことが原因でした。</p>
<h2 id="%E8%A7%A3%E6%B1%BA"><a class="header-anchor-link" href="#%E8%A7%A3%E6%B1%BA" aria-hidden="true"></a> 解決</h2>
<p>一縷の望みにすがってTwitterを検索したところ、神速さんのツイートを見つけ、助けられました。大変感謝しています！<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-tweet"><iframe id="zenn-embedded__6bb2219b181c7" src="https://embed.zenn.studio/tweet#zenn-embedded__6bb2219b181c7" data-content="https%3A%2F%2Ftwitter.com%2Fsinsoku_listy%2Fstatus%2F1346015985396957185%3Fs%3D20%26t%3DZl9wrMpAPTayk69DqXRLNw" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://twitter.com/sinsoku_listy/status/1346015985396957185?s=20&amp;t=Zl9wrMpAPTayk69DqXRLNw" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://twitter.com/sinsoku_listy/status/1346015985396957185?s=20&amp;t=Zl9wrMpAPTayk69DqXRLNw</a></p>
<p>こんな大事な情報、公式のドキュメントに書いてないはずが....</p>
<p><br /><br />
<br /><br />
<br /><br />
<br /><br />
<br /><br />
<br /><br />
<br /><br />
<br /><br />
<br /><br />
<br /><br />
<br /><br />
<br /><br />
<br /><br />
<br /><br />
<br /><br />
<br /><br />
<br /><br />
<br /><br />
<br /><br />
<br /></p>
<p>書いてある！！！！！！！！</p>
<blockquote>
<p>注: このイベントは、ワークフローファイルがデフォルト ブランチにある場合にのみワークフローの実行をトリガーします。</p>
</blockquote>
<p><img src="/images/posts/github-actions-on_issue_comment/image1.png" alt /></p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__f3de393a69f4" src="https://embed.zenn.studio/card#zenn-embedded__f3de393a69f4" data-content="https%3A%2F%2Fdocs.github.com%2Fja%2Factions%2Fusing-workflows%2Fevents-that-trigger-workflows%23issue_comment" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://docs.github.com/ja/actions/using-workflows/events-that-trigger-workflows#issue_comment" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://docs.github.com/ja/actions/using-workflows/events-that-trigger-workflows#issue_comment</a></p>
<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" aria-hidden="true"></a> おわりに</h2>
<p>デフォルトブランチにワークフローファイルをマージし、動作確認用のpull requestにコメントしてみたところ、無事ワークフローが動きました🙌<br />
<img src="/images/posts/github-actions-on_issue_comment/image2.png" alt /></p>
<p>クラッソーネでは、プロダクトとチームの双方をより良く改善していけるエンジニアを募集中です！<br />
ご興味ある方はぜひ採用サイトをご覧ください！</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__35604d5a1833e" src="https://embed.zenn.studio/card#zenn-embedded__35604d5a1833e" data-content="https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.crassone.co.jp/recruit/engineer/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://www.crassone.co.jp/recruit/engineer/</a></p>



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

本日は、GitHub Actionsのワークフローのトリガーとして、issue_comment を利用したときにハマった話をしたいと思います。

きっかけ
pull requestに「deploy-qa」などのコメントを行った時に、GitHub Actionsのワークフローを実行させ、検証環境の構築を行っていました。
（pull request単位の検証環境を構築するお話は、また別の記事で😁）

この時に何度コメントを行ってもワークフローが動かず、半日近い時間を溶かしました💦

サンプルコード
pull requestで、コメントを行った時にPRの番号をechoで出力するワークフローです。

on: issue_comment

jobs:
  pr_commented:
    name: PR comment
    if: ${{ github.event.issue.pull_request }}
    runs-on: ubuntu-latest
    steps:
      run: |
          echo A comment on PR "$NUMBER"
        env:
          NUMBER: ${{ github.event.issue.number }}

pull requestのコメントが作成、編集、または削除されたときにワークフローを実行する場合は、issue_commentを利用します。
https://docs.github.com/ja/actions/using-workflows/events-that-trigger-workflows#pullrequestcomment-issue_comment-%E3%82%92%E4%BD%BF%E7%94%A8

github.event.issue.pull_requestの値を利用して、pull requestのコメントかissueのコメントかを判定しています。

原因
ワークフローをトリガーするイベントがissue_commentのワークフローファイルが、デフォルトブランチに存在しないことが原因でした。

解決
一縷の望みにすがってTwitterを検索したところ、神速さんのツイートを見つけ、助けられました。大変感謝しています！
https://twitter.com/sinsoku_listy/status/1346015985396957185?s=20&t=Zl9wrMpAPTayk69DqXRLNw

こんな大事な情報、公式のドキュメントに書いてないはずが....

書いてある！！！！！！！！
> 注: このイベントは、ワークフローファイルがデフォルト ブランチにある場合にのみワークフローの実行をトリガーします。

https://docs.github.com/ja/actions/using-workflows/events-that-trigger-workflows#issue_comment

はい。僕が完全に見逃していました。
猛省ですね。

おわりに
デフォルトブランチにワークフローファイルをマージし、動作確認用のpull requestにコメントしてみたところ、無事ワークフローが動きました🙌

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

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


issue_commentをトリガーにワークフローを実行するときにハマった話


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

本日は、AWS LambdaをTerraformを利用して管理するよ！というお話しです。

💡 きっかけ
クラッソーネのAWS上のリソースは、Terraformを利用してコード化されています。
しかしながら、既存のLambda関数は、AWS サーバーレスアプリケーションモデル (SAM、Serverless Application Model)を利用して、開発・運用されています。
新しいLambda関数を作成するときに、SAMを利用するか、Terraformを利用するかで悩みました。

Terraformを利用して、Lambda関数を開発・運用する知見を得たので、紹介してみたいと思います。

Lambda関数で実行する関数の作成
> 今回は、Pythonを利用したいと思います。

Pipfileの作成
Pipenvを利用して関数を作っていきます。
Pipenvを利用することで、プロジェクトや関数ごとの依存関係を、仮想環境に閉じ込めることができ、ローカルの開発環境を汚さずに開発が行え、とても開発体験が良いです✨

Pipfileに、pytestなど利用するパッケージや、テストやフォーマット用のスクリプトを記述します。
[[source]]
url = "https://pypi.org/simple"
verify_ssl = true
name = "pypi"

[packages]

[dev-packages]
pytest = "*"
pytest-cov = "*"
pytest-mock = "*"
moto = "*"
autopep8 = "*"

[requires]
python_version = "3.10"

[scripts]
test = "bash -c \"PYTHONPATH=src python -m pytest --cov --cov-branch --cov-report=html -v\""
format = "autopep8 -ivr ."

下記コマンドを利用して、必要なパッケージをインストールし、Pipfile.lockファイルを作成します。
pipenv install -d

Lambda関数で実行したい関数の作成
次に lambda_handler関数を作成します。
今回は、sampleという文字列を返すだけにしてみます。
def lambda_handler():
    return 'sample'

次にテストコードを作成します。
import importlib
import pytest

@pytest.fixture
def app():
    return importlib.import_module('src.app')

def testlambdahandler(app):
    ret = app.lambda_handler()

    assert ret == 'sample'

runコマンドからテストを実行します。
pipenv run test

最終的なディレクトリ構造は、以下のようになります。
.
├── Pipfile
├── Pipfile.lock
├── src
│   └── app.py
└── tests
    └── test_app.py

AWSのリソースの作成
次に、Lambda関数を実行するために必要なリソースを定義していきましょう。

ロググループの作成
Lambda関数を実行したときのログを残せるように、ロググループを作成しましょう。
今回は、14日間分のログを維持するようにしています。
こちらは、それぞれのプロジェクトやチームのルールに合わせて設定してください。

resource "awscloudwatchloggroup" "sampleapp" {
  name              = "/aws/lambda/sample-app"
  retentionindays = 14
}

IAM Policy と IAM Roleの作成
Lambda関数を実行したときに、ログストリームへログを出力する権限を設定します。

resource "awsiampolicy" "sample_app" {
  name        = "sample-app-logging-policy"
  path        = "/"
  description = "IAM policy for logging from a sample_app"

  policy = jsonencode(
    {
      "Statement" : [
        {
          "Action" : "logs:CreateLogGroup",
          "Effect" : "Allow",
          "Resource" : "arn:aws:logs:ap-northeast-1:AWSアカウントのID:*"
        },
        {
          "Action" : [
            "logs:CreateLogStream",
            "logs:PutLogEvents"
          ],
          "Effect" : "Allow",
          "Resource" : [
            "arn:aws:logs:ap-northeast-1:AWSアカウントのID:log-group:/aws/lambda/sample-app:*"
          ]
        }
      ],
      "Version" : "2012-10-17"
    }
  )
}

作成した awsiampolicy のARNを、awsiamrole の managedpolicyarns に設定します。
こちらのRoleをLambda関数の実行ロールとして設定しましょう。

resource "awsiamrole" "sample_app" {
  name = "sample-app-execution-role"
  assumerolepolicy = jsonencode(
    {
      "Version" : "2012-10-17",
      "Statement" : [
        {
          "Action" : "sts:AssumeRole",
          "Principal" : {
            "Service" : "lambda.amazonaws.com"
          },
          "Effect" : "Allow",
          "Sid" : ""
        }
      ]
    }
  )

  managedpolicyarns = [
    awsiampolicy.sample_app.arn,
  ]
}

Lambda関数の作成
lambdafunctions/sampleapp/src/app.pyに、Lambda関数で実行したい処理を実装しています。
このファイルをLambda関数で実行したいので、データリソースのarchive_fileを利用します。
terraform plan実行時に、指定したディレクトリのZipファイルを作成してくれます。

data "archivefile" "sampleapp" {
  type        = "zip"
  sourcedir  = "lambdafunctions/sample_app/src"
  outputpath = "lambdafunctions/sample_app/src/app.zip"
}

awslambdafunctionを定義していきます。
function_nameは、プロジェクトやチームの命名ルールに合わせてみてくださいね。
roleには、先ほど作成したIAM RoleのARNを渡します。
handlerには、app.pyのlambdahandler()を呼び出したいので、app.lambdahandlerと設定します。
sourcecodehashには、データリソースの出力ファイルをBase64でエンコードした際のSHA256チェックサムを渡します。
sourcecodehashは、Lambda関数の更新のトリガーに使用できます。app.pyの変更をトリガーに、Lambda関数をTerraformからデプロイできるようになります。

resource "awslambdafunction" "sample_app" {
  filename         = data.archivefile.sampleapp.output_path
  function_name    = "sample-app-function"
  role             = awsiamrole.sample_app.arn
  handler          = "app.lambda_handler"
  runtime          = "python3.9"
  sourcecodehash = data.archivefile.sampleapp.output_base64sha256
}

すでにLambda関数がデプロイ済みでlambdafunctions/sampleapp/src/app.pyを編集し、terraform planを実行すると以下のような出力を得られます。
このことから、app.pyの変更によりLambda関数自体にも、変更が入ることがわかります。
Terraform used the selected providers to generate the following execution
plan. Resource actions are indicated with the following symbols:
  ~ update in-place

Terraform will perform the following actions:

awslambdafunction.sample_app will be updated in-place
  ~ resource "awslambdafunction" "sample_app" {
        id                             = "sample-app-function"
      ~ last_modified                  = "2023-01-06T00:00:00.000+0000" -> (known after apply)
      ~ sourcecodehash               = "*=" -> ""*=""
        tags                           = {}
(19 unchanged attributes hidden)

(2 unchanged blocks hidden)
    }

Plan: 0 to add, 1 to change, 0 to destroy.
> sourcecodehashの値は、マスキングしています。

EventBridgeのルールとトリガーを作成する
作成したLambda関数を、指定したスケジュールで定期的に呼び出したいですよね。
EventBridgeのルールとトリガーを作成し、Lambda関数を紐づけてあげることで、設定が行えます。

以下は、毎時0分に実行するルールです。
resource "awscloudwatcheventrule" "sampleapp" {
  name                = "sample-app-function-rule"
  description         = "Rule to run sample_app hourly."
  schedule_expression = "cron(0 * * * ? *)"
  is_enabled          = true
}

resource "awscloudwatcheventtarget" "sampleapp" {
  rule      = awscloudwatcheventrule.sampleapp.name
  targetid = awscloudwatcheventrule.sample_app.name
  arn       = awslambdafunction.sample_app.arn
}

awslambdapermissionを利用して、awscloudwatcheventruleとawslambda_functionを紐づけます。
resource "awslambdapermission" "sample_app" {
  statement_id  = "AllowExecutionFromCloudWatch"
  action        = "lambda:InvokeFunction"
  functionname = awslambdafunction.sampleapp.function_name
  principal     = "events.amazonaws.com"
  sourcearn    = awscloudwatcheventrule.sample_app.arn
}

最終的な構成

ディレクトリ構造
pythonのソースコードやTerraformのリソース定義を、1つのRepositoryに閉じ込める構成にしてみました。
必要なリソースやLambda関数で実行したい処理だけでを、新規に作成したり、改修したりすることが行いやすくなったかと思います。

.
├── README.md
├── backend.tf
├── cloudwatcheventrule.tf
├── cloudwatcheventtarget.tf
├── cloudwatchloggroup.tf
├── iam_policy.tf
├── iam_role.tf
├── lambda_functions
│   ├── sample_app
│   │   ├── Pipfile
│   │   ├── Pipfile.lock
│   │   ├── README.md
│   │   ├── src
│   │   │   └── app.py
│   │   └── tests
│   │       └── test_app.py
├── lambda.tf
├── lambda_permission.tf
├── provider.tf
└── versions.tf

デプロイの流れ
Pull RequestにApproveが付きマージされると、Terraform Cloudを利用してAWS環境へデプロイされていきます。
Terraformに不慣れなメンバーが多い場合は、Auto applyは許可せず、Manual applyに制限し、詳しいメンバーが最終的な反映をするようにしておくと安全です。

終わりに
今回は、Terraformを利用してLambda関数を作成する構成について紹介してみました。
実行する関数の中身や、関数に必要なリソースをひとまとめにして管理し、デプロイまで行えることがわかりました。
SAMも非常に便利なツールだと思うのですが、他のリソースをTerraformで管理している場合は、Terraformに寄せてしまう方が使い方で悩むことが少なくなるのかなと思いました。

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

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


AWS LambdaをTerraformで管理する

<p>こんにちは！<br />
SREチームの宮原（<a href="https://twitter.com/TakashiMiyahara" target="_blank" rel="nofollow noopener noreferrer">@TakashiMiyahara</a>）です🙋</p>
<p>本日は、開発環境として、<a href="https://github.com/features/codespaces" target="_blank" rel="nofollow noopener noreferrer"><code>GitHub Codespaces</code></a> を利用してみたよ！というお話しです。</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" aria-hidden="true"></a> 💡 きっかけ</h2>
<p>先日の「GitHub Universe 2022」の基調講演にて「GitHub Codespaces」が、無料プランの個人ユーザーにも毎月60時間まで無料で提供することが発表されました。<br />
これを受けて、「良い機会だし、GitHub Codespacesを会社でも開発環境としてトライアルしてみようか」という話になり、着手しました。<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-tweet"><iframe id="zenn-embedded__812c4d301206" src="https://embed.zenn.studio/tweet#zenn-embedded__812c4d301206" data-content="https%3A%2F%2Ftwitter.com%2Fgithub%2Fstatus%2F1590403103014420481" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://twitter.com/github/status/1590403103014420481" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://twitter.com/github/status/1590403103014420481</a></p>
<h2 id="%F0%9F%94%8D-github-codespaces%E3%81%A8%E3%81%AF%EF%BC%9F"><a class="header-anchor-link" href="#%F0%9F%94%8D-github-codespaces%E3%81%A8%E3%81%AF%EF%BC%9F" aria-hidden="true"></a> 🔍 GitHub Codespacesとは？</h2>
<p>Codespacesは、GitHubの機能として利用できるWeb IDEおよび仮想マシンです。GitHubのWebページからワンクリックで開発環境を構築し、コードの編集やデバッグなどが簡単に行えます。</p>
<p><img src="https://docs.github.com/assets/cb-89172/images/help/codespaces/codespaces-diagram.png" alt /></p>
<blockquote>
<p><a href="https://docs.github.com/ja/codespaces/overview#what-is-a-codespace" target="_blank" rel="nofollow noopener noreferrer">https://docs.github.com/ja/codespaces/overview#what-is-a-codespace</a></p>
</blockquote>
<h2 id="%F0%9F%8F%97%EF%B8%8F-%E6%BA%96%E5%82%99"><a class="header-anchor-link" href="#%F0%9F%8F%97%EF%B8%8F-%E6%BA%96%E5%82%99" aria-hidden="true"></a> 🏗️ 準備</h2>
<blockquote>
<p>💡 <strong>Limit spending</strong> や <strong>idle timeout</strong> などは、使用状況に応じて適宜修正してみてください。</p>
</blockquote>
<h3 id="limit-spending%E3%81%AE%E8%A8%AD%E5%AE%9A"><a class="header-anchor-link" href="#limit-spending%E3%81%AE%E8%A8%AD%E5%AE%9A" aria-hidden="true"></a> Limit spendingの設定</h3>
<p><code>Unlimited spending</code>も選択できますが、際限なく料金が発生することを抑制したいので、<code>Limit spending</code>を選択しています。<br />
<img src="/images/posts/use-codespaces/image1.png" alt /></p>
<blockquote>
<p>ここでは、仮に$5を設定しています。まずは、小さめの金額から始めてみるのが良さそうです。</p>
</blockquote>
<p><code>Organization &gt; Settings &gt; Access &gt; Billing and plans &gt; Manage spending limit</code> の中に、<code>Codespaces</code>の項目があります。<br />
<img src="/images/posts/use-codespaces/image0.png" alt /></p>
<p><code>Limit spending</code>で設定した金額分利用すると、以下のようなメールが届きます。<br />
継続して利用したい場合は、<code>Limit spending</code>の値を大きくしてみてください。<br />
<img src="/images/posts/use-codespaces/image11.png" alt /></p>
<h3 id="codespaces-general%E3%81%AE%E8%A8%AD%E5%AE%9A"><a class="header-anchor-link" href="#codespaces-general%E3%81%AE%E8%A8%AD%E5%AE%9A" aria-hidden="true"></a> Codespaces Generalの設定</h3>
<p><code>Organization &gt; Settings &gt; Code, planning, and automation &gt; Codespaces &gt; General</code> から、Codespacesを利用するメンバーを選択します。<br />
<code>Selected members</code>を選択し、任意のメンバーからCodespacesの利用を開始するもよし、<code>All members</code>や<code>All members and outside collaborators</code>を選択し、Organizationに参画しているメンバー一律で利用できるようにするのもありです。</p>
<p><img src="/images/posts/use-codespaces/image2.png" alt /></p>
<blockquote>
<p>上記は<code>Selected members</code>の例です。</p>
</blockquote>
<h3 id="codespaces-policies%E3%81%AE%E8%A8%AD%E5%AE%9A"><a class="header-anchor-link" href="#codespaces-policies%E3%81%AE%E8%A8%AD%E5%AE%9A" aria-hidden="true"></a> Codespaces policiesの設定</h3>
<p><code>Organization &gt; Settings &gt; Code, planning, and automation &gt; Codespaces &gt; Policies</code> から、Codespacesを利用するポリシーを作成します。</p>
<p><img src="/images/posts/use-codespaces/image3.png" alt /><br />
利用するマシンタイプや最大のアイドル時間などを設定します。</p>
<p><code>Change policy target</code>から、ポリシーを適応したいRepositoryを選択することもできるようです。<br />
マシンパワーを必要とするアプリケーション用のポリシーなど、チームやアプリケーションに応じて柔軟に設定できそうですね。<br />
<img src="/images/posts/use-codespaces/image4.png" alt /></p>
<p>ここまでで、利用の準備は完了です。<br />
では、実際に利用してみましょう。</p>
<h2 id="%F0%9F%91%A8%E2%80%8D%F0%9F%92%BB-%E5%88%A9%E7%94%A8%E6%96%B9%E6%B3%95"><a class="header-anchor-link" href="#%F0%9F%91%A8%E2%80%8D%F0%9F%92%BB-%E5%88%A9%E7%94%A8%E6%96%B9%E6%B3%95" aria-hidden="true"></a> 👨‍💻 利用方法</h2>
<p>Codespacesは、ブラウザやローカルのIDE（Visual Studio CodeやJupyterLab）を利用することができます。<br />
今回は、ブラウザから利用する方法をご紹介したいと思います。</p>
<h3 id="%E4%BB%AE%E6%83%B3%E3%83%9E%E3%82%B7%E3%83%B3%E3%81%A8web-ide%E3%81%AE%E8%B5%B7%E5%8B%95"><a class="header-anchor-link" href="#%E4%BB%AE%E6%83%B3%E3%83%9E%E3%82%B7%E3%83%B3%E3%81%A8web-ide%E3%81%AE%E8%B5%B7%E5%8B%95" aria-hidden="true"></a> 仮想マシンとWeb IDEの起動</h3>
<p>Codespacesを利用したいRepositoryにアクセスします。<br />
Repositoryの<code>&lt; &gt; Code</code>を選択して、<code>Create codespace on ブランチ名</code>から、仮想マシンを起動します。</p>
<p><img src="/images/posts/use-codespaces/image5.png" alt /></p>
<p>仮想マシンの起動とともに、Web IDEのVisual Studio Codeが起動します。</p>
<p><img src="/images/posts/use-codespaces/image6.png" alt /></p>
<blockquote>
<p>巨大なコードベースの場合は、多少時間がかかるかもしれません。<br />
クラッソーネのアプリケーションの場合は、数秒で、Visual Studio Codeが起動しました。</p>
</blockquote>
<h3 id="%E9%96%8B%E7%99%BA%E7%92%B0%E5%A2%83%E3%81%AE%E6%A7%8B%E7%AF%89"><a class="header-anchor-link" href="#%E9%96%8B%E7%99%BA%E7%92%B0%E5%A2%83%E3%81%AE%E6%A7%8B%E7%AF%89" aria-hidden="true"></a> 開発環境の構築</h3>
<p>Codespacesのイメージには、Python、 Node、 PHP、 Java、 Go、 C++、 Ruby、 .NET Core/C#などの一般的な言語や、Git、 docker-compose、 ghコマンドなどが導入済みです。<br />
Web IDEが起動すれば、速やかにアプリケーションをビルドして、開発を開始できます。</p>
<p>クラッソーネのアプリケーションは、コンテナ化されているので、以下の手順でサクッと起動できます。</p>
<div class="code-block-container"><pre class="language-shell"><code class="language-shell"><span class="token function">docker</span> compose build
<span class="token function">docker</span> compose pull
<span class="token function">docker</span> compose up
</code></pre></div><p>アプリケーションを起動すると、ポートの一覧に、Codespacesで起動しているアプリケーションの情報が表示されます。<br />
起動しているアプリケーションのポートがフォワードされ、ローカルアドレスにCodespacesにて発行されたURLが表示されます。<br />
<img src="/images/posts/use-codespaces/image7.png" alt /></p>
<blockquote>
<p>ローカルアドレスは、<code>https://GitHubのユーザー名-ランダムな値-ポート番号.preview.app.github.dev</code>の構造となるようです。</p>
</blockquote>
<p>また、ポートの表示範囲は、Private、Private to Organization、Publicの3つから選べるようです。<br />
<img src="/images/posts/use-codespaces/image8.png" alt /><br />
開発中の機能を、他のメンバーに確認して欲しい時は、<code>Private to Organization</code>を選択してURLを共有するなどができそうですね。</p>
<h3 id="%E4%BB%AE%E6%83%B3%E3%83%9E%E3%82%B7%E3%83%B3%E3%81%AE%E5%81%9C%E6%AD%A2%E3%81%A8%E5%89%8A%E9%99%A4"><a class="header-anchor-link" href="#%E4%BB%AE%E6%83%B3%E3%83%9E%E3%82%B7%E3%83%B3%E3%81%AE%E5%81%9C%E6%AD%A2%E3%81%A8%E5%89%8A%E9%99%A4" aria-hidden="true"></a> 仮想マシンの停止と削除</h3>
<p>Web IDEのコマンドパレットを表示し、<code>Stop Current Codespaces</code>から停止できます。<br />
<img src="/images/posts/use-codespaces/image9.png" alt /></p>
<p>もしくは、Repositoryのトップページから、起動中のCodespacesを選択し、停止することもできるようです。<br />
<img src="/images/posts/use-codespaces/image10.png" alt /></p>
<p>削除は、Repositoryのトップページから、起動中のCodespacesを選択し、<code>Delete</code>を選択すると削除できます。</p>
<p>また、Codespaces policiesに、最大のアイドルタイムや保存期間を設定しておくと、そのタイミングが来たときに、停止と削除が実行されます。</p>
<h2 id="%E6%84%9F%E6%83%B3"><a class="header-anchor-link" href="#%E6%84%9F%E6%83%B3" aria-hidden="true"></a> 感想</h2>
<p>Codespacesを利用して、アプリケーションの開発をしたり、この記事を執筆したりしてみました。</p>
<p>ローカル環境では、Docker Desktop for MacとApple M1の相性が良くなく、buildに時間を要していました。<br />
Codespacesでは、仮想マシンの起動から環境構築までが5分以内で完了し、すぐに開発に着手でき、とても良い体験でした。<br />
（コンテナイメージのPullやGemのインストールが高速で、コーヒーを入れる時間もないくらいでした😁）</p>
<p>加えて、開発チームメンバーの開発環境を揃えるという観点でも、Codespacesの利用はメリットが大きいなと感じました。<br />
開発マシンのアーキテクチャの差異により、開発環境の構築に時間を要してしまい、開発者体験が損なわれることが減りそうです。</p>
<p>また、gitやghコマンドが利用できるので、実装、テスト、コミット、リモートへのPush、PRの作成、コードレビューが、ブラウザで完結できるところも良い体験でした。</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"></a> おわりに</h2>
<p>クラッソーネでは、プロダクトとチームの双方をより良く改善していけるエンジニアを募集中です！<br />
ご興味ある方はぜひ採用サイトをご覧ください！</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__ceef19cbce382" src="https://embed.zenn.studio/card#zenn-embedded__ceef19cbce382" data-content="https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.crassone.co.jp/recruit/engineer/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://www.crassone.co.jp/recruit/engineer/</a></p>



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

本日は、開発環境として、GitHub Codespaces を利用してみたよ！というお話しです。

💡 きっかけ
先日の「GitHub Universe 2022」の基調講演にて「GitHub Codespaces」が、無料プランの個人ユーザーにも毎月60時間まで無料で提供することが発表されました。
これを受けて、「良い機会だし、GitHub Codespacesを会社でも開発環境としてトライアルしてみようか」という話になり、着手しました。
https://twitter.com/github/status/1590403103014420481

🔍 GitHub Codespacesとは？
Codespacesは、GitHubの機能として利用できるWeb IDEおよび仮想マシンです。GitHubのWebページからワンクリックで開発環境を構築し、コードの編集やデバッグなどが簡単に行えます。

> https://docs.github.com/ja/codespaces/overview#what-is-a-codespace

🏗️ 準備
> 💡 Limit spending や idle timeout などは、使用状況に応じて適宜修正してみてください。

Limit spendingの設定
Unlimited spendingも選択できますが、際限なく料金が発生することを抑制したいので、Limit spendingを選択しています。

> ここでは、仮に$5を設定しています。まずは、小さめの金額から始めてみるのが良さそうです。

Organization > Settings > Access > Billing and plans > Manage spending limit の中に、Codespacesの項目があります。

Limit spendingで設定した金額分利用すると、以下のようなメールが届きます。
継続して利用したい場合は、Limit spendingの値を大きくしてみてください。

Codespaces Generalの設定
Organization > Settings > Code, planning, and automation > Codespaces > General から、Codespacesを利用するメンバーを選択します。
Selected membersを選択し、任意のメンバーからCodespacesの利用を開始するもよし、All membersやAll members and outside collaboratorsを選択し、Organizationに参画しているメンバー一律で利用できるようにするのもありです。

> 上記はSelected membersの例です。

Codespaces policiesの設定
Organization > Settings > Code, planning, and automation > Codespaces > Policies から、Codespacesを利用するポリシーを作成します。

利用するマシンタイプや最大のアイドル時間などを設定します。

Change policy targetから、ポリシーを適応したいRepositoryを選択することもできるようです。
マシンパワーを必要とするアプリケーション用のポリシーなど、チームやアプリケーションに応じて柔軟に設定できそうですね。

ここまでで、利用の準備は完了です。
では、実際に利用してみましょう。

👨‍💻 利用方法
Codespacesは、ブラウザやローカルのIDE（Visual Studio CodeやJupyterLab）を利用することができます。
今回は、ブラウザから利用する方法をご紹介したいと思います。

仮想マシンとWeb IDEの起動
Codespacesを利用したいRepositoryにアクセスします。
Repositoryの Codeを選択して、Create codespace on ブランチ名から、仮想マシンを起動します。

仮想マシンの起動とともに、Web IDEのVisual Studio Codeが起動します。

> 巨大なコードベースの場合は、多少時間がかかるかもしれません。
> クラッソーネのアプリケーションの場合は、数秒で、Visual Studio Codeが起動しました。

開発環境の構築
Codespacesのイメージには、Python、 Node、 PHP、 Java、 Go、 C++、 Ruby、 .NET Core/C#などの一般的な言語や、Git、 docker-compose、 ghコマンドなどが導入済みです。
Web IDEが起動すれば、速やかにアプリケーションをビルドして、開発を開始できます。

クラッソーネのアプリケーションは、コンテナ化されているので、以下の手順でサクッと起動できます。

docker compose build
docker compose pull
docker compose up

アプリケーションを起動すると、ポートの一覧に、Codespacesで起動しているアプリケーションの情報が表示されます。
起動しているアプリケーションのポートがフォワードされ、ローカルアドレスにCodespacesにて発行されたURLが表示されます。

> ローカルアドレスは、https://GitHubのユーザー名-ランダムな値-ポート番号.preview.app.github.devの構造となるようです。

また、ポートの表示範囲は、Private、Private to Organization、Publicの3つから選べるようです。

開発中の機能を、他のメンバーに確認して欲しい時は、Private to Organizationを選択してURLを共有するなどができそうですね。

仮想マシンの停止と削除

Web IDEのコマンドパレットを表示し、Stop Current Codespacesから停止できます。

もしくは、Repositoryのトップページから、起動中のCodespacesを選択し、停止することもできるようです。

削除は、Repositoryのトップページから、起動中のCodespacesを選択し、Deleteを選択すると削除できます。

また、Codespaces policiesに、最大のアイドルタイムや保存期間を設定しておくと、そのタイミングが来たときに、停止と削除が実行されます。

感想
Codespacesを利用して、アプリケーションの開発をしたり、この記事を執筆したりしてみました。

ローカル環境では、Docker Desktop for MacとApple M1の相性が良くなく、buildに時間を要していました。
Codespacesでは、仮想マシンの起動から環境構築までが5分以内で完了し、すぐに開発に着手でき、とても良い体験でした。
（コンテナイメージのPullやGemのインストールが高速で、コーヒーを入れる時間もないくらいでした😁）

加えて、開発チームメンバーの開発環境を揃えるという観点でも、Codespacesの利用はメリットが大きいなと感じました。
開発マシンのアーキテクチャの差異により、開発環境の構築に時間を要してしまい、開発者体験が損なわれることが減りそうです。

また、gitやghコマンドが利用できるので、実装、テスト、コミット、リモートへのPush、PRの作成、コードレビューが、ブラウザで完結できるところも良い体験でした。

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

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


開発環境としてGitHub Codespacesを使ってみたら、最高体験だった

<p>こんにちは！<br />
SREチームの宮原（<a href="https://twitter.com/TakashiMiyahara" target="_blank" rel="nofollow noopener noreferrer">@TakashiMiyahara</a>）です🙋</p>
<p>本日は、<a href="https://www.wantedly.com/companies/classi/post_articles/145844" target="_blank" rel="nofollow noopener noreferrer"><code>Classi株式会社さん</code></a> や <a href="https://tech.medpeer.co.jp/entry/2018/10/24/180932" target="_blank" rel="nofollow noopener noreferrer"><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" aria-hidden="true"></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" aria-hidden="true"></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" aria-hidden="true"></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" aria-hidden="true"></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" aria-hidden="true"></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" aria-hidden="true"></a> おわりに</h2>
<p>プロダクトをより良くする活動がクラッソーネに誕生し、技術的負債に立ち向かう大きな一歩になったと感じています。<br />
「整地部」の活動は始まったばかりですが、より良いプロダクトを開発・維持していくために、活動していきます。</p>
<p>クラッソーネでは、プロダクトとチームの双方をより良く改善していけるエンジニアを募集中です！<br />
ご興味ある方はぜひ採用サイトをご覧ください！</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__283ea447ca2f2" src="https://embed.zenn.studio/card#zenn-embedded__283ea447ca2f2" data-content="https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.crassone.co.jp/recruit/engineer/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">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" target="_blank" rel="nofollow noopener noreferrer">@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" aria-hidden="true"></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" aria-hidden="true"></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" aria-hidden="true"></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" aria-hidden="true"></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" aria-hidden="true"></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" aria-hidden="true"></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" aria-hidden="true"></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" aria-hidden="true"></a> おわりに</h2>
<p>クラッソーネでは、プロダクトとチームの双方をより良く改善していけるエンジニアを募集中です！</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__57c8f88bcb12b" src="https://embed.zenn.studio/card#zenn-embedded__57c8f88bcb12b" data-content="https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.crassone.co.jp/recruit/engineer/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">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" target="_blank" rel="nofollow noopener noreferrer">@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" aria-hidden="true"></a> tfsecとは？</h2>
<p><a href="https://aquasecurity.github.io/tfsec/" target="_blank" rel="nofollow noopener noreferrer">tfsec</a>は、Terraform向けの静的解析ツールです。<br />
実装内容がセキュリティ的にベストプラクティスに沿っているかなどを指摘してくれるため、Terraformでコードを書く方には強く導入をおすすめします。</p>
<p>tfsecに関しては、<a href="https://qiita.com/reireias" target="_blank" rel="nofollow noopener noreferrer">@reireiasさん</a>が詳しく紹介してくれていますので、下記の記事も併せて確認いただければと思います✨<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__4b512c8e4619e" src="https://embed.zenn.studio/card#zenn-embedded__4b512c8e4619e" data-content="https%3A%2F%2Fqiita.com%2Freireias%2Fitems%2F71671cc516424421f7f3" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://qiita.com/reireias/items/71671cc516424421f7f3" style="display:none" target="_blank" rel="nofollow noopener noreferrer">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" aria-hidden="true"></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" target="_blank" rel="nofollow noopener noreferrer">terraform-security-scan</a>を利用して、Pull Request作成時にtfsecを実行していました🙋</p>
<p>現在は、<a href="https://github.com/aquasecurity/tfsec-pr-commenter-action" target="_blank" rel="nofollow noopener noreferrer">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" aria-hidden="true"></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" aria-hidden="true"></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" target="_blank" rel="nofollow noopener noreferrer">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/" target="_blank" rel="nofollow noopener noreferrer">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" aria-hidden="true"></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" aria-hidden="true"></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" aria-hidden="true"></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" aria-hidden="true"></a> ワークフローの実行時間</h2>
<p><code>tfsec-pr-commenter-action</code>を利用するワークフローの方が高速であることがわかりました🙋</p>
<h3 id="before"><a class="header-anchor-link" href="#before" aria-hidden="true"></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" aria-hidden="true"></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" aria-hidden="true"></a> 警告があった場合のコメント例</h2>
<p>どちらのワークフローでも重要度やリファレンスのURLなどの情報が、Pull Requestにコメントされることがわかりました🙋</p>
<h3 id="before-1"><a class="header-anchor-link" href="#before-1" aria-hidden="true"></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-1"><a class="header-anchor-link" href="#after-1" aria-hidden="true"></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" aria-hidden="true"></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" aria-hidden="true"></a> おわりに</h2>
<p>クラッソーネでは、プロダクトとチームの双方をより良く改善していけるエンジニアを募集中です！</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__4f5a94e3ef5df" src="https://embed.zenn.studio/card#zenn-embedded__4f5a94e3ef5df" data-content="https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.crassone.co.jp/recruit/engineer/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">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" target="_blank" rel="nofollow noopener noreferrer">@TakashiMiyahara</a>）です🙋</p>
<p>SREチームでは、<a href="https://www.terraform.io/" target="_blank" rel="nofollow noopener noreferrer">Terraform</a>によるインフラのコード化を進めています。<br />
既存のリソースをTerraform管理下に置く場合は、<a href="https://www.terraform.io/cli/commands/import" target="_blank" rel="nofollow noopener noreferrer">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" target="_blank" rel="nofollow noopener noreferrer">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"></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"></a> 報告方法</h2>
<p>不備を見つけたので、 <code>HashiCorp AWS Provider team</code> へ報告します。<br />
Terraformのドキュメントページには、<a href="https://github.com/hashicorp/terraform-provider-aws/issues" target="_blank" rel="nofollow noopener noreferrer">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"></a> 起票したissue</h2>
<p>実際に起票したissueはこちらになります。<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__f8f02c016e8c8" src="https://embed.zenn.studio/card#zenn-embedded__f8f02c016e8c8" data-content="https%3A%2F%2Fgithub.com%2Fhashicorp%2Fterraform-provider-aws%2Fissues%2F24355" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://github.com/hashicorp/terraform-provider-aws/issues/24355" style="display:none" target="_blank" rel="nofollow noopener noreferrer">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" target="_blank" rel="nofollow noopener noreferrer">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"></a> 作成したパッチ</h2>
<p>修正対応のPRはこちらです。<br style="display:none" />
<span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__19d2a2f4385e" src="https://embed.zenn.studio/card#zenn-embedded__19d2a2f4385e" data-content="https%3A%2F%2Fgithub.com%2Fhashicorp%2Fterraform-provider-aws%2Fpull%2F24373" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://github.com/hashicorp/terraform-provider-aws/pull/24373" style="display:none" target="_blank" rel="nofollow noopener noreferrer">https://github.com/hashicorp/terraform-provider-aws/pull/24373</a></p>
<p>DrFaust92さん、メンテナーの<a href="https://github.com/ewbankkit" target="_blank" rel="nofollow noopener noreferrer">ewbankkit</a>さんにレビューいただいて、無事マージされました🙌<br />
コミュニティに迎え入れてくれたメンテナーの皆様、ありがとうございます✨</p>
<blockquote>
<p>2022年4月28日に、<a href="https://github.com/hashicorp/terraform-provider-aws/tree/v4.12.0" target="_blank" rel="nofollow noopener noreferrer">v4.12.0</a>がリリースされました。<br />
このバージョンから、<a href="https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/cloudwatch_dashboard#import" target="_blank" rel="nofollow noopener noreferrer">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"></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"></a> おわりに</h2>
<p>クラッソーネでは、プロダクトとチームの双方をより良く改善していけるエンジニアを募集中です！</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__17e65bed894b1" src="https://embed.zenn.studio/card#zenn-embedded__17e65bed894b1" data-content="https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.crassone.co.jp/recruit/engineer/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">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"></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"></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"></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"></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"></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"></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"></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"></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"></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"></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"></a> おわりに</h2>
<p>SREチーム立ち上げの取り組みとしてご紹介するTipsは、沢山ございます！<br />
次回は、DatadogのNotebookに障害調査方法をまとめるTipsについてご紹介したいと思います🙋</p>
<p>クラッソーネでは一緒に働く仲間を募集しています🙌<br />
一緒に日本の空き家問題にエンジニアリングで参加してみませんか？<br />
ご応募をお待ちしております！</p>
<p><span class="embed-block zenn-embedded zenn-embedded-card"><iframe id="zenn-embedded__a0ed57897ae5c" src="https://embed.zenn.studio/card#zenn-embedded__a0ed57897ae5c" data-content="https%3A%2F%2Fwww.crassone.co.jp%2Frecruit%2Fengineer%2F" frameborder="0" scrolling="no" loading="lazy"></iframe></span><a href="https://www.crassone.co.jp/recruit/engineer/" style="display:none" target="_blank" rel="nofollow noopener noreferrer">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"></a> 参考文献</h2>
<ul>
<li><a href="https://en.wikipedia.org/wiki/Computer_vision" target="_blank" rel="nofollow noopener noreferrer">Computer Vision</a></li>
<li><a href="https://en.wikipedia.org/wiki/Human%E2%80%93computer_interaction" target="_blank" rel="nofollow noopener noreferrer">Human Computer Interaction</a></li>
<li><a href="https://docs.github.com/ja/issues/trying-out-the-new-projects-experience/about-projects" target="_blank" rel="nofollow noopener noreferrer">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)


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

宮原崇志が執筆した記事

Make(Integromat)で公式モジュールが用意されていないサービスのAPIと連携する方法

macOS SonomaでESET Endpoint Antivirusを導入するときにハマったこと

Azure OpenAI Serviceを使う際にハマったこと

解体工事現場を遠隔で施工管理できる仕組みを構築したよ

wingetで効率化！業務アプリの自動セットアップ

schemaの変更をトリガーにER図を自動更新する仕組みの紹介

issue_commentをトリガーにワークフローを実行するときにハマった話

AWS LambdaをTerraformで管理する

開発環境としてGitHub Codespacesを使ってみたら、最高体験だった

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

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

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

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

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

宮原 崇志が執筆した記事

Make(Integromat)で公式モジュールが用意されていないサービスのAPIと連携する方法

macOS SonomaでESET Endpoint Antivirusを導入するときにハマったこと

Azure OpenAI Serviceを使う際にハマったこと

解体工事現場を遠隔で施工管理できる仕組みを構築したよ

wingetで効率化！業務アプリの自動セットアップ

schemaの変更をトリガーにER図を自動更新する仕組みの紹介

issue_commentをトリガーにワークフローを実行するときにハマった話

AWS LambdaをTerraformで管理する

開発環境としてGitHub Codespacesを使ってみたら、最高体験だった

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

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

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

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

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

宮原崇志が執筆した記事