Skip to main content
Version: 6.x (Latest)

Development Mode

A lot of teams configure DevSpace so that the development experience is very similar to using docker-compose but with the additional benefits of running inside Kubernetes, having a reproducible dev environment that is as close to production as it gets. If an engineer is already familiar with how to develop with docker-compose, DevSpace will be easy to get started with.

Dev Containers‚Äč

Dev containers are central to the DevSpace-based development experience. A dev container serves as a remote work environment for the engineer that is connected to the local machine of the engineer via port forwarding, file sync, etc. These connections allow engineers to work with their local IDE or with any cloud IDE without having to change their habits and familiar workflows.

DevSpace can turn any container into a dev container, no matter if this container has been deployed by DevSpace or by another tool. That means you could use a GitOps tool like ArgoCD for deployment of your dev environments and then use DevSpace to connect to the deployed applications to debug and develop them inside your dev cluster.

To define a dev container, you need to configure the dev section of devspace.yaml and first:

  1. Define a selector that matches a pod/container running inside your Kubernetes cluster
  2. Modify selected container to prepare it for the use as remote development environment
  3. Optionally modify the dev container to optimize it for the use as remote development environment

1. Select Container‚Äč

DevSpace provides several ways to select a pod/container. The most common option to select a container is by defining an imageSelector which selects the container that runs the specified image. Alternatively, you could also use the labelSelector that is a common pattern in Kubernetes to select objects in a cluster.

Selector

imageSelector required string ‚Äč

ImageSelector to select a pod

labelSelector required <labelSelector_name>:string ‚Äč

LabelSelector to select a pod

namespace required string ‚Äč

Namespace where to select the pod

container required string ‚Äč

Container is the container name these services should get started.

arch required string ‚Äč

Target Container architecture to use for the devspacehelper (currently amd64 or arm64). Defaults to amd64, but devspace tries to find out the architecture by itself by looking at the node this container runs on.

containers required <container_name>:object ‚Äč

Selector

container required string ‚Äč

Container is the container name these services should get started.

arch required string ‚Äč

Target Container architecture to use for the devspacehelper (currently amd64 or arm64). Defaults to amd64, but devspace tries to find out the architecture by itself by looking at the node this container runs on.

Modifications

devImage required string ‚Äč

DevImage is the image to use for this container and will replace the existing image if necessary.

command required string[] ‚Äč

Command can be used to override the entrypoint of the container

args required string[] ‚Äč

Args can be used to override the args of the container

workingDir required string ‚Äč

WorkingDir can be used to override the working dir of the container

env required object[] ‚Äč

Env can be used to add environment variables to the container. DevSpace will not replace existing environment variables if an environment variable is defined here.

name required string ‚Äč

Name of the environment variable

value required string ‚Äč

Value of the environment variable

resources required ‚Äč

Resources can be used to override the resource definitions of the container

requests required <request_name>:string ‚Äč

Requests are the requests part of the resources

limits required <limit_name>:string ‚Äč

Limits are the limits part of the resources

Port Forwarding

reversePorts required object[] ‚Äč

ReversePorts are port mappings to make local ports available inside the container

port required string ‚Äč

Port is a port mapping that maps the localPort:remotePort. So if you port forward the remote port will be available at the local port. If you do reverse port forwarding, the local port will be available at the remote port in the container. If only port is specified, local and remote port are the same.

bindAddress required string ‚Äč

BindAddress is the address DevSpace should listen on. Optional and defaults to localhost.

File Sync

sync required object[] ‚Äč

Sync allows you to sync certain local paths with paths inside the container

path required string ‚Äč

Path is the path to sync. This can be defined in the form localPath:remotePath. You can also use '.' to specify either the local or remote working directory. This is valid for example: .:.

Exclude Paths From File Sync
excludePaths required string[] ‚Äč

ExcludePaths is an array of file patterns in gitignore format to exclude.

excludeFile required string ‚Äč

ExcludeFile loads the file patterns to exclude from a file.

downloadExcludePaths required string[] ‚Äč

DownloadExcludePaths is an array of file patterns in gitignore format to exclude from downloading

downloadExcludeFile required string ‚Äč

DownloadExcludeFile loads the file patterns to exclude from downloading from a file.

uploadExcludePaths required string[] ‚Äč

UploadExcludePaths is an array of file patterns in gitignore format to exclude from uploading

uploadExcludeFile required string ‚Äč

UploadExcludeFile loads the file patterns to exclude from uploading from a file.

