/* Copyright The containerd Authors. 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 shim import ( "context" "flag" "fmt" "io" "os" "runtime" "runtime/debug" "strings" "time" "github.com/containerd/containerd/events" "github.com/containerd/containerd/log" "github.com/containerd/containerd/namespaces" "github.com/containerd/containerd/plugin" shimapi "github.com/containerd/containerd/runtime/v2/task" "github.com/containerd/containerd/version" "github.com/containerd/ttrpc" "github.com/gogo/protobuf/proto" "github.com/pkg/errors" "github.com/sirupsen/logrus" ) // Publisher for events type Publisher interface { events.Publisher io.Closer } // StartOpts describes shim start configuration received from containerd type StartOpts struct { ID string ContainerdBinary string Address string TTRPCAddress string } // Init func for the creation of a shim server type Init func(context.Context, string, Publisher, func()) (Shim, error) // Shim server interface type Shim interface { Cleanup(ctx context.Context) (*shimapi.DeleteResponse, error) StartShim(ctx context.Context, opts StartOpts) (string, error) } // OptsKey is the context key for the Opts value. type OptsKey struct{} // Opts are context options associated with the shim invocation. type Opts struct { BundlePath string Debug bool } // BinaryOpts allows the configuration of a shims binary setup type BinaryOpts func(*Config) // Config of shim binary options provided by shim implementations type Config struct { // NoSubreaper disables setting the shim as a child subreaper NoSubreaper bool // NoReaper disables the shim binary from reaping any child process implicitly NoReaper bool // NoSetupLogger disables automatic configuration of logrus to use the shim FIFO NoSetupLogger bool } type ttrpcService interface { RegisterTTRPC(*ttrpc.Server) error } type taskService struct { local shimapi.TaskService } func (t *taskService) RegisterTTRPC(server *ttrpc.Server) error { shimapi.RegisterTaskService(server, t.local) return nil } var ( debugFlag bool versionFlag bool idFlag string namespaceFlag string socketFlag string bundlePath string addressFlag string containerdBinaryFlag string action string ) const ( ttrpcAddressEnv = "TTRPC_ADDRESS" ) func parseFlags() { flag.BoolVar(&debugFlag, "debug", false, "enable debug output in logs") flag.BoolVar(&versionFlag, "v", false, "show the shim version and exit") flag.StringVar(&namespaceFlag, "namespace", "", "namespace that owns the shim") flag.StringVar(&idFlag, "id", "", "id of the task") flag.StringVar(&socketFlag, "socket", "", "socket path to serve") flag.StringVar(&bundlePath, "bundle", "", "path to the bundle if not workdir") flag.StringVar(&addressFlag, "address", "", "grpc address back to main containerd") flag.StringVar(&containerdBinaryFlag, "publish-binary", "containerd", "path to publish binary (used for publishing events)") flag.Parse() action = flag.Arg(0) } func setRuntime() { debug.SetGCPercent(40) go func() { for range time.Tick(30 * time.Second) { debug.FreeOSMemory() } }() if os.Getenv("GOMAXPROCS") == "" { // If GOMAXPROCS hasn't been set, we default to a value of 2 to reduce // the number of Go stacks present in the shim. runtime.GOMAXPROCS(2) } } func setLogger(ctx context.Context, id string) error { logrus.SetFormatter(&logrus.TextFormatter{ TimestampFormat: log.RFC3339NanoFixed, FullTimestamp: true, }) if debugFlag { logrus.SetLevel(logrus.DebugLevel) } f, err := openLog(ctx, id) if err != nil { return err } logrus.SetOutput(f) return nil } // Run initializes and runs a shim server func Run(id string, initFunc Init, opts ...BinaryOpts) { var config Config for _, o := range opts { o(&config) } if err := run(id, initFunc, config); err != nil { fmt.Fprintf(os.Stderr, "%s: %s\n", id, err) os.Exit(1) } } func run(id string, initFunc Init, config Config) error { parseFlags() if versionFlag { fmt.Printf("%s:\n", os.Args[0]) fmt.Println(" Version: ", version.Version) fmt.Println(" Revision:", version.Revision) fmt.Println(" Go version:", version.GoVersion) fmt.Println("") return nil } if namespaceFlag == "" { return fmt.Errorf("shim namespace cannot be empty") } setRuntime() signals, err := setupSignals(config) if err != nil { return err } if !config.NoSubreaper { if err := subreaper(); err != nil { return err } } ttrpcAddress := os.Getenv(ttrpcAddressEnv) publisher, err := NewPublisher(ttrpcAddress) if err != nil { return err } defer publisher.Close() ctx := namespaces.WithNamespace(context.Background(), namespaceFlag) ctx = context.WithValue(ctx, OptsKey{}, Opts{BundlePath: bundlePath, Debug: debugFlag}) ctx = log.WithLogger(ctx, log.G(ctx).WithField("runtime", id)) ctx, cancel := context.WithCancel(ctx) service, err := initFunc(ctx, idFlag, publisher, cancel) if err != nil { return err } // Handle explicit actions switch action { case "delete": logger := logrus.WithFields(logrus.Fields{ "pid": os.Getpid(), "namespace": namespaceFlag, }) go handleSignals(ctx, logger, signals) response, err := service.Cleanup(ctx) if err != nil { return err } data, err := proto.Marshal(response) if err != nil { return err } if _, err := os.Stdout.Write(data); err != nil { return err } return nil case "start": opts := StartOpts{ ID: idFlag, ContainerdBinary: containerdBinaryFlag, Address: addressFlag, TTRPCAddress: ttrpcAddress, } address, err := service.StartShim(ctx, opts) if err != nil { return err } if _, err := os.Stdout.WriteString(address); err != nil { return err } return nil } if !config.NoSetupLogger { if err := setLogger(ctx, idFlag); err != nil { return err } } // Register event plugin plugin.Register(&plugin.Registration{ Type: plugin.EventPlugin, ID: "publisher", InitFn: func(ic *plugin.InitContext) (interface{}, error) { return publisher, nil }, }) // If service is an implementation of the task service, register it as a plugin if ts, ok := service.(shimapi.TaskService); ok { plugin.Register(&plugin.Registration{ Type: plugin.TTRPCPlugin, ID: "task", InitFn: func(ic *plugin.InitContext) (interface{}, error) { return &taskService{ts}, nil }, }) } var ( initialized = plugin.NewPluginSet() ttrpcServices = []ttrpcService{} ) plugins := plugin.Graph(func(*plugin.Registration) bool { return false }) for _, p := range plugins { id := p.URI() log.G(ctx).WithField("type", p.Type).Infof("loading plugin %q...", id) initContext := plugin.NewContext( ctx, p, initialized, // NOTE: Root is empty since the shim does not support persistent storage, // shim plugins should make use state directory for writing files to disk. // The state directory will be destroyed when the shim if cleaned up or // on reboot "", bundlePath, ) initContext.Address = addressFlag initContext.TTRPCAddress = ttrpcAddress // load the plugin specific configuration if it is provided //TODO: Read configuration passed into shim, or from state directory? //if p.Config != nil { // pc, err := config.Decode(p) // if err != nil { // return nil, err // } // initContext.Config = pc //} result := p.Init(initContext) if err := initialized.Add(result); err != nil { return errors.Wrapf(err, "could not add plugin result to plugin set") } instance, err := result.Instance() if err != nil { if plugin.IsSkipPlugin(err) { log.G(ctx).WithError(err).WithField("type", p.Type).Infof("skip loading plugin %q...", id) } else { log.G(ctx).WithError(err).Warnf("failed to load plugin %s", id) } continue } if src, ok := instance.(ttrpcService); ok { logrus.WithField("id", id).Debug("registering ttrpc service") ttrpcServices = append(ttrpcServices, src) } } server, err := newServer() if err != nil { return errors.Wrap(err, "failed creating server") } for _, srv := range ttrpcServices { if err := srv.RegisterTTRPC(server); err != nil { return errors.Wrap(err, "failed to register service") } } if err := serve(ctx, server, signals); err != nil { if err != context.Canceled { return err } } // NOTE: If the shim server is down(like oom killer), the address // socket might be leaking. if address, err := ReadAddress("address"); err == nil { _ = RemoveSocket(address) } select { case <-publisher.Done(): return nil case <-time.After(5 * time.Second): return errors.New("publisher not closed") } } // serve serves the ttrpc API over a unix socket in the current working directory // and blocks until the context is canceled func serve(ctx context.Context, server *ttrpc.Server, signals chan os.Signal) error { dump := make(chan os.Signal, 32) setupDumpStacks(dump) path, err := os.Getwd() if err != nil { return err } l, err := serveListener(socketFlag) if err != nil { return err } go func() { defer l.Close() if err := server.Serve(ctx, l); err != nil && !strings.Contains(err.Error(), "use of closed network connection") { logrus.WithError(err).Fatal("containerd-shim: ttrpc server failure") } }() logger := logrus.WithFields(logrus.Fields{ "pid": os.Getpid(), "path": path, "namespace": namespaceFlag, }) go func() { for range dump { dumpStacks(logger) } }() return handleSignals(ctx, logger, signals) } func dumpStacks(logger *logrus.Entry) { var ( buf []byte stackSize int ) bufferLen := 16384 for stackSize == len(buf) { buf = make([]byte, bufferLen) stackSize = runtime.Stack(buf, true) bufferLen *= 2 } buf = buf[:stackSize] logger.Infof("=== BEGIN goroutine stack dump ===\n%s\n=== END goroutine stack dump ===", buf) }