Table of Contents |
---|
To create a new pipeline, navigate to the Search Pipelines screen using the Pipelines screen through the menu, and click on the Create button. . Provide a name and click on Create to continue with the configuration.
...
To edit an existing pipeline, click on the Pipeline Name column of the target pipeline in the search results, or select the row and click the Edit button.
...
...
Field
...
Description
...
Name
...
The name of the pipeline.
...
Updated On
...
The user who last updated the pipeline verson (read-only).
...
Updated By
...
The last update date/time of the pipeline version (read-only).
list of pipelines. Creating or Editing a pipeline should open up the Pipeline Definition where Stages/Environments and their constituent Gates/Steps can be added
...
Pipeline Info
The Pipeline Info provides general details about the current pipeline and a list of all the Releases using the pipeline. The releases in the Used By section can be accessed directly by clicking on them.
...
Definition
The Definition tab provides the definition of the pipeline stages, and their constituent steps and gates. Changes to the pipeline, like a workflow, are versioned so that changes can be published to consumers , or previous versions can be reverted.
...
Field
...
Description
...
Description
...
A free-form description of the pipeline version.
...
To add stages to the pipeline version, see Creating/Editing a Pipeline Stage.
Once the stages are added to the pipeline version you can reorder by clicking the arrows on the arrows on each stage, or delete the stage by clicking the delete buttonthe Delete Stage option from the extended menu on each stage. In addition, for quicker configuration, you have the option to copy any number of gates/steps from one stage to another using copybuttonthe Copy Stage or Copy Gates/Steps option from the extended menu. Using the copy button feature will add the gates or steps selected to the end of the target stage. To view/edit the stage, click on the maximize buttonedit button.
...
Click the button Save Draft button to save your changes and continue with further updates, or the button to save your changes and return to the previous page. The button reverts the changes and returns to the previous page. Click the button to set the selected pipeline version as active, and be sure to save your changes. Upon . The Compare Versions button next to the version can be used to view the difference between the current and previous versions of the pipeline.
...
Once all the changes are complete, use the Activate button at the bottom to activate the current pipeline version. Upon activation, the previously active version becomes inactive. Once a version has been activated it is locked from future edits, and you must click the button to edit button to create a new version in order to make further changes. You can switch the editor to another version of the pipeline by selecting the pipeline desired version name in the Switch Version drop-down.
Note |
---|
Any pipeline version which is active, or has ever been active, is locked from future edits. You must make a copy in order to make further changes. |
Anchor | ||||
---|---|---|---|---|
|
Team
...
Roles
The Roles section in the pipeline defines a set of roles which that will participate during the execution of the pipeline. Roles assigned to the pipeline may then be used within the defined gates and steps (i.e. an approval step). A role contains default members, which can be FlexDeploy Groups, FlexDeploy Users, or email addresses (used for notifications only). A release which that consumes the pipeline inherits the roles and default members from the pipeline , and can override those members. For example, the Release Manager members can be different across releases.
...
In addition to members, a role defined within a pipeline also establishes default permissions. When a release consumes the pipeline, it inherits the role's default permissions , but can override them for that particular role. In other words, a role may have different permissions from release to release if necessary.
To create a new Role, click the iconCreate button. To edit an existing Role, click on the role name or use the Edit option from the Actions menu. To delete a new Role, click the iconuse the Delete option from the Actions menu. If a role is used in older versions of the pipeline, but not the active version it will be inactivated instead of deleted.
Add FlexDeploy Group or FlexDeploy User members to the role by shuttling them from the Available lists on the left to the Member lists on the right.
...
Tip |
---|
TipFilter the list of available Groups or Users by typing all or part of its name into the Search fields. |
...
Field
...
Description
...
Name
...
selecting from the possible values for each type.
...
Field | Description |
---|---|
Name | The name of the pipeline role. |
Assigned Groups | FlexDeploy Groups assigned as members of this role. |
Assigned Users | FlexDeploy Users assigned as members of this role. |
Assigned Emails | List of email addresses assigned to this role. Used for email notification only. |
Skip Stage Execution | Whether or not this role has permission to skip the execution of pipeline stages when creating a release snapshot. |
Manage Stage Execution | Whether or not this role has permission perform actions on the pipeline stage in the release dashboard (e.g. Replay Stage). |
Manage Gate Execution | Whether or not this role has permission to perform actions on the pipeline stage gates in the release dashboard (e.g. Replay Gate, Skip Gate). |
Manage Step Execution | Whether or not this role has permission to perform actions on the pipeline stage |
steps in the release dashboard (e.g. Replay Step, Skip Step). | |
Upload Execution Info | Whether or not this role has permission to upload execution information in the release dashboard (e.g. Inputs, Change Tickets). |
Active | Indicates whether this pipeline role is active. |
All FlexDeploy Groups defined within the Security.
Member Groups
FlexDeploy Groups assigned as members of this role.
Available Users
All FlexDeploy Users defined within the Security.
Member Users
FlexDeploy Users assigned as members of this role.
Email Recipients
Semi-colon or comma delimited list of email addresses assigned to this role. Used for email notification only.
Click the button Click the Done button to save the changes to the role (be sure to also save the pipeline, or changes will be lost), or to revert any unsaved changes.
Properties
Pipeline Properties are used to decorate a release with some context. Values for the properties are provided on each release, or as inputs for each snapshot based on the value set for Property Type and may be used in various groovy scripts within the pipeline definition. For example, only execute a particular step in the pipeline if the "Release Type" is "Security".
...
To create a new Pipeline Property, click the icon. To the Create button. To edit an existing Pipeline Property, click on the Property Code .
...
use the Edit option from the Actions menu. Properties can also be deleted through the Delete option from the Actions menu.
...
Field | Description |
---|
Indicates whether the pipeline property is active. Inactive properties will not appear on the release.
Code | A code for the property, as appropriate for variables within Groovy or Shell scripts. (e.g. no spaces or special characters other than underscore.) |
Description
A meaningful description for the property.
Data Type
Subtype
Not currently used.
Default Value
A default value to assign to the property if not specified on the release.
Rows
Defines the height of the component to display when capturing the value from the user.
Columns
Defines the length of the component to display when capturing the value from the user.
Display Name | A meaningful name for the property used for display. |
Description | A |
meaningful description for the property. |
Value1,Value2,Value3
Key1,Value1##Key2,Value2##Key3,Value3 (e.g. Key1 will be what is displayed, Value1 will be the actual value when selected)
,Value1,Value2 (e.g. Note comma in the front - will result in empty item in list)
| |
Required | Whether or not a value is required for this property. |
Encrypted | Whether or not to encrypt the value, not display on screen or in the logs. |
Multiselect
Whether multiple values can be selected from the List Data. Only applicable for String data type, and when List Data is provided.
Length
The maximum allowed length of the property value. Optional, and only applicable for String data type.
Required
Whether or not a value is required for this property.
Min Value
Minimum allowed value. Optional, and only applicable for Integer and Double data types.
Max Value
Maximum allowed value. Optional, and only applicable for Integer and Double data types.
Allows selecting the default value from credentials available in the FlexDeploy instance. | ||||||
Default Value | A default value to assign to the property if not specified on the release or in the snapshot input. | |||||
Validation Script | Optional Groovy Script to validate provided value. The script should return true if the value is valid, and false otherwise. The user-specified value is available to the script in the Value variable. If not valid, the ValidationMessage is displayed to the user. For example, Example
|
Validator2
Optional Groovy Script to validate provided value. See Validator1.
Validator3
Optional Groovy Script to validate provided value. See Validator1.
Validator4
Optional Groovy Script to validate provided value. See Validator1.
Validator5
Optional Groovy Script to validate provided value. See Validator1.
...
Field Data Type | The data type for this property. |
List Data CSV | A comma separated list of valid values for the property. Optional, and only applicable for Text Field and Text Area data type. |
Multiselect | Whether multiple values can be selected from the List Data. Only applicable for Text Field data type, and when List Data CSV is provided. |
Length | The maximum allowed length of the property value. Optional, and only applicable for String data type. |
Click the Done button to save the changes to the property (be sure to also save the pipeline, or changes will be lost), or to revert any unsaved changes.
...
Variables
Snapshot variables Variables provide a state for the life of a snapshot. Such a state affords the ability to store some data as part of a step or gate in one stage, and consume it or make decisions in a later stage. One classic example is to store off a CMS ticket which that was entered or created in one stage , and feed it into another stage which will use the same ticket. The pipeline defines the metadata for any snapshot variables which that are available, and values can be set or retrieved using Custom Gates or Custom Steps.
...
To create a Snapshot Variable, click on the Create icon. Enter the required information and click Save. Edit or Delete an existing variable by using the options from the Actions menu.
...
Field | Description |
---|---|
Code | The identifier which is used to access the variable from Groovy |
Active
scripts. | |
Description | A description for the variable. |
Data Type | The data type of the variable. Allowed types are Boolean, Integer, Double, Long, or String. |
Project Groups
Project Groups provide categorization tags for release content. As such, pipelines define the tags, and deploy segments of the content based on those tags. Releases consuming the pipeline can then tag its content as belonging to those groups.
For example, suppose a pipeline defines project groups Database, Configuration, and Applications. The steps within a pipeline stage can then deploy all Database, deploy all Configuration, and finally, deploy all Applications. The release which consumes the pipeline, then defines which content is tagged with Database, Configuration, and Applications.
...
Field
...
Description
...
Active
...
Indicates whether the project group is active. Inactive project groups will not appear on the release or be available to the pipeline steps.
...
Code
...
To add a new project group, click the icon. Enter the Group Name.To edit a project group, modify the Group Name, or set the Active flag.Create button and provide a name for the group
To delete a project group, click on the icon use the Delete option for the project group you wish to remove .
Referenced By
Identifies the Releases which are referencing this pipeline.
...
Field
...
Description
...
Release
...
The internal id of the release.
...
Name
...
The name of the release.
...
Description
...
The description of the release.
...
Start Date
...
The start date of the release.
...
End Date
...
The end date of the release.
...
Status
...
from the Actions menu.
Click the Save button to save the changes to the property (be sure to also save the pipeline, or changes will be lost).