Azure Prerequisites
Platform9 provides native integration with Microsoft Azure to create Kubernetes clusters using Azure VM instances, not AKS and manages the lifecycle of each component required to run a Kubernetes Cluster, including the following Azure services:
- Virtual Machines
- Traffic Manager
- Application Gateway
- Azure Managed Disks
- Auto-scaling
To create a Kubernetes cluster on Azure, you need to first create a Kubernetes Cloud Provider by providing Azure credentials that are stored in the Platform9 SaaS Management Plane.
The following items are required to create an Azure Cloud Provider:
Field | Description |
---|---|
Tenant ID | Tenant ID of the service principal you created for PMK |
Client ID | Client ID of the service principal you created for PMK |
Client Secret | Client secret you created for PMK |
Subscription ID | ID of the subscription that correlates to the service principal |
Each item above is required to create an Azure Cloud Provider.
Prerequisites
Below are the steps to get the required credentials for your Azure account:
- Create a Service Principal with Contributor Role A Service Principal in Azure is an identity for an external application to use to programmatically access Azure resources.
Create a new Service Principal in your Azure account that is associated to the Subscription ID you intend to use, and assign the Service Principal the Contributor role.
The Contributor role is required as Platform9 will create new resources in Azure, including:
- Virtual Machines
- Security Groups
- Resource Groups
- Virtual Networks
- Scale Sets
- Load Balancer
The service principal that was used to create the Cloud Provider must have access to the AKS Cluster as an Azure Kubernetes Service Cluster Admin Role
For help creating a Service Principal and assigning the correct role, see the Microsoft Azure documentation below. Create a Service Principal
- Obtain the Tenant and Client IDs for the Service Principal You will need to supply the Tenant and Client IDs of the Service Principal so that Platform9 can make programmatic sign-in requests to your Azure account.
How to find Tenant and Client IDs
- Create a new Client Secret Authentication to Azure requires a unique Secret, to generate a new secrete follow the Azure documentation for how to create a new client secret.
- Get your Azure Subscription ID, The Subscription ID is a GUID that uniquely identifies your Azure subscription. Follow the steps below to find your Subscription ID
- Log on to the Azure portal.
- In the left navigation panel, click Subscriptions.
- The list of your subscriptions is displayed along with the subscription ID.
Ensure that the Service Principal belongs to the Subscription ID you plan to use in Platform9. A mismatch between the Subscription ID and the Service Principal will result in a failure to execute API request to your Azure account
Supported Operating Systems
Regardless of what infrastructure or cloud provider you are creating the PMK clusters on, PMK supports the following operating systems for the nodes of those Kubernetes clusters.
- CentOS 7+ (64-bit)
- RHEL 7+ (64-bit)
- Ubuntu LTS 18.04 (64-bit)
- Ubuntu LTS 20.04 (64-bit)