The Projects page

On this page

When the browser opens on your CloudBees Jenkins X Distribution UI you are first presented with the Projects page, which displays all of the projects currently managed by your cluster.

CloudBees Jenkins X Distribution UI Project page

Any project that you have imported or created with a quickstart in your CloudBees Jenkins X Distribution cluster appears in the UI. Also included are the repositories CloudBees Jenkins X Distribution uses for development, staging, and projection environments (for example if you named your development cluster docstest1 your staging repository is named environment-docstest1-staging).

Finding individual projects can be done either through the Search Projects box as well as the drop-down, which allows users to filter projects by Recently Created and Recently Built projects.

Create new projects

By clicking the Create Project button you can now create your projects from the UI.

Create a new project from a quickstart

If you want to start a brand new project, you can select a template from a list available "quickstarts" that are pre-configured to work with CloudBees Jenkins X Distribution. Select Quickstart after clicking the Create Project button, select your quickstart from the list and click the Continue button:

CloudBees Jenkins X Distribution UI Quickstart list

You are then prompted to enter the required information to create your project:

  • Git Access Token: the user token who has access to the organization you want to create your project on.

  • Git Organization: the git organization on which you want your project to be created.

  • New Repository: the new repository name for your project.

CloudBees Jenkins X Distribution UI Quickstart form

Once you’ve completed all the fields and they are valid, click the Finish button to create your project.

CloudBees Jenkins X Distribution UI Quickstart result

The resulting page shows you the steps completed to create your project. You can then browse the project on github or go to the project page to follow the first build that is triggered automatically.

For more information about creating quickstarts and how they work, refer to the Creating Quickstarts page.

Import an existing project

If you want to import an existing project, you can do so by clicking the Create project button and then select Import Repository.

You are then prompted to enter the required information to create your project:

  • Git Access Token: the user token who has access to the organization you want to create your project on.

  • Git Organization: the git organization on which your project is located.

  • Repository: the list of projects you can select from will be populated as soon as you have selected the organization so you can select the project you want to import.

CloudBees Jenkins X Distribution UI Import form

Once you’ve completed all the fields and they are valid, click the Finish button to import your project. The resulting page shows you the steps completed to create your project. You can then browse the project on github or go to the project page to follow the first build that is triggered automatically.