Need help with quickstart-redhat-openshift?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

161 Stars 183 Forks Apache License 2.0 588 Commits 79 Opened issues


AWS Quick Start Team

Services available


Need anything else?

Contributors list


Red Hat OpenShift Container Platform on the AWS Cloud

This Quick Start deploys Red Hat OpenShift Container Platform on the AWS Cloud in a highly available configuration.

Red Hat OpenShift Container Platform is a platform as a service (PaaS) solution that is based on Docker-formatted Linux containers, Kubernetes orchestration, and the Red Hat Enterprise Linux (RHEL) operating system.

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 virtual private cloud (VPC) across three Availability Zones.

Quick Start architecture for OpenShift Container Platform on AWS

For architectural details, best practices, step-by-step instructions, and customization options, see the deployment guide.

To post feedback, submit feature ideas, or report bugs, use the Issues section of this GitHub repo. If you'd like to submit code for this Quick Start, please review the AWS Quick Start Contributor's Kit.

OpenShift 4.x Usage

Deploying an OpenShift 4 cluster requires a RedHat Pull Secret to access RedHat's container registry.

If you have a Red Hat account, you can log into your account to generate a new Pull Secret. This will require an active subscription for Red Hat OpenShift.

For a standard OpenShift 4.x deployment, you must set the following parameters:

  • ClusterName
  • AvailabilityZones
  • DomainName
  • HostedZoneId
  • PullSecret

OpenShift 3.x Usage

Using this Quick Start requires credentials for a Red Hat account that includes a subscription for Red Hat OpenShift Enterprise (note that that may require a non-personal email address registration).

The default provisioning in this Quick Start will launch 10 m4.xlarge EC2 instances (3 masters, 3 workers, 3 etcd nodes and 1 ansible configuration server).

If you have a Red Hat account and do not have easy access to the Red Hat subscription manager you can launch an RHEL instance in the AWS to determine if your account includes the necessary subscription and associated Pool ID.

Launch an RHEL instance and do the following on it to access your account

$ sudo subscription-manager register

This will prompt you for your account name and password.

Now get a list of what is available to you with this

$ sudo subscription-manager list --available --all

The output may include a number of sections. If the output includes something like

Red Hat OpenShift Enterprise
then look for something after it called
Pool ID: xxx
. If you see that value keep it for use with the CloudFormation stack that you will be launching.

You also need to confirm that you have

Entitlements Available
. If that value is zero or does not appear at all that you may not be able to use the Quick Start.

Once you are finished with determining what you need you can unregister the host and then terminate the instance. Unregister the instance with this

$ sudo subscription-manager unregister

Important This Quick Start will allocate from your subscription entitlements. Before you use this ensure that you will not be taking them away from a pool that needs to be available for your company usage.

It is a good idea to go to your Red Hat account portal and ensure that your hosts and subscription entitlements have been removed after you are finished with this exercise and your instances have been terminated.

If you do not already have access to a Red Hat account then go to the following to register and get access (note that that may require a non-personal email address for registration)

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.