Create a run configuration

Ensure that the project setup in your IDE aligns with the development workload you intend to develop.

JetBrains IDE uses configurations to run, debug, and test your code. Each run configuration is a named set of startup properties that define what to execute, and what parameters and environment to use. Velocity works with native JetBrains run configurations. This process explains how to create a Velocity run configuration by building a dedicated Dockerfile image.

This process explains how to set up a Velocity run configuration from scratch for a private project, or how to create a pre-defined base configuration for your team. If you are working as part of an organization with an already pre-configured Velocity base configuration, see Start from a Base Configuration to get started.

Set up the configuration

  1. Click Create a new configuration to launch the onboarding wizard.

  2. From the dropdown list at the top of the next screen, choose the programming language you are developing and then choose whether to create your configuration based on an existing workload or a Dockerfile. For this walkthrough, choose Based on Dockerfile and click Next.

  3. Now, configure the workload that you are developing. Confirm that all of the values auto-populated by Velocity are correct, or update them as needed, and click Next.


Configuration name

Choose a name that suggests the goal of the run configuration - for example, the name of the application you're developing


The path to the Dockerfile associated with the service that you're developing

Build context path

The build context is the set of files that your build can access. The positional argument that you pass to the build command specifies the context (for example, the local path) that you want to use for the build. Read more here.

Kubernetes context

The Kubernetes cluster that you're working in

Kubernetes namespace

The namespace in which your deployed service is running

Kubernetes workload

The specific Kubernetes workload that you're developing

  1. Now review and, if necessary, provide additional details for Velocity to build a Dockerfile:

  2. Click Create. The wizard closes, a new Velocity run configuration is created and you can get familiar with Velocity in your IDE and start your first development session with Velocity.

Last updated