Skip to main content

Bitrise on AWS: manual setup

Abstract

Bitrise is available as an Amazon Machine Image (AMI) in the AWS Marketplace. With the Bitrise AMI, you can run Bitrise builds using your own AWS resources on AWS EC2 instances connected to a Bitrise Workspace.

Bitrise is available as an Amazon Machine Image (AMI) in the AWS Marketplace. With the Bitrise AMI, you can run Bitrise builds using your own AWS resources on AWS EC2 instances connected to a Bitrise Workspace. This section focuses on how to manually set up a fully customized AWS configuration for Bitrise builds.

aws-manual-setup-diagram.png

The manual setup also requires an active subscription to a Bitrise AMI: Subscribing to the Bitrise on AWS AMIs.

Cloud Controller

Instead of the manual setup, we strongly recommend using the Cloud Controller to set up AWS for Bitrise builds: Bitrise on AWS: Cloud Controller.

Setting up the EC2 instance

To run Bitrise builds on an AWS EC2 instance, you need to:

  1. Configure runner pools on Bitrise: Set up a runner pool for your builds and get the token required to connect your Bitrise Workspace to your AWS EC2 instance.

  2. Subscribe to the Bitrise AMI and launch an AWS EC2 instance. You can launch either a Mac or a Linux instance. For a Mac instance, you'll need to allocate a dedicated host before launching the instance.

  3. Use the token to connect the instance to your Bitrise Workspace. This will allow the Bitrise agent to run your builds on your EC2 instances.

In this section:

A Workspace is an environment that allows you to manage your Bitrise apps and the team members working on the apps. You can create multiple Workspaces, and you can be invited to Workspaces by other Bitrise users. To be able to add apps and run builds, you either need to be part of a Workspace, or you have to be an outside contributor on an app's team.