Keptn v1 reached EOL December 22, 2023. For more information see https://bit.ly/keptn
This documentation is for an older Keptn release. Please consider the newest one when working with the latest Keptn.

Manage Projects

The Bridge provides features to make managing projects more convenient. It is possible to create and update projects directly from the UI. The following sections explain in detail which functionalities you can use to set up your projects and where to find them.

This may also be interesting for you:

Create a new project in Bridge

Going to the project overview, there is a “Create a new project” button at the bottom of the page. Clicking on this button redirects you to a new page with a form that provides all the necessary information needed for creating a new project in Keptn.

Empty project page
Create project page
Create project page filled in with examples

This information needs to be provided:

Project name

The project name has to be unique in the Keptn installation. Therefore, it must not be a name that is already in use for another project.

Git repository settings

The Git upstream can be set by providing the Git repository URL, Git username and the Git token. This is parallel to the Git --git-user=GIT_USER --git-token=GIT_TOKEN --git-remote-url=GIT_REMOTE_URL parameters when using the Keptn CLI. More information about how you can set up your git provider can be found in the Git-based upstream documentation.

Shipyard file

Please provide the shipyard.yaml file here for your project. You can either drag it into the panel or select it manually from your file system with the “Select a file” button. You can find more information about the shipyard file on the Shipyard documentation page.

After the successful creation of the project, you are redirected directly to the new project’s settings page. Your project should already be available in the project overview and in the navigation.

Successful creation of a project
Project overview

Update your project

On the project settings page, you can update your project.

Project settings

Delete your project

On the project settings page, you can delete your project. Please be careful when using this feature, as the project will be removed permanently from your Keptn installation and cannot be restored.

Delete project

Update the Git upstream settings

The git upstream can be updated by providing the Git repository URL, Git username and the Git token. This can also be achieved by using the keptn update project command. More information about how you can set up your Git provider can be found in the Git-based upstream documentation.