Pipelines enables you to integrate your Acquia-hosted application with version control repositories hosted by GitHub.com.
Requirements
Before you connect Cloud Platform to your repository, ensure you meet the requirements for your repository, based on the following:
If you don’t already have a GitHub repository, sign in to your GitHub account, and then visit github.com/new to create a new repository from the GitHub interface.
If you have an existing repository, add GitHub as a new remote by modifying your project repository’s local clone with the following code (where
[username]is your GitHub username and[project]is the name of your project):git remote add github [email protected]:[username]/[project].git git push github master
Connecting to your Github repository
To connect to your GitHub repository:
Note
To connect to your GitHub repository through a command-line client, see Managing your Pipelines from the command line.
Click the name of the application you want to connect to GitHub.
In the left menu, click Pipelines. If your application doesn’t display a Pipelines link, contact Acquia Support.
In the Select Source section, click the Choose source link.
Click Configure.
In the Configure Pipelines with your GitHub repository section, click Configure.
Click Connect to GitHub.
In the GitHub user interface, click Authorize to grant access of your GitHub repository to Cloud Platform. Cloud Platform displays a page containing your environment’s Pipelines information.
Click Select GitHub repository.
Select the repository to which you want to connect, and click Continue.
Each time you use GitHub to create or reopen a pull request, push a
commit, or push a tag, Cloud Platform executes the pipelines start command
using the build definition file in the GitHub repository, and then commits the
resulting build artifact, named
pipelines-build-[BRANCHNAME], to your Cloud Platform repository.
Changing your webhook
To change the webhook in use by your repository:
Note
You can use the following process to also remove the webhook from your repo. In that case, skip the final step in the following procedure.
Sign in to GitHub.
Go to the following URL:
https://github.com/[your_namespace]/[your_repo]/settings/hooksDelete the webhook associated with your application.
Complete the steps in the earlier connection procedure to reinitialize your repository with the new Acquia application ID and GitHub repository name.
Next step
To operate, Pipelines expects a file in YAML format
named acquia-pipelines.yaml to exist in the root directory of your code
repository. This build definition file has all the information required
for Pipelines to perform the build, including any variables required and the
instructions used to perform the build.
For information about how to structure this file and what it should contain, see Creating and managing your build definition file.