Documentation
¶
Overview ¶
Package driver defines the interface for AWS EKS control-plane mocks.
Wave 1 covers the cloud-side EKS surface only: clusters, managed node groups, Fargate profiles, and add-ons. The Kubernetes data plane (Deployments, Pods, Services, …) is explicitly out of scope and will be Wave 2 — when it lands, the cluster Endpoint and CertificateAuthority fields will point at a real in-process apiserver instead of the placeholder values returned today.
The shape is intentionally service-local: EKS has no cross-cloud equivalent that warrants a portable abstraction yet, so this lives next to the provider implementation rather than in a top-level package.
Index ¶
Constants ¶
const ( ClusterStatusCreating = "CREATING" ClusterStatusActive = "ACTIVE" ClusterStatusDeleting = "DELETING" ClusterStatusUpdating = "UPDATING" )
Cluster lifecycle states. Mirrors the AWS EKS ClusterStatus enum.
const ( NodegroupStatusCreating = "CREATING" NodegroupStatusActive = "ACTIVE" NodegroupStatusUpdating = "UPDATING" NodegroupStatusDeleting = "DELETING" )
Nodegroup lifecycle states.
const ( FargateProfileStatusCreating = "CREATING" FargateProfileStatusActive = "ACTIVE" FargateProfileStatusDeleting = "DELETING" )
FargateProfile lifecycle states.
const ( AddonStatusCreating = "CREATING" AddonStatusActive = "ACTIVE" AddonStatusUpdating = "UPDATING" AddonStatusDeleting = "DELETING" )
Addon lifecycle states.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Addon ¶
type Addon struct {
ClusterName string
AddonName string
AddonVersion string
ARN string
ServiceAccountRoleArn string
ConfigurationValues string
Status string
Tags map[string]string
CreatedAt time.Time
ModifiedAt time.Time
}
Addon is the mock-side representation of a cluster add-on.
type AddonConfig ¶
type AddonConfig struct {
ClusterName string
AddonName string
AddonVersion string
ServiceAccountRoleArn string
ConfigurationValues string
Tags map[string]string
}
AddonConfig configures a new cluster add-on.
type Cluster ¶
type Cluster struct {
Name string
ARN string
Version string
PlatformVersion string
RoleArn string
Endpoint string
CertificateAuthority string
Status string
VPCConfig VPCConfig
Tags map[string]string
CreatedAt time.Time
}
Cluster is the mock-side representation of an EKS cluster.
type ClusterConfig ¶
type ClusterConfig struct {
Name string
Version string
RoleArn string
VPCConfig VPCConfig
Tags map[string]string
}
ClusterConfig configures a new EKS cluster.
type ClusterUpdate ¶
type ClusterUpdate struct {
ID string
Type string // VersionUpdate, EndpointAccessUpdate, …
Status string // InProgress, Failed, Canceled, Successful
CreatedAt time.Time
}
ClusterUpdate is returned by mutating cluster ops; SDKs poll this via DescribeUpdate but Wave 1 returns done=true immediately.
type EKS ¶
type EKS interface {
// Clusters
CreateCluster(ctx context.Context, cfg ClusterConfig) (*Cluster, error)
DescribeCluster(ctx context.Context, name string) (*Cluster, error)
ListClusters(ctx context.Context) ([]string, error)
UpdateClusterConfig(ctx context.Context, name string, cfg VPCConfig, tags map[string]string) (*ClusterUpdate, error)
UpdateClusterVersion(ctx context.Context, name, version string) (*ClusterUpdate, error)
DeleteCluster(ctx context.Context, name string) (*Cluster, error)
// Node groups
CreateNodegroup(ctx context.Context, cfg NodegroupConfig) (*Nodegroup, error)
DescribeNodegroup(ctx context.Context, clusterName, nodegroupName string) (*Nodegroup, error)
ListNodegroups(ctx context.Context, clusterName string) ([]string, error)
UpdateNodegroupConfig(
ctx context.Context, clusterName, nodegroupName string,
scaling *NodegroupScalingConfig, labels map[string]string,
) (*ClusterUpdate, error)
UpdateNodegroupVersion(
ctx context.Context, clusterName, nodegroupName, version, releaseVersion string,
) (*ClusterUpdate, error)
DeleteNodegroup(ctx context.Context, clusterName, nodegroupName string) (*Nodegroup, error)
// Fargate profiles
CreateFargateProfile(ctx context.Context, cfg FargateProfileConfig) (*FargateProfile, error)
DescribeFargateProfile(ctx context.Context, clusterName, profileName string) (*FargateProfile, error)
ListFargateProfiles(ctx context.Context, clusterName string) ([]string, error)
DeleteFargateProfile(ctx context.Context, clusterName, profileName string) (*FargateProfile, error)
// Add-ons
CreateAddon(ctx context.Context, cfg AddonConfig) (*Addon, error)
DescribeAddon(ctx context.Context, clusterName, addonName string) (*Addon, error)
ListAddons(ctx context.Context, clusterName string) ([]string, error)
UpdateAddon(ctx context.Context, cfg AddonConfig) (*ClusterUpdate, error)
DeleteAddon(ctx context.Context, clusterName, addonName string) (*Addon, error)
}
EKS is the interface implemented by the EKS provider mock. It mirrors the AWS EKS API operations the SDK-compat handler needs to serve real clients.
type FargateProfile ¶
type FargateProfile struct {
ClusterName string
FargateProfileName string
ARN string
PodExecutionRole string
Subnets []string
Selectors []FargateProfileSelector
Status string
Tags map[string]string
CreatedAt time.Time
}
FargateProfile is the mock-side representation of a Fargate profile.
type FargateProfileConfig ¶
type FargateProfileConfig struct {
ClusterName string
FargateProfileName string
PodExecutionRole string
Subnets []string
Selectors []FargateProfileSelector
Tags map[string]string
}
FargateProfileConfig configures a new Fargate profile.
type FargateProfileSelector ¶
FargateProfileSelector matches Pods to a Fargate profile.
type Nodegroup ¶
type Nodegroup struct {
ClusterName string
NodegroupName string
ARN string
NodeRole string
Subnets []string
InstanceTypes []string
AmiType string
CapacityType string
DiskSize int
Version string
ReleaseVersion string
ScalingConfig NodegroupScalingConfig
Status string
Labels map[string]string
Tags map[string]string
CreatedAt time.Time
}
Nodegroup is the mock-side representation of a managed node group.
type NodegroupConfig ¶
type NodegroupConfig struct {
ClusterName string
NodegroupName string
NodeRole string
Subnets []string
InstanceTypes []string
AmiType string
CapacityType string
DiskSize int
Version string
ReleaseVersion string
ScalingConfig NodegroupScalingConfig
Labels map[string]string
Tags map[string]string
}
NodegroupConfig configures a new managed node group.
type NodegroupScalingConfig ¶
NodegroupScalingConfig captures Auto Scaling sizing for a nodegroup.
Source Files