デバッガーで実行中の Go プロセスにアタッチする

ステップ 1. gops パッケージをインストールする

• ターミナルツールウィンドウ（表示 | ツールウィンドウ | ターミナル）を開き、次のコマンドを実行します。

  go get -t github.com/google/gops/

• 実行 | プロセスにアタッチ（Ctrl+Alt+F5）をクリックします。通知ウィンドウで、「go get gops」を呼び出すリンクをクリックします。

  

ステップ 2. アプリケーションをビルドして実行する

1. 表示 | ツールウィンドウ | ターミナルに移動してターミナルツールウィンドウを開き、次のコマンドを実行します。

   go build -gcflags="all=-N -l" -o myApp.exe

   このコマンドは、myApp.exe 実行可能ファイルをコンパイルし、コンパイラーの最適化とインライン展開を無効にします。

2. コンパイルされた実行可能ファイルを実行します。

   .\myApp.exe

   

ステップ 3. 実行中のプロセスにアタッチしてデバッグする

1. ブレークポイントを設定するコード行の横にあるガターをクリックします。提供されている例(英語)では、行 23 (message := fmt.Sprintf("Hello %s!", r.UserAgent())) にブレークポイントを配置します。ブレークポイントのブレークポイントの詳細については、こちらを参照してください。

2. 実行 | プロセスにアタッチをクリックするか、ショートカット Ctrl+Alt+F5 を使用します。

3. デバッガーで接続するウィンドウでアプリケーションプロセスを選択し、Enter を押します。

4. アプリケーション内のブレークポイントに関連付けられたイベントをトリガーします。提供されているコード例を使用する場合は、ブラウザーで http://localhost:8080/ リンクを開きます。

ステップ 1. リモートコンピューターでアプリケーションを構築する

• ターミナルツールウィンドウ（表示 | ツールウィンドウ | ターミナル）を開き、次のコマンドを実行します。

  go build -gcflags="all=-N -l" -o myApp.exe

  このコマンドは、myApp.exe 実行可能ファイルをコンパイルし、コンパイラーの最適化とインライン展開を無効にします。

ステップ 2. リモートマシンで Delve を実行する

• ホストマシンでデバッガーを起動するには、2 つのオプションがあります。

  • デバッガーがプロセスを実行します。ファイアウォールを使用する場合は、構成で使用されているポート（たとえば、2345）を公開します。使用されていない任意のポート番号を使用できます。myApp は、ステップ 1 で構築された実行可能ファイルの名前です。

    dlv --listen=:2345 --headless=true --api-version=2 exec ./myApp

    バイナリに引数をそのまま渡す必要がある場合は、前のコマンドに二重ダッシュ記号（--）を追加してから、必要なオプション（-- --config=/path/to/config/file など）を追加します。

  • プロセスを実行すると、デバッガーは実行中のプロセスに接続します。<PID> は、アプリケーションのプロセス識別子です。プロセスにアタッチコマンドを使用して、プロセス ID を取得できます。

    dlv --listen=:2345 --headless=true --api-version=2 attach <PID>

  

ステップ 3. ローカルコンピューターでデバッグプロセスを開始する

1. アプリケーションのコードを開き、ブレークポイントを配置します。提供されているコード例(英語)では、行 23 (message := fmt.Sprintf("Hello %s!", r.UserAgent())) にブレークポイントを設定します。ブレークポイントのブレークポイントの詳細については、こちらを参照してください。

2. 編集 | 実行構成をクリックします。または、ツールバーの実行 / デバッグ構成のリストをクリックして、実行構成の編集を選択します。

3. 実行 / デバッグ構成ダイアログで、追加ボタン（）をクリックし、Go リモートを選択します。

4. ホストフィールドに、ホスト IP アドレス (たとえば、localhost または 192.168.1.33) を入力します。

5. ポートフィールドに、ステップ 2 で構成したデバッガーポート（たとえば、2345）を入力します。

6. デバッグをクリックします。

7. アプリケーションのブレークポイントでイベントをトリガーします。提供されているコード例(英語)を使用した場合は、ブラウザーで http://<host_address>:8080/ リンクを開きます。

   次のビデオには 2 つの IDE インスタンスがあります。ダークテーマを使用している IDE はローカルコンピューターであり、ライトテーマを使用している IDE はリモートコンピューターです。

ステップ 1. Dockerfile 構成を作成する

1. 編集 | 実行構成をクリックします。または、ツールバーの実行 / デバッグ構成のリストをクリックして、実行構成の編集を選択します。

2. 実行 / デバッグ構成ダイアログで、追加ボタン（）をクリックし、Docker | Dockerfile を選択します。

3. Dockerfile フィールドで、参照アイコン（）をクリックし、ファイルブラウザーで Dockerfile に移動します。このセクションの例を使用する場合は、この Dockerfile(英語) に移動します。

4. 「コンテナー名」フィールドに、コンテナー名（たとえば、debugging-tutorial）を入力します。

5. 実行 / デバッグ構成ダイアログで、変更をクリックし、バインドポートと実行オプションを選択します。

   

6. バインドポートフィールドで、参照 () をクリックします。

7. ポートバインディングダイアログで、追加ボタン () をクリックします。ホストポート列に、8080 と入力します。コンテナーポート列をクリックし、8080 と入力します。さらに、ポート 40000 に同じバインドを作成します。

   

8. 実行オプションフィールドで、Docker のコマンドラインオプションを指定します。Dockerfile で提供されている例では、セキュリティプロファイル(英語)を無効にして、SYS_PTRACE Linux 機能(英語)を追加します。

   --security-opt="apparmor=unconfined" --cap-add=SYS_PTRACE

9. 実行をクリックします。

   

ステップ 2. Go リモート実行 / デバッグ構成を作成する

1. 編集 | 実行構成をクリックします。または、ツールバーの実行 / デバッグ構成のリストをクリックして、実行構成の編集を選択します。

2. 実行 / デバッグ構成ダイアログで、追加ボタン（）をクリックし、Go リモートを選択します。

3. ホストフィールドに、ホストの IP アドレスを入力します（例: localhost）。

4. ポートフィールドに、構成したデバッガーポートを入力します。この例では、40000 です。

5. OK をクリックします。

   

ステップ 3. デバッグプロセスを開始する

1. サービスツールウィンドウ（表示 | ツールウィンドウ | サービス）で、Docker | コンテナーを展開します。作成されたコンテナーが実行中であり、事前構成されたデバッガーポートをリッスンしていることを確認します。

2. ブレークポイントを配置するには、コード行の近くのガターをクリックします。例: 提供されているコード例(英語)では、行 23 (message := fmt.Sprintf("Hello %s!", r.UserAgent())) にブレークポイントを配置します。

   ブレークポイントのブレークポイントの詳細については、こちらを参照してください。

3. ツールバーの実行 / デバッグ構成のリストから、作成した Go リモート構成を選択し、デバッグ <構成名> ボタン () をクリックします。または、Alt+Shift+F9 を押して、作成した Go リモート構成を選択します。

4. アプリケーションのブレークポイントでイベントをトリガーします。提供されているコード例(英語)を使用した場合は、ブラウザーで http://localhost:8080/ を開きます。

   次のビデオでは、コンテナーを実行し、リモート実行 / デバッグ構成を作成し、デバッグのためにコンテナーに接続する方法を説明します。

リモートプロセスを終了する

• Ctrl+F2 を押すと、リモートデバッグセッション中にリモートプロセスを終了できます。プロセスを終了したときに、プロセスに再接続できないことに注意してください。