GoLand
 
2023.2
Shortcuts: Windows
Get GoLand
You are viewing the documentation for an earlier version of GoLand.
  1. Running
  2. Run targets

Run targets

Last modified: 23 August 2023

You can run your code in another environment such as cloud or a Docker container directly from GoLand.

For certain run/debug configurations, you can run your code in another environment such as cloud or a Docker container directly from GoLand.

This feature allows you to instantly test the changes against the real environment the app is intended for. This ensures that there will be no incompatibilities when moving to production, which is especially important when working on code that heavily depends on the environment.

Running the app directly in such environment also spares you the extra actions normally required to deploy and run the app every time something changes.

The environment that is used for running the app is referred to as target. For GoLand to run code on a target, the target has to define a language runtime, which represents something on the target that can be used by a run/debug configuration to run code.

In order to run your code on a target, all you need is to define the target execution environment in the run/debug configuration that you would normally use for local run. After you have done that, launching the app on a target is no different than launching it locally.

You can run several configurations on the same target. It is possible to set a project-wide default run target.

Set a default target for a project

  1. Click Run | Manage Targets.

  2. From the Project default target list, select a target that you want to use for your project.

    Set a default target for a project

Supported run/debug configuration types

The following run/debug configurations can run on a remote target:

  • Go Build

  • Go Test

Create a run/debug configuration

Run

Target types

A target describes the configuration of the environment in which the application will run.

When you create a remote target, GoLand automatically detects the configuration available in the remote environment. If required, you can manually configure additional configuration.

SSH

note

FTP/SFTP/WebDAV connectivity plugin is required.

  1. Select if you want to use an existing SSH configuration or create a new one:

    Select an existing SSH configuration from the SSH list, then click Next. For instructions on how to configure an SSH configuration, refer to Create SSH configurations.

  2. Wait for the SSH server introspection to complete. During this step, GoLand tries to identify the language configuration available in the environment. Click Next.

    Introspection of the SSH server

  3. Configure the following properties:

    • Use rsync: toggle this option to use rsync for file transfer. This is recommended as it will generally speed up copying files.

    • Project path on target: the path on the server that will be used for storing the project files.

  4. Add language configuration settings. For each configuration, specify its version and path on the server. The configured settings then appear in the Build and run section of the run/debug configuration when you select this environment as the target.

    The following configuration settings are available:

    • Go Executable: the path to the Go executable (for example, /usr/local/go/bin/go)

    • GOPATH: the path that defines the root of your workspace. A root directory must contain bin, pkg, and src subdirectories. (for example, /home/goprojects)

    • Version: a version number of your Go SDK (for example, go1.15.8 linux/amd64). GoLand detects this information automatically by running go version.

    • Additional settings: a group of settings that allow you to set directories for source code files and executables.

      To run on a target, GoLand needs to upload to a target the following entities: source code files, files from a working directory, compiled binaries, and delve. If you do not specify paths in Additional Settings, the IDE will create random directories to store previously-mentioned files. See the following screenshot with randomly-generated directories for source files and executables.

      randomly-generated directories

      You can specify the following options:

      • Project sources directory: a directory on a target where source code files are uploaded.

      • Compiled executables directory: a directory on a target that is used to store executables that your code produces.

    Go Run Targets Ssh Runtime

Docker

note

Docker plugin is required.

  1. Select or configure a Docker server as described in Enable Docker support.

  2. For Windows and macOS – make sure Docker has access to all the folders used in the workflow, for example, the project folder, .maven, and so on. For details, refer to official Docker documentation.

  3. Select if you want to build an image locally or pull it from Docker registry.

    • Dockerfile: the Dockerfile that will be used for building the image.

    • Context folder: a folder whose contents will be accessible by the Docker daemon during the build to be later used in the image filesystem.

    • Rebuild image automatically every time before running code: when this option is set, the image will be rebuilt every time the code is run. Otherwise, GoLand will use the already existing image (if any).

    Additionally, you can specify the following:

    • Image tag: specify the name and tag for the built image. Similar to using the -t option with docker build.

    • Build options: specify arbitrary options for the docker build command.

    • Build args: override the default build-time variables. Similar to using the --build-arg option with docker build.

    • Run options: specify arbitrary options for the docker run command.

      note

      Not all docker run options are supported. If you would like to request support for some option, leave a comment in IDEA-181088.

    run targets docker build image

  4. Wait for the container introspection to complete. During this step, GoLand tries to identify the language configuration available in the environment. Click Next.

  5. Configure Go settings.

    The following configuration settings are available:

    • Project path on target: the path on the server that will be used for storing the project files.

    • Go Executable: the path to the Go executable (for example, /usr/local/go/bin/go)

    • GOPATH: the path that defines the root of your workspace. A root directory must contain bin, pkg, and src subdirectories. (for example, /home/goprojects)

    • Version: a version number of your Go SDK (for example, go1.15.8 linux/amd64). GoLand detects this information automatically by running go version.

    • Additional settings: a group of settings that allow you to set directories for source code files and executables.

      To run on a target, GoLand needs to upload to a target the following entities: source code files, files from a working directory, compiled binaries, and delve. If you do not specify paths in Additional Settings, the IDE will create random directories to store previously-mentioned files. See the following screenshot with randomly-generated directories for source files and executables.

      randomly-generated directories

      You can specify the following options:

      • Project sources directory: a directory on a target where source code files are uploaded.

      • Compiled executables directory: a directory on a target that is used to store executables that your code produces.

    The final step of the Docker target

Docker Compose

You can use a single Docker Compose service as a run target.

note

Docker plugin is required.

  1. Select or configure a Docker server as described in Enable Docker support.

  2. For Windows and macOS – make sure Docker has access to all the folders used in the workflow, for example, the project folder. For details, refer to official Docker documentation.

  3. Specify the Docker Compose configuration files, select the necessary service, and provide any additional environment variables. Click Next.

  4. Wait for the Docker Compose service introspection to complete. During this step, GoLand tries to identify the language configuration available in the environment. Click Next.

  5. Configure Go settings.

    The following configuration settings are available:

    • Project path on target: the path on the server that will be used for storing the project files.

    • Go Executable: the path to the Go executable (for example, /usr/local/go/bin/go)

    • GOPATH: the path that defines the root of your workspace. A root directory must contain bin, pkg, and src subdirectories. (for example, /home/goprojects)

    • Version: a version number of your Go SDK (for example, go1.15.8 linux/amd64). GoLand detects this information automatically by running go version.

    • Additional settings: a group of settings that allow you to set directories for source code files and executables.

      To run on a target, GoLand needs to upload to a target the following entities: source code files, files from a working directory, compiled binaries, and delve. If you do not specify paths in Additional Settings, the IDE will create random directories to store previously-mentioned files. See the following screenshot with randomly-generated directories for source files and executables.

      randomly-generated directories

      You can specify the following options:

      • Project sources directory: a directory on a target where source code files are uploaded.

      • Compiled executables directory: a directory on a target that is used to store executables that your code produces.

    The final step of the Docker target

WSL

  1. From the main menu, select Run | Edit Configurations. Alternatively, press AltShiftF10, then 00.

  2. In the Run/Debug Configuration dialog, click the Add button on the toolbar or press AltInsert.

  3. From the Add New Configuration window, select the run/debug configuration that you want to create for running a target. It can be Go Build or Go Test.

  4. From the Run on menu, under the New targets section, select WSL to add a WSL target.

    select wsl from run on list

  5. In the New Target wizard, select your Linux distribution from the Linux distribution list. If the distribution was detected automatically and the introspection passed, click Next.

    introspection of wsl target

  6. Check that the Go runtime configuration for WSL was detected correctly and click Finish.

    Alternatively, type your own settings.

    • Go Executable: the path to the Go executable (for example, /usr/local/go/bin/go)

    • GOPATH: the path that defines the root of your workspace. A root directory must contain bin, pkg, and src subdirectories. (for example, /home/goprojects)

    • Version: a version number of your Go SDK (for example, go1.15.8 linux/amd64). GoLand detects this information automatically by running go version.

    • Additional settings: a group of settings that allow you to set directories for source code files and executables.

      To run on a target, GoLand needs to upload to a target the following entities: source code files, files from a working directory, compiled binaries, and delve. If you do not specify paths in Additional Settings, the IDE will create random directories to store previously-mentioned files. See the following screenshot with randomly-generated directories for source files and executables.

      randomly-generated directories

      You can specify the following options:

      • Project sources directory: a directory on a target where source code files are uploaded.

      • Compiled executables directory: a directory on a target that is used to store executables that your code produces.

    check Go runtime configuration for WSL

  7. From the main menu, click Run and select the necessary run configuration or press (ShiftF10) to run your code and check the output in the Run tool window.

    Run tool window: WSL output