kubernetes/kops · error

error creating Akamai (Linode) instance for group %q: %w

Error message

error creating Akamai (Linode) instance for group %q: %w

What it means

RenderLinode calls the Linode API CreateInstance and wraps any API error with the group name. This is the wrapper you see when instance creation itself fails (quota, invalid options, region issues, auth).

Source

Thrown at upup/pkg/fi/cloudup/linodetasks/instance.go:242

	toCreate := expected.Count - actualCount
	for range toCreate {
		label, err := buildLinodeInstanceLabel(fi.ValueOf(expected.Name))
		if err != nil {
			return fmt.Errorf("error generating Akamai (Linode) instance label for group %q: %w", fi.ValueOf(expected.Name), err)
		}
		_, err = t.Cloud.Client().CreateInstance(context.Background(), linodego.InstanceCreateOptions{
			Region:              expected.Region,
			Type:                expected.Type,
			Label:               label,
			Image:               expected.Image,
			AuthorizedKeys:      authorizedKeys,
			Tags:                instanceTags,
			Metadata:            &linodego.InstanceMetadataOptions{UserData: encodedUserData},
			InterfaceGeneration: linodego.GenerationLinode,
			LinodeInterfaces:    interfaces,
		})
		if err != nil {
			return fmt.Errorf("error creating Akamai (Linode) instance for group %q: %w", fi.ValueOf(expected.Name), err)
		}
	}

	return nil
}

// generateUserDataHash generates a unique hash for the given user data string.
func generateUserDataHash(userData string) string {
	hash := sha256.Sum256([]byte(userData))
	fullHashString := base64.RawURLEncoding.EncodeToString(hash[:])

	// Truncate the hash to ensure the tag name does not exceed 50 characters.
	maxLength := 50 - len(linode.TagKubernetesInstanceUserData) - 1 // 1 for the colon separator
	truncatedHash := fullHashString[:maxLength]

	return truncatedHash
}

View on GitHub (pinned to 4c8573c808)

Solutions

1. Read the wrapped inner error for the actual API cause
2. Verify the Linode API token is valid and has write scopes
3. Check the region supports the chosen plan type and the image is valid
4. Check account instance limits/quota in the Linode manager
5. Retry after resolving; transient API errors may just need a re-run

// pre-check plan availability and quota via linodego before apply
if _, _, err := client.ListTypes(ctx, &linodego.ListOptions{}); err != nil { return err }

_, err = client.CreateInstance(ctx, opts)
if err != nil {
    if linodego.ErrorNeedsRetry(err) { /* retry with backoff */ }
    return fmt.Errorf("error creating Akamai (Linode) instance for group %q: %w", name, err)
}

When it happens

Trigger: linodego CreateInstance returns an error: invalid region/type/image, insufficient account quota, auth token failure, or invalid interface configuration.

Common situations: Exceeded Linode account limit, plan type unavailable in region, expired LINODE_TOKEN, or specifying an image the plan doesn't support.

Related errors

• failed to get info for Akamai (Linode) instance %q: %w
• error listing Akamai (Linode) interfaces for instance %q: %w
• error listing Akamai (Linode) SSH keys: %w
• error listing Akamai (Linode) SSH keys: %w
• error building linode node identifier: %w

AI-assisted analysis of kubernetes/kops@4c8573c808 (2026-09-05). Data as JSON: /api/errors/c115d99eefb5a7fe. Report an issue: GitHub.