package cli import ( "log" "time" "github.com/portainer/portainer" "os" "strings" "gopkg.in/alecthomas/kingpin.v2" ) // Service implements the CLIService interface type Service struct{} const ( errInvalidEndpointProtocol = portainer.Error("Invalid endpoint protocol: Portainer only supports unix:// or tcp://") errSocketNotFound = portainer.Error("Unable to locate Unix socket") errEndpointsFileNotFound = portainer.Error("Unable to locate external endpoints file") errInvalidSyncInterval = portainer.Error("Invalid synchronization interval") errEndpointExcludeExternal = portainer.Error("Cannot use the -H flag mutually with --external-endpoints") errNoAuthExcludeAdminPassword = portainer.Error("Cannot use --no-auth with --admin-password") ) // ParseFlags parse the CLI flags and return a portainer.Flags struct func (*Service) ParseFlags(version string) (*portainer.CLIFlags, error) { kingpin.Version(version) flags := &portainer.CLIFlags{ Endpoint: kingpin.Flag("host", "Dockerd endpoint").Short('H').String(), ExternalEndpoints: kingpin.Flag("external-endpoints", "Path to a file defining available endpoints").String(), SyncInterval: kingpin.Flag("sync-interval", "Duration between each synchronization via the external endpoints source").Default(defaultSyncInterval).String(), Addr: kingpin.Flag("bind", "Address and port to serve Portainer").Default(defaultBindAddress).Short('p').String(), Assets: kingpin.Flag("assets", "Path to the assets").Default(defaultAssetsDirectory).Short('a').String(), Data: kingpin.Flag("data", "Path to the folder where the data is stored").Default(defaultDataDirectory).Short('d').String(), NoAuth: kingpin.Flag("no-auth", "Disable authentication").Default(defaultNoAuth).Bool(), NoAnalytics: kingpin.Flag("no-analytics", "Disable Analytics in app").Default(defaultNoAuth).Bool(), TLSVerify: kingpin.Flag("tlsverify", "TLS support").Default(defaultTLSVerify).Bool(), TLSCacert: kingpin.Flag("tlscacert", "Path to the CA").Default(defaultTLSCACertPath).String(), TLSCert: kingpin.Flag("tlscert", "Path to the TLS certificate file").Default(defaultTLSCertPath).String(), TLSKey: kingpin.Flag("tlskey", "Path to the TLS key").Default(defaultTLSKeyPath).String(), SSL: kingpin.Flag("ssl", "Secure Portainer instance using SSL").Default(defaultSSL).Bool(), SSLCert: kingpin.Flag("sslcert", "Path to the SSL certificate used to secure the Portainer instance").Default(defaultSSLCertPath).String(), SSLKey: kingpin.Flag("sslkey", "Path to the SSL key used to secure the Portainer instance").Default(defaultSSLKeyPath).String(), AdminPassword: kingpin.Flag("admin-password", "Hashed admin password").String(), // Deprecated flags Labels: pairs(kingpin.Flag("hide-label", "Hide containers with a specific label in the UI").Short('l')), Logo: kingpin.Flag("logo", "URL for the logo displayed in the UI").String(), Templates: kingpin.Flag("templates", "URL to the templates (apps) definitions").Short('t').String(), } kingpin.Parse() return flags, nil } // ValidateFlags validates the values of the flags. func (*Service) ValidateFlags(flags *portainer.CLIFlags) error { if *flags.Endpoint != "" && *flags.ExternalEndpoints != "" { return errEndpointExcludeExternal } err := validateEndpoint(*flags.Endpoint) if err != nil { return err } err = validateExternalEndpoints(*flags.ExternalEndpoints) if err != nil { return err } err = validateSyncInterval(*flags.SyncInterval) if err != nil { return err } if *flags.NoAuth && (*flags.AdminPassword != "") { return errNoAuthExcludeAdminPassword } displayDeprecationWarnings(*flags.Templates, *flags.Logo, *flags.Labels) return nil } func validateEndpoint(endpoint string) error { if endpoint != "" { if !strings.HasPrefix(endpoint, "unix://") && !strings.HasPrefix(endpoint, "tcp://") { return errInvalidEndpointProtocol } if strings.HasPrefix(endpoint, "unix://") { socketPath := strings.TrimPrefix(endpoint, "unix://") if _, err := os.Stat(socketPath); err != nil { if os.IsNotExist(err) { return errSocketNotFound } return err } } } return nil } func validateExternalEndpoints(externalEndpoints string) error { if externalEndpoints != "" { if _, err := os.Stat(externalEndpoints); err != nil { if os.IsNotExist(err) { return errEndpointsFileNotFound } return err } } return nil } func validateSyncInterval(syncInterval string) error { if syncInterval != defaultSyncInterval { _, err := time.ParseDuration(syncInterval) if err != nil { return errInvalidSyncInterval } } return nil } func displayDeprecationWarnings(templates, logo string, labels []portainer.Pair) { if templates != "" { log.Println("Warning: the --templates / -t flag is deprecated and will be removed in future versions.") } if logo != "" { log.Println("Warning: the --logo flag is deprecated and will be removed in future versions.") } if labels != nil { log.Println("Warning: the --hide-label / -l flag is deprecated and will be removed in future versions.") } }