// Copyright (c) HashiCorp, Inc. // SPDX-License-Identifier: MPL-2.0 package command import ( "errors" "fmt" "io" "sort" "strings" "github.com/hashicorp/nomad/api" ) func (c *VolumeStatusCommand) csiBanner() { if !(c.json || len(c.template) > 0) { c.Ui.Output(c.Colorize().Color("[bold]Container Storage Interface[reset]")) } } func (c *VolumeStatusCommand) csiStatus(client *api.Client, id string) int { // Invoke list mode if no volume id if id == "" { return c.listVolumes(client) } // Prefix search for the volume vols, _, err := client.CSIVolumes().List(&api.QueryOptions{Prefix: id}) if err != nil { c.Ui.Error(fmt.Sprintf("Error querying volumes: %s", err)) return 1 } if len(vols) == 0 { c.Ui.Error(fmt.Sprintf("No volumes(s) with prefix or ID %q found", id)) return 1 } var ns string if len(vols) == 1 { // need to set id from the actual ID because it might be a prefix id = vols[0].ID ns = vols[0].Namespace } // List sorts by CreateIndex, not by ID, so we need to search for // exact matches but account for multiple exact ID matches across // namespaces if len(vols) > 1 { exactMatchesCount := 0 for _, vol := range vols { if vol.ID == id { exactMatchesCount++ ns = vol.Namespace } } if exactMatchesCount != 1 { out, err := c.csiFormatVolumes(vols) if err != nil { c.Ui.Error(fmt.Sprintf("Error formatting: %s", err)) return 1 } c.Ui.Error(fmt.Sprintf("Prefix matched multiple volumes\n\n%s", out)) return 1 } } // Try querying the volume client.SetNamespace(ns) vol, _, err := client.CSIVolumes().Info(id, nil) if err != nil { c.Ui.Error(fmt.Sprintf("Error querying volume: %s", err)) return 1 } str, err := c.formatBasic(vol) if err != nil { c.Ui.Error(fmt.Sprintf("Error formatting volume: %s", err)) return 1 } c.Ui.Output(str) return 0 } func (c *VolumeStatusCommand) listVolumes(client *api.Client) int { c.csiBanner() vols, _, err := client.CSIVolumes().List(nil) if err != nil { c.Ui.Error(fmt.Sprintf("Error querying volumes: %s", err)) return 1 } if len(vols) == 0 { // No output if we have no volumes c.Ui.Error("No CSI volumes") } else { str, err := c.csiFormatVolumes(vols) if err != nil { c.Ui.Error(fmt.Sprintf("Error formatting: %s", err)) return 1 } c.Ui.Output(str) } if !c.verbose { return 0 } plugins, _, err := client.CSIPlugins().List(nil) if err != nil { c.Ui.Error(fmt.Sprintf("Error querying CSI plugins: %s", err)) return 1 } if len(plugins) == 0 { return 0 // No more output if we have no plugins } var code int q := &api.QueryOptions{PerPage: 30} // TODO: tune page size NEXT_PLUGIN: for _, plugin := range plugins { if !plugin.ControllerRequired || plugin.ControllersHealthy < 1 { continue // only controller plugins can support this query } for { externalList, _, err := client.CSIVolumes().ListExternal(plugin.ID, q) if err != nil && !errors.Is(err, io.EOF) { c.Ui.Error(fmt.Sprintf( "Error querying CSI external volumes for plugin %q: %s", plugin.ID, err)) // we'll stop querying this plugin, but there may be more to // query, so report and set the error code but move on to the // next plugin code = 1 continue NEXT_PLUGIN } if externalList == nil || len(externalList.Volumes) == 0 { // several plugins return EOF once you hit the end of the page, // rather than an empty list continue NEXT_PLUGIN } rows := []string{"External ID|Condition|Nodes"} for _, v := range externalList.Volumes { condition := "OK" if v.IsAbnormal { condition = fmt.Sprintf("Abnormal (%v)", v.Status) } rows = append(rows, fmt.Sprintf("%s|%s|%s", limit(v.ExternalID, c.length), limit(condition, 20), strings.Join(v.PublishedExternalNodeIDs, ","), )) } c.Ui.Output(formatList(rows)) q.NextToken = externalList.NextToken if q.NextToken == "" { break } // we can't know the shape of arbitrarily-sized lists of volumes, // so break after each page c.Ui.Output("...") } } return code } func (c *VolumeStatusCommand) csiFormatVolumes(vols []*api.CSIVolumeListStub) (string, error) { // Sort the output by volume id sort.Slice(vols, func(i, j int) bool { return vols[i].ID < vols[j].ID }) if c.json || len(c.template) > 0 { out, err := Format(c.json, c.template, vols) if err != nil { return "", fmt.Errorf("format error: %v", err) } return out, nil } return csiFormatSortedVolumes(vols) } // Format the volumes, assumes that we're already sorted by volume ID func csiFormatSortedVolumes(vols []*api.CSIVolumeListStub) (string, error) { rows := make([]string, len(vols)+1) rows[0] = "ID|Name|Plugin ID|Schedulable|Access Mode" for i, v := range vols { rows[i+1] = fmt.Sprintf("%s|%s|%s|%t|%s", v.ID, v.Name, v.PluginID, v.Schedulable, v.AccessMode, ) } return formatList(rows), nil } func (c *VolumeStatusCommand) formatBasic(vol *api.CSIVolume) (string, error) { if c.json || len(c.template) > 0 { out, err := Format(c.json, c.template, vol) if err != nil { return "", fmt.Errorf("format error: %v", err) } return out, nil } output := []string{ fmt.Sprintf("ID|%s", vol.ID), fmt.Sprintf("Name|%s", vol.Name), fmt.Sprintf("External ID|%s", vol.ExternalID), fmt.Sprintf("Plugin ID|%s", vol.PluginID), fmt.Sprintf("Provider|%s", vol.Provider), fmt.Sprintf("Version|%s", vol.ProviderVersion), fmt.Sprintf("Schedulable|%t", vol.Schedulable), fmt.Sprintf("Controllers Healthy|%d", vol.ControllersHealthy), fmt.Sprintf("Controllers Expected|%d", vol.ControllersExpected), fmt.Sprintf("Nodes Healthy|%d", vol.NodesHealthy), fmt.Sprintf("Nodes Expected|%d", vol.NodesExpected), fmt.Sprintf("Access Mode|%s", vol.AccessMode), fmt.Sprintf("Attachment Mode|%s", vol.AttachmentMode), fmt.Sprintf("Mount Options|%s", csiVolMountOption(vol.MountOptions, nil)), fmt.Sprintf("Namespace|%s", vol.Namespace), } // Exit early if c.short { return formatKV(output), nil } full := []string{formatKV(output)} if len(vol.Topologies) > 0 { topoBanner := c.Colorize().Color("\n[bold]Topologies[reset]") topo := c.formatTopology(vol) full = append(full, topoBanner) full = append(full, topo) } // Format the allocs banner := c.Colorize().Color("\n[bold]Allocations[reset]") allocs := formatAllocListStubs(vol.Allocations, c.verbose, c.length) full = append(full, banner) full = append(full, allocs) return strings.Join(full, "\n"), nil } func (c *VolumeStatusCommand) formatTopology(vol *api.CSIVolume) string { rows := []string{"Topology|Segments"} for i, t := range vol.Topologies { if t == nil { continue } segmentPairs := make([]string, 0, len(t.Segments)) for k, v := range t.Segments { segmentPairs = append(segmentPairs, fmt.Sprintf("%s=%s", k, v)) } // note: this looks awkward because we don't have any other // place where we list collections of arbitrary k/v's like // this without just dumping JSON formatted outputs. It's likely // the spec will expand to add extra fields, in which case we'll // add them here and drop the first column rows = append(rows, fmt.Sprintf("%02d|%v", i, strings.Join(segmentPairs, ", "))) } if len(rows) == 1 { return "" } return formatList(rows) } func csiVolMountOption(volume, request *api.CSIMountOptions) string { var req, opts *api.CSIMountOptions if request != nil { req = &api.CSIMountOptions{ FSType: request.FSType, MountFlags: request.MountFlags, } } if volume == nil { opts = req } else { opts = &api.CSIMountOptions{ FSType: volume.FSType, MountFlags: volume.MountFlags, } opts.Merge(req) } if opts == nil { return "" } var out string if opts.FSType != "" { out = fmt.Sprintf("fs_type: %s", opts.FSType) } if len(opts.MountFlags) > 0 { out = fmt.Sprintf("%s flags: %s", out, strings.Join(opts.MountFlags, ", ")) } return out }