Devfile schema - Version 2.1.0

Devfile describes the structure of a cloud-native devworkspace and development environment.

attributes: object

Map of implementation-dependant free-form YAML attributes.

commands: object[]

Predefined, ready-to-use, devworkspace-related commands

object
apply: object

Command that consists in applying a given component definition, typically bound to a devworkspace event.

For example, when an apply command is bound to a preStart event, and references a container component, it will start the container as a K8S initContainer in the devworkspace POD, unless the component has its dedicatedPod field set to true.

When no apply command exist for a given component, it is assumed the component will be applied at devworkspace start by default.

component: string

Describes component that will be applied

group: object

Defines the group this command is part of

isDefault: boolean

Identifies the default command for a given group kind

kind: string , x ∈ { build , run , test , debug }

Kind of group the command is part of

label: string

Optional label that provides a label for this command to be used in Editor UI menus for example

composite: object

Composite command that allows executing several sub-commands either sequentially or concurrently

commands: string[]

The commands that comprise this composite command

string
group: object

Defines the group this command is part of

isDefault: boolean

Identifies the default command for a given group kind

kind: string , x ∈ { build , run , test , debug }

Kind of group the command is part of

label: string

Optional label that provides a label for this command to be used in Editor UI menus for example

parallel: boolean

Indicates if the sub-commands should be executed concurrently

exec: object

CLI Command executed in an existing component container

commandLine: string

The actual command-line string

Special variables that can be used:

  • $PROJECTS_ROOT: A path where projects sources are mounted as defined by container component's sourceMapping.

  • $PROJECT_SOURCE: A path to a project source ($PROJECTS_ROOT/). If there are multiple projects, this will point to the directory of the first one.

component: string

Describes component to which given action relates

env: object[]

Optional list of environment variables that have to be set before running the command

object
name: string
value: string
group: object

Defines the group this command is part of

isDefault: boolean

Identifies the default command for a given group kind

kind: string , x ∈ { build , run , test , debug }

Kind of group the command is part of

hotReloadCapable: boolean

Whether the command is capable to reload itself when source code changes. If set to true the command won't be restarted and it is expected to handle file changes on its own.

Default value is false

label: string

Optional label that provides a label for this command to be used in Editor UI menus for example

workingDir: string

Working directory where the command should be executed

Special variables that can be used:

  • $PROJECTS_ROOT: A path where projects sources are mounted as defined by container component's sourceMapping.

  • $PROJECT_SOURCE: A path to a project source ($PROJECTS_ROOT/). If there are multiple projects, this will point to the directory of the first one.

attributes: object

Map of implementation-dependant free-form YAML attributes.

id: string (up to 63 chars) , must match ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$

Mandatory identifier that allows referencing this command in composite commands, from a parent, or in events.

components: object[]

List of the devworkspace components, such as editor and plugins, user-provided containers, or other types of components

object
container: object

Allows adding and configuring devworkspace-related containers

args: string[]

The arguments to supply to the command running the dockerimage component. The arguments are supplied either to the default command provided in the image or to the overridden command.

Defaults to an empty array, meaning use whatever is defined in the image.

string
command: string[]

The command to run in the dockerimage component instead of the default one provided in the image.

Defaults to an empty array, meaning use whatever is defined in the image.

string
cpuLimit: string
cpuRequest: string
dedicatedPod: boolean

Specify if a container should run in its own separated pod, instead of running as part of the main development environment pod.

Default value is false

endpoints: object[]
object
attributes: object

Map of implementation-dependant string-based free-form attributes.

Examples of Che-specific attributes:

  • cookiesAuthEnabled: "true" / "false",
  • type: "terminal" / "ide" / "ide-dev",
exposure: string , x ∈ { public (default) , internal , none }

