Managing integrations

Integrations let you define and re-apply access data to third-party services in Buddy's pipelines. For example, adding an AWS integration will allow you to upload assets to S3 buckets, deploy Elastic Beanstalk apps, invalidate CloudFront cache, or run commands in the AWS CLI.

Whenever you add an action that requires connecting to a third-party service, Buddy will ask you to create an integration. Depending on the type of the integration, you may need to fill a form with the access data (e.g. access and secret keys), or authenticate Buddy in the external service with OAuth (e.g. when connecting to GitHub).

Adding integrations

There are two ways to add integrations:

1. By clicking the New integration button on the Integrations page:

Adding new integration from Integrations tab

2. From the integration selection dropdown in an action using the integration:

Adding new integration from action

Defining integrations

Whenever you add an action that requires connecting to a third-party service, Buddy will ask you to create an integration. Depending on the type of the integration, you may need to fill a form with the access data (e.g. access and secret keys), or authenticate Buddy in the external service with OAuth (e.g. when connecting to GitHub).

Adding AWS integration

Multiple integrations for one service

You can have multiple integrations of one type in your workspace. For example, you can use several AWS integrations and deploy to different accounts within the same project. There are two ways to add extra integrations.

1. From the account selection dropdown of the action using the integration:

Adding a new integration from an action

2. By clicking the +Add a new integration button in the Integrations tab.

Adding a new integration from the Integrations tab

Managing integrations

All integrations can be managed in the Integrations tab on the left sidebar (https://app.buddy.works/$DOMAIN/workspace/integrations). There you can add and remove integrations and edit their details: name, access data, and scope.

Integration management screen

Integrations in YAML

If you manage your pipelines with YAML, make sure to provide the ID of the integration to the actions that are using it. Here's an example:

yaml - action: "Upload files to AWS S3"
   type: "AMAZON_S3"
   input_type: "BUILD_ARTIFACTS"
   bucket_name: "buddy-tests-files"
   acl: "PRIVATE"
   integration_hash: "5e391f5aae784b7208de0d0a"

ID hash

You can find the ID on the integration's tile in the Integrations tab:

ID hash of an AWS integration