Sync-Triggered Actions
startContainer required boolean false ‚Äč

StartContainer will start the container after initial sync is done. This will inject a devspacehelper into the pod and you need to define dev.*.command for this to work.

onUpload required ‚Äč

OnUpload can be used to execute certain commands on uploading either in the container or locally as well as restart the container after a file changed has happened.

restartContainer required boolean false ‚Äč

If true restart container will try to restart the container after a change has been made. Make sure that images.*.injectRestartHelper is enabled for the container that should be restarted or the devspace-restart-helper script is present in the container root folder.

exec required object[] ‚Äč

Exec will execute the given commands in order after a sync operation

####### name required string {#dev-containers-sync-onUpload-exec-name}

Name is the name to show for this exec in the logs

####### command required string {#dev-containers-sync-onUpload-exec-command}

Command is the command to execute. If no args are specified this is executed within a shell.

####### args required string[] {#dev-containers-sync-onUpload-exec-args}

Args are arguments to pass to the command

####### failOnError required boolean false {#dev-containers-sync-onUpload-exec-failOnError}

FailOnError specifies if the sync should fail if the command fails

####### local required boolean false {#dev-containers-sync-onUpload-exec-local}

Local specifies if the command should be executed locally instead of within the container

####### once required boolean false {#dev-containers-sync-onUpload-exec-once}

Once executes this command only once in the container's life. Can be used to initialize a container before starting it, but after everything was synced.

####### onChange required string[] {#dev-containers-sync-onUpload-exec-onChange}

OnChange is an array of file patterns that trigger this command execution

Initial Sync
initialSync required string ‚Äč

InitialSync defines the initial sync strategy to use when this sync starts. Defaults to mirrorLocal

waitInitialSync required boolean false ‚Äč

WaitInitialSync can be used to tell DevSpace to not wait until the initial sync is done

initialSyncCompareBy required string ‚Äč

InitialSyncCompareBy defines if the sync should only compare by the given type. Either mtime or size are possible

One-Directional Sync
disableDownload required boolean false ‚Äč

DisableDownload will disable downloading completely

disableUpload required boolean false ‚Äč

DisableUpload will disable uploading completely

bandwidthLimits required ‚Äč

BandwidthLimits can be used to limit the amount of bytes that are transferred by DevSpace with this sync configuration

download required integer ‚Äč

Download is the download limit in kilo bytes per second

upload required integer ‚Äč

Upload is the upload limit in kilo bytes per second

polling required boolean false ‚Äč

Polling will tell the remote container to use polling instead of inotify

noWatch required boolean false ‚Äč

NoWatch will terminate the sync after the initial sync is done

file required boolean false ‚Äč

File signals DevSpace that this is a single file that should get synced instead of a whole directory

persistPaths required object[] ‚Äč

PersistPaths allows you to persist certain paths within this container with a persistent volume claim

path required string ‚Äč

Path is the container path that should get persisted. By default, DevSpace will create an init container that will copy over the contents of this folder from the existing image.

volumePath required string ‚Äč

VolumePath is the sub path on the volume that is mounted as persistent volume for this path

readOnly required boolean false ‚Äč

ReadOnly will make the persistent path read only to the user

skipPopulate required boolean false ‚Äč

SkipPopulate will not create an init container to copy over the existing contents if true

initContainer required ‚Äč

InitContainer holds additional options for the persistent path init container

resources required ‚Äč

Resources are the resources used by the persistent path init container

####### requests required <request_name>:string {#dev-containers-persistPaths-initContainer-resources-requests}

Requests are the requests part of the resources

####### limits required <limit_name>:string {#dev-containers-persistPaths-initContainer-resources-limits}

Limits are the limits part of the resources

Foreground Dev Workflows

terminal required ‚Äč

Terminal allows you to tell DevSpace to open a terminal with screen support to this container

command required string ‚Äč

Command is the command that should be executed on terminal start. This command is executed within a shell.

workDir required string ‚Äč

WorkDir is the working directory that is used to execute the command in.

enabled required boolean false ‚Äč

If enabled is true, DevSpace will use the terminal. Can be also used to disable the terminal if set to false. DevSpace makes sure that within a pipeline only one dev configuration can open a terminal at a time and subsequent dev terminals will fail.

disableReplace required boolean false ‚Äč

DisableReplace tells DevSpace to not replace the pod or adjust its settings to make sure the pod is sleeping when opening a terminal

disableScreen required boolean false ‚Äč

DisableScreen will disable screen which is used by DevSpace by default to preserve sessions if connections interrupt or the session is lost.

