An application groups components, environments, and a source repository into a software product you can build, deploy, release, and manage feature flags with CloudBees Unify. Refer to the applications documentation to gain a deeper understanding of how to use applications in CloudBees Unify, 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.
The following sections describe how to access, create, update, and delete applications in the UI.
Components and repositories in applications
An application is a logical grouping of components, environments, and configurations. Understanding how components and repositories work within applications helps you configure them effectively:
-
Component: A deployable unit of software (such as a service, library, or module). Each component is connected to a repository via an SCM integration.
-
Component repository: The source code location where a specific component’s code is stored. Each component has its own repository.
-
Application repository link (optional): A single repository that can be linked at the application level for workflow orchestration (deployer workflows, staged workflows). This is separate from component repositories.
Example: A microservices application might have:
-
Three components (
auth-service,api-service,web-ui). -
Three component repositories (one for each service’s code).
-
One application repository link (optional, for coordinating multi-component releases).
-
Each component can have different feature flags and deployment states.
Feature management code references
Components must be linked to the application. CloudBees Unify scans the repository associated with each component to find where flags are referenced in that component’s code.
Refer to components documentation for more details about creating and managing components.
Access an application
Select an organization, and then select Applications to view all applications within that organization, including links to associated repositories and workflow runs.
From the application list, you can:
-
Select the application name to view the application details, or the Repo link to view the repository.
-
Select the run link to view the details of the most recent run.
-
If the run is not manually triggered, select the Trigger link to view the commit in the repository.
|
Select |
To access an application from the list:
-
(Optional) Search for a specific application by entering all or part of its name into Search.
-
(Optional) Select Filter to filter applications by their most recent run status. Only status types that are present in the unfiltered list are available in the filter.
-
Select an application name to view the application details.
Create an application
Create applications in your organization and connect them to environments, components, and repositories.
To create an application:
-
Select an organization, and then select Applications.
-
Select Create application.
-
Enter an Application name.
-
(Optional) Enter a Description.
-
(Optional) Select Add environment, and then select an environment from the options. Repeat to add more environments.
To rearrange the environment list, select 
next to an environment and drag to the desired position.
-
(Optional) To enable source code access for workflow orchestration, select Add repository, and then do one of the following:
-
Select a repository from the options, and then select Add.
Select
to display only those repositories available for connection. -
Select Connect your repository to create a new SCM integration. Then return to the application creation form to link the repository.
-
-
(Optional) Select Add component, and then select a component from the options. Repeat to add more components.
Feature management code references require components to be linked to the application. CloudBees Unify scans each component’s repository for flag references. Refer to Components and repositories in applications for details on the relationship between components and repositories.
-
Select Create.
CloudBees Unify creates the application and lists it in Applications for your organization.
|
Linking components and a repository to your application enables:
For detailed instructions on setting up code references, refer to Set up code references. |
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:
-
Select an application.
-
Select
next to the application you want to update. -
Select Edit.
-
Make any desired changes, including:
-
Update the Application name.
-
Update the Description.
-
Link one or more environments. To unlink, select
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
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
next to a component, and then select Confirm.
-
-
Select Save to save changes.
|
When you change the component list, the deployer workflow becomes invalid. You must regenerate or edit the deployer workflow to accommodate these changes. |
Delete an application
A deleted application is completely removed from all organizations in CloudBees Unify, and deletion is irreversible.
To delete an application:
-
Select an application.
-
Select
next to the application to delete. -
Select Delete application.
-
Select Delete. The application is permanently deleted.