Describes how the endpoint should be exposed on the network.

  • public means that the endpoint will be exposed on the public network, typically through a K8S ingress or an OpenShift route.
  • internal means that the endpoint will be exposed internally outside of the main devworkspace POD, typically by K8S services, to be consumed by other elements running on the same cloud internal network.
  • none means that the endpoint will not be exposed and will only be accessible inside the main devworkspace POD, on a local address.

Default value is public

name: string (up to 63 chars) , must match ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$
path: string

Path of the endpoint URL

protocol: string , x ∈ { http (default) , https , ws , wss , tcp , udp }

Describes the application and transport protocols of the traffic that will go through this endpoint.

  • http: Endpoint will have http traffic, typically on a TCP connection. It will be automaticaly promoted to https when the secure field is set to true.
  • https: Endpoint will have https traffic, typically on a TCP connection.
  • ws: Endpoint will have ws traffic, typically on a TCP connection. It will be automaticaly promoted to wss when the secure field is set to true.
  • wss: Endpoint will have wss traffic, typically on a TCP connection.
  • tcp: Endpoint will have traffic on a TCP connection, without specifying an application protocol.
  • udp: Endpoint will have traffic on an UDP connection, without specifying an application protocol.

Default value is http

secure: boolean

Describes whether the endpoint should be secured and protected by some authentication process. This requires a protocol of https or wss.

targetPort: integer
env: object[]

Environment variables used in this container.

The following variables are reserved and cannot be overridden via env:

  • $PROJECTS_ROOT

  • $PROJECT_SOURCE

object
name: string
value: string
image: string
memoryLimit: string
memoryRequest: string
mountSources: boolean

Toggles whether or not the project source code should be mounted in the component.

Defaults to true for all component types except plugins and components that set dedicatedPod to true.

sourceMapping: string /projects

Optional specification of the path in the container where project sources should be transferred/mounted when mountSources is true. When omitted, the default value of /projects is used.

volumeMounts: object[]

List of volumes mounts that should be mounted is this container.

object

Volume that should be mounted to a component container

name: string (up to 63 chars) , must match ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$

The volume mount name is the name of an existing Volume component. If several containers mount the same volume name then they will reuse the same volume and will be able to access to the same files.

path: string

The path in the component container where the volume should be mounted. If not path is mentioned, default path is the is /<name>.

kubernetes: object

Allows importing into the devworkspace the Kubernetes resources defined in a given manifest. For example this allows reusing the Kubernetes definitions used to deploy some runtime components in production.

inlined: string

Inlined manifest

uri: string

Location in a file fetched from a uri.

endpoints: object[]
object
attributes: object

Map of implementation-dependant string-based free-form attributes.

Examples of Che-specific attributes:

  • cookiesAuthEnabled: "true" / "false",
  • type: "terminal" / "ide" / "ide-dev",
exposure: string , x ∈ { public (default) , internal , none }

Describes how the endpoint should be exposed on the network.

  • public means that the endpoint will be exposed on the public network, typically through a K8S ingress or an OpenShift route.
  • internal means that the endpoint will be exposed internally outside of the main devworkspace POD, typically by K8S services, to be consumed by other elements running on the same cloud internal network.
  • none means that the endpoint will not be exposed and will only be accessible inside the main devworkspace POD, on a local address.

Default value is public

name: string (up to 63 chars) , must match ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$
path: string

Path of the endpoint URL

protocol: string , x ∈ { http (default) , https , ws , wss , tcp , udp }

Describes the application and transport protocols of the traffic that will go through this endpoint.

  • http: Endpoint will have http traffic, typically on a TCP connection. It will be automaticaly promoted to https when the secure field is set to true.
  • https: Endpoint will have https traffic, typically on a TCP connection.
  • ws: Endpoint will have ws traffic, typically on a TCP connection. It will be automaticaly promoted to wss when the secure field is set to true.
  • wss: Endpoint will have wss traffic, typically on a TCP connection.
  • tcp: Endpoint will have traffic on a TCP connection, without specifying an application protocol.
  • udp: Endpoint will have traffic on an UDP connection, without specifying an application protocol.