disableTTY required boolean false ‚Äč

DisableTTY will disable a tty shell for terminal command execution

logs required ‚Äč

Logs allows you to tell DevSpace to stream logs from this container to the console

enabled required boolean false ‚Äč

Enabled can be used to enable printing container logs

lastLines required integer ‚Äč

LastLines is the amount of lines to print of the running container initially

attach required ‚Äč

Attach allows you to tell DevSpace to attach to this container

enabled required boolean false ‚Äč

Enabled can be used to enable attaching to a container

disableReplace required boolean false ‚Äč

DisableReplace prevents DevSpace from actually replacing the pod with modifications so that the pod starts up correctly.

disableTTY required boolean false ‚Äč

DisableTTY is used to tell DevSpace to not use a TTY connection for attaching

ssh required ‚Äč

SSH allows you to create an SSH tunnel to this container

enabled required boolean false ‚Äč

Enabled can be used to enable the ssh server within the container. By default, DevSpace will generate the required keys and create an entry in your ~/.ssh/config for this container that can be used via ssh dev-config-name.dev-project-name.devspace

localHostname required string ‚Äč

LocalHostname is the local ssh host to write to the ~/.ssh/config

localPort required integer ‚Äč

LocalPort is the local port to forward from, if empty will be random

remoteAddress required string ‚Äč

RemoteAddress is the address to listen to inside the container

useInclude required boolean false ‚Äč

UseInclude tells DevSpace to use a the file ~/.ssh/devspace_config for its ssh entries. DevSpace will also create an import for its own entries inside ~/.ssh/config, this is a cleaner way, but unfortunately not all SSH clients support this.

proxyCommands required object[] ‚Äč

ProxyCommands allow you to proxy certain local commands to the container

gitCredentials required boolean false ‚Äč

GitCredentials configures a git credentials helper inside the container that proxies local git credentials

command required string ‚Äč

Command is the name of the command that should be available in the remote container. DevSpace will create a small script for that inside the container that redirect command execution to the local computer.

localCommand required string ‚Äč

LocalCommand can be used to run a different command than specified via the command option. By default, this will be assumed to be the same as command.

skipContainerEnv required boolean false ‚Äč

SkipContainerEnv will not forward the container environment variables to the local command

env required <env_name>:string ‚Äč

Env are extra environment variables to set for the command

restartHelper required ‚Äč

RestartHelper holds restart helper specific configuration. The restart helper is used to delay starting of the container and restarting it and is injected via an annotation in the replaced pod.

path required string ‚Äč

Path defines the path to the restart helper that might be used if certain config options are enabled

inject required boolean false ‚Äč

Inject signals DevSpace to inject the restart helper

Logical && For Selectors

If multiple selectors (e.g. imageSelector and labelSelector) are specified, DevSpace will combine them with a logical AND (&&) when looking for a pod/container to match the specified conditions.

2. Add Dev Connections‚Äč

Dev connections defines how your local machine and IDE is connected to the dev container that runs in Kubernetes.

Common dev connections include:

3. Modify Container For Development‚Äč

Because the idea behind dev containers is that you just deploy your prod/stable containers and then turn one or even multiple containers into dev containers later on when you actually want to work on them, DevSpace allows you to make modifications for these containers on-the-fly.

A common example for modifying a container to optimize it for development would be to use the devImage feature which tells DevSpace to swap out the container's prod/stable image with a prebuilt dev-optimized image (e.g. that contains a remote debugger and other dev tooling).

Modifications

devImage required string ‚Äč

DevImage is the image to use for this container and will replace the existing image if necessary.

command required string[] ‚Äč

Command can be used to override the entrypoint of the container

args required string[] ‚Äč

Args can be used to override the args of the container

workingDir required string ‚Äč

WorkingDir can be used to override the working dir of the container

env required object[] ‚Äč

Env can be used to add environment variables to the container. DevSpace will not replace existing environment variables if an environment variable is defined here.

name required string ‚Äč

Name of the environment variable

value required string ‚Äč

Value of the environment variable

resources required ‚Äč

Resources can be used to override the resource definitions of the container

requests required <request_name>:string ‚Äč

Requests are the requests part of the resources

limits required <limit_name>:string ‚Äč

Limits are the limits part of the resources

persistenceOptions required ‚Äč

PersistenceOptions are additional options for persisting paths within this pod

size required string ‚Äč

Size is the size of the created persistent volume in Kubernetes size notation like 5Gi

