reference deployment

CloudBees CI

A CI solution based on Jenkins and integrated with Amazon EKS

This Partner Solution deploys CloudBees CI on the Amazon Web Services (AWS) Cloud to provide continuous integration (CI) that's based on Jenkins and integrated with Amazon Elastic Kubernetes Service (Amazon EKS).

The Partner Solution sets up a CI environment that meets architectural best practices, including high availability, automatic scaling, segregation of agent workloads, and Kubernetes-native integration with Amazon Elastic Compute Cloud (Amazon EC2) Spot Instances.

The Partner Solution is automated by AWS CloudFormation templates that deploy CloudBees CI in about 45 minutes in your AWS account. You can choose to install CloudBees CI into a new virtual private cloud (VPC) or into your existing VPC. After you deploy the Partner Solution, you can use Jenkins plugins to add functionality to your CI environment.

This reference deployment uses the Amazon EKS Architecture Partner Solution as a foundation to provide a fully managed, highly available, and certified Kubernetes-conformant control plane for CloudBees CI.

portworx logo

This Partner Solution was developed by CloudBees Inc.
in collaboration with AWS. CloudBees Inc. is
an APN Partner.

AWS Service Catalog administrators can add this architecture to their own catalog.  

  •  What you'll build
  • Use this Partner Solution to automatically set up the following environment on AWS:

    • A highly available architecture that spans three Availability Zones.*
    • A VPC configured with three public and three private subnets (one public and one private subnet in each Availability Zone).*
    • In the public subnets:
      • Managed NAT gateways to allow outbound internet access for resources in the private subnets.*
      • A Linux bastion host in an Auto Scaling group to allow inbound Secure Shell (SSH) access to the Amazon EKS nodes in the private subnets.*
    • In the private subnets, the following Amazon EKS nodes in Auto Scaling groups:
      • Three CloudBees CI master nodes.
      • Three CloudBees CI regular agent nodes.
      • Three CloudBees CI Spot agent nodes. These nodes are in an Auto Scaling group that is configured for multiple instance types.
    • Helm and kubectl installed and configured on the bastion host.
    • CloudBees CI, installed on Amazon EKS as a Kubernetes StatefulSet.
    • An Amazon Elastic File System (Amazon EFS) file system and EFS CSI Driver for Multi-AZ file storage. You can also configure CloudBees CI to use Amazon Elastic Block Store (Amazon EBS) instead of Amazon EFS.

    *  The template that deploys the Partner Solution into an existing VPC skips the components marked by asterisks and prompts you for your existing VPC configuration.

  •  How to deploy
  • To deploy CloudBees CI on AWS, follow the instructions in the deployment guide. The deployment process takes about 45 minutes and includes these steps:

    1. Sign in to your AWS account. If you don't already have an AWS account, sign up at
    2. Launch the Partner Solution, choosing from the following options:
    3. Activate CloudBees CI.

    To customize your deployment, you can configure infrastructure settings, the number of nodes in the Amazon EKS cluster partitions, instance types and storage sizes, Kubernetes version, and storage type.

    Amazon may share user-deployment information with the AWS Partner that collaborated with AWS on this solution.  

  •  Cost and licenses
  • You are responsible for the cost of the AWS services used while running this Partner Solution reference deployment. There is no additional cost for using the Partner Solution.

    The AWS CloudFormation templates for this Partner Solution include configuration parameters that you can customize. Some of these settings, such as instance type, will affect the cost of deployment. For cost estimates, see the pricing pages for each AWS service you will be using. Prices are subject to change.

    Tip     After you deploy the Partner Solution, enable the AWS Cost and Usage Report to track costs associated with the Partner Solution. This report delivers billing metrics to an S3 bucket in your account. It provides cost estimates based on usage throughout each month, and finalizes the data at the end of the month. For more information about the report, see the AWS documentation.

    After you deploy the Partner Solution, you can request a free, 15-day trial license for CloudBees by choosing Request a trial license in the CloudBees CI Cloud Operations Center, or submit a pricing request on the CloudBees website.