Requirements
Before installing the Linode Cloud Controller Manager, ensure your environment meets the following requirements.
Kubernetes Cluster Requirements
Version Compatibility
- Kubernetes version 1.22 or higher
- Kubernetes cluster running on Linode infrastructure
Kubernetes Components Configuration
The following Kubernetes components must be started with the --cloud-provider=external flag:
- Kubelet
- Kube Controller Manager
- Kube API Server
Linode Requirements
API Token
You need a Linode APIv4 Personal Access Token with the following scopes:
- Linodes - Read/Write
- NodeBalancers - Read/Write
- IPs - Read/Write
- Volumes - Read/Write
- Firewalls - Read/Write (if using firewall features)
- VPCs - Read/Write (if using VPC features)
- VLANs - Read/Write (if using VLAN features)
To create a token:
- Log into the Linode Cloud Manager
- Go to your profile
- Select the "API Tokens" tab
- Click "Create a Personal Access Token"
- Select the required scopes
- Set an expiry (optional)
Region Support
Your cluster must be in a supported Linode region.
Network Requirements
Private Networking
- If using NodeBalancers, nodes must have private IP addresses
- VPC or VLAN configurations require additional network configuration
Firewall Considerations
- Ensure required ports are open for Kubernetes components
- If using Cloud Firewalls, ensure the API token has firewall management permissions
Resource Quotas
Ensure your Linode account has sufficient quota for:
- NodeBalancers (if using LoadBalancer services)
- Additional IP addresses (if using shared IP features)
- Cloud Firewalls (if using firewall features)