Information for: DEVELOPERS   PARTNERS

Managing your pipelines in the Cloud Platform user interface

The Cloud Platform pipelines feature is available as an add-on for Cloud Platform Enterprise and Site Factory subscribers, and requires Cloud Platform CD on Cloud Platform. To obtain the Cloud Platform pipelines feature for your subscription, contact your Account Manager.

Cloud Platform provides you the ability to start and track your different pipeline jobs with both an application in the user interface and a command-line interface.

Accessing the pipelines user interface

Subscribers using IP address whitelisting must use pipelines from the command line, instead of the user interface. For more information, see this known issue.

To view information about your pipelines in Cloud Platform, complete the following steps:

  1. Sign in to Cloud Platform with an account that has the Execute pipelines permission.
  2. Select the application that you want to use.
  3. In the left menu, click Pipelines.

The first time you visit the page, you can select from one of the following options:

  • Select a source for your repository
  • Start a pipeline job
  • View the available environments

Follow-on visits to the page (after you have configured your repository connection) will display a list of the logged pipeline jobs.

Managing your repository connection

Cloud Platform displays information about your repository connection, including its URL and several common Git commands. To examine or change your the repository connected to your application, on the Pipelines page click More Links.

More Links icon

You can then click View Connection Info, which allows you to change to a different repository for your application. To do this, click the Configure link, select the type of repository that you want to use, and then complete its configuration based on your repository. For information about using this process to connect to external code repositories, see Connecting an application to an external Git repo.

Webhooks

Cloud Platform users using Acquia’s native Git installation can enable or disable webhooks in the Configure page by selecting the desired option from the Webhooks list.

  1. Sign in to Cloud Platform.
  2. Select an application.
  3. Click Pipelines.
  4. Click More links > View Application Info.
  5. In the Webhooks section, click Enable or Disable as required.

Cloud Platform will display a confirmation dialog box in the upper right of the webpage.

Reviewing job activity

The Job List page for Cloud Platform provides an overview of the pipeline jobs that are both currently processing or have already completed. The webpage will regularly update to include any new jobs, or to reflect the status of any on-going or newly completed jobs. To learn more about the overview page, see Viewing pipelines job history.

Detailed information about any job listed on the Job List page can be found by clicking on the job’s name in the Job column. To learn more about reading detailed job information, see Viewing job output.

Starting a pipeline job

To start a new pipeline job from the Cloud Platform interface, complete the following steps:

  1. Select the application for which you want to start a pipelines job.

  2. In the left menu, click Pipelines.

  3. Click Start Job.

    Start Job icon

    Cloud Platform will display a How to start a job dialog.

  4. In the Branch Name field, enter the name of the branch that contains the build definition file that you want to use.

  5. Click Start.

You can execute a maximum of five jobs at one time. The pipelines feature makes 15 attempts to start a queued job with an interval of five minutes.

Important

The pipelines feature executes subsequent jobs using the credentials of the user who first executes a pipelines build. For more information on how to update to another user, see User permission issues.