Adding projects

This section describes how to add one or more projects to a devfile.

Prerequisites

• Adding schema version

• Adding a name

Procedure

1. Add a projects section in the devfile, containing a list of one or more projects.

   A minimal devfile with one single project

   devfile.yaml

   schemaVersion: 2.1.0
   metadata:
     name: petclinic-dev-environment
     version: 1.0.0
   projects:
     - name: petclinic
       git:
         remotes:
           origin: "https://github.com/spring-projects/spring-petclinic.git"
         checkoutFrom:
           revision: main
   

   A devfile with multiple projects

   devfile.yaml

   schemaVersion: 2.1.0
   metadata:
     name: example-devfile
     version: 1.0.0
   projects:
   - name: frontend
     git:
       remotes:
         origin: "https://github.com/acmecorp/frontend.git"
   - name: backend
     git:
       remotes:
         origin: "https://github.com/acmecorp/backend.git"
   

2. For each project, define an unique value for the mandatory name attribute.

3. For each project, define a mandatory source of either the git or zip type.

   Projects with sources in Git. checkoutFrom refers to the branch being used.

   git

   devfile.yaml

   projects:
     - name: my-project1
       git:
         remotes:
           origin: "https://github.com/my-org/project1.git"
         checkoutFrom:
           revision: main
   

   Projects with sources in a ZIP archive. location refers to the URL of a ZIP file.

   zip

   devfile.yaml

   source:
       zip:
         location: http://host.net/path/project-src.zip
   

4. For each project, define the optional clonePath attribute to specify the path into which the project is to be cloned. The path must be relative to the /projects/ directory, and it cannot leave the /projects/ directory. The default value is the project name.

   Defining the clonePath attribute

   devfile.yaml

   schemaVersion: 2.1.0
   metadata:
     name: my-project-dev
     version: 2.0.0
   projects:
     - name: my-project-resource
       clonePath: resources/my-project
       zip:
         location: http://host.net/path/project-res.zip
     - name: my-project2
         git:
           remotes:
             origin: "https://github.com/my-org/project2.git"
           checkoutFrom:
             revision: develop
   

Additional resources

• API reference

• Devfile resources