Keptn v1 reached EOL December 22, 2023. For more information see https://bit.ly/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

The bottom of the project overview, has a “Create a new project” button. 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 must be unique in the Keptn installation, meaning that it must not be a name that is used 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

You can update your project on the project settings page.

Project settings

Delete your project

You can delete your project on the project settings page. 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.