Working with Nested Components

As an Application Developer, you use nested Components to execute a single deployment process where multiple Components are deployed on the same Deployment Target. This helps you to, for example, keep track of the sub-components when deploying a Kubernetes Application using Helm.

Nested Components can also be used to deploy one Component that needs to get multiple Artifacts from different Artifact Sources. Nested Components can overcome the 1-1 assignment limit of Component-Artifact mapping in one Package.

To deploy nested Components, you have to assign them to a normal Component and deploy the normal Component. Several nested Components can be assigned to a normal Component. However, deploying a normal Component with assigned nested Components does not necessarily mean that all nested Components are deployed. You can define which nested Components should be deployed by adding the Select Nested Components Action to the Component Workflow.

Notes:

Nested Components cannot be assigned to Deployment Targets, only the parent Component.
Nested Components without a parent assignment can be used as normal Components in Workflows.
You can configure if you want to create installation records for the Component custom type. See: Traceable

Viewing Nested Components

Nested Components can be accessed:

From an Application:
1. Open the Release Automation perspective and click the Applications tab.
2. Double-click an Application to open it.
3. Select a parent Component.
4. Display the Nested Components tab in the right panel.
From a Package:
1. Open the Release Automation perspective and click the Packages tab.
2. Click the Packages tab in the navigator pane.
3. Click the Components button at the top.
4. Display the Nested Components tab in the right panel.

Creating Nested Components

To create a nested Component, the same procedure as for Creating Components can be used. The nested type is defined by the baseType parameter set in the Component custom type.

Assigning Nested Components to a Parent Component

Nested Components can be assigned:

From the Application dashboard:
1. Double-click an Application to open the Application dashboard.
2. Select a Component.
3. Click Properties.
4. Click Assign Components in the Nested Components section.
5. Select the Component you want to assign to the parent Component.
6. Click OK.
From a Package Component:
1. Open a Package.
2. Select the Components tab.
3. In the Nested Components section of the sidebar, click Assign Components.
4. Select the Component you want to assign to the parent Component.
5. Click OK.
Note: When a nested Component is added to a parent Component, all Packages that contain the parent Component are affected.

Deleting Nested Components

To delete a nested Component, the same procedure for Deleting Components can be used.

You can also delete nested Components from the Application dashboard:

Double-click an Application to open the Application dashboard.
Select a Component.
Click the delete button in the Nested Components section of the right sidebar.

Dynamic Properties

You can use the @parent type to reference dynamic properties of the parent Component.

Example:

{@parent/system/name}