--- title: "Pipelines" date: "2024-02-14T06:18:38+00:00" summary: "Streamline your development workflow with Acquia Pipelines. Automate code deployment, manage dependencies, and control permissions for your Cloud Platform applications. Boost efficiency and ensure compliance." image: type: "page" url: "/acquia-cloud-platform/pipelines" id: "a74f24d5-8f7e-4015-8829-92a043b1b6b1" --- Acquia Pipelines is a continuous delivery tool to automate development workflows for applications hosted by Cloud Platform. With Pipelines, you can: * Manage your application’s source code on third-party Git infrastructure, and seamlessly deploy to Cloud Platform. * Use tools like Composer or `drush make` to assemble your application’s components and dependencies. * Use technologies such as [Sass](https://sass-lang.com/) and [Typescript](https://www.typescriptlang.org/) to compile application source code. * Control which developers or teams have permission to change different parts of your application code base. Note Pipelines is FedRAMP, ISO, SOC1, SOC2, CSA STAR, ISO27001, and HIPAA compliant. How Pipelines works ------------------- Pipelines executes the instructions you provide, transforming application source code into a build artifact which you can then test and deploy. Here is how Pipelines works: * Create a [build definition file](/acquia-cloud-platform/creating-and-managing-your-build-definition-file "Creating and managing your build definition file"), hosted in your Git repository. For an example, see [acquia-pipelines.yaml](/acquia-cloud-platform/example-pipelines-build-definition-files "Example Pipelines build definition files"). * Connect Pipelines to your repository, whether it’s hosted by Cloud Platform or externally at [Bitbucket or GitHub](/acquia-cloud-platform/connecting-application-external-git-repo "Connecting an application to an external Git repo"). * Trigger Pipelines jobs when creating or reopening pull requests, pushing commits, or pushing tags. You can also trigger jobs manually through the [user interface](/acquia-cloud-platform/managing-your-pipelines-cloud-platform-user-interface "Managing your Pipelines in the Cloud Platform user interface"), or the command-line client’s [pipelines start](/acquia-cloud-platform/using-cloud-platform-pipelines-client "Using the Cloud Platform Pipelines client") command. * Pipelines clones the Git source repository and checks out the specified branch. * Pipelines looks for a YAML-format file named [acquia-pipelines.yaml](/acquia-cloud-platform/creating-and-managing-your-build-definition-file "Creating and managing your build definition file") in the selected Git branch and executes its [instructions](/acquia-cloud-platform/features/pipelines/commands) in your [container](https://pipelines/container.html). The instructions have access to [environment variables](/acquia-cloud-platform/features/pipelines/variables), and can perform [multiple actions](/acquia-cloud-platform/features/pipelines/commands) in a single [Pipelines job](/acquia-cloud-platform/features/pipelines/ui), such as assembling your application from different source code components and dependencies using tools like Composer, transforming source files into compiled files ready for deployment, and running tests. * If the Pipelines job is completed without errors, Cloud Platform commits all the files and directories created by the instructions as [a build artifact](/acquia-cloud-platform/features/pipelines/artifacts#pipelines-build-artifact), named `pipelines-build-[BRANCHNAME]`, to a build branch in your application’s Cloud Platform Git repository, which you can deploy programmatically or manually. Other repositories can’t be targets. * You can view the results of each job with the Pipelines user interface in Cloud Platform, the status posted to your pull request on your third-party code repository, and the `pipelines status` and `logs` commands. For a list of software available in your container, and resource limits on Pipelines jobs, see [Resources for Pipelines jobs](/acquia-cloud-platform/features/pipelines/container). Availability of Pipelines ------------------------- Pipelines is available as an add-on for Cloud Platform Enterprise and Site Factory subscribers, and requires [Cloud Platform CD](/acquia-cloud-platform/features/cd) on Cloud Platform. To obtain Pipelines for your subscription, contact your Account Manager. ### Using Pipelines with Site Factory Pipelines is available as a continuous integration tool for Site Factory subscribers. When configuring Pipelines for a Site Factory, be aware of the following issues: * [On-demand environments](/acquia-cloud-platform/features/cd) are not available for Site Factory. * Pipelines is available as a continuous integration tool only. * Pipelines is available in the Cloud Platform user interface, and not in the [Site Factory Management Console](/site-factory/manage). * The Cloud Platform [teams and permissions](/acquia-cloud-platform/access/teams) system, not the [Site Factory Management Console](/site-factory/managing-your-site-factory-sites "Managing your Site Factory sites"), controls access to Pipelines. Getting started --------------- Use the following general steps to start using Pipelines for your website development and testing: 1. Confirm your [Cloud Platform account’s role](/acquia-cloud-platform/access/teams/roles) has the [Execute Pipelines](/node/56065#permissions-list) permission. You may also need the [Add an environment](/node/56065#permissions-list) permission. Note for Site Factory subscribers These permissions must be assigned through the Cloud Platform teams and permissions system, and not the [Site Factory Management Console](/site-factory/manage). 2. (_Optional_) [Connect your application to an external Git repository](/acquia-cloud-platform/features/pipelines/connect). 3. Ensure your application is running either PHP 7.4, 8.2, 8.3, 8.4, Node 20, or Node 22. 4. [Create a build definition file](/acquia-cloud-platform/features/pipelines/yaml#toplevel). 5. [Start a Pipelines job](/acquia-cloud-platform/features/pipelines/ui#pipelines-cli-start-job) in the Cloud Platform user interface or the command-line interface. Important Pipelines 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](/node/68976).