Go can be configured using Administration Tab. You can perform operations like add/edit Pipelines, Stages, Jobs, Tasks, Templates and Pipeline group. You can also configure Go by editing the full XML file if you wish, by clicking on the Config XML section of the Administration tab. Go will check the syntax of the configuration before it saves it again
To create a new pipeline, go to the Pipelines sub-tab of the Administration tab and click on the "Create a new pipeline within this group" link as shown in the screen shot below.
Now that you have a pipeline, lets add another material to it.
Often you do want to specify a set of files that Go should ignore when it checks for changes. Repository changesets which contain only these files will not automatically trigger a pipeline. These are detailed in the ignore section of the configuration reference.
Now that you have a pipeline with a single stage, lets add more stages to it.
Fill stage name and trigger type.
Fill in the details for the first job and first task belonging to this job. You can add more jobs and add more tasks to the jobs.
Click on help icon next to the fields to get additional details about the fields you are editing.
Now that we have a pipeline with stage(s), we can add more jobs to any of the existing stages. You can now use the tree navigation on the left side of the screen to edit a stage or a job under a pipeline.
Click on the Jobs tab
Click on "Add new job"
Fill in the details for the initial task belonging to this job. You can edit this job later to add more tasks
You can choose the type of the task as required.
For task types Ant, Nant and Rake, the build file and target will default as per the tool used. For example, Ant task, would look for build.xml in the working directory, and use the default task if nothing is mentioned.
Click on help icon next to the fields to get additional details about the fields you are editing.
Click "Save"
Now that we have a pipeline with stage(s) containing job(s) we can add tasks to any of the existing jobs. You can now use the tree navigation on the left side of the screen to edit a a job under a stage.
Fill the basic settings for the task
Click on help icon next to the fields to get additional details about the fields you are editing.
Click "Save"
Clone pipeline functionality helps you create a new pipeline from an existing pipeline by giving it a new name. Typically when setting up a pipeline for a new branch, it is very useful to take an existing pipeline and clone it.
If the user is a pipeline group admin, she can clone the new pipeline into a group that she has access to. If the user is an admin she can clone the pipeline into any group or give a new group name, in which case the group gets created.
Navigate to the Admin tab
Locate the pipeline that needs to be cloned
In that row, click on the "Clone" icon.
Select a pipeline group. If you are an admin, you will be able to enter the name of the pipeline group using the auto suggest or enter a new group name
Click "Save"
Templating helps to create reusable workflows in order to make tasks like creating and maintaining branches, and managing large number of pipelines easier.
Pipeline Templates can be managed from the Templates tab on the Administration Page.
Clicking on the "Add New Template" brings up the following form which allows you to create a fresh template, or extract it from an existing pipeline. Once saved, the pipeline indicated will also start using this newly created template.
A template can also be extracted from a pipeline using the "Extract Template" link. This can be found on the "Pipelines" tab in the Administration page.
As an example, assume that there is a pipeline group called "my-app" and it contains a pipeline called "app-trunk" which builds the application from trunk. Now, if we need to create another pipeline called "app-1.0-branch" which builds 1.0 version of the application, we can use Pipeline Templates as follows
Go Administrators can now enable any Go user to edit a template by making them a template administrator.
Template administrators can view and edit the templates to which they have permissions, on the template tab of the admin page. Template Administrators, will however not be able to add, delete or change permissions for a template. They will also be able to see the number of pipelines in which the template is being used, but not the details of those pipelines.
Pipeline Templates can now be viewed by Administrators and Pipeline Group Administrators while editing or creating a Pipeline.
Clicking on the icon indicated by arrow will display the following:
The pop-up shows the extract of the template "Services-Template" configured for the pipeline "Service_1".
By default, when one stage completes successfully, the next stage is automatically triggered by Go. However sometimes you don't want the next stage to be triggered automatically. This might be the case if you have a stage that deploys your application to a testing, staging or production environment. Another case can be when you don't want your pipeline to be automatically triggered by changes in version control. In these situations, you want the stage triggered by manual intervention. This can be done through manual approvals.
If you add a manual approval to the first stage in a pipeline, it will prevent the pipeline from being triggered from version control. Instead, it will only pick up changes when you trigger the pipeline manually (this is sometimes known as "forcing the build").
From Cruise 1.1 (legacy version of Go), you can control who can trigger manual approvals. See the section on Adding authorization to approvals for more details.
Starting with Cruise 1.3 (legacy version of Go), there is support for collecting multiple pipelines into a single named group. See the section on Specifying who can view and operate pipeline groups for more details.