/* Copyright 2020 Gravitational, Inc. 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 common import ( "context" "os" "text/template" "github.com/gravitational/kingpin" "github.com/gravitational/trace" "github.com/gravitational/teleport" "github.com/gravitational/teleport/api/client" "github.com/gravitational/teleport/api/client/proto" "github.com/gravitational/teleport/api/types" "github.com/gravitational/teleport/lib/auth" libclient "github.com/gravitational/teleport/lib/client" "github.com/gravitational/teleport/lib/service/servicecfg" "github.com/gravitational/teleport/lib/utils" ) // DBCommand implements "tctl db" group of commands. type DBCommand struct { config *servicecfg.Config // format is the output format (text, json or yaml). format string searchKeywords string predicateExpr string labels string // verbose sets whether full table output should be shown for labels verbose bool // dbList implements the "tctl db ls" subcommand. dbList *kingpin.CmdClause } // Initialize allows DBCommand to plug itself into the CLI parser. func (c *DBCommand) Initialize(app *kingpin.Application, config *servicecfg.Config) { c.config = config db := app.Command("db", "Operate on databases registered with the cluster.") c.dbList = db.Command("ls", "List all databases registered with the cluster.") c.dbList.Flag("format", "Output format, 'text', 'json', or 'yaml'").Default(teleport.Text).StringVar(&c.format) c.dbList.Arg("labels", labelHelp).StringVar(&c.labels) c.dbList.Flag("search", searchHelp).StringVar(&c.searchKeywords) c.dbList.Flag("query", queryHelp).StringVar(&c.predicateExpr) c.dbList.Flag("verbose", "Verbose table output, shows full label output").Short('v').BoolVar(&c.verbose) } // TryRun attempts to run subcommands like "db ls". func (c *DBCommand) TryRun(ctx context.Context, cmd string, client auth.ClientI) (match bool, err error) { switch cmd { case c.dbList.FullCommand(): err = c.ListDatabases(ctx, client) default: return false, nil } return true, trace.Wrap(err) } // ListDatabases prints the list of database proxies that have recently sent // heartbeats to the cluster. func (c *DBCommand) ListDatabases(ctx context.Context, clt auth.ClientI) error { labels, err := libclient.ParseLabelSpec(c.labels) if err != nil { return trace.Wrap(err) } var servers []types.DatabaseServer resources, err := client.GetResourcesWithFilters(ctx, clt, proto.ListResourcesRequest{ ResourceType: types.KindDatabaseServer, Labels: labels, PredicateExpression: c.predicateExpr, SearchKeywords: libclient.ParseSearchKeywords(c.searchKeywords, ','), }) switch { case err != nil: if utils.IsPredicateError(err) { return trace.Wrap(utils.PredicateError{Err: err}) } return trace.Wrap(err) default: servers, err = types.ResourcesWithLabels(resources).AsDatabaseServers() if err != nil { return trace.Wrap(err) } } coll := &databaseServerCollection{servers: servers, verbose: c.verbose} switch c.format { case teleport.Text: return trace.Wrap(coll.writeText(os.Stdout)) case teleport.JSON: return trace.Wrap(coll.writeJSON(os.Stdout)) case teleport.YAML: return trace.Wrap(coll.writeYAML(os.Stdout)) default: return trace.BadParameter("unknown format %q", c.format) } } var dbMessageTemplate = template.Must(template.New("db").Parse(`The invite token: {{.token}} This token will expire in {{.minutes}} minutes. Fill out and run this command on a node to start proxying the database: > teleport db start \ --token={{.token}} \{{range .ca_pins}} --ca-pin={{.}} \{{end}} --auth-server={{.auth_server}} \ --name={{.db_name}} \ --protocol={{.db_protocol}} \ --uri={{.db_uri}} Or, generate the configuration and start a Teleport agent using it: > teleport db configure create \ --token={{.token}} \{{range .ca_pins}} --ca-pin={{.}} \{{end}} --proxy={{.auth_server}} \ --name={{.db_name}} \ --protocol={{.db_protocol}} \ --uri={{.db_uri}} \ --output file:///etc/teleport.yaml > teleport start -c /etc/teleport.yaml Please note: - This invitation token will expire in {{.minutes}} minutes. - Database address {{.db_uri}} must be reachable from the new database service. - When proxying an on-prem database, it must be configured with Teleport CA and key pair issued by "tctl auth sign --format=db" command. - When proxying an AWS RDS or Aurora database, the region must also be specified with --db-aws-region flag. `))