SSH Usernames
This page lists the Secure Shell (SSH) user names created on Kubernetes nodes, which vary by provider and Operating System (OS).
These user names are relevant when using SSH key pairs with your Palette host clusters.
Public Cloud
Public Cloud includes both Infrastructure as a Service (IaaS) and Managed Kubernetes.
Infrastructure Provider
| Provider | OS Pack | SSH Username |
|---|---|---|
| AWS IaaS | Ubuntu | ubuntu |
| AWS IaaS | CentOS | centos |
| Azure IaaS | Ubuntu | ubuntu |
| Azure IaaS | CentOS | centos |
| GCP IaaS | Ubuntu | ubuntu |
| GCP IaaS | CentOS | centos |
Managed Kubernetes
| Provider | OS Pack | SSH Username |
|---|---|---|
| AWS EKS | Amazon EKS optimized Linux | ec2-user |
| Azure AKS | Linux | azureuser |
| GCP GKE | Container-Optimized OS | Refer to the SSH Configuration on GCP GKE section. |
SSH Configuration on GCP GKE
It is not possible to configure GCP GKE clusters with an SSH key during cluster creation. If SSH access to your GCP GKE nodes is critical, consider one of the following options:
-
Configure project or node-level metadata to include your SSH key. Refer to Predefined and custom metadata keys for guidance.
-
Enable OS Login and associate your SSH key with your IAM identity. Refer to How OS Login works for guidance.
Data Center
| Provider | OS Pack | SSH Username |
|---|---|---|
| MAAS | Ubuntu | ubuntu |
| Openstack | Ubuntu | ubuntu |
| VMware vSphere | Ubuntu | spectro |
| VMware vSphere | CentOS | spectro |
Edge
This is dependent on the OS you provide for your edge hosts using either Agent Mode or EdgeForge.
If using EdgeForge, you can also create custom users and assign SSH keys to them using cloud-init stages. Refer to Cloud Init Stages for an example.
Bring Your Own OS
You can select Bring Your Own OS (BYOOS) as the OS pack for your cluster in Palette. The default SSH username will depend on the OS image that you have built. Refer to Bring Your Own OS (BYOOS) for further guidance on building custom images.
-
For images built using the Kubernetes Image Builder, the SSH username is defined as the value for
ssh_usernamein the corresponding OS JSON file. For example, the Amazon Linux 2 JSON sets thessh_usernamevalue asec2-user.If
ssh_usernameis not defined in the OS JSON, thenrootis set by the Bring Your Own OS (BYOOS) pack. -
For images built for VMware vSphere, the SSH username is set to
spectroby Palette.