Acquia Pipelines

Latest release - Acquia Pipelines 0.39.4 (Jun 23, 2017)

Acquia Pipelines logo

Acquia Pipelines is a tool for developing, testing, and deploying websites or other applications to Acquia Cloud. It enables you to:

  • Manage your application's source code on GitHub, or other third-party Git servers, and seamlessly deploy to Acquia Cloud.
  • Use tools like Composer or Drush Make to assemble your application's components and dependencies automatically.
  • Use technologies like Sass and Typescript to compile application source code.
  • Control which developers or teams have access to change different parts of your application code base.

Why use Acquia Pipelines?

Code that is built frequently needs consistency to achieve continuous integration. It can be a challenge for individual developers on a team to achieve consistency. In traditional deployment workflows, you need to do all of the work of assembling a website's deployment image in your code repository. Any resources (including Drupal core, contributed, or custom modules, or other code) must be copied into your code repository. If a module is updated, you will have to copy the new version of that module into your repository.

Using Acquia Pipelines, your workspace can contain just your website's version-controlled build instructions and private resources. You can keep the canonical version of external resources outside of your repository, and pull in the latest or other required version as you build your website for deployment.

In traditional deployment workflows based on local builds, each developer needs to make sure that they have available all the correct prerequisites in their correct versions (PHP, Git, Acquia Cloud repository access, SSH, Composer, a JavaScript testing framework). Different team members need to be able to consistently replicate this development environment locally. In contrast, when you use Acquia Pipelines, a consistent build and testing environment is available to all developers in a container on the cloud. Acquia provides scalable cloud resources, so you and others on your development team can run multiple simultaneous builds.

How Acquia Pipelines works

Acquia Pipelines executes instructions that you provide to transform application source code into a build artifact which can then be tested and deployed. Specifically:

  • Acquia Pipelines jobs are triggered when you run the Acquia Pipelines command line client's pipelines start command or, optionally, by a commit or pull request at GitHub.
  • Acquia Pipelines clones the Git source repository and checks out the specified branch. Initially, the source repository for your application is its Acquia Cloud Git repository, but you can choose to use a GitHub repository as the source using the pipelines init-github command. See Using GitHub with Acquia Pipelines.
  • Acquia Pipelines looks for a file named /acquia-pipelines.yml in YAML format in the selected Git branch and executes the instructions it finds there. These instructions can assemble your application from multiple code bases, transform source files into compiled files ready to deploy, run tests, and so forth. See Using a build definition file.
  • If all of the instructions in the YAML build definition file succeed, Acquia Pipelines commits all of the files and directories created by the instructions as a build artifact to a build branch in the target repository. Currently, the target repository is always the application's Acquia Cloud Git repository.
  • You can see the results of each job with the pipelines status and logs commands. For jobs triggered by a GitHub pull request, you can also see the status posted in GitHub on the pull request.

Tutorials and examples

In addition to this product documentation, you can learn more about how to use Acquia Pipelines in the tutorials and example code at GitHub.

Add new comment

Plain text

  • No HTML tags allowed.
  • Lines and paragraphs break automatically.
  • Web page addresses and email addresses turn into links automatically.
By submitting this form, you accept the Mollom privacy policy.

Contact supportStill need assistance? Contact Acquia Support