Default value is http

secure: boolean

Describes whether the endpoint should be secured and protected by some authentication process. This requires a protocol of https or wss.

targetPort: integer
openshift: object

Allows importing into the devworkspace the OpenShift resources defined in a given manifest. For example this allows reusing the OpenShift definitions used to deploy some runtime components in production.

inlined: string

Inlined manifest

uri: string

Location in a file fetched from a uri.

endpoints: object[]
object
attributes: object

Map of implementation-dependant string-based free-form attributes.

Examples of Che-specific attributes:

  • cookiesAuthEnabled: "true" / "false",
  • type: "terminal" / "ide" / "ide-dev",
exposure: string , x ∈ { public (default) , internal , none }

Describes how the endpoint should be exposed on the network.

  • public means that the endpoint will be exposed on the public network, typically through a K8S ingress or an OpenShift route.
  • internal means that the endpoint will be exposed internally outside of the main devworkspace POD, typically by K8S services, to be consumed by other elements running on the same cloud internal network.
  • none means that the endpoint will not be exposed and will only be accessible inside the main devworkspace POD, on a local address.

Default value is public

name: string (up to 63 chars) , must match ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$
path: string

Path of the endpoint URL

protocol: string , x ∈ { http (default) , https , ws , wss , tcp , udp }

Describes the application and transport protocols of the traffic that will go through this endpoint.

  • http: Endpoint will have http traffic, typically on a TCP connection. It will be automaticaly promoted to https when the secure field is set to true.
  • https: Endpoint will have https traffic, typically on a TCP connection.
  • ws: Endpoint will have ws traffic, typically on a TCP connection. It will be automaticaly promoted to wss when the secure field is set to true.
  • wss: Endpoint will have wss traffic, typically on a TCP connection.
  • tcp: Endpoint will have traffic on a TCP connection, without specifying an application protocol.
  • udp: Endpoint will have traffic on an UDP connection, without specifying an application protocol.

Default value is http

secure: boolean

Describes whether the endpoint should be secured and protected by some authentication process. This requires a protocol of https or wss.

targetPort: integer
volume: object

Allows specifying the definition of a volume shared by several other components

ephemeral: boolean

Ephemeral volumes are not stored persistently across restarts. Defaults to false

size: string

Size of the volume

attributes: object

Map of implementation-dependant free-form YAML attributes.

name: string (up to 63 chars) , must match ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$

Mandatory name that allows referencing the component from other elements (such as commands) or from an external devfile that may reference this component through a parent or a plugin.

events: object

Bindings of commands to events. Each command is referred-to by its name.

postStart: string[]

IDs of commands that should be executed after the devworkspace is completely started. In the case of Che-Theia, these commands should be executed after all plugins and extensions have started, including project cloning. This means that those commands are not triggered until the user opens the IDE in his browser.

string
postStop: string[]

IDs of commands that should be executed after stopping the devworkspace.

string
preStart: string[]

IDs of commands that should be executed before the devworkspace start. Kubernetes-wise, these commands would typically be executed in init containers of the devworkspace POD.

string
preStop: string[]

IDs of commands that should be executed before stopping the devworkspace.

string
metadata: object

Optional metadata

attributes: object

Map of implementation-dependant free-form YAML attributes. Deprecated, use the top-level attributes field instead.

description: string

Optional devfile description

displayName: string

Optional devfile display name

globalMemoryLimit: string

Optional devfile global memory limit

icon: string

Optional devfile icon, can be a URI or a relative path in the project

language: string

Optional devfile language

name: string

Optional devfile name

projectType: string

Optional devfile project type

tags: string[]

Optional devfile tags

string
version: string , must match ^([0-9]+)\.([0-9]+)\.([0-9]+)(\-[0-9a-z-]+(\.[0-9a-z-]+)*)?(\+[0-9A-Za-z-]+(\.[0-9A-Za-z-]+)*)?$

