package diagnostics import ( "fmt" "io" "os" "runtime/debug" "github.com/spf13/cobra" kcmdutil "k8s.io/kubernetes/pkg/kubectl/cmd/util" kutilerrors "k8s.io/kubernetes/pkg/util/errors" "k8s.io/kubernetes/pkg/util/sets" "github.com/openshift/origin/pkg/cmd/admin/diagnostics/options" "github.com/openshift/origin/pkg/cmd/admin/diagnostics/util" "github.com/openshift/origin/pkg/cmd/templates" "github.com/openshift/origin/pkg/diagnostics/log" poddiag "github.com/openshift/origin/pkg/diagnostics/pod" "github.com/openshift/origin/pkg/diagnostics/types" ) // PodDiagnosticsOptions holds values received from environment variables // for the command to operate. type PodDiagnosticsOptions struct { // list of diagnostic names to limit what is run RequestedDiagnostics []string // LogOptions determine globally what the user wants to see and how. LogOptions *log.LoggerOptions // The Logger is built with the options and should be used for all diagnostic output. Logger *log.Logger } const ( // Standard locations for the secrets mounted in pods StandardMasterCaPath = "/var/run/secrets/kubernetes.io/serviceaccount/ca.crt" StandardTokenPath = "/var/run/secrets/kubernetes.io/serviceaccount/token" StandardMasterUrl = "https://kubernetes.default.svc.cluster.local" ) var longPodDiagDescription = templates.LongDesc(` This utility is intended to run diagnostics inside a container and log the results so that the calling diagnostic can report them.`) // NewCommandPodDiagnostics is the command for running pod diagnostics. func NewCommandPodDiagnostics(name string, out io.Writer) *cobra.Command { o := &PodDiagnosticsOptions{ RequestedDiagnostics: []string{}, LogOptions: &log.LoggerOptions{Out: out}, } cmd := &cobra.Command{ Use: name, Short: "Within a pod, run pod diagnostics", Long: fmt.Sprintf(longPodDiagDescription), Run: func(c *cobra.Command, args []string) { kcmdutil.CheckErr(o.Complete(args)) failed, err, warnCount, errorCount := o.BuildAndRunDiagnostics() o.Logger.Summary(warnCount, errorCount) kcmdutil.CheckErr(err) if failed { os.Exit(255) } }, } cmd.SetOutput(out) // for output re: usage / help options.BindLoggerOptionFlags(cmd.Flags(), o.LogOptions, options.RecommendedLoggerOptionFlags()) return cmd } // Complete fills in PodDiagnosticsOptions needed if the command is actually invoked. func (o *PodDiagnosticsOptions) Complete(args []string) error { var err error o.Logger, err = o.LogOptions.NewLogger() if err != nil { return err } o.RequestedDiagnostics = append(o.RequestedDiagnostics, args...) if len(o.RequestedDiagnostics) == 0 { o.RequestedDiagnostics = availablePodDiagnostics.List() } return nil } // BuildAndRunDiagnostics builds diagnostics based on the options and executes them, returning a summary. func (o PodDiagnosticsOptions) BuildAndRunDiagnostics() (bool, error, int, int) { failed := false errors := []error{} diagnostics := []types.Diagnostic{} func() { // don't trust discovery/build of diagnostics; wrap panic nicely in case of developer error defer func() { if r := recover(); r != nil { failed = true stack := debug.Stack() errors = append(errors, fmt.Errorf("While building the diagnostics, a panic was encountered.\nThis is a bug in diagnostics. Error and stack trace follow: \n%v\n%s", r, stack)) } }() // deferred panic handler podDiags, ok, err := o.buildPodDiagnostics() failed = failed || !ok if ok { diagnostics = append(diagnostics, podDiags...) } if err != nil { errors = append(errors, err...) } }() if failed { return failed, kutilerrors.NewAggregate(errors), 0, len(errors) } failed, err, numWarnings, numErrors := util.RunDiagnostics(o.Logger, diagnostics, 0, len(errors)) return failed, err, numWarnings, numErrors } var ( // availablePodDiagnostics contains the names of host diagnostics that can be executed // during a single run of diagnostics. Add more diagnostics to the list as they are defined. availablePodDiagnostics = sets.NewString(poddiag.PodCheckDnsName, poddiag.PodCheckAuthName) ) // buildPodDiagnostics builds host Diagnostic objects based on the host environment. // Returns the Diagnostics built, "ok" bool for whether to proceed or abort, and an error if any was encountered during the building of diagnostics. func (o PodDiagnosticsOptions) buildPodDiagnostics() ([]types.Diagnostic, bool, []error) { diagnostics := []types.Diagnostic{} err, requestedDiagnostics := util.DetermineRequestedDiagnostics(availablePodDiagnostics.List(), o.RequestedDiagnostics, o.Logger) if err != nil { return diagnostics, false, []error{err} // don't waste time on discovery } // TODO: check we're actually in a container for _, diagnosticName := range requestedDiagnostics { switch diagnosticName { case poddiag.PodCheckDnsName: diagnostics = append(diagnostics, poddiag.PodCheckDns{}) case poddiag.PodCheckAuthName: diagnostics = append(diagnostics, poddiag.PodCheckAuth{ MasterCaPath: StandardMasterCaPath, TokenPath: StandardTokenPath, MasterUrl: StandardMasterUrl, }) default: return diagnostics, false, []error{fmt.Errorf("unknown diagnostic: %v", diagnosticName)} } } return diagnostics, true, nil }