{"record":{"id":"b8a5e209dd8fdf0b","repo":"kubernetes/kops","slug":"error-parsing-etcd-cluster-tag-q-on-volume-q-v-b8a5e2","errorCode":null,"errorMessage":"error parsing etcd cluster tag %q on volume %q: %v","messagePattern":"error parsing etcd cluster tag %q on volume %q: (.+?)","errorType":"exception","errorClass":null,"httpStatus":null,"severity":"error","filePath":"upup/pkg/fi/cloudup/openstack/status.go","lineNumber":84,"sourceCode":"\t}\n\tvolumes, err := c.ListVolumes(opt)\n\tif err != nil {\n\t\treturn nil, fmt.Errorf(\"error describing volumes: %v\", err)\n\t}\n\n\tfor _, volume := range volumes {\n\t\tvolumeID := volume.ID\n\n\t\tetcdClusterName := \"\"\n\t\tvar etcdClusterSpec *etcd.EtcdClusterSpec\n\n\t\tmaster := false\n\t\tfor k, v := range volume.Metadata {\n\t\t\tif strings.HasPrefix(k, TagNameEtcdClusterPrefix) {\n\t\t\t\tetcdClusterName := strings.TrimPrefix(k, TagNameEtcdClusterPrefix)\n\t\t\t\tetcdClusterSpec, err = etcd.ParseEtcdClusterSpec(etcdClusterName, v)\n\t\t\t\tif err != nil {\n\t\t\t\t\treturn nil, fmt.Errorf(\"error parsing etcd cluster tag %q on volume %q: %v\", v, volumeID, err)\n\t\t\t\t}\n\t\t\t} else if k == TagNameRolePrefix+TagRoleControlPlane || k == TagNameRolePrefix+TagRoleMaster {\n\t\t\t\tmaster = true\n\t\t\t}\n\t\t}\n\t\tif etcdClusterSpec == nil || !master {\n\t\t\tcontinue\n\t\t}\n\n\t\tetcdClusterName = etcdClusterSpec.ClusterKey\n\t\tstatus := statusMap[etcdClusterName]\n\t\tif status == nil {\n\t\t\tstatus = &kops.EtcdClusterStatus{\n\t\t\t\tName: etcdClusterName,\n\t\t\t}\n\t\t\tstatusMap[etcdClusterName] = status\n\t\t}\n","sourceCodeStart":66,"sourceCodeEnd":102,"githubUrl":"https://github.com/kubernetes/kops/blob/4c8573c808a73d578c5eadc86d410646ea0b0d73/upup/pkg/fi/cloudup/openstack/status.go#L66-L102","documentation":"After finding etcd volumes, kOps scans each volume's metadata for keys prefixed with TagNameEtcdClusterPrefix and parses the value with etcd.ParseEtcdClusterSpec. If the tag value is not a valid serialized etcd cluster spec, the parse error is wrapped as \"error parsing etcd cluster tag %q on volume %q\". This indicates corrupted or hand-edited etcd metadata on the volume.","triggerScenarios":"A volume carries a key like k8s.io/etcd/<name> whose value is malformed JSON or was produced by an incompatible kOps version; ParseEtcdClusterSpec rejects it.","commonSituations":"Manual edits to Cinder volume metadata, volume reuse from a cluster created by a much older/newer kops, or metadata truncated/modified by another automation tool.","solutions":["Inspect the volume metadata in OpenStack and fix or remove the offending k8s.io/etcd/* key","Check kOps release notes for etcd spec format changes affecting your cluster version","Restore the metadata from a known-good backup or recreate the volume via kops","If the volume is orphaned, delete it after confirming it is not backing a live etcd member"],"exampleFix":"// before (note: inner := shadows the outer etcdClusterName variable)\netcdClusterName := strings.TrimPrefix(k, TagNameEtcdClusterPrefix)\netcdClusterSpec, err = etcd.ParseEtcdClusterSpec(etcdClusterName, v)\n// after\netcdClusterName = strings.TrimPrefix(k, TagNameEtcdClusterPrefix)\netcdClusterSpec, err = etcd.ParseEtcdClusterSpec(etcdClusterName, v)","handlingStrategy":"validation","validationCode":"// Validate volume metadata before treating it as an etcd spec\nfor k, v := range volume.Metadata {\n\tif strings.HasPrefix(k, TagNameEtcdClusterPrefix) {\n\t\tif err := json.Unmarshal([]byte(v), &map[string]interface{}{}); err != nil {\n\t\t\tlog.Printf(\"volume %s has malformed etcd tag value %q\", volumeID, v)\n\t\t}\n\t}\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Never hand-edit Cinder volume metadata on kops-managed volumes","Keep kops and cluster spec versions aligned (etcd spec format changes)","Back up volume metadata before maintenance","Audit volume tags after external automation touches volumes"],"tags":["openstack","etcd","metadata","parsing"],"backgroundTag":"etcd-cluster-spec-parse-failed","analyzedSha":"4c8573c808a73d578c5eadc86d410646ea0b0d73","analyzedAt":"2026-09-05T04:13:19.212Z","contentChangedAt":"2026-09-05T04:13:19.212Z","schemaVersion":2},"datasetVersion":"2026-09-12T12:17:11.808Z"}