Optional semver-compatible version

website: string

Optional devfile website

parent: object

Parent devworkspace template

id: string

Id in a registry that contains a Devfile yaml file

kubernetes: object

Reference to a Kubernetes CRD of type DevWorkspaceTemplate

name: string
namespace: string
uri: string

URI Reference of a parent devfile YAML file. It can be a full URL or a relative URI with the current devfile as the base URI.

attributes: object

Overrides of attributes encapsulated in a parent devfile. Overriding is done according to K8S strategic merge patch standard rules.

commands: object[]

Overrides of commands encapsulated in a parent devfile or a plugin. Overriding is done according to K8S strategic merge patch standard rules.

object
apply: object

Command that consists in applying a given component definition, typically bound to a devworkspace event.

For example, when an apply command is bound to a preStart event, and references a container component, it will start the container as a K8S initContainer in the devworkspace POD, unless the component has its dedicatedPod field set to true.

When no apply command exist for a given component, it is assumed the component will be applied at devworkspace start by default.

component: string

Describes component that will be applied

group: object

Defines the group this command is part of

isDefault: boolean

Identifies the default command for a given group kind

kind: string , x ∈ { build , run , test , debug }

Kind of group the command is part of

label: string

Optional label that provides a label for this command to be used in Editor UI menus for example

composite: object

Composite command that allows executing several sub-commands either sequentially or concurrently

commands: string[]

The commands that comprise this composite command

string
group: object

Defines the group this command is part of

isDefault: boolean

Identifies the default command for a given group kind

kind: string , x ∈ { build , run , test , debug }

Kind of group the command is part of

label: string

Optional label that provides a label for this command to be used in Editor UI menus for example

parallel: boolean

Indicates if the sub-commands should be executed concurrently

exec: object

CLI Command executed in an existing component container

commandLine: string

The actual command-line string

Special variables that can be used:

  • $PROJECTS_ROOT: A path where projects sources are mounted as defined by container component's sourceMapping.

  • $PROJECT_SOURCE: A path to a project source ($PROJECTS_ROOT/). If there are multiple projects, this will point to the directory of the first one.

component: string

Describes component to which given action relates

env: object[]

Optional list of environment variables that have to be set before running the command

object
name: string
value: string
group: object

Defines the group this command is part of

isDefault: boolean

Identifies the default command for a given group kind

kind: string , x ∈ { build , run , test , debug }

Kind of group the command is part of

hotReloadCapable: boolean

Whether the command is capable to reload itself when source code changes. If set to true the command won't be restarted and it is expected to handle file changes on its own.

Default value is false

label: string

Optional label that provides a label for this command to be used in Editor UI menus for example

workingDir: string

Working directory where the command should be executed

Special variables that can be used:

  • $PROJECTS_ROOT: A path where projects sources are mounted as defined by container component's sourceMapping.

  • $PROJECT_SOURCE: A path to a project source ($PROJECTS_ROOT/). If there are multiple projects, this will point to the directory of the first one.

attributes: object

Map of implementation-dependant free-form YAML attributes.

id: string (up to 63 chars) , must match ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$

Mandatory identifier that allows referencing this command in composite commands, from a parent, or in events.

components: object[]

Overrides of components encapsulated in a parent devfile or a plugin. Overriding is done according to K8S strategic merge patch standard rules.

object
container: object

Allows adding and configuring devworkspace-related containers

args: string[]

The arguments to supply to the command running the dockerimage component. The arguments are supplied either to the default command provided in the image or to the overridden command.

Defaults to an empty array, meaning use whatever is defined in the image.

string
command: string[]

The command to run in the dockerimage component instead of the default one provided in the image.

Defaults to an empty array, meaning use whatever is defined in the image.

string
cpuLimit: string
cpuRequest: string
dedicatedPod: boolean

Specify if a container should run in its own separated pod, instead of running as part of the main development environment pod.

