以前、Visual Studioのデバッグ実行でpulumi previewを実行する方法を紹介しました。今回はデバッグ実行中のPulumiにデバッガーをアタッチする方法を紹介します。これを使うとPulumi実行時にブレークポイントを仕込んで実行しつつ経過確認したり、変数の値を確認したり、ウォッチウィンドウを使えます。

Debug Adapter Protocol
Visual Studioでのデバッガーアタッチ
- --attach-debugger引数を追加
- Visual Studioでデバッグ実行 & プロセスへデバッガーアタッチ
注意
まとめ
参考

Debug Adapter Protocol

Pulumiは各種IDEに対してDebug Adapter Protocolをサポートしています。公式のデバッガー記事にはVS Codeのデバッガーを使った方法が紹介されていますが、Visual Studioはpulumi preview --attach-debuggerを使ってデバッガーを差し込むことになります。

Visual Studioでのデバッガーアタッチ

以前の記事で、Visual Studioのデバッグ実行でpulumi previewを仕込みました。これをベースにデバッガーをアタッチする流れを説明します。

{
  "profiles": {
    "pulumi": {
      "commandName": "Executable",
      "executablePath": "pulumi",
      "commandLineArgs": "preview --refresh --stack {スタック名}",
      "environmentVariables": {
        "IS_DEBUG": "false",
        "AWS_PROFILE": "{AWS_PROFILE_NAME}"
      }
    }
  }
}

`--attach-debugger`引数を追加

pulumiの実行時に--attach-debugger引数を追加します。これでPulumi実行中にデバッガーがアタッチされるまで実行が止まります。

{
  "profiles": {
    "pulumi": {
      "commandName": "Executable",
      "executablePath": "pulumi",
      "commandLineArgs": "preview --attach-debugger --refresh --stack {スタック名}",
      "environmentVariables": {
        "IS_DEBUG": "false",
        "AWS_PROFILE": "{AWS_PROFILE_NAME}"
      }
    }
  }
}

Visual Studioでデバッグ実行 & プロセスへデバッガーアタッチ

Visual Studioで適当にブレークポイントを仕込みましょう。今回はregionを取得している箇所でブレークポイントを仕込みます。

var region = Output.Create(Pulumi.Aws.GetRegion.InvokeAsync()).Apply(x => x.Id);

alt text

Visual Studioでデバッグ実行(F5)を開始します。Pulumiの実行が始まるとコンソール出力が止まり、デバッガーがアタッチされるまで待機します¹。

Previewing update (master)

View in Browser (Ctrl+O): https://app.pulumi.com/foobar/.....

     Type                                      Name                                               Plan           Info
     省略....
 ~   └─ pkg:component:route53                                   route53-foo
 ~      └─ aws:route53:Zone                                     route53-foo-zone

Visual StudioのメニューからDebug > Attach to Process...を選択します。

Attach to Process... の選択