reference deployment

Red Hat OpenShift on AWS

Container application platform with Kubernetes orchestration on the AWS Cloud

This Quick Start sets up a cloud architecture and deploys Red Hat OpenShift Container Platform on AWS.

Red Hat OpenShift Container Platform is based on Docker-formatted Linux containers, Kubernetes orchestration, and Red Hat Enterprise Linux (RHEL).

The deployment includes AWS CloudFormation templates that build the AWS infrastructure using AWS best practices, and then pass that environment to Ansible playbooks to build out the OpenShift environment. The deployment provisions OpenShift master instances, etcd instances, and node instances in a highly available configuration.

Optional components include AWS Service Broker, GlusterFS, OpenShift Automation Broker, and Hawkular metrics.


This Quick Start was developed by AWS. Red Hat is an AWS Partner.

  •  What you'll build
  •  How to deploy
  •  Cost and licenses
  •  Demo
  •  What you'll build
  • Use this Quick Start to automatically set up the following Red Hat OpenShift environment on AWS:

    • A virtual private cloud (VPC) that spans three Availability Zones, with one private and one public subnet in each Availability Zone.*
    • An internet gateway to provide internet access to each subnet.*
    • In one of the public subnets, an Ansible config server instance.
    • In the private subnets:
      • Three OpenShift master instances in an Auto Scaling group
      • Three OpenShift etcd instances in an Auto Scaling group
      • A variable number of OpenShift node instances in an Auto Scaling group

    The Quick Start places the OpenShift instances in Auto Scaling groups, but doesn’t enable scaling. The number of master and etcd instances are fixed at three (one per Availability Zone). Nodes can be set to a variable number and are distributed among the selected Availability Zones.

    The Auto Scaling components of the Quick Start use Amazon CloudWatch Events and AWS Systems Manager Run Command to call on-instance scripts to configure instances within the OpenShift cluster. The scripts query the Auto Scaling APIs to determine whether any changes were made to the Auto Scaling groups within the cluster. If changes are found, the script takes the appropriate action. For example, for a scale-out event, the script generates cluster-related metadata for new instances. For instance removals, the script removes node definitions from the Ansible hosts inventory.

    The Quick Start also provides optional deployments of AWS Service Broker, which provides direct access to AWS services on the Red Hat OpenShift Container Platform; GlusterFS, which provides read-write-many (RWX) persistent storage for the cluster; and OpenShift Automation Broker, which helps you manage Kubernetes applications.

    *  The template that deploys the Quick Start into an existing VPC skips the tasks marked by asterisks and prompts you for your existing VPC configuration.

  •  How to deploy
  • To build your Red Hat OpenShift environment on AWS, follow the instructions in the deployment guide. The deployment process includes these steps:

    1. Sign up for a Red Hat subscription.
    2. If you don't already have an AWS account, sign up at
    3. Launch the Quick Start. Each deployment takes about 1.5 hours. You can choose from two options:
    4. Set up DNS if you're using a DNS service other than Amazon Route 53.
    5. Verify your deployment by using the OpenShift Command Line Interface (CLI), and connect to the OpenShift web console.

    To customize your deployment, you can configure infrastructure settings, OpenShift nodes, DNS settings, and optional components.

    Amazon may share user-deployment information with the AWS Partner that collaborated with AWS on the Quick Start.  

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

    The AWS CloudFormation template for this Quick Start includes 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.

    This Quick Start requires a Red Hat subscription.

  •  Demo
  • This demo was created by solutions architects at AWS for evaluation or proof-of-concept (POC) purposes on the AWS Cloud. For production-ready deployments, use the Red Hat OpenShift Quick Start.

    This demo deploys a simplified Red Hat OpenShift architecture into your AWS account with sample data. After the demo is up and running, you can use the demo walkthrough guide for a tour of product features. The demo walks you through deploying an application (WordPress) into OpenShift, and then updating the application to a native AWS service (Amazon Relational Database Service) by using AWS Service Broker.

    To deploy:

    1. If you don't already have an AWS account, sign up at
    2. Sign up to launch the demo. After you answer a few questions and submit the sign-up form, the AWS CloudFormation console will launch.
    3. If you don’t already have a Red Hat subscription for OpenShift with at least eight entitlements available, you can sign up for a trial license. Provide your Red Hat user name and password when you launch the demo.
    4. Obtain an OpenShift subscription ID (pool ID) from Red Hat at
    5. In the console, provide the requested information to launch the demo.

    Estimated time: 90 minutes for deployment, 60 minutes for walkthrough

    Cost: You are responsible for the cost of the AWS services and Red Hat OpenShift subscriptions used while running this demo. There is no additional cost.