| /* |
| * Copyright 2019-present Ciena Corporation |
| * |
| * Licensed under the Apache License, Version 2.0 (the "License"); |
| * you may not use this file except in compliance with the License. |
| * You may obtain a copy of the License at |
| * |
| * http://www.apache.org/licenses/LICENSE-2.0 |
| * |
| * Unless required by applicable law or agreed to in writing, software |
| * distributed under the License is distributed on an "AS IS" BASIS, |
| * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| * See the License for the specific language governing permissions and |
| * limitations under the License. |
| */ |
| package commands |
| |
| import ( |
| "context" |
| "crypto/tls" |
| "encoding/json" |
| "errors" |
| "fmt" |
| "io/ioutil" |
| "log" |
| "os" |
| "path/filepath" |
| "reflect" |
| "regexp" |
| "strconv" |
| "strings" |
| "time" |
| |
| "github.com/golang/protobuf/jsonpb" |
| "github.com/golang/protobuf/proto" |
| configv1 "github.com/opencord/voltctl/internal/pkg/apis/config/v1" |
| configv2 "github.com/opencord/voltctl/internal/pkg/apis/config/v2" |
| configv3 "github.com/opencord/voltctl/internal/pkg/apis/config/v3" |
| "github.com/opencord/voltctl/pkg/filter" |
| "github.com/opencord/voltctl/pkg/format" |
| "github.com/opencord/voltctl/pkg/order" |
| "google.golang.org/grpc" |
| "google.golang.org/grpc/credentials" |
| yaml "gopkg.in/yaml.v2" |
| ) |
| |
| type OutputType uint8 |
| |
| const ( |
| OUTPUT_TABLE OutputType = iota |
| OUTPUT_JSON |
| OUTPUT_YAML |
| |
| supportedKvStoreType = "etcd" |
| ) |
| |
| var ( |
| ParamNames = map[string]map[string]string{ |
| "v1": { |
| "ID": "voltha.ID", |
| }, |
| "v2": { |
| "ID": "common.ID", |
| }, |
| "v3": { |
| "ID": "common.ID", |
| "port": "voltha.Port", |
| "ValueSpecifier": "common.ValueSpecifier", |
| }, |
| } |
| |
| CharReplacer = strings.NewReplacer("\\t", "\t", "\\n", "\n") |
| |
| GlobalConfig = configv3.NewDefaultConfig() |
| |
| GlobalCommandOptions = make(map[string]map[string]string) |
| |
| GlobalOptions struct { |
| Config string `short:"c" long:"config" env:"VOLTCONFIG" value-name:"FILE" default:"" description:"Location of client config file"` |
| Stack string `short:"v" long:"stack" env:"STACK" value-name:"STACK" default:"" description:"Name of stack to use in multistack deployment"` |
| Server string `short:"s" long:"server" default:"" value-name:"SERVER:PORT" description:"IP/Host and port of VOLTHA"` |
| Kafka string `short:"k" long:"kafka" default:"" value-name:"SERVER:PORT" description:"IP/Host and port of Kafka"` |
| KvStore string `short:"e" long:"kvstore" env:"KVSTORE" value-name:"SERVER:PORT" description:"IP/Host and port of KV store (etcd)"` |
| |
| // nolint: staticcheck |
| Debug bool `short:"d" long:"debug" description:"Enable debug mode"` |
| Timeout string `short:"t" long:"timeout" description:"API call timeout duration" value-name:"DURATION" default:""` |
| UseTLS bool `long:"tls" description:"Use TLS"` |
| CACert string `long:"tlscacert" value-name:"CA_CERT_FILE" description:"Trust certs signed only by this CA"` |
| Cert string `long:"tlscert" value-name:"CERT_FILE" description:"Path to TLS vertificate file"` |
| Key string `long:"tlskey" value-name:"KEY_FILE" description:"Path to TLS key file"` |
| Verify bool `long:"tlsverify" description:"Use TLS and verify the remote"` |
| K8sConfig string `short:"8" long:"k8sconfig" env:"KUBECONFIG" value-name:"FILE" default:"" description:"Location of Kubernetes config file"` |
| KvStoreTimeout string `long:"kvstoretimeout" env:"KVSTORE_TIMEOUT" value-name:"DURATION" default:"" description:"timeout for calls to KV store"` |
| CommandOptions string `short:"o" long:"command-options" env:"VOLTCTL_COMMAND_OPTIONS" value-name:"FILE" default:"" description:"Location of command options default configuration file"` |
| MaxCallRecvMsgSize string `short:"m" long:"maxcallrecvmsgsize" description:"Max GRPC Client request size limit in bytes (eg: 4MB)" value-name:"SIZE" default:"4M"` |
| } |
| |
| Debug = log.New(os.Stdout, "DEBUG: ", 0) |
| Info = log.New(os.Stdout, "INFO: ", 0) |
| Warn = log.New(os.Stderr, "WARN: ", 0) |
| Error = log.New(os.Stderr, "ERROR: ", 0) |
| ) |
| |
| type OutputOptions struct { |
| Format string `long:"format" value-name:"FORMAT" default:"" description:"Format to use to output structured data"` |
| Quiet bool `short:"q" long:"quiet" description:"Output only the IDs of the objects"` |
| // nolint: staticcheck |
| OutputAs string `short:"o" long:"outputas" default:"table" choice:"table" choice:"json" choice:"yaml" description:"Type of output to generate"` |
| NameLimit int `short:"l" long:"namelimit" default:"-1" value-name:"LIMIT" description:"Limit the depth (length) in the table column name"` |
| } |
| |
| type FlowIdOptions struct { |
| HexId bool `short:"x" long:"hex-id" description:"Output Ids in hex format"` |
| } |
| |
| type ListOutputOptions struct { |
| OutputOptions |
| Filter string `short:"f" long:"filter" default:"" value-name:"FILTER" description:"Only display results that match filter"` |
| OrderBy string `short:"r" long:"orderby" default:"" value-name:"ORDER" description:"Specify the sort order of the results"` |
| } |
| |
| type OutputOptionsJson struct { |
| Format string `long:"format" value-name:"FORMAT" default:"" description:"Format to use to output structured data"` |
| Quiet bool `short:"q" long:"quiet" description:"Output only the IDs of the objects"` |
| // nolint: staticcheck |
| OutputAs string `short:"o" long:"outputas" default:"json" choice:"table" choice:"json" choice:"yaml" description:"Type of output to generate"` |
| NameLimit int `short:"l" long:"namelimit" default:"-1" value-name:"LIMIT" description:"Limit the depth (length) in the table column name"` |
| } |
| |
| type ListOutputOptionsJson struct { |
| OutputOptionsJson |
| Filter string `short:"f" long:"filter" default:"" value-name:"FILTER" description:"Only display results that match filter"` |
| OrderBy string `short:"r" long:"orderby" default:"" value-name:"ORDER" description:"Specify the sort order of the results"` |
| } |
| |
| func toOutputType(in string) OutputType { |
| switch in { |
| case "table": |
| fallthrough |
| default: |
| return OUTPUT_TABLE |
| case "json": |
| return OUTPUT_JSON |
| case "yaml": |
| return OUTPUT_YAML |
| } |
| } |
| |
| type CommandResult struct { |
| Format format.Format |
| Filter string |
| OrderBy string |
| OutputAs OutputType |
| NameLimit int |
| Data interface{} |
| } |
| |
| func GetCommandOptionWithDefault(name, option, defaultValue string) string { |
| if cmd, ok := GlobalCommandOptions[name]; ok { |
| if val, ok := cmd[option]; ok { |
| return CharReplacer.Replace(val) |
| } |
| } |
| return defaultValue |
| } |
| |
| var sizeParser = regexp.MustCompile(`^([0-9]+)([PETGMK]?)I?B?$`) |
| |
| func parseSize(size string) (uint64, error) { |
| |
| parts := sizeParser.FindAllStringSubmatch(strings.ToUpper(size), -1) |
| if len(parts) == 0 { |
| return 0, fmt.Errorf("size: invalid size '%s'", size) |
| } |
| value, err := strconv.ParseUint(parts[0][1], 10, 64) |
| if err != nil { |
| return 0, fmt.Errorf("size: invalid size '%s'", size) |
| } |
| switch parts[0][2] { |
| case "E": |
| value = value * 1024 * 1024 * 1024 * 1024 * 1024 * 1024 |
| case "P": |
| value = value * 1024 * 1024 * 1024 * 1024 * 1024 |
| case "T": |
| value = value * 1024 * 1024 * 1024 * 1024 |
| case "G": |
| value = value * 1024 * 1024 * 1024 |
| case "M": |
| value = value * 1024 * 1024 |
| case "K": |
| value = value * 1024 |
| default: |
| } |
| return value, nil |
| } |
| |
| func ProcessGlobalOptions() { |
| ReadConfig() |
| |
| // If a stack is selected via command line set it |
| if GlobalOptions.Stack != "" { |
| if GlobalConfig.StackByName(GlobalOptions.Stack) == nil { |
| Error.Fatalf("stack specified, '%s', not found in configuration", |
| GlobalOptions.Stack) |
| } |
| GlobalConfig.CurrentStack = GlobalOptions.Stack |
| } |
| |
| ApplyOptionOverrides(GlobalConfig.Current()) |
| |
| // If a k8s cert/key were not specified, then attempt to read it from |
| // any $HOME/.kube/config if it exists |
| if len(GlobalOptions.K8sConfig) == 0 { |
| home, err := os.UserHomeDir() |
| if err != nil { |
| Warn.Printf("Unable to discover the user's home directory: %s", err) |
| home = "~" |
| } |
| GlobalOptions.K8sConfig = filepath.Join(home, ".kube", "config") |
| } |
| |
| if len(GlobalOptions.CommandOptions) == 0 { |
| home, err := os.UserHomeDir() |
| if err != nil { |
| Warn.Printf("Unable to discover the user's home directory: %s", err) |
| home = "~" |
| } |
| GlobalOptions.CommandOptions = filepath.Join(home, ".volt", "command_options") |
| } |
| |
| if info, err := os.Stat(GlobalOptions.CommandOptions); err == nil && !info.IsDir() { |
| optionsFile, err := ioutil.ReadFile(GlobalOptions.CommandOptions) |
| if err != nil { |
| Error.Fatalf("Unable to read command options configuration file '%s' : %s", |
| GlobalOptions.CommandOptions, err.Error()) |
| } |
| if err = yaml.Unmarshal(optionsFile, &GlobalCommandOptions); err != nil { |
| Error.Fatalf("Unable to parse the command line options configuration file '%s': %s", |
| GlobalOptions.CommandOptions, err.Error()) |
| } |
| } |
| } |
| |
| func ApplyOptionOverrides(stack *configv3.StackConfigSpec) { |
| |
| if stack == nil { |
| // nothing to do |
| return |
| } |
| // Override from command line |
| if GlobalOptions.Server != "" { |
| stack.Server = GlobalOptions.Server |
| } |
| |
| if GlobalOptions.UseTLS { |
| stack.Tls.UseTls = true |
| } |
| |
| if GlobalOptions.Verify { |
| stack.Tls.Verify = true |
| } |
| |
| if GlobalOptions.Kafka != "" { |
| stack.Kafka = GlobalOptions.Kafka |
| } |
| |
| if GlobalOptions.KvStore != "" { |
| stack.KvStore = GlobalOptions.KvStore |
| } |
| |
| if GlobalOptions.KvStoreTimeout != "" { |
| timeout, err := time.ParseDuration(GlobalOptions.KvStoreTimeout) |
| if err != nil { |
| Error.Fatalf("Unable to parse specified KV strore timeout duration '%s': %s", |
| GlobalOptions.KvStoreTimeout, err.Error()) |
| } |
| stack.KvStoreConfig.Timeout = timeout |
| } |
| |
| if GlobalOptions.Timeout != "" { |
| timeout, err := time.ParseDuration(GlobalOptions.Timeout) |
| if err != nil { |
| Error.Fatalf("Unable to parse specified timeout duration '%s': %s", |
| GlobalOptions.Timeout, err.Error()) |
| } |
| stack.Grpc.Timeout = timeout |
| } |
| |
| if GlobalOptions.MaxCallRecvMsgSize != "" { |
| stack.Grpc.MaxCallRecvMsgSize = GlobalOptions.MaxCallRecvMsgSize |
| } |
| } |
| |
| func ReadConfig() { |
| if len(GlobalOptions.Config) == 0 { |
| home, err := os.UserHomeDir() |
| if err != nil { |
| Warn.Printf("Unable to discover the user's home directory: %s", err) |
| home = "~" |
| } |
| GlobalOptions.Config = filepath.Join(home, ".volt", "config") |
| } |
| |
| if info, err := os.Stat(GlobalOptions.Config); err == nil && !info.IsDir() { |
| configFile, err := ioutil.ReadFile(GlobalOptions.Config) |
| if err != nil { |
| Error.Fatalf("Unable to read the configuration file '%s': %s", |
| GlobalOptions.Config, err.Error()) |
| } |
| // First try the latest version of the config api then work |
| // backwards |
| if err = yaml.Unmarshal(configFile, &GlobalConfig); err != nil { |
| GlobalConfigV2 := configv2.NewDefaultConfig() |
| if err = yaml.Unmarshal(configFile, &GlobalConfigV2); err != nil { |
| GlobalConfigV1 := configv1.NewDefaultConfig() |
| if err = yaml.Unmarshal(configFile, &GlobalConfigV1); err != nil { |
| Error.Fatalf("Unable to parse the configuration file '%s': %s", |
| GlobalOptions.Config, err.Error()) |
| } |
| GlobalConfig = configv3.FromConfigV1(GlobalConfigV1) |
| } else { |
| GlobalConfig = configv3.FromConfigV2(GlobalConfigV2) |
| } |
| } |
| } |
| |
| } |
| |
| func NewConnection() (*grpc.ClientConn, error) { |
| ProcessGlobalOptions() |
| |
| // convert grpc.msgSize into bytes |
| n, err := parseSize(GlobalConfig.Current().Grpc.MaxCallRecvMsgSize) |
| if err != nil { |
| Error.Fatalf("Cannot convert msgSize %s to bytes", GlobalConfig.Current().Grpc.MaxCallRecvMsgSize) |
| } |
| |
| var opts []grpc.DialOption |
| |
| opts = append(opts, |
| grpc.WithDisableRetry(), |
| grpc.WithBlock(), |
| grpc.WithDefaultCallOptions(grpc.MaxCallRecvMsgSize(int(n)))) |
| |
| if GlobalConfig.Current().Tls.UseTls { |
| creds := credentials.NewTLS(&tls.Config{ |
| InsecureSkipVerify: !GlobalConfig.Current().Tls.Verify}) |
| opts = append(opts, grpc.WithTransportCredentials(creds)) |
| } else { |
| opts = append(opts, grpc.WithInsecure()) |
| } |
| ctx, cancel := context.WithTimeout(context.TODO(), |
| GlobalConfig.Current().Grpc.ConnectTimeout) |
| defer cancel() |
| return grpc.DialContext(ctx, GlobalConfig.Current().Server, opts...) |
| } |
| |
| func ConvertJsonProtobufArray(data_in interface{}) (string, error) { |
| result := "" |
| |
| slice := reflect.ValueOf(data_in) |
| if slice.Kind() != reflect.Slice { |
| return "", errors.New("Not a slice") |
| } |
| |
| result = result + "[" |
| |
| marshaler := jsonpb.Marshaler{EmitDefaults: true} |
| for i := 0; i < slice.Len(); i++ { |
| item := slice.Index(i).Interface() |
| protoMessage, okay := item.(proto.Message) |
| if !okay { |
| return "", errors.New("Failed to convert item to a proto.Message") |
| } |
| asJson, err := marshaler.MarshalToString(protoMessage) |
| if err != nil { |
| return "", fmt.Errorf("Failed to marshal the json: %s", err) |
| } |
| |
| result = result + asJson |
| |
| if i < slice.Len()-1 { |
| result = result + "," |
| } |
| } |
| |
| result = result + "]" |
| |
| return result, nil |
| } |
| |
| func GenerateOutput(result *CommandResult) { |
| if result != nil && result.Data != nil { |
| data := result.Data |
| if result.Filter != "" { |
| f, err := filter.Parse(result.Filter) |
| if err != nil { |
| Error.Fatalf("Unable to parse specified output filter '%s': %s", result.Filter, err.Error()) |
| } |
| data, err = f.Process(data) |
| if err != nil { |
| Error.Fatalf("Unexpected error while filtering command results: %s", err.Error()) |
| } |
| } |
| if result.OrderBy != "" { |
| s, err := order.Parse(result.OrderBy) |
| if err != nil { |
| Error.Fatalf("Unable to parse specified sort specification '%s': %s", result.OrderBy, err.Error()) |
| } |
| data, err = s.Process(data) |
| if err != nil { |
| Error.Fatalf("Unexpected error while sorting command result: %s", err.Error()) |
| } |
| } |
| if result.OutputAs == OUTPUT_TABLE { |
| tableFormat := format.Format(result.Format) |
| if err := tableFormat.Execute(os.Stdout, true, result.NameLimit, data); err != nil { |
| Error.Fatalf("Unexpected error while attempting to format results as table : %s", err.Error()) |
| } |
| } else if result.OutputAs == OUTPUT_JSON { |
| // first try to convert it as an array of protobufs |
| asJson, err := ConvertJsonProtobufArray(data) |
| if err != nil { |
| // if that fails, then just do a standard json conversion |
| asJsonB, err := json.Marshal(&data) |
| if err != nil { |
| Error.Fatalf("Unexpected error while processing command results to JSON: %s", err.Error()) |
| } |
| asJson = string(asJsonB) |
| } |
| fmt.Printf("%s", asJson) |
| } else if result.OutputAs == OUTPUT_YAML { |
| asYaml, err := yaml.Marshal(&data) |
| if err != nil { |
| Error.Fatalf("Unexpected error while processing command results to YAML: %s", err.Error()) |
| } |
| fmt.Printf("%s", asYaml) |
| } |
| } |
| } |