kubernetes/kops · error

cannot render nodes for %q: %v

Error message

cannot render nodes for %q: %v

What it means

Thrown by validateClusterOutputTable when rendering the NODE STATUS table fails during `kops validate cluster`. The nodes list from the validation result cannot be rendered into the NAME/ROLE/READY table; the renderer error is wrapped with the cluster name. Same family as the instance-group render failure but for the nodes section.

Source

Thrown at cmd/kops/validate_cluster.go:299

	}

	{
		nodeTable := &tables.Table{}
		nodeTable.AddColumn("NAME", func(n *validation.ValidationNode) string {
			return n.Name
		})

		nodeTable.AddColumn("READY", func(n *validation.ValidationNode) v1.ConditionStatus {
			return n.Status
		})

		nodeTable.AddColumn("ROLE", func(n *validation.ValidationNode) string {
			return n.Role
		})

		fmt.Fprintln(out, "\nNODE STATUS")
		if err := nodeTable.Render(result.Nodes, out, "NAME", "ROLE", "READY"); err != nil {
			return fmt.Errorf("cannot render nodes for %q: %v", cluster.Name, err)
		}
	}

	if len(result.Failures) != 0 {
		failuresTable := &tables.Table{}
		failuresTable.AddColumn("KIND", func(e *validation.ValidationError) string {
			return e.Kind
		})
		failuresTable.AddColumn("NAME", func(e *validation.ValidationError) string {
			return e.Name
		})
		failuresTable.AddColumn("MESSAGE", func(e *validation.ValidationError) string {
			return e.Message
		})

		fmt.Fprintln(out, "\nVALIDATION ERRORS")
		if err := failuresTable.Render(result.Failures, out, "KIND", "NAME", "MESSAGE"); err != nil {
			return fmt.Errorf("error rendering failures table: %v", err)

View on GitHub (pinned to 4c8573c808)

Solutions

1. Re-run without piping into commands that close early (use a file instead of `| head`).
2. Verify stdout target is writable and the disk has space.
3. Switch to `--output json` to skip table rendering.
4. Inspect the wrapped `%v` inner error for the exact cause.

Example fix

// before
kops validate cluster | grep -m1 ready
// after
kops validate cluster > out.txt && grep -m1 ready out.txt

// Go: treat render failure as non-fatal, re-emit as JSON
if err != nil && strings.Contains(err.Error(), "cannot render nodes") {
    return json.NewEncoder(fileOut).Encode(result)
}

When it happens

Trigger: `kops validate cluster` reaches the NODE STATUS section and nodeTable.Render(result.Nodes, out, ...) returns an error — typically a write failure on the output stream.

Common situations: Downstream consumer of stdout exits early (broken pipe); output redirected to an unwritable file or full disk; terminal closed mid-command.

Related errors

• cannot render instance groups for %q: %w
• error rendering failures table: %v
• must specify %q label with cluster name to create instanceGr
• error querying cluster %q: %v
• cluster %q not found

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