Default value is false

endpoints: object[]
object
attributes: object

Map of implementation-dependant string-based free-form attributes.

Examples of Che-specific attributes:

  • cookiesAuthEnabled: "true" / "false",
  • type: "terminal" / "ide" / "ide-dev",
exposure: string , x ∈ { public , internal , none }

Describes how the endpoint should be exposed on the network.

  • public means that the endpoint will be exposed on the public network, typically through a K8S ingress or an OpenShift route.
  • internal means that the endpoint will be exposed internally outside of the main devworkspace POD, typically by K8S services, to be consumed by other elements running on the same cloud internal network.
  • none means that the endpoint will not be exposed and will only be accessible inside the main devworkspace POD, on a local address.

Default value is public

name: string (up to 63 chars) , must match ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$
path: string

Path of the endpoint URL

protocol: string , x ∈ { http , https , ws , wss , tcp , udp }

Describes the application and transport protocols of the traffic that will go through this endpoint.

  • http: Endpoint will have http traffic, typically on a TCP connection. It will be automaticaly promoted to https when the secure field is set to true.
  • https: Endpoint will have https traffic, typically on a TCP connection.
  • ws: Endpoint will have ws traffic, typically on a TCP connection. It will be automaticaly promoted to wss when the secure field is set to true.
  • wss: Endpoint will have wss traffic, typically on a TCP connection.
  • tcp: Endpoint will have traffic on a TCP connection, without specifying an application protocol.
  • udp: Endpoint will have traffic on an UDP connection, without specifying an application protocol.

Default value is http

secure: boolean

Describes whether the endpoint should be secured and protected by some authentication process. This requires a protocol of https or wss.

targetPort: integer
env: object[]

Environment variables used in this container.

The following variables are reserved and cannot be overridden via env:

  • $PROJECTS_ROOT

  • $PROJECT_SOURCE

object
name: string
value: string
image: string
memoryLimit: string
memoryRequest: string
mountSources: boolean

Toggles whether or not the project source code should be mounted in the component.

Defaults to true for all component types except plugins and components that set dedicatedPod to true.

sourceMapping: string

Optional specification of the path in the container where project sources should be transferred/mounted when mountSources is true. When omitted, the default value of /projects is used.

volumeMounts: object[]

List of volumes mounts that should be mounted is this container.

object

Volume that should be mounted to a component container

name: string (up to 63 chars) , must match ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$

The volume mount name is the name of an existing Volume component. If several containers mount the same volume name then they will reuse the same volume and will be able to access to the same files.

path: string

The path in the component container where the volume should be mounted. If not path is mentioned, default path is the is /<name>.

kubernetes: object

Allows importing into the devworkspace the Kubernetes resources defined in a given manifest. For example this allows reusing the Kubernetes definitions used to deploy some runtime components in production.

inlined: string

Inlined manifest

uri: string

Location in a file fetched from a uri.

endpoints: object[]
object
attributes: object

Map of implementation-dependant string-based free-form attributes.

Examples of Che-specific attributes:

  • cookiesAuthEnabled: "true" / "false",
  • type: "terminal" / "ide" / "ide-dev",
exposure: string , x ∈ { public , internal , none }

Describes how the endpoint should be exposed on the network.

  • public means that the endpoint will be exposed on the public network, typically through a K8S ingress or an OpenShift route.
  • internal means that the endpoint will be exposed internally outside of the main devworkspace POD, typically by K8S services, to be consumed by other elements running on the same cloud internal network.
  • none means that the endpoint will not be exposed and will only be accessible inside the main devworkspace POD, on a local address.

Default value is public

name: string (up to 63 chars) , must match ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$
path: string

Path of the endpoint URL

protocol: string , x ∈ { http , https , ws , wss , tcp , udp }

