Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Allow flag or file based configuration #620

Merged
merged 10 commits into from
May 26, 2017
10 changes: 10 additions & 0 deletions cmd/createtree/main.go
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,7 @@ import (
"github.com/golang/protobuf/ptypes"
"github.com/golang/protobuf/ptypes/any"
"github.com/google/trillian"
"github.com/google/trillian/cmd"
"github.com/google/trillian/crypto/keyspb"
"github.com/google/trillian/crypto/sigpb"
"google.golang.org/grpc"
Expand All @@ -60,6 +61,8 @@ var (
privateKeyFormat = flag.String("private_key_format", "PEMKeyFile", "Type of private key to be used")
pemKeyPath = flag.String("pem_key_path", "", "Path to the private key PEM file")
pemKeyPassword = flag.String("pem_key_password", "", "Password of the private key PEM file")

configFile = flag.String("config", "", "Config file containing flags, file contents can be overridden by command line flags")
)

// createOpts contains all user-supplied options required to run the program.
Expand Down Expand Up @@ -175,6 +178,13 @@ func newOptsFromFlags() *createOpts {
func main() {
flag.Parse()

if *configFile != "" {
if err := cmd.ParseFlagFile(*configFile); err != nil {
fmt.Fprintf(os.Stderr, "Failed to parse %v: %v\n", *configFile, err)
os.Exit(1)
}
}

ctx := context.Background()
tree, err := createTree(ctx, newOptsFromFlags())
if err != nil {
Expand Down
53 changes: 53 additions & 0 deletions cmd/flags.go
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
// Copyright 2017 Google Inc. All Rights Reserved.
//
// 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 cmd

import (
"errors"
"flag"
"io/ioutil"
"os"

"bitbucket.org/creachadair/shell"
)

// ParseFlagFile parses a set of flags from a file at the provided
// path. Re-calls flag.Parse() after parsing the flags in the file
// so that flags provided on the command line take precedence over
// flags provided in the file.
func ParseFlagFile(path string) error {
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This func could do with some tests.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Done.

file, err := ioutil.ReadFile(path)
if err != nil {
return err
}

// Expand any environment variables in the file
flagsString := os.ExpandEnv(string(file))
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Expanding envvars before splitting might lead to unintended splitting if the envvar value contains spaces, quotation marks, etc. Unfortunately, you might have to instead call os.ExpandEnv() on each of args. A test case could confirm this.


args, valid := shell.Split(flagsString)
if !valid {
return errors.New("flag file contains unclosed quotations")
}

err = flag.CommandLine.Parse(args)
if err != nil {
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These two lines could be combined, e.g. if err := flag.CommandLine.Parse(args); err != nil {

return err
}

// Call flag.Parse() again so that command line flags
// can override flags provided in the provided flag file.
flag.Parse()
return nil
}
13 changes: 13 additions & 0 deletions server/trillian_log_server/main.go
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,9 @@ package main
import (
"context"
"flag"
"fmt"
_ "net/http/pprof"
"os"
"strings"
"time"

Expand All @@ -27,6 +29,7 @@ import (
etcdnaming "github.com/coreos/etcd/clientv3/naming"
"github.com/golang/glog"
"github.com/google/trillian"
"github.com/google/trillian/cmd"
"github.com/google/trillian/crypto/keys"
"github.com/google/trillian/extension"
"github.com/google/trillian/monitoring"
Expand All @@ -48,10 +51,20 @@ var (
etcdServers = flag.String("etcd_servers", "", "A comma-separated list of etcd servers; no etcd registration if empty")
etcdService = flag.String("etcd_service", "trillian-log", "Service name to announce ourselves under")
maxUnsequencedRows = flag.Int("max_unsequenced_rows", mysqlq.DefaultMaxUnsequenced, "Max number of unsequenced rows before rate limiting kicks in")

configFile = flag.String("config", "", "Config file containing flags, file contents can be overridden by command line flags")
)

func main() {
flag.Parse()

if *configFile != "" {
if err := cmd.ParseFlagFile(*configFile); err != nil {
fmt.Fprintf(os.Stderr, "Failed to parse %v: %v\n", *configFile, err)
os.Exit(1)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

glog.Exitf() would be better here.

}
}

ctx := context.Background()

// First make sure we can access the database, quit if not
Expand Down
11 changes: 11 additions & 0 deletions server/trillian_log_signer/main.go
Original file line number Diff line number Diff line change
Expand Up @@ -23,6 +23,7 @@ import (
_ "github.com/go-sql-driver/mysql" // Load MySQL driver

"github.com/golang/glog"
"github.com/google/trillian/cmd"
"github.com/google/trillian/crypto/keys"
"github.com/google/trillian/extension"
"github.com/google/trillian/monitoring/metric"
Expand Down Expand Up @@ -50,10 +51,20 @@ var (
masterCheckInterval = flag.Duration("master_check_interval", 5*time.Second, "Interval between checking mastership still held")
masterHoldInterval = flag.Duration("master_hold_interval", 60*time.Second, "Minimum interval to hold mastership for")
resignOdds = flag.Int("resign_odds", 10, "Chance of resigning mastership after each check, the N in 1-in-N")

configFile = flag.String("config", "", "Config file containing flags, file contents can be overridden by command line flags")
)

func main() {
flag.Parse()

if *configFile != "" {
if err := cmd.ParseFlagFile(*configFile); err != nil {
fmt.Fprintf(os.Stderr, "Failed to parse %v: %v\n", *configFile, err)
os.Exit(1)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

glog.Exitf() would be better here.

}
}

glog.CopyStandardLogTo("WARNING")
glog.Info("**** Log Signer Starting ****")

Expand Down
12 changes: 12 additions & 0 deletions server/vmap/trillian_map_server/main.go
Original file line number Diff line number Diff line change
Expand Up @@ -17,12 +17,15 @@ package main
import (
"context"
"flag"
"fmt"
_ "net/http/pprof"
"os"

_ "github.com/go-sql-driver/mysql" // Load MySQL driver

"github.com/golang/glog"
"github.com/google/trillian"
"github.com/google/trillian/cmd"
"github.com/google/trillian/crypto/keys"
"github.com/google/trillian/extension"
mysqlq "github.com/google/trillian/quota/mysql"
Expand All @@ -39,11 +42,20 @@ var (
rpcEndpoint = flag.String("rpc_endpoint", "localhost:8090", "Endpoint for RPC requests (host:port)")
httpEndpoint = flag.String("http_endpoint", "localhost:8091", "Endpoint for HTTP metrics and REST requests on (host:port, empty means disabled)")
maxUnsequencedRows = flag.Int("max_unsequenced_rows", mysqlq.DefaultMaxUnsequenced, "Max number of unsequenced rows before rate limiting kicks in")

configFile = flag.String("config", "", "Config file containing flags, file contents can be overridden by command line flags")
)

func main() {
flag.Parse()

if *configFile != "" {
if err := cmd.ParseFlagFile(*configFile); err != nil {
fmt.Fprintf(os.Stderr, "Failed to parse %v: %v\n", *configFile, err)
os.Exit(1)
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

glog.Exitf() rather than fmt.Fprintf(), os.Exit(1) would be more consistent with the rest of the file.

}
}

db, err := mysql.OpenDB(*mySQLURI)
if err != nil {
glog.Exitf("Failed to open database: %v", err)
Expand Down