Adding container component

A component type that allows to define a container image-based configuration of a container in a workspace. A devfile can contain one or more component(s) of the container type. The container type of component brings in custom tools into the workspace. The component is identified by its image.

Prerequisites

• Adding schema version

• Adding a name

• Adding components

Procedure

1. Define a component using the type container.

   A container component

   devfile.yaml

   components:
     - name: maven
       container:
         image: eclipse/maven-jdk8:latest
         volumeMounts:
           - name: mavenrepo
             path: /root/.m2
         env:
           - name: ENV_VAR
             value: value
         endpoints:
           - name: maven-server
             targetPort: 3101
             protocol: https
             secure: 'true'
             exposure: public
         memoryRequest: 256M
         memoryLimit: 1536M
         cpuRequest: 0.1
         cpuLimit: 0.5
         command: ['tail']
         args: ['-f', '/dev/null']
   

   A minimal container component

   devfile.yaml

   schemaVersion: 2.1.0
   metadata:
       name: mydevfile
   components:
     - name: go
       container:
         image: golang
         memoryLimit: 512Mi
         command: ['sleep', 'infinity']
   

   It specifies the type of the component, container and the image attribute names the image to be used for the component using the usual Docker naming conventions, that is, the above image attribute is equal to docker.io/library/golang:latest.

2. Mounting project sources

   For the container component to have access to the project sources, you must set the mountSources attribute to true.

   devfile.yaml

       schemaVersion: 2.1.0
       metadata:
           name: mydevfile
       components:
         - name: go
           container:
             image: golang
             memoryLimit: 512Mi
             mountSources: true
             command: ['sleep', 'infinity']
   

   The sources is mounted on a location stored in the PROJECTS_ROOT environment variable that is made available in the running container of the image. This location defaults to /projects. If sourceMapping is defined in the container, it overrides the PROJECT_ROOT value if present and mounts the source to the path defined by sourceMapping.

3. Container Entrypoint

   Use the command attribute of the container type to modify the entrypoint command of the container created from the image. The availability of the sleep command and the support for the infinity argument depend on the base image used in the particular images.

Additional Resources

• API reference

• Devfile resources