Manage applications

3 minute read

An application is a grouping for components and environments in your CloudBees platform organization. Refer to the applications documentation to gain a deeper understanding of how to use applications in the platform, and use role-based access control to manage permissions for application-related tasks.

A single application may be linked to:

  • A single source code repository.

  • One or more environments.

  • One or more components.

Perform any of the following management functions on applications in your organization:

Access an application

Select an organization, and then select Applications, to display all applications within that organization, including links to associated repositories and workflow runs.

Application filter
Figure 1. An example application list filtering for successful runs.

Perform any of the following in the application list:

  1. Select the application name to view the application details, and the Repo link to view the repository.

  2. Select the run link to view the details of the most recent run.

  3. If the run is not manually triggered, select the Trigger link to view the commit in the repository.

  4. Select Application details to view the application details (identical to selecting the application name).

Select Sort down or Sort up next to an application list column heading to sort on that heading.

To access an application from the list:

  1. (Optional) Search for a specific application by entering all or part of its name into Search.

  2. Select Filter to list applications by the status of their most recent run. Only status types which are present in the unfiltered list are available in the filter.

  3. Select an application name or Application details.

The application details are displayed accordingly.

Create an application

You can create multiple applications in an organization. Connect your application to environments and components within your organization. Integrate a repository with the CloudBees platform, and then link it to your application.

To create an application:

  1. Select an organization, and then select Applications.

  2. Select Create application.

  3. Enter an Application name.

  4. (Optional) Enter a Description.

  5. (Optional) Select Add environment, and then select an environment from the options. Repeat to add more environments.

    To rearrange the environment list, select Six dots next to an environment and drag to the desired position.
  6. (Optional) Select Add repository, and then do one of the following:

    • Select a repository from the options, and then select Add.

      • Select Hide connected repositories to display only those repositories available for connection.

    • Select Connect your repository to create a new SCM integration, and then create an application.

  7. (Optional) Select Add component, and then select a component from the options. Repeat to add more components.

  8. Select Create.

The application is created accordingly and listed in Applications for your organization.

Create an application
Figure 2. Creating an example application with multiple linkages.

Update an application

You can edit the application name and description, as well as add or remove the following linkages:

  • Environment(s)

  • A single repository

  • Component(s)

To update an application:

  1. Select an application.

  2. Select Vertical ellipsis next to the application you want to update.

  3. Select Edit.

  4. Make any desired changes, including:

    • Update the Application name.

    • Update the Description.

    • Link one or more environments. To unlink, select Trash can next to an environment, and then select Confirm.

    • Link or unlink a repository:

      • If no repository is linked, select a repository from the options, and then select Add.

      • To unlink, select Trash can next to a repository, and then select Confirm.

        You can only link a single repository to an application. To link to a different repository, first remove the existing linkage.
    • Link one or more components. To unlink, select Trash can next to a component, and then select Confirm.

  5. Select Save.

The selected application is updated accordingly.

Delete an application

Delete any of your applications. A deleted application is completely removed from all organizations in the CloudBees platform, and deletion is irreversible.

To delete an application:

  1. Select an application.

  2. Select Vertical ellipsis next to the application you want to delete.

  3. Select Delete application.

  4. Select Delete.

The selected application is deleted and removed from the application list.