ターゲットの実行
特定の実行 / デバッグ構成については、クラウドや Docker コンテナーなどの別の環境でコードを GoLand から直接実行できます。
この機能を使用すると、アプリが対象とする実際の環境に対して変更を即座にテストできます。これにより、本番環境に移行する際に非互換性がなくなることが保証されます。これは、環境に依存するコードで作業する場合に特に重要です。この機能により、何かが変更されるたびにアプリをデプロイして実行するために通常必要な追加のアクションも不要になります。
前提条件
アプリの実行に使用される環境は、ターゲットと呼ばれます。GoLand がターゲット上でコードを実行するには、ターゲットで言語ランタイムを定義する必要があります。これは、実行 / デバッグ構成でコードを実行するために使用できるターゲット上の何かを表します。
ターゲット上でコードを実行するために必要なのは、通常ローカル実行に使用する実行 / デバッグ構成でターゲット実行環境を定義することだけです。それを行った後、ターゲットでアプリを起動することは、ローカルで起動することと同じです。
同じターゲットで複数の構成を実行できます。プロジェクト全体のデフォルトの実行ターゲットを設定することができます。
プロジェクトのデフォルトのターゲットを設定する
をクリックします。
プロジェクトのデフォルトターゲットリストから、プロジェクトに使用するターゲットを選択します。
サポートされている実行 / デバッグ構成タイプ
次の実行 / デバッグ構成は、リモートターゲットで実行できます。
Go ビルド
Go テスト
実行 / デバッグ構成を作成する
に進みます。または、Alt+Shift+F10 を押してから 0 を押します。
実行 / デバッグ構成ダイアログで、ツールバーの追加ボタン
をクリックするか、Alt+Insert を押します。サポートされている実行 / デバッグ構成タイプの 1 つを選択します。
すでにターゲットを定義している場合は、実行メニューからターゲットを選択します。それ以外の場合は、ターゲットの管理をクリックして新しいターゲットを追加します。特定のターゲットタイプの構成の詳細については、次の手順を参照してください。
実行 / デバッグ構成テンプレートで実行ターゲットを構成することもできるため、次にその型の新しい構成を作成するときに、そのパラメーターにはすでに目的の値があります。詳細については、テンプレートのデフォルト値を構成するを参照してください。
実行
リモートターゲットでアプリを実行する手順は、ローカルで実行する場合と同じです。
メインツールバーで実行 / デバッグ構成を選択します。
をクリックするか、Shift+F10 を押します。
GoLand はアーティファクトをビルドしてから、ターゲットにコピーします。その後、指定された構成を使用してターゲット上でアプリを実行します。
ターゲットタイプ
ターゲットは、アプリケーションが実行される環境の構成を記述します。
次のターゲットを作成できます。
リモートターゲットを作成すると、GoLand はリモート環境で使用可能な構成を自動的に検出します。必要に応じて、追加の構成を手動で構成できます。
WSL
メインメニューで、をクリックします。
ターゲットを追加ウィンドウから WSL を選択します。
新規ターゲットウィザードで、Linux ディストリビューションリストから Linux ディストリビューションを選択します。分布が自動的に検出され、イントロスペクションに合格した場合は、次へをクリックします。
WSL の Go ランタイム構成が正しく検出されたことを確認し、完了をクリックします。
または、独自の設定を入力します。
実行可能にする : Go 実行可能ファイルへのパス (たとえば、/home/user/sdk/go1.22.0)
GOPATH : ワークスペースのルートを定義するパス。ルートディレクトリには、bin、pkg、src サブディレクトリが含まれている必要があります。(たとえば、/home/user/sdk/gopath)
バージョン : Go SDK のバージョン番号（たとえば、
go1.15.8 linux/amd64）。GoLand は、go versionを実行することにより、この情報を自動的に検出します。追加設定 : ソースコードファイルと実行可能ファイルのディレクトリを設定できるようにする設定のグループ。
ターゲットで実行するには、GoLand は次のエンティティをターゲットにアップロードする必要があります: ソースコードファイル、作業ディレクトリからのファイル、コンパイルされたバイナリ、掘り下げ。追加設定でパスを指定しない場合、IDE は前述のファイルを格納するためのランダムなディレクトリを作成します。ソースファイルと実行可能ファイルについては、ランダムに生成されたディレクトリを含む次のスクリーンショットを参照してください。
次のオプションを指定できます。
プロジェクトソースディレクトリ : ソースコードファイルがアップロードされるターゲット上のディレクトリ。
コンパイルされた実行可能ファイルディレクトリ : コードが生成する実行可能ファイルを格納するために使用されるターゲット上のディレクトリ。
ターゲットの実行ダイアログで、プロジェクトのデフォルトターゲットリストをクリックし、作成した構成を選択します。
アプリケーションを実行します。
SSH
既存の SSH 構成を使用するか、新しい構成を作成するかを選択します。
SSH リストから既存の SSH 構成を選択し、次へをクリックします。SSH の構成の詳細については、「SSH 構成を作成する」を参照してください。
SSH サーバーの IP、SSH 接続をリッスンしているポート、サーバーマシン上のユーザーの名前を入力します。ユーザーの名前に代わってアプリケーションを実行します。次へをクリックします。
接続が確立されるのを待ちます。資格情報を持つエージェントが存在する場合、追加の構成は必要ありません。それ以外の場合は、認証方法を選択し、必要な値を入力します。
パスワード : パスワードを入力します。
キーペア (OpenSSH または PuTTY) : この認証方法を適用するには、クライアントマシンに秘密鍵があり、リモートサーバーに公開鍵が必要です。GoLand は、OpenSSH(英語) ユーティリティで生成された秘密鍵をサポートします。
秘密鍵が保存されているファイルへのパスを指定し、パスフレーズ (存在する場合) を対応するフィールドに入力します。GoLand にパスフレーズを記憶させるには、「パスフレーズを保存」チェックボックスを選択します。
次へをクリックします。
SSH サーバーのイントロスペクションが完了するのを待ちます。このステップの間に、GoLand は環境で使用可能な言語構成を識別しようとします。次へをクリックします。
次のプロパティを構成します。
rsync を使用する : ファイル転送に rsync(英語) を使用するには、このオプションを切り替えます。通常、ファイルのコピーが高速化されるため、これをお勧めします。
ターゲット上のプロジェクトパス : プロジェクトファイルの保存に使用されるサーバー上のパス。
言語構成設定を追加します。構成ごとに、サーバー上のバージョンとパスを指定します。この環境をターゲットとして選択すると、構成された設定が実行 / デバッグ構成のビルドと実行セクションに表示されます。
次の構成設定を使用できます。
実行可能にする : Go 実行可能ファイルへのパス (たとえば、/usr/local/go/bin/go)
GOPATH : ワークスペースのルートを定義するパス。ルートディレクトリには、bin、pkg、src サブディレクトリが含まれている必要があります。(たとえば、/home/goprojects)
バージョン : Go SDK のバージョン番号（たとえば、
go1.15.8 linux/amd64）。GoLand は、go versionを実行することにより、この情報を自動的に検出します。追加設定 : ソースコードファイルと実行可能ファイルのディレクトリを設定できるようにする設定のグループ。
ターゲットで実行するには、GoLand は次のエンティティをターゲットにアップロードする必要があります: ソースコードファイル、作業ディレクトリからのファイル、コンパイルされたバイナリ、掘り下げ。追加設定でパスを指定しない場合、IDE は前述のファイルを格納するためのランダムなディレクトリを作成します。ソースファイルと実行可能ファイルについては、ランダムに生成されたディレクトリを含む次のスクリーンショットを参照してください。
次のオプションを指定できます。
プロジェクトソースディレクトリ : ソースコードファイルがアップロードされるターゲット上のディレクトリ。
コンパイルされた実行可能ファイルディレクトリ : コードが生成する実行可能ファイルを格納するために使用されるターゲット上のディレクトリ。
Docker
Docker サポートを有効にする説明に従って、Docker サーバーを選択または構成します。
Windows および macOS の場合 – Docker がワークフローで使用されるすべてのフォルダー (プロジェクトフォルダー、.maven など) にアクセスできることを確認してください。詳細については、公式の Docker ドキュメント(英語)を参照してください。
イメージをローカルでビルドするか、Docker レジストリからプルするかを選択します。
Dockerfile: イメージの構築に使用される Dockerfile。
コンテキストフォルダー : ビルド中に Docker デーモンがその内容にアクセスして、後でイメージファイルシステムで使用するフォルダー。
コードを実行する前に毎回自動的にイメージを再ビルドする : このオプションを設定すると、コードが実行されるたびにイメージが再構築されます。それ以外の場合、GoLand は既存のイメージ（存在する場合）を使用します。
さらに、以下を指定できます。
イメージタグ : ビルドされたイメージの名前とタグを指定します。
docker buildで-tオプションを使用するのと同様です。ビルドオプション :
docker buildコマンドに任意のオプションを指定します。ビルド引数 : デフォルトのビルド時変数をオーバーライドします(英語)。
docker buildで--build-argオプションを使用するのと同じです。実行オプション :
docker runコマンドに任意のオプションを指定します。
イメージタグ : レジストリから取得するイメージの完全な座標を指定します。リポジトリのみが指定されている場合は、デフォルトの
:latestタグが使用されます。実行オプション :
docker runコマンドに任意のオプションを指定します。
コンテナーのイントロスペクションが完了するのを待ちます。このステップの間に、GoLand は環境で使用可能な言語構成を識別しようとします。次へをクリックします。
Go 設定を構成します。
次の構成設定を使用できます。
ターゲット上のプロジェクトパス : プロジェクトファイルの保存に使用されるサーバー上のパス。
実行可能にする : Go 実行可能ファイルへのパス (たとえば、/home/user/sdk/go1.22.0)
GOPATH : ワークスペースのルートを定義するパス。ルートディレクトリには、bin、pkg、src サブディレクトリが含まれている必要があります。(たとえば、/home/user/sdk/gopath)
バージョン : Go SDK のバージョン番号（たとえば、
go1.15.8 linux/amd64）。GoLand は、go versionを実行することにより、この情報を自動的に検出します。追加設定 : ソースコードファイルと実行可能ファイルのディレクトリを設定できるようにする設定のグループ。
ターゲットで実行するには、GoLand は次のエンティティをターゲットにアップロードする必要があります: ソースコードファイル、作業ディレクトリからのファイル、コンパイルされたバイナリ、掘り下げ。追加設定でパスを指定しない場合、IDE は前述のファイルを格納するためのランダムなディレクトリを作成します。ソースファイルと実行可能ファイルについては、ランダムに生成されたディレクトリを含む次のスクリーンショットを参照してください。
次のオプションを指定できます。
プロジェクトソースディレクトリ : ソースコードファイルがアップロードされるターゲット上のディレクトリ。
コンパイルされた実行可能ファイルディレクトリ : コードが生成する実行可能ファイルを格納するために使用されるターゲット上のディレクトリ。
Docker Compose
単一の Docker Compose サービスを実行ターゲットとして使用できます。
Docker サポートを有効にする説明に従って、Docker サーバーを選択または構成します。
Windows および macOS の場合 – プロジェクトフォルダーなど、ワークフローで使用されるすべてのフォルダーに Docker がアクセスできることを確認してください。詳細については、公式の Docker ドキュメント(英語)を参照してください。
Docker Compose 構成ファイルを指定し、必要なサービスを選択して、追加の環境変数を提供します。次へをクリックします。
Docker Compose サービスのイントロスペクションが完了するのを待ちます。このステップの間に、GoLand は環境で使用可能な言語構成を識別しようとします。次へをクリックします。
Go 設定を構成します。
次の構成設定を使用できます。
ターゲット上のプロジェクトパス : プロジェクトファイルの保存に使用されるサーバー上のパス。
実行可能にする : Go 実行可能ファイルへのパス (たとえば、/home/user/sdk/go1.22.0)
GOPATH : ワークスペースのルートを定義するパス。ルートディレクトリには、bin、pkg、src サブディレクトリが含まれている必要があります。(たとえば、/home/user/sdk/gopath)
バージョン : Go SDK のバージョン番号（たとえば、
go1.15.8 linux/amd64）。GoLand は、go versionを実行することにより、この情報を自動的に検出します。追加設定 : ソースコードファイルと実行可能ファイルのディレクトリを設定できるようにする設定のグループ。
ターゲットで実行するには、GoLand は次のエンティティをターゲットにアップロードする必要があります: ソースコードファイル、作業ディレクトリからのファイル、コンパイルされたバイナリ、掘り下げ。追加設定でパスを指定しない場合、IDE は前述のファイルを格納するためのランダムなディレクトリを作成します。ソースファイルと実行可能ファイルについては、ランダムに生成されたディレクトリを含む次のスクリーンショットを参照してください。
次のオプションを指定できます。
プロジェクトソースディレクトリ : ソースコードファイルがアップロードされるターゲット上のディレクトリ。
コンパイルされた実行可能ファイルディレクトリ : コードが生成する実行可能ファイルを格納するために使用されるターゲット上のディレクトリ。
関連ページ：
実行 / デバッグ構成
GoLand は、実行 / デバッグ構成を使用して、コードを実行、デバッグ、テストします。各構成は、何を実行し、どのパラメーターと環境を使用するかを定義する、名前付きのスタートアッププロパティのセットです。実行 / デバッグ構成には 2 つのタイプがあります。一時的 — 関数またはテストを実行またはデバッグするたびに作成されます。永続的 — テンプレートから明示的に作成されるか、一時的な構成を保存することによって作成されます。永続的な構成は、削除するまでプロジェクトの一部として残ります。コードを実行...
Docker
Docker は、分離された再現可能な環境で実行可能ファイルをデプロイおよび実行するためのツールです。これは、たとえば、本番環境と同じ環境でコードをテストする場合に役立ちます。GoLand は Docker 機能を統合し、Docker イメージの作成、Docker コンテナーの実行、Docker Compose アプリケーションの管理、パブリックおよびプライベート Docker レジストリの使用など、IDE から直接実行するための支援を提供します。Docker プラグインを有効にするこの機能は、デ...
SSH 構成を作成する
GoLand では、リモートサーバーの SSH 接続パラメーターを専用の SSH 構成として保存できます。作成された構成は、リモートインタープリターの構成、SFTP デプロイサーバーへの接続、または SSH セッションの起動に使用できます。設定ダイアログで、に移動します。既存のすべての SSH 構成を一覧表示する左側のペインで、をクリックします。このプロジェクトでのみ表示するチェックボックスを使用して、このサーバーアクセス構成を他のプロジェクトで再利用できるようにします。チェックボックスを選択して...
ログオプションの設定
実行 / デバッグ構成ダイアログのログタブを使用して、アプリケーションまたはサーバーによって生成されたログファイルがコンソールに表示される方法を設定します。アプリケーションまたはサーバーがログファイルを生成する場合、デフォルトのエントリは自動的に実行 / デバッグ構成ダイアログのログファイルリストに追加されます。ログのオプションを設定するに進みます。または、を押してからを押します。ログセクションで、追加ボタンをクリックします。エイリアスフィールドに、ログエントリのエイリアスを入力します。ログ...