Describes the application and transport protocols of the traffic that will go through this endpoint.

  • http: Endpoint will have http traffic, typically on a TCP connection. It will be automaticaly promoted to https when the secure field is set to true.
  • https: Endpoint will have https traffic, typically on a TCP connection.
  • ws: Endpoint will have ws traffic, typically on a TCP connection. It will be automaticaly promoted to wss when the secure field is set to true.
  • wss: Endpoint will have wss traffic, typically on a TCP connection.
  • tcp: Endpoint will have traffic on a TCP connection, without specifying an application protocol.
  • udp: Endpoint will have traffic on an UDP connection, without specifying an application protocol.

Default value is http

secure: boolean

Describes whether the endpoint should be secured and protected by some authentication process. This requires a protocol of https or wss.

targetPort: integer
openshift: object

Allows importing into the devworkspace the OpenShift resources defined in a given manifest. For example this allows reusing the OpenShift definitions used to deploy some runtime components in production.

inlined: string

Inlined manifest

uri: string

Location in a file fetched from a uri.

endpoints: object[]
object
attributes: object

Map of implementation-dependant string-based free-form attributes.

Examples of Che-specific attributes:

  • cookiesAuthEnabled: "true" / "false",
  • type: "terminal" / "ide" / "ide-dev",
exposure: string , x ∈ { public , internal , none }

Describes how the endpoint should be exposed on the network.

  • public means that the endpoint will be exposed on the public network, typically through a K8S ingress or an OpenShift route.
  • internal means that the endpoint will be exposed internally outside of the main devworkspace POD, typically by K8S services, to be consumed by other elements running on the same cloud internal network.
  • none means that the endpoint will not be exposed and will only be accessible inside the main devworkspace POD, on a local address.

Default value is public

name: string (up to 63 chars) , must match ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$
path: string

Path of the endpoint URL

protocol: string , x ∈ { http , https , ws , wss , tcp , udp }

Describes the application and transport protocols of the traffic that will go through this endpoint.

  • http: Endpoint will have http traffic, typically on a TCP connection. It will be automaticaly promoted to https when the secure field is set to true.
  • https: Endpoint will have https traffic, typically on a TCP connection.
  • ws: Endpoint will have ws traffic, typically on a TCP connection. It will be automaticaly promoted to wss when the secure field is set to true.
  • wss: Endpoint will have wss traffic, typically on a TCP connection.
  • tcp: Endpoint will have traffic on a TCP connection, without specifying an application protocol.
  • udp: Endpoint will have traffic on an UDP connection, without specifying an application protocol.

Default value is http

secure: boolean

Describes whether the endpoint should be secured and protected by some authentication process. This requires a protocol of https or wss.

targetPort: integer
volume: object

Allows specifying the definition of a volume shared by several other components

ephemeral: boolean

Ephemeral volumes are not stored persistently across restarts. Defaults to false

size: string

Size of the volume

attributes: object

Map of implementation-dependant free-form YAML attributes.

name: string (up to 63 chars) , must match ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$

Mandatory name that allows referencing the component from other elements (such as commands) or from an external devfile that may reference this component through a parent or a plugin.

projects: object[]

Overrides of projects encapsulated in a parent devfile. Overriding is done according to K8S strategic merge patch standard rules.

object
git: object

Project's Git source

checkoutFrom: object

Defines from what the project should be checked out. Required if there are more than one remote configured

remote: string

The remote name should be used as init. Required if there are more than one remote configured

revision: string

The revision to checkout from. Should be branch name, tag or commit id. Default branch is used if missing or specified revision is not found.

remotes: object

The remotes map which should be initialized in the git project. Must have at least one remote configured

zip: object

Project's Zip source

location: string

Zip project's source location address. Should be file path of the archive, e.g. file://$FILE_PATH

attributes: object

Map of implementation-dependant free-form YAML attributes.

clonePath: string

Path relative to the root of the projects to which this project should be cloned into. This is a unix-style relative path (i.e. uses forward slashes). The path is invalid if it is absolute or tries to escape the project root through the usage of '..'. If not specified, defaults to the project name.

