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, Google Kubernetes orchestration, and Red Hat Enterprise Linux (RHEL).

The Quick Start 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.

RedHat_OpenShift_sm

This Quick Start was developed by
AWS solutions architects.

  •  What you'll build
  •  How to deploy
  •  Cost and licenses
  •  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 https://aws.amazon.com.
    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.

  •  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.