storageClassName required string ‚Äč

StorageClassName is the storage type DevSpace should use for this persistent volume

accessModes required string[] ‚Äč

AccessModes are the access modes DevSpace should use for the persistent volume

readOnly required boolean false ‚Äč

ReadOnly specifies if the volume should be read only

name required string ‚Äč

Name is the name of the PVC that should be created. If a PVC with that name already exists, DevSpace will use that PVC instead of creating one.

patches required object[] ‚Äč

Patches are additional changes to the pod spec that should be applied

op required string ‚Äč

Operation is the path operation to do. Can be either replace, add or remove

path required string ‚Äč

Path is the config path to apply the patch to

value required ‚Äč

Value is the value to use for this patch.

Start Development Mode‚Äč

Start the development mode using this command:

devspace dev
warning

Running devspace dev multiple times in parallel for the same project does not work and returns a fatal error because multiple instances of port forwarding and file sync will disturb each other. However, running devspace dev for several different projects (i.e. 2 different devspace.yaml files with different name) works seamlessly.

Config Reference‚Äč

dev required <dev_name>:object ‚Äč

Dev holds development configuration. Each dev configuration targets a single pod and enables certain dev services on that pod or even rewrites it if certain changes are requested, such as adding an environment variable or changing the entrypoint. Dev allows you to:

  • sync local folders to the Kubernetes pod
  • port forward remote ports to your local computer
  • forward local ports into the Kubernetes pod
  • configure an ssh tunnel to the Kubernetes pod
  • proxy local commands to the container
  • restart the container on file changes

<dev_name> required string ‚Äč

Name of the dev configuration

Selector

imageSelector required string ‚Äč

ImageSelector to select a pod

labelSelector required <labelSelector_name>:string ‚Äč

LabelSelector to select a pod

namespace required string ‚Äč

Namespace where to select the pod

container required string ‚Äč

Container is the container name these services should get started.

arch required string ‚Äč

Target Container architecture to use for the devspacehelper (currently amd64 or arm64). Defaults to amd64, but devspace tries to find out the architecture by itself by looking at the node this container runs on.

containers required <container_name>:object ‚Äč

Selector

container required string ‚Äč

Container is the container name these services should get started.

arch required string ‚Äč

Target Container architecture to use for the devspacehelper (currently amd64 or arm64). Defaults to amd64, but devspace tries to find out the architecture by itself by looking at the node this container runs on.

Modifications

devImage required string ‚Äč

DevImage is the image to use for this container and will replace the existing image if necessary.

command required string[] ‚Äč

Command can be used to override the entrypoint of the container

args required string[] ‚Äč

Args can be used to override the args of the container

workingDir required string ‚Äč

WorkingDir can be used to override the working dir of the container

env required object[] ‚Äč

Env can be used to add environment variables to the container. DevSpace will not replace existing environment variables if an environment variable is defined here.

name required string ‚Äč

Name of the environment variable

value required string ‚Äč

Value of the environment variable

resources required ‚Äč

Resources can be used to override the resource definitions of the container

requests required <request_name>:string ‚Äč

Requests are the requests part of the resources

limits required <limit_name>:string ‚Äč

Limits are the limits part of the resources

Port Forwarding

reversePorts required object[] ‚Äč

ReversePorts are port mappings to make local ports available inside the container

port required string ‚Äč

Port is a port mapping that maps the localPort:remotePort. So if you port forward the remote port will be available at the local port. If you do reverse port forwarding, the local port will be available at the remote port in the container. If only port is specified, local and remote port are the same.

bindAddress required string ‚Äč

BindAddress is the address DevSpace should listen on. Optional and defaults to localhost.

File Sync

sync required object[] ‚Äč

Sync allows you to sync certain local paths with paths inside the container

path required string ‚Äč

Path is the path to sync. This can be defined in the form localPath:remotePath. You can also use '.' to specify either the local or remote working directory. This is valid for example: .:.

Exclude Paths From File Sync
excludePaths required string[] ‚Äč

ExcludePaths is an array of file patterns in gitignore format to exclude.

excludeFile required string ‚Äč

ExcludeFile loads the file patterns to exclude from a file.

downloadExcludePaths required string[] ‚Äč

DownloadExcludePaths is an array of file patterns in gitignore format to exclude from downloading

downloadExcludeFile required string ‚Äč

DownloadExcludeFile loads the file patterns to exclude from downloading from a file.

uploadExcludePaths required string[] ‚Äč

UploadExcludePaths is an array of file patterns in gitignore format to exclude from uploading