name: string (up to 63 chars) , must match ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$

Project name

registryUrl: string

Registry URL to pull the parent devfile from when using id in the parent reference. To ensure the parent devfile gets resolved consistently in different environments, it is recommended to always specify the regsitryURL when Id is used.

starterProjects: object[]

Overrides of starterProjects encapsulated in a parent devfile. Overriding is done according to K8S strategic merge patch standard rules.

object
git: object

Project's Git source

checkoutFrom: object

Defines from what the project should be checked out. Required if there are more than one remote configured

remote: string

The remote name should be used as init. Required if there are more than one remote configured

revision: string

The revision to checkout from. Should be branch name, tag or commit id. Default branch is used if missing or specified revision is not found.

remotes: object

The remotes map which should be initialized in the git project. Must have at least one remote configured

zip: object

Project's Zip source

location: string

Zip project's source location address. Should be file path of the archive, e.g. file://$FILE_PATH

attributes: object

Map of implementation-dependant free-form YAML attributes.

description: string

Description of a starter project

name: string (up to 63 chars) , must match ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$

Project name

subDir: string

Sub-directory from a starter project to be used as root for starter project.

variables: object

Overrides of variables encapsulated in a parent devfile. Overriding is done according to K8S strategic merge patch standard rules.

projects: object[]

Projects worked on in the devworkspace, containing names and sources locations

object
git: object

Project's Git source

checkoutFrom: object

Defines from what the project should be checked out. Required if there are more than one remote configured

remote: string

The remote name should be used as init. Required if there are more than one remote configured

revision: string

The revision to checkout from. Should be branch name, tag or commit id. Default branch is used if missing or specified revision is not found.

remotes: object

The remotes map which should be initialized in the git project. Must have at least one remote configured

zip: object

Project's Zip source

location: string

Zip project's source location address. Should be file path of the archive, e.g. file://$FILE_PATH

attributes: object

Map of implementation-dependant free-form YAML attributes.

clonePath: string

Path relative to the root of the projects to which this project should be cloned into. This is a unix-style relative path (i.e. uses forward slashes). The path is invalid if it is absolute or tries to escape the project root through the usage of '..'. If not specified, defaults to the project name.

name: string (up to 63 chars) , must match ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$

Project name

schemaVersion: string , must match ^([2-9])\.([0-9]+)\.([0-9]+)(\-[0-9a-z-]+(\.[0-9a-z-]+)*)?(\+[0-9A-Za-z-]+(\.[0-9A-Za-z-]+)*)?$

Devfile schema version

starterProjects: object[]

StarterProjects is a project that can be used as a starting point when bootstrapping new projects

object
git: object

Project's Git source

checkoutFrom: object

Defines from what the project should be checked out. Required if there are more than one remote configured

remote: string

The remote name should be used as init. Required if there are more than one remote configured

revision: string

The revision to checkout from. Should be branch name, tag or commit id. Default branch is used if missing or specified revision is not found.

remotes: object

The remotes map which should be initialized in the git project. Must have at least one remote configured

zip: object

Project's Zip source

location: string

Zip project's source location address. Should be file path of the archive, e.g. file://$FILE_PATH

attributes: object

Map of implementation-dependant free-form YAML attributes.

description: string

Description of a starter project

name: string (up to 63 chars) , must match ^[a-z0-9]([-a-z0-9]*[a-z0-9])?$

Project name

subDir: string

Sub-directory from a starter project to be used as root for starter project.

variables: object

Map of key-value variables used for string replacement in the devfile. Values can can be referenced via {{variable-key}} to replace the corresponding value in string fields in the devfile. Replacement cannot be used for

  • schemaVersion, metadata, parent source - element identifiers, e.g. command id, component name, endpoint name, project name - references to identifiers, e.g. in events, a command's component, container's volume mount name - string enums, e.g. command group kind, endpoint exposure