/* Copyright 2016 The Fission 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 executor import ( "context" "fmt" "net/http" "os" "strconv" "strings" "sync" "time" "github.com/dchest/uniuri" "github.com/pkg/errors" "github.com/prometheus/client_golang/prometheus/promhttp" "go.uber.org/zap" k8sInformers "k8s.io/client-go/informers" k8sCache "k8s.io/client-go/tools/cache" fv1 "github.com/fission/fission/pkg/apis/core/v1" "github.com/fission/fission/pkg/crd" "github.com/fission/fission/pkg/executor/cms" "github.com/fission/fission/pkg/executor/executortype" "github.com/fission/fission/pkg/executor/executortype/container" "github.com/fission/fission/pkg/executor/executortype/newdeploy" "github.com/fission/fission/pkg/executor/executortype/poolmgr" "github.com/fission/fission/pkg/executor/fscache" "github.com/fission/fission/pkg/executor/reaper" "github.com/fission/fission/pkg/executor/util" fetcherConfig "github.com/fission/fission/pkg/fetcher/config" genInformer "github.com/fission/fission/pkg/generated/informers/externalversions" "github.com/fission/fission/pkg/utils" otelUtils "github.com/fission/fission/pkg/utils/otel" ) type ( // Executor defines a fission function executor. Executor struct { logger *zap.Logger executorTypes map[fv1.ExecutorType]executortype.ExecutorType cms *cms.ConfigSecretController fissionClient *crd.FissionClient requestChan chan *createFuncServiceRequest fsCreateWg sync.Map } createFuncServiceRequest struct { context context.Context function *fv1.Function respChan chan *createFuncServiceResponse } createFuncServiceResponse struct { funcSvc *fscache.FuncSvc err error } ) // MakeExecutor returns an Executor for given ExecutorType(s). func MakeExecutor(ctx context.Context, logger *zap.Logger, cms *cms.ConfigSecretController, fissionClient *crd.FissionClient, types map[fv1.ExecutorType]executortype.ExecutorType, informers []k8sCache.SharedIndexInformer) (*Executor, error) { executor := &Executor{ logger: logger.Named("executor"), cms: cms, fissionClient: fissionClient, executorTypes: types, requestChan: make(chan *createFuncServiceRequest), } // Run all informers for _, informer := range informers { go informer.Run(ctx.Done()) } for _, et := range types { go func(et executortype.ExecutorType) { et.Run(ctx) }(et) } go executor.serveCreateFuncServices() return executor, nil } // All non-cached function service requests go through this goroutine // serially. It parallelizes requests for different functions, and // ensures that for a given function, only one request causes a pod to // get specialized. In other words, it ensures that when there's an // ongoing request for a certain function, all other requests wait for // that request to complete. func (executor *Executor) serveCreateFuncServices() { for { req := <-executor.requestChan fnMetadata := &req.function.ObjectMeta if req.function.Spec.InvokeStrategy.ExecutionStrategy.ExecutorType == fv1.ExecutorTypePoolmgr { go func() { buffer := 10 // add some buffer time for specialization specializationTimeout := req.function.Spec.InvokeStrategy.ExecutionStrategy.SpecializationTimeout // set minimum specialization timeout to avoid illegal input and // compatibility problem when applying old spec file that doesn't // have specialization timeout field. if specializationTimeout < fv1.DefaultSpecializationTimeOut { specializationTimeout = fv1.DefaultSpecializationTimeOut } fnSpecializationTimeoutContext, cancel := context.WithTimeout(req.context, time.Duration(specializationTimeout+buffer)*time.Second) defer cancel() fsvc, err := executor.createServiceForFunction(fnSpecializationTimeoutContext, req.function) req.respChan <- &createFuncServiceResponse{ funcSvc: fsvc, err: err, } }() continue } // Cache miss -- is this first one to request the func? wg, found := executor.fsCreateWg.Load(crd.CacheKey(fnMetadata)) if !found { // create a waitgroup for other requests for // the same function to wait on wg := &sync.WaitGroup{} wg.Add(1) executor.fsCreateWg.Store(crd.CacheKey(fnMetadata), wg) // launch a goroutine for each request, to parallelize // the specialization of different functions go func() { // Control overall specialization time by setting function // specialization time to context. The reason not to use // context from router requests is because a request maybe // canceled for unknown reasons and let executor keeps // spawning pods that never finish specialization process. // Also, even a request failed, a specialized function pod // still can serve other subsequent requests. buffer := 10 // add some buffer time for specialization specializationTimeout := req.function.Spec.InvokeStrategy.ExecutionStrategy.SpecializationTimeout // set minimum specialization timeout to avoid illegal input and // compatibility problem when applying old spec file that doesn't // have specialization timeout field. if specializationTimeout < fv1.DefaultSpecializationTimeOut { specializationTimeout = fv1.DefaultSpecializationTimeOut } fnSpecializationTimeoutContext, cancel := context.WithTimeout(req.context, time.Duration(specializationTimeout+buffer)*time.Second) defer cancel() fsvc, err := executor.createServiceForFunction(fnSpecializationTimeoutContext, req.function) req.respChan <- &createFuncServiceResponse{ funcSvc: fsvc, err: err, } executor.fsCreateWg.Delete(crd.CacheKey(fnMetadata)) wg.Done() }() } else { // There's an existing request for this function, wait for it to finish go func() { executor.logger.Debug("waiting for concurrent request for the same function", zap.Any("function", fnMetadata)) wg, ok := wg.(*sync.WaitGroup) if !ok { err := fmt.Errorf("could not convert value to workgroup for function %v in namespace %v", fnMetadata.Name, fnMetadata.Namespace) req.respChan <- &createFuncServiceResponse{ funcSvc: nil, err: err, } } wg.Wait() // get the function service from the cache fsvc, err := executor.getFunctionServiceFromCache(req.context, req.function) // fsCache return error when the entry does not exist/expire. // It normally happened if there are multiple requests are // waiting for the same function and executor failed to cre- // ate service for function. err = errors.Wrapf(err, "error getting service for function %v in namespace %v", fnMetadata.Name, fnMetadata.Namespace) req.respChan <- &createFuncServiceResponse{ funcSvc: fsvc, err: err, } }() } } } func (executor *Executor) createServiceForFunction(ctx context.Context, fn *fv1.Function) (*fscache.FuncSvc, error) { logger := otelUtils.LoggerWithTraceID(ctx, executor.logger) otelUtils.SpanTrackEvent(ctx, "createServiceForFunction", otelUtils.GetAttributesForFunction(fn)...) logger.Debug("no cached function service found, creating one", zap.String("function_name", fn.ObjectMeta.Name), zap.String("function_namespace", fn.ObjectMeta.Namespace)) t := fn.Spec.InvokeStrategy.ExecutionStrategy.ExecutorType e, ok := executor.executorTypes[t] if !ok { return nil, errors.Errorf("Unknown executor type '%v'", t) } fsvc, fsvcErr := e.GetFuncSvc(ctx, fn) if fsvcErr != nil { e := "error creating service for function" logger.Error(e, zap.Error(fsvcErr), zap.String("function_name", fn.ObjectMeta.Name), zap.String("function_namespace", fn.ObjectMeta.Namespace)) fsvcErr = errors.Wrap(fsvcErr, fmt.Sprintf("[%s] %s", fn.ObjectMeta.Name, e)) } return fsvc, fsvcErr } func (executor *Executor) getFunctionServiceFromCache(ctx context.Context, fn *fv1.Function) (*fscache.FuncSvc, error) { otelUtils.SpanTrackEvent(ctx, "getFunctionServiceFromCache", otelUtils.GetAttributesForFunction(fn)...) t := fn.Spec.InvokeStrategy.ExecutionStrategy.ExecutorType e, ok := executor.executorTypes[t] if !ok { return nil, errors.Errorf("Unknown executor type '%v'", t) } return e.GetFuncSvcFromCache(ctx, fn) } func serveMetric(logger *zap.Logger) { // Expose the registered metrics via HTTP. metricAddr := ":8080" http.Handle("/metrics", promhttp.Handler()) err := http.ListenAndServe(metricAddr, nil) logger.Fatal("done listening on metrics endpoint", zap.Error(err)) } // StartExecutor Starts executor and the executor components such as Poolmgr, // deploymgr and potential future executor types func StartExecutor(ctx context.Context, logger *zap.Logger, functionNamespace string, envBuilderNamespace string, port int, openTracingEnabled bool) error { fissionClient, kubernetesClient, _, metricsClient, err := crd.MakeFissionClient() if err != nil { return errors.Wrap(err, "failed to get kubernetes client") } err = fissionClient.WaitForCRDs() if err != nil { return errors.Wrap(err, "error waiting for CRDs") } fetcherConfig, err := fetcherConfig.MakeFetcherConfig("/userfunc") if err != nil { return errors.Wrap(err, "Error making fetcher config") } executorInstanceID := strings.ToLower(uniuri.NewLen(8)) logger.Info("Starting executor", zap.String("instanceID", executorInstanceID)) informerFactory := genInformer.NewSharedInformerFactory(fissionClient, time.Minute*30) funcInformer := informerFactory.Core().V1().Functions() pkgInformer := informerFactory.Core().V1().Packages() envInformer := informerFactory.Core().V1().Environments() gpmInformerFactory, err := utils.GetInformerFactoryByExecutor(kubernetesClient, fv1.ExecutorTypePoolmgr, time.Minute*30) if err != nil { return err } gpmPodInformer := gpmInformerFactory.Core().V1().Pods() gpmRsInformer := gpmInformerFactory.Apps().V1().ReplicaSets() gpm, err := poolmgr.MakeGenericPoolManager( logger, fissionClient, kubernetesClient, metricsClient, functionNamespace, fetcherConfig, executorInstanceID, funcInformer, pkgInformer, envInformer, gpmPodInformer, gpmRsInformer) if err != nil { return errors.Wrap(err, "pool manager creation failed") } ndmInformerFactory, err := utils.GetInformerFactoryByExecutor(kubernetesClient, fv1.ExecutorTypeNewdeploy, time.Minute*30) if err != nil { return err } ndmDeplInformer := ndmInformerFactory.Apps().V1().Deployments() ndmSvcInformer := ndmInformerFactory.Core().V1().Services() ndm, err := newdeploy.MakeNewDeploy( logger, fissionClient, kubernetesClient, functionNamespace, fetcherConfig, executorInstanceID, funcInformer, envInformer, ndmDeplInformer, ndmSvcInformer) if err != nil { return errors.Wrap(err, "new deploy manager creation failed") } cnmInformerFactory, err := utils.GetInformerFactoryByExecutor(kubernetesClient, fv1.ExecutorTypeContainer, time.Minute*30) if err != nil { return err } cnmDeplInformer := cnmInformerFactory.Apps().V1().Deployments() cnmSvcInformer := cnmInformerFactory.Core().V1().Services() cnm, err := container.MakeContainer( ctx, logger, fissionClient, kubernetesClient, functionNamespace, executorInstanceID, funcInformer, cnmDeplInformer, cnmSvcInformer) if err != nil { return errors.Wrap(err, "container manager creation failed") } executorTypes := make(map[fv1.ExecutorType]executortype.ExecutorType) executorTypes[gpm.GetTypeName(ctx)] = gpm executorTypes[ndm.GetTypeName(ctx)] = ndm executorTypes[cnm.GetTypeName(ctx)] = cnm adoptExistingResources, _ := strconv.ParseBool(os.Getenv("ADOPT_EXISTING_RESOURCES")) wg := &sync.WaitGroup{} for _, et := range executorTypes { wg.Add(1) go func(et executortype.ExecutorType) { defer wg.Done() if adoptExistingResources { et.AdoptExistingResources(ctx) } et.CleanupOldExecutorObjects(ctx) }(et) } // set hard timeout for resource adoption // TODO: use context to control the waiting time once kubernetes client supports it. util.WaitTimeout(wg, 30*time.Second) k8sInformerFactory := k8sInformers.NewSharedInformerFactory(kubernetesClient, time.Minute*30) configmapInformer := k8sInformerFactory.Core().V1().ConfigMaps() secretInformer := k8sInformerFactory.Core().V1().Secrets() cms := cms.MakeConfigSecretController(ctx, logger, fissionClient, kubernetesClient, executorTypes, configmapInformer, secretInformer) api, err := MakeExecutor(ctx, logger, cms, fissionClient, executorTypes, []k8sCache.SharedIndexInformer{ funcInformer.Informer(), pkgInformer.Informer(), envInformer.Informer(), configmapInformer.Informer(), secretInformer.Informer(), gpmPodInformer.Informer(), gpmRsInformer.Informer(), ndmDeplInformer.Informer(), ndmSvcInformer.Informer(), cnmDeplInformer.Informer(), cnmSvcInformer.Informer(), }) if err != nil { return err } go reaper.CleanupRoleBindings(ctx, logger, kubernetesClient, fissionClient, functionNamespace, envBuilderNamespace, time.Minute*30) go api.Serve(port, openTracingEnabled) go serveMetric(logger) return nil }