AWS
This article describes the steps to create a Kubernetes cluster on Amazon Web Services (AWS) cloud using AWS EC2 instances, and using Platform9 Managed Kubernetes (PMK).
What you’ll need
- Access to the inbox of a valid email address
- AWS account that meets the Pre-requisites for AWS Native Clusters
Log in to your Platform9 Account
Log in to your Platform9 account. Once you sign in you’ll be directed to your account's dashboard. This is a summary of all Kubernetes clusters, nodes, pods, and cloud accounts associated with your Platform9 account. If this is a brand new account, there may not be anything associated… yet!
Platform9 – UI - Dashboard
Connect your AWS account with your Platform9 instance
Before associating your account make sure it meets the minimum requirements, read more here. You’ll need an SSH key-pair before running the provider wizard.
From your dashboard click the "Add Cloud" button and choose "Amazon Web Services" as your cloud provider type. Name the new provider something memorable like 'my-aws-provider' and provide your AWS key credentials.
Ensure your AWS IAM User has the correct IAM access by using the Cloud Provider Checks CLI or by adding the Platform9 IAM Policy by downloading it here
Platform9 – UI - Add New AWS Cloud Provider
When you click "Next" your AWS account will be validated for correct permissions.
Platform9 – UI - AWS - Validating Cloud Provider Access
Once validated, choose the AWS region, route name, and SSH key-pair to use when creating your new cluster. As you choose a region, your routes within that region will be loaded automatically.
In order to route traffic to your cluster, a valid domain name must be used.
"Complete" to create your new cloud provider and be directed back to the cloud providers listing.
Create a simple one-click cluster
From your dashboard, click the "Add Cluster" button and choose "Amazon Web Services" as your infrastructure provider. Choose the "One-Click Cluster" button to get started.
Name your cluster something memorable like "my-aws-cluster" and choose the appropriate values to tell the Platform9 system where to create the cluster.
"Complete" to begin the creation of your new cluster.
The Platform9 system will create a single EC2 instance, promote it to be a Kubernetes master node, and enable your workloads to run on it. Routing will be automatically configured as well as full observability.
Sometimes this can take a little time depending on many things. Behind the scenes the PMK packages are being installed, along with other needed services.
After creation successfully initializes, you will be directed to the "Node Health" tab where you can watch the progress.
As the deployment progresses, the screen will update with steps completed and a final message of "Connected" and "Healthy".
Navigate back to your dashboard to see a summary of the new management plane.
Removing a One-Click Cluster From Your AWS Account
- Navigate to the "Infrastructure" area.
- Choose the "Clusters" tab.
- Select the cluster to remove and click the "Delete" icon.
It will take a few minutes to terminate the EC2 instance running as the Kubernetes master. In the "Nodes" tab, the associated instance will automatically remove after termination.
What's next?
| Introduction to kubeconfig | Get Your First Container Running on Kubernetes | Integrating External DNS with Kubernetes |
|---|---|---|