<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__50ee7f7255756" src="https://embed.zenn.studio/card#zenn-embedded__50ee7f7255756" 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__d2a913af9605b" src="https://embed.zenn.studio/tweet#zenn-embedded__d2a913af9605b" 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__3518056ebe514" src="https://embed.zenn.studio/card#zenn-embedded__3518056ebe514" 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__0c3e9c91075be" src="https://embed.zenn.studio/card#zenn-embedded__0c3e9c91075be" 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__0977e36c2ec1e" src="https://embed.zenn.studio/tweet#zenn-embedded__0977e36c2ec1e" 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__1e7af4c3d76c8" src="https://embed.zenn.studio/card#zenn-embedded__1e7af4c3d76c8" 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__775077165215d" src="https://embed.zenn.studio/card#zenn-embedded__775077165215d" 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__2661b34a1f9f7" src="https://embed.zenn.studio/card#zenn-embedded__2661b34a1f9f7" 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__d5a963fed1b45" src="https://embed.zenn.studio/card#zenn-embedded__d5a963fed1b45" 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__e975d212b3918" src="https://embed.zenn.studio/card#zenn-embedded__e975d212b3918" 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__3f55a28e5a003" src="https://embed.zenn.studio/card#zenn-embedded__3f55a28e5a003" 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__086bb827e4569" src="https://embed.zenn.studio/card#zenn-embedded__086bb827e4569" 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__1209504a6ea2f" src="https://embed.zenn.studio/card#zenn-embedded__1209504a6ea2f" 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__0fa061e64cade" src="https://embed.zenn.studio/card#zenn-embedded__0fa061e64cade" 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)


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

宮原崇志が執筆した記事

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

AWS LambdaをTerraformで管理する

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

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

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

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

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

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

宮原 崇志が執筆した記事

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

AWS LambdaをTerraformで管理する

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

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

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

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

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

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

宮原崇志が執筆した記事