uploadExcludeFile required string ‚Äč

UploadExcludeFile loads the file patterns to exclude from uploading from a file.

Sync-Triggered Actions
startContainer required boolean false ‚Äč

StartContainer will start the container after initial sync is done. This will inject a devspacehelper into the pod and you need to define dev.*.command for this to work.

onUpload required ‚Äč

OnUpload can be used to execute certain commands on uploading either in the container or locally as well as restart the container after a file changed has happened.

restartContainer required boolean false ‚Äč

If true restart container will try to restart the container after a change has been made. Make sure that images.*.injectRestartHelper is enabled for the container that should be restarted or the devspace-restart-helper script is present in the container root folder.

exec required object[] ‚Äč

Exec will execute the given commands in order after a sync operation

####### name required string {#dev-containers-sync-onUpload-exec-name}

Name is the name to show for this exec in the logs

####### command required string {#dev-containers-sync-onUpload-exec-command}

Command is the command to execute. If no args are specified this is executed within a shell.

####### args required string[] {#dev-containers-sync-onUpload-exec-args}

Args are arguments to pass to the command

####### failOnError required boolean false {#dev-containers-sync-onUpload-exec-failOnError}

FailOnError specifies if the sync should fail if the command fails

####### local required boolean false {#dev-containers-sync-onUpload-exec-local}

Local specifies if the command should be executed locally instead of within the container

####### once required boolean false {#dev-containers-sync-onUpload-exec-once}

Once executes this command only once in the container's life. Can be used to initialize a container before starting it, but after everything was synced.

####### onChange required string[] {#dev-containers-sync-onUpload-exec-onChange}

OnChange is an array of file patterns that trigger this command execution

Initial Sync
initialSync required string ‚Äč

InitialSync defines the initial sync strategy to use when this sync starts. Defaults to mirrorLocal

waitInitialSync required boolean false ‚Äč

WaitInitialSync can be used to tell DevSpace to not wait until the initial sync is done

initialSyncCompareBy required string ‚Äč

InitialSyncCompareBy defines if the sync should only compare by the given type. Either mtime or size are possible

One-Directional Sync
disableDownload required boolean false ‚Äč

DisableDownload will disable downloading completely

disableUpload required boolean false ‚Äč

DisableUpload will disable uploading completely

bandwidthLimits required ‚Äč

BandwidthLimits can be used to limit the amount of bytes that are transferred by DevSpace with this sync configuration

download required integer ‚Äč

Download is the download limit in kilo bytes per second

upload required integer ‚Äč

Upload is the upload limit in kilo bytes per second

polling required boolean false ‚Äč

Polling will tell the remote container to use polling instead of inotify

noWatch required boolean false ‚Äč

NoWatch will terminate the sync after the initial sync is done

file required boolean false ‚Äč

File signals DevSpace that this is a single file that should get synced instead of a whole directory

persistPaths required object[] ‚Äč

PersistPaths allows you to persist certain paths within this container with a persistent volume claim

path required string ‚Äč

Path is the container path that should get persisted. By default, DevSpace will create an init container that will copy over the contents of this folder from the existing image.

volumePath required string ‚Äč

VolumePath is the sub path on the volume that is mounted as persistent volume for this path

readOnly required boolean false ‚Äč

ReadOnly will make the persistent path read only to the user

skipPopulate required boolean false ‚Äč

SkipPopulate will not create an init container to copy over the existing contents if true

initContainer required ‚Äč

InitContainer holds additional options for the persistent path init container

resources required ‚Äč

Resources are the resources used by the persistent path init container

####### requests required <request_name>:string {#dev-containers-persistPaths-initContainer-resources-requests}

Requests are the requests part of the resources

####### limits required <limit_name>:string {#dev-containers-persistPaths-initContainer-resources-limits}

Limits are the limits part of the resources

Foreground Dev Workflows

terminal required ‚Äč

Terminal allows you to tell DevSpace to open a terminal with screen support to this container

command required string ‚Äč

Command is the command that should be executed on terminal start. This command is executed within a shell.

workDir required string ‚Äč

WorkDir is the working directory that is used to execute the command in.

enabled required boolean false ‚Äč

If enabled is true, DevSpace will use the terminal. Can be also used to disable the terminal if set to false. DevSpace makes sure that within a pipeline only one dev configuration can open a terminal at a time and subsequent dev terminals will fail.

disableReplace required boolean false ‚Äč

DisableReplace tells DevSpace to not replace the pod or adjust its settings to make sure the pod is sleeping when opening a terminal

disableScreen required boolean false ‚Äč

DisableScreen will disable screen which is used by DevSpace by default to preserve sessions if connections interrupt or the session is lost.

disableTTY required boolean false ‚Äč

DisableTTY will disable a tty shell for terminal command execution

logs required ‚Äč

Logs allows you to tell DevSpace to stream logs from this container to the console

enabled required boolean false ‚Äč

Enabled can be used to enable printing container logs

lastLines required integer ‚Äč

LastLines is the amount of lines to print of the running container initially

attach required ‚Äč

Attach allows you to tell DevSpace to attach to this container

enabled required boolean false ‚Äč

Enabled can be used to enable attaching to a container

disableReplace required boolean false ‚Äč

DisableReplace prevents DevSpace from actually replacing the pod with modifications so that the pod starts up correctly.

disableTTY required boolean false ‚Äč

DisableTTY is used to tell DevSpace to not use a TTY connection for attaching

ssh required ‚Äč

SSH allows you to create an SSH tunnel to this container

enabled required boolean false ‚Äč

Enabled can be used to enable the ssh server within the container. By default, DevSpace will generate the required keys and create an entry in your ~/.ssh/config for this container that can be used via ssh dev-config-name.dev-project-name.devspace

localHostname required string ‚Äč

LocalHostname is the local ssh host to write to the ~/.ssh/config

localPort required integer ‚Äč

LocalPort is the local port to forward from, if empty will be random

remoteAddress required string ‚Äč

RemoteAddress is the address to listen to inside the container

useInclude required boolean false ‚Äč

UseInclude tells DevSpace to use a the file ~/.ssh/devspace_config for its ssh entries. DevSpace will also create an import for its own entries inside ~/.ssh/config, this is a cleaner way, but unfortunately not all SSH clients support this.

proxyCommands required object[] ‚Äč

ProxyCommands allow you to proxy certain local commands to the container

gitCredentials required boolean false ‚Äč

GitCredentials configures a git credentials helper inside the container that proxies local git credentials

command required string ‚Äč

Command is the name of the command that should be available in the remote container. DevSpace will create a small script for that inside the container that redirect command execution to the local computer.

localCommand required string ‚Äč

LocalCommand can be used to run a different command than specified via the command option. By default, this will be assumed to be the same as command.

skipContainerEnv required boolean false ‚Äč

SkipContainerEnv will not forward the container environment variables to the local command

env required <env_name>:string ‚Äč

Env are extra environment variables to set for the command

restartHelper required ‚Äč

RestartHelper holds restart helper specific configuration. The restart helper is used to delay starting of the container and restarting it and is injected via an annotation in the replaced pod.

path required string ‚Äč

Path defines the path to the restart helper that might be used if certain config options are enabled

inject required boolean false ‚Äč

Inject signals DevSpace to inject the restart helper

Modifications

devImage required string ‚Äč

DevImage is the image to use for this container and will replace the existing image if necessary.

command required string[] ‚Äč

Command can be used to override the entrypoint of the container

args required string[] ‚Äč

Args can be used to override the args of the container

workingDir required string ‚Äč

WorkingDir can be used to override the working dir of the container

env required object[] ‚Äč

Env can be used to add environment variables to the container. DevSpace will not replace existing environment variables if an environment variable is defined here.

name required string ‚Äč

Name of the environment variable

value required string ‚Äč

Value of the environment variable

resources required ‚Äč

Resources can be used to override the resource definitions of the container

requests required <request_name>:string ‚Äč

Requests are the requests part of the resources

limits required <limit_name>:string ‚Äč

Limits are the limits part of the resources

persistenceOptions required ‚Äč

PersistenceOptions are additional options for persisting paths within this pod

size required string ‚Äč

Size is the size of the created persistent volume in Kubernetes size notation like 5Gi

storageClassName required string ‚Äč

StorageClassName is the storage type DevSpace should use for this persistent volume

accessModes required string[] ‚Äč

AccessModes are the access modes DevSpace should use for the persistent volume

readOnly required boolean false ‚Äč

ReadOnly specifies if the volume should be read only

name required string ‚Äč

Name is the name of the PVC that should be created. If a PVC with that name already exists, DevSpace will use that PVC instead of creating one.

patches required object[] ‚Äč

Patches are additional changes to the pod spec that should be applied

op required string ‚Äč

Operation is the path operation to do. Can be either replace, add or remove

path required string ‚Äč

Path is the config path to apply the patch to

value required ‚Äč

Value is the value to use for this patch.

Port Forwarding

reversePorts required object[] ‚Äč

ReversePorts are port mappings to make local ports available inside the container

port required string ‚Äč

Port is a port mapping that maps the localPort:remotePort. So if you port forward the remote port will be available at the local port. If you do reverse port forwarding, the local port will be available at the remote port in the container. If only port is specified, local and remote port are the same.

bindAddress required string ‚Äč

BindAddress is the address DevSpace should listen on. Optional and defaults to localhost.

ports required object[] ‚Äč

Ports defines port mappings from the remote pod that should be forwarded to your local computer

port required string ‚Äč

Port is a port mapping that maps the localPort:remotePort. So if you port forward the remote port will be available at the local port. If you do reverse port forwarding, the local port will be available at the remote port in the container. If only port is specified, local and remote port are the same.

bindAddress required string ‚Äč

BindAddress is the address DevSpace should listen on. Optional and defaults to localhost.

File Sync

sync required object[] ‚Äč

Sync allows you to sync certain local paths with paths inside the container

path required string ‚Äč

Path is the path to sync. This can be defined in the form localPath:remotePath. You can also use '.' to specify either the local or remote working directory. This is valid for example: .:.

Exclude Paths From File Sync

excludePaths required string[] ‚Äč

ExcludePaths is an array of file patterns in gitignore format to exclude.

excludeFile required string ‚Äč

ExcludeFile loads the file patterns to exclude from a file.

downloadExcludePaths required string[] ‚Äč

DownloadExcludePaths is an array of file patterns in gitignore format to exclude from downloading

downloadExcludeFile required string ‚Äč

DownloadExcludeFile loads the file patterns to exclude from downloading from a file.

uploadExcludePaths required string[] ‚Äč

UploadExcludePaths is an array of file patterns in gitignore format to exclude from uploading

uploadExcludeFile required string ‚Äč

UploadExcludeFile loads the file patterns to exclude from uploading from a file.

Sync-Triggered Actions

startContainer required boolean false ‚Äč

StartContainer will start the container after initial sync is done. This will inject a devspacehelper into the pod and you need to define dev.*.command for this to work.

onUpload required ‚Äč

OnUpload can be used to execute certain commands on uploading either in the container or locally as well as restart the container after a file changed has happened.

restartContainer required boolean false ‚Äč

If true restart container will try to restart the container after a change has been made. Make sure that images.*.injectRestartHelper is enabled for the container that should be restarted or the devspace-restart-helper script is present in the container root folder.

exec required object[] ‚Äč

Exec will execute the given commands in order after a sync operation

name required string ‚Äč

Name is the name to show for this exec in the logs

command required string ‚Äč

Command is the command to execute. If no args are specified this is executed within a shell.

args required string[] ‚Äč

Args are arguments to pass to the command

failOnError required boolean false ‚Äč

FailOnError specifies if the sync should fail if the command fails

local required boolean false ‚Äč

Local specifies if the command should be executed locally instead of within the container

once required boolean false ‚Äč

Once executes this command only once in the container's life. Can be used to initialize a container before starting it, but after everything was synced.

onChange required string[] ‚Äč

OnChange is an array of file patterns that trigger this command execution

Initial Sync

initialSync required string ‚Äč

InitialSync defines the initial sync strategy to use when this sync starts. Defaults to mirrorLocal

waitInitialSync required boolean false ‚Äč

WaitInitialSync can be used to tell DevSpace to not wait until the initial sync is done

initialSyncCompareBy required string ‚Äč

InitialSyncCompareBy defines if the sync should only compare by the given type. Either mtime or size are possible

One-Directional Sync

disableDownload required boolean false ‚Äč

DisableDownload will disable downloading completely

disableUpload required boolean false ‚Äč

DisableUpload will disable uploading completely

bandwidthLimits required ‚Äč

BandwidthLimits can be used to limit the amount of bytes that are transferred by DevSpace with this sync configuration

download required integer ‚Äč

Download is the download limit in kilo bytes per second

upload required integer ‚Äč

Upload is the upload limit in kilo bytes per second

polling required boolean false ‚Äč

Polling will tell the remote container to use polling instead of inotify

noWatch required boolean false ‚Äč

NoWatch will terminate the sync after the initial sync is done

file required boolean false ‚Äč

File signals DevSpace that this is a single file that should get synced instead of a whole directory

persistPaths required object[] ‚Äč

PersistPaths allows you to persist certain paths within this container with a persistent volume claim

path required string ‚Äč

Path is the container path that should get persisted. By default, DevSpace will create an init container that will copy over the contents of this folder from the existing image.

volumePath required string ‚Äč

VolumePath is the sub path on the volume that is mounted as persistent volume for this path

readOnly required boolean false ‚Äč

ReadOnly will make the persistent path read only to the user

skipPopulate required boolean false ‚Äč

SkipPopulate will not create an init container to copy over the existing contents if true

initContainer required ‚Äč

InitContainer holds additional options for the persistent path init container

resources required ‚Äč

Resources are the resources used by the persistent path init container

requests required <request_name>:string ‚Äč

Requests are the requests part of the resources

limits required <limit_name>:string ‚Äč

Limits are the limits part of the resources

Foreground Dev Workflows

terminal required ‚Äč

Terminal allows you to tell DevSpace to open a terminal with screen support to this container

command required string ‚Äč

Command is the command that should be executed on terminal start. This command is executed within a shell.

workDir required string ‚Äč

WorkDir is the working directory that is used to execute the command in.

enabled required boolean false ‚Äč

If enabled is true, DevSpace will use the terminal. Can be also used to disable the terminal if set to false. DevSpace makes sure that within a pipeline only one dev configuration can open a terminal at a time and subsequent dev terminals will fail.

disableReplace required boolean false ‚Äč

DisableReplace tells DevSpace to not replace the pod or adjust its settings to make sure the pod is sleeping when opening a terminal

disableScreen required boolean false ‚Äč

DisableScreen will disable screen which is used by DevSpace by default to preserve sessions if connections interrupt or the session is lost.

disableTTY required boolean false ‚Äč

DisableTTY will disable a tty shell for terminal command execution

logs required ‚Äč

Logs allows you to tell DevSpace to stream logs from this container to the console

enabled required boolean false ‚Äč

Enabled can be used to enable printing container logs

lastLines required integer ‚Äč

LastLines is the amount of lines to print of the running container initially

attach required ‚Äč

Attach allows you to tell DevSpace to attach to this container

enabled required boolean false ‚Äč

Enabled can be used to enable attaching to a container

disableReplace required boolean false ‚Äč

DisableReplace prevents DevSpace from actually replacing the pod with modifications so that the pod starts up correctly.

disableTTY required boolean false ‚Äč

DisableTTY is used to tell DevSpace to not use a TTY connection for attaching

ssh required ‚Äč

SSH allows you to create an SSH tunnel to this container

enabled required boolean false ‚Äč

Enabled can be used to enable the ssh server within the container. By default, DevSpace will generate the required keys and create an entry in your ~/.ssh/config for this container that can be used via ssh dev-config-name.dev-project-name.devspace

localHostname required string ‚Äč

LocalHostname is the local ssh host to write to the ~/.ssh/config

localPort required integer ‚Äč

LocalPort is the local port to forward from, if empty will be random

remoteAddress required string ‚Äč

RemoteAddress is the address to listen to inside the container

useInclude required boolean false ‚Äč

UseInclude tells DevSpace to use a the file ~/.ssh/devspace_config for its ssh entries. DevSpace will also create an import for its own entries inside ~/.ssh/config, this is a cleaner way, but unfortunately not all SSH clients support this.

Background Dev Workflows

proxyCommands required object[] ‚Äč

ProxyCommands allow you to proxy certain local commands to the container

gitCredentials required boolean false ‚Äč

GitCredentials configures a git credentials helper inside the container that proxies local git credentials

command required string ‚Äč

Command is the name of the command that should be available in the remote container. DevSpace will create a small script for that inside the container that redirect command execution to the local computer.

localCommand required string ‚Äč

LocalCommand can be used to run a different command than specified via the command option. By default, this will be assumed to be the same as command.

skipContainerEnv required boolean false ‚Äč

SkipContainerEnv will not forward the container environment variables to the local command

env required <env_name>:string ‚Äč

Env are extra environment variables to set for the command

restartHelper required ‚Äč

RestartHelper holds restart helper specific configuration. The restart helper is used to delay starting of the container and restarting it and is injected via an annotation in the replaced pod.

path required string ‚Äč

Path defines the path to the restart helper that might be used if certain config options are enabled

inject required boolean false ‚Äč

Inject signals DevSpace to inject the restart helper

open required object[] ‚Äč

Open defines urls that should be opened as soon as they are reachable

url required string ‚Äč

URL is the url to open in the browser after it is available