Adding a loop segment

You can add a loop segment within a loop to manage a microservice that requires its own repositories, builds, and integrations.

Before you begin

Ensure that the following tasks are completed:

  • Created a teamspace or a member of an existing teamspace.
  • Created a loop.

About this task

Segments are used when an application contains multiple microservices that require independent repositories, builds, and testing processes. Each segment represents a microservice within the loop.

Procedure

  1. Click Loop Details option of the loop for which you want to add a loop segment.
  2. Click Add connection > Loop segment.
    The Add Loop Segment panel is displayed.
  3. Enter a segment name.
  4. Optional: Enter additional details in Description.
  5. Click Add Segment.

    The system begins the segment setup process and displays a progress view that shows the status of each initialization task. During this process, the system performs the following actions:

    Figure 1. Capability-specific resources and configurations created in segment
    Capability or Plugin Configuration during segment creation
    Plan
    • Creates a plan component.
    Control
    • Creates a repository with the same name as the segment name in the organization associated with the teamspace.
    • Applies branch protection rules to the repository.
    Build

    • Creates a project with the naming convention TeamSpace~Loop:LoopName:SegmentName and configures it using the Process and Source templates.

      Note:
      A project is associated with only one loop or segment.

    • Creates a job template with basic CI/CD steps for the segment.

    • The segment process is added as dependency within the process of the main project of the loop.
    • The main project build is trigerred only when we have at least one version built for all the segments in the loop.
    Test
    • Creates a project with the name as LoopName-SegmentNamewithin the teamspace.
    • Configures Control repository in the created project.
    • Configures webhook to upload test results to measure.
    • Configures Plan integration in the created project.
    Deploy
    • Creates a component in Deploy with the name as LoopName-SegmentName within the application.
    Build Plugin
    • Updates the Build plugin configuration in Measure to add the newly created project for the segment.
    Control Plugin
    • Updates the Control plugin configuration in Measure to add the newly created repository for the segment.
    Control–Plan Integration
    • Links repository changes (pull requests, commits, branch creation) in Control to work items in Plan.
    • Pull request titles and branch names should start with the work item ID for proper syncing.
    • Changes appear in the SCM Event section of the work item in Plan.
    • A personal access token in Plan configures a webhook in Control.
    After all tasks are completed, the segment is successfully created and appears under the LoopName Loop Segments section in the Loop Connections tab.