AppCode 2019.2 Help

Services Tool Window

The Services tool window includes various services that help you during software development: run/debug configurations, application servers, database sessions, Docker connections, and so on. Plugin developers can add other services through the IntelliJ platform API.

Main toolbar

The main toolbar contains the following buttons and menus:

Icon

Action

Description

The Expand All button

Expand All ⌘+

Expand all items in the list.

The Collapse All button

Collapse All ⌘-

Collapse all items in the list.

The Group By menu

Group By

Choose how you want to organize the services.

The Show in New Tab button

Show in New Tab

Move the selected items to a separate tab.

The Split to New Tabs button

Split to New Tabs

Place the selected items into separate tabs.

The Split By Type button

Split By Type

Create separate tabs for each type of service.

Run/debug configurations

Run/debug configurations are not listed in the Services tool window by default. You need to explicitly specify which types of configurations you want to be available:

  1. From the main menu, select Run | Edit Configurations or use the selector on the toolbar.

  2. In the Run/Debug Configurations dialog, select Templates from the list on the left.

  3. In the right-hand pane, expand the Configurations available in Services section.

  4. Click the Add button in the Configurations available in Services section and select the necessary run configuration type.

    You can add or remove multiple configuration types one by one.

    Enabling the Services tool window

    Note that the tool window will only display the configuration types for which you have created one or more configurations.

    Thus, if you add a configuration type for which no configurations exist in the project, this type will not be displayed in the tool window until you create a configuration of this type.

Buttons on the toolbar depend on the selected type of the run/debug configuration.

Icon

Action

Description

The Run button

Run ⌃⇧R

Run the selected configuration.

The Debug button

Debug ⌃⇧D

Debug the selected configuration.

The Stop button

Stop ⌘F2

Stop the selected configuration.

Database service

In the database service, you can manage your sessions and connections. Connection is a physical communication channel and session is a state of information exchange. For example, if you surf a social network, your connection log might have thousands of connection entries between a client and a server while a session log might show you only a single log entry with the number of bytes transferred.

For more information about managing database sessions, see Run a query.

Left toolbar

Icon

Action

Description

Tx

Tx Mode and Tx Isolation

Choose the isolation level for database transactions and the way transactions are committed.

  • Auto: each statement is executed in its own transaction that is implicitly committed.

  • Manual: transactions are committed and rolled back manually.

The Commit button

Commit ⌥⇧⌘⏎

Commit the current transaction.

The Rollback button

Rollback

Roll back the last transaction.

The Cancel Running Statements button

Cancel Running Statements ⌘F2

Terminate the execution of the current statement.

The Restore Default Layout button

Restore Default Layout ⌘F2

Restore default positions of visual elements in the Service view.

The Jump to Console button

Jump to Console ⇧⌘F10

Open the Consoles popup. In the Consoles popup, you can select a database console that you want to open in the editor.

The Disconnect button

Disconnect ⌘F2

(For data sources) Close a connection to the selected data source.

The Disconnect button

Cancel Running Statements ⌘F2

(For sessions and attached files) Close a connection to the selected data source.

Data sources

Icon

Action

Description

The Jump to Console button

Jump to Console ⇧⌘F10

Open the Consoles popup. In the Consoles popup, you can select a database console that you want to open in the editor.

The Disconnect button

Disconnect ⌘F2

Close a connection to the selected data source.

Close All Sessions

Close all opened sessions to a data source.

The Show in New Tab button

Show in New Tab

Move the selected items to a separate tab.

The Split to New Tabs button

Split to New Tabs

Split the selected items into separate tabs.

The Split By Type button

Split By Type

Create separate tabs for each type of service.

Delete

Close all opened sessions to a data source. Identical to Close All Sessions.

Sessions

Icon

Action

Description

Tx

Tx Mode and Tx Isolation

Choose the isolation level for database transactions and the way transactions are committed.

  • Auto: each statement is executed in its own transaction that is implicitly committed.

  • Manual: transactions are committed and rolled back manually.

The Commit button

Commit ⌥⇧⌘⏎

Commit the current transaction.

The Rollback button

Rollback

Roll back the last transaction.

The Disconnect button

Cancel Running Statements ⌘F2

Stop execution of running statements.

The Restore Default Layout button

Restore Default Layout ⌘F2

Restore visual elements of are arranged.

Rename Session

Display the Rename dialog where you can specify a name for a session.

Close Session

Close the selected session.

The Show in New Tab button

Show in New Tab

Move the selected items to a separate tab.

The Split to New Tabs button

Split to New Tabs

Split the selected items into separate tabs.

The Split By Type button

Split By Type

Create separate tabs for each type of service.

Delete

Close all opened sessions to a data source. Identical to Close All Sessions.

SQL files

Icon

Action

Description

Tx

Tx Mode and Tx Isolation

Choose the isolation level for database transactions and the way transactions are committed.

  • Auto: each statement is executed in its own transaction that is implicitly committed.

  • Manual: transactions are committed and rolled back manually.

The Commit button

Commit ⌥⇧⌘⏎

Commit the current transaction.

The Rollback button

Rollback

Roll back the last transaction.

The Disconnect button

Cancel Running Statements ⌘F2

Stop execution of running statements.

The Restore Default Layout button

Restore Default Layout ⌘F2

Restore visual elements of are arranged.

Switch Session

Display the Sessions popup where you can select or create a new session and connect to it.

Detach Session

Detach the selected file from the current session. To attach the file to a session, open the file in the editor, and select the session in the sessions list.

Detach a session
The Show in New Tab button

Show in New Tab

Move the selected items to a separate tab.

The Split to New Tabs button

Split to New Tabs

Split the selected items into separate tabs.

The Split By Type button

Split By Type

Create separate tabs for each type of service.

Delete

Close all opened sessions to a data source. Identical to Close All Sessions.

the Jump to Source button

Jump to Source ⌘↓

Open the file in the editor.

Docker

This type of service is available if you have configured connection settings for at least one Docker instance. For more information, see Enable Docker support.

Main Docker node

Icon

Action

Description

The Connect button

Connect

Connect to the Docker daemon and list all available images and containers.

The Disconnect button

Disconnect

Disconnect from the Docker daemon.

The Edit Configuration button

Edit Configuration

Edit the Docker connection settings.

The Deploy button

Deploy

Select an existing Docker run configuration or create a new one. For more information, see Running containers

The Pull Image button

Pull Image

Pull an image from a Docker registry. For more information, see Pull an image from a Docker registry.

The Filter button

Filter

Choose whether you want to show or hide containers that are not running and images with no tags.

Containers

Icon

Action

Description

The Start Container button

Start Container

Run the selected container.

The Stop Container button

Stop Container

Stop the selected container.

The Delete Container button

Delete Container

Delete the selected container.

The Filter button

Filter

Choose whether you want to show or hide containers that are not running and images with no tags.

Images

Icon

Action

Description

The Pull Image button

Pull Image

Pull an image from a Docker registry. For more information, see Pull an image from a Docker registry.

The Create Container button

Create Container

Create a Docker container from the selected image.

The Delete Image button

Delete Image

Remove the selected image.

The Push Image button

Push Image

Push an image to a Docker registry. For more information, see Push an image to a Docker registry.

The Filter button

Filter

Choose whether you want to show or hide containers that are not running and images with no tags.

Main Docker Compose node

Icon

Action

Description

The Deploy button

Deploy

Deploy your selected Docker Compose services using the associated run/debug configuration. For more information, see Docker Compose

The Stop button

Stop

Stop all containers in the selected Docker Compose services.

The Down button

Down

Stop and remove all containers in the selected Docker Compose services, including all related networks, volumes, and images.

The Edit Configuration button

Edit Configuration

Edit the selected Docker Compose run configuration.

The Filter button

Filter

Choose whether you want to show or hide containers that are not running and images with no tags.

Docker Compose services

Icon

Action

Description

The Start button

Start

Start all containers for the selected service.

The Stop button

Stop

Stop all containers for the selected service.

The Scale button

Scale

Change the number of containers for the selected service.

The Delete Container button

Delete Container

Delete the selected container.

The Filter button

Filter

Choose whether you want to show or hide containers that are not running and images with no tags.

Productivity tips

Use tabs

The Services tool window can include a lot of services, which you can group according to their type or create separate tabs for your own custom grouping. For example, you can create a tab that will include the following: the run configuration for the application that you are developing, the Docker container that runs the database used as a backend for your application, and a console for the database.

Hide services tree

Click The Show Options Menu button in the right part of the Services tool window toolbar and then click Show Services Tree to remove the checkbox. You can also press ⇧⌘T to toggle the services tree.

If you hide the services tree, it is replaced by a services navigation bar. Press ⌘↑ to focus the services navigation bar.

Last modified: 10 October 2019