Lesson 4: Preparing the deployment plan

Configure the segments in the Default Plan and add a segment to it.

The tutorial assumes that you are doing each lesson in the order it is presented. Before you start this lesson, make sure that you complete the previous lessons.
A deployment plan contains the tasks that must be completed for a successful deployment. To finish a deployment, all tasks in all segments must be resolved. A task is some business meaningful activity with start and end points, and a measurable duration. You determine the number and types of tasks. A task can be one of several types. In this tutorial, you use manual, signal, and wait tasks. Other task types are used in later tutorials.

Tasks are organized into segments. A deployment plan can have any number of segments and must have at least one. The number of segments and their composition is up to you. A task, regardless of its type, must be added to a specific segment. The deployment plan in this tutorial uses three segments.

A deployment plan is always attached to a release. Even when you create a new, blank plan, you assign it to a release. Deployment plans are identified by their names and the releases they are assigned to. The deployment plan that you create in the tutorial is identified as Default Plan-Demo Release. Each new release that you create is initially assigned a copy of the original, default plan called Default Plan. The Default Plan that is assigned to the next release you create will not reflect the changes you make to the Default Plan attached to the Demo Release.

Typically, you define all the tasks in a plan before you use it in a deployment, but you can add tasks during a running deployment. If you add tasks during a deployment, the tasks are saved and are available the next time you use it for a deployment.

  1. From the IBM® UrbanCode™ Release dashboard, click Releases and Deployments, and then click Deployment Plans.
  2. Click the Default Plan link for the Demo Release.
    By default, the Default Plan was attached to every phase when you created the release.
    The Deployment Plan page for the Default Plan-Demo Release is displayed, as shown in this figure:

    The Default Plan page

    The Default Plan has two segments: Pre-Deployment Tasks and Deployment Tasks. The Deployment Tasks segment has the Pre-Deployment Tasks segment as a prerequisite, which is indicated by the Dependencies: 1 property in the figure. Segments without executor roles assigned to them start as soon as they are eligible. Segments with executor roles cannot start until someone in the role manually starts the segment. Otherwise, segments without prerequisites or executors can start as soon as the deployment starts. The Pre-Deployment Tasks segment starts as soon as the deployment starts. Segments with other segments as prerequisites cannot start until all the prerequisite segments are complete. The Deployment Tasks segment cannot start until all the tasks in the Pre-Deployment Tasks segment are completed.

    Tasks can start after their parent segment starts. Although segments do not necessarily run in the order that they are listed, the first segment is usually the one you want to start first. You can rearrange the segment order with the up and down arrows on the right side.

    The Default Plan has two segments but no tasks. The Default Plan organizes tasks into predeployment and deployment tasks. As you become more familiar with IBM UrbanCode Release, you will create deployment plans with many segments. You add another segment to your deployment plan later in this lesson.

  3. Click he Edit action for the Pre-Deployment Tasks segment.
    The configuration fields for the Pre-Deployment Tasks segment are displayed, as shown in the following figure:

    Segment configuration fields

    All segments have the same configuration fields. The Execution Pattern determines how the segment's duration is calculated, and when tasks are eligible to run. If it is set to Parallel, the segment's duration is equal to the duration of the longest task in the segment, and tasks can start simultaneously. When Execution Pattern is set to Sequential, the segment's duration is equal to the duration of all tasks in the segment. If you select Sequential and Sequential Execution Enforced, tasks must run in the order they are listed. If you select Sequential but not Sequential Execution Enforced, tasks can run in any order but the duration is still equal to the tasks' total duration.

    Segments can be assigned an executor role. If a role is assigned, only users with that role can start the segment. In the tutorial, the default value None is used for all segments in the plan.

  4. Select the Sequential Execution Enforced check box.
    The duration for the Pre-Deployment Tasks segment equals the duration of all tasks in the segment. Also, the tasks must be run in the order that they are listed.
  5. Click Save, and then close the configuration area for the segment.
    Because the Pre-Deployment Tasks segment is the first segment, it cannot be assigned a prerequisite segment.
    The heading for the Pre-Deployment Tasks segment displays Sequential Enforced.
  6. Open the configuration area for the Deployment Tasks segment, and then, below Prerequisites, make sure that Pre-Deployment Tasks is selected.
    The Deployment Tasks segment has the Pre-Deployment Tasks segment as a prerequisite.
  7. In the Execution Pattern list, select Parallel.
    The tasks in this segment can start in any order, and multiple tasks can be run at the same time.
  8. Click Save, and then close the configuration area for the Deployment Tasks segment.
    The heading for the Deployment Tasks segment displays Dependencies: 1 and Parallel.
  9. Click Create Segment and complete the following steps to add a segment to the deployment plan:
    1. In the Name field, enter Deployment Tasks II, or some other suitable name.
    2. Accept the default values for the other fields.
      The Deployment Tasks II segment does not have a prerequisite segment. Like the Pre-Deployment Tasks segment, this segment starts as soon as the deployment starts. After the segment starts, the tasks in this segment can start in any order.
    3. Click Save.
      Note: You can also create segments by hovering the mouse between segments and then clicking the Add button (.
    The new segment is inserted at the beginning of the plan.
  10. Use the down arrow () until the Deployment Tasks II segment is positioned at the end of the segment list.
    The order in which segments are displayed is not necessarily the order in which they run. When you are creating a deployment plan, it can be useful to arrange the segments in the order that you expect them to run.

Lesson checkpoint

In this lesson, you modified the segments in the Default Plan and added a segment to it.

You configured the Default Plan to follow a specific workflow. The first segments to start are the Pre-Deployment Tasks and Deployment Tasks II segments. The tasks in the Pre-Deployment Tasks segment must be completed in the order that they are listed. Just as you did with the segment order, you can rearrange the task order within a segment by using the up and down arrows. The tasks in the Deployment Tasks segment cannot start until all tasks in its prerequisite segment finish. After the segment starts, the tasks in the Deployment Tasks segment can be resolved in any order. Multiple tasks can be run at the same time. Although the tasks in the Deployment Tasks II segment can start when the deployment begins, later you order task dependencies so that these tasks are actually done last.


The Default Plan with three segments

To learn more about deployment plans, see Deployment plans.