/* * Copyright 2020 Intel Corporation, 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 module import ( "encoding/base64" "encoding/json" "fmt" "time" gpic "github.com/onap/multicloud-k8s/src/orchestrator/pkg/gpic" "github.com/onap/multicloud-k8s/src/orchestrator/pkg/infra/db" log "github.com/onap/multicloud-k8s/src/orchestrator/pkg/infra/logutils" "github.com/onap/multicloud-k8s/src/orchestrator/pkg/state" "github.com/onap/multicloud-k8s/src/orchestrator/pkg/status" "github.com/onap/multicloud-k8s/src/orchestrator/utils/helm" pkgerrors "github.com/pkg/errors" ) // ManifestFileName is the name given to the manifest file in the profile package const ManifestFileName = "manifest.yaml" // GenericPlacementIntentName denotes the generic placement intent name const GenericPlacementIntentName = "genericPlacementIntent" // SEPARATOR used while creating clusternames to store in etcd const SEPARATOR = "+" // InstantiationClient implements the InstantiationManager type InstantiationClient struct { db InstantiationClientDbInfo } type DeploymentStatus struct { Project string `json:"project,omitempty"` CompositeAppName string `json:"composite-app-name,omitempty"` CompositeAppVersion string `json:"composite-app-version,omitempty"` CompositeProfileName string `json:"composite-profile-name,omitempty"` status.StatusResult `json:",inline"` } /* InstantiationKey used in storing the contextid in the momgodb It consists of ProjectName, CompositeAppName, CompositeAppVersion, DeploymentIntentGroup */ type InstantiationKey struct { Project string CompositeApp string Version string DeploymentIntentGroup string } // InstantiationManager is an interface which exposes the // InstantiationManager functionalities type InstantiationManager interface { Approve(p string, ca string, v string, di string) error Instantiate(p string, ca string, v string, di string) error Status(p, ca, v, di, qInstance, qType, qOutput string, qApps, qClusters, qResources []string) (DeploymentStatus, error) Terminate(p string, ca string, v string, di string) error } // InstantiationClientDbInfo consists of storeName and tagState type InstantiationClientDbInfo struct { storeName string // name of the mongodb collection to use for Instantiationclient documents tagState string // attribute key name for context object in App Context } // NewInstantiationClient returns an instance of InstantiationClient func NewInstantiationClient() *InstantiationClient { return &InstantiationClient{ db: InstantiationClientDbInfo{ storeName: "orchestrator", tagState: "stateInfo", }, } } //Approve approves an instantiation func (c InstantiationClient) Approve(p string, ca string, v string, di string) error { s, err := NewDeploymentIntentGroupClient().GetDeploymentIntentGroupState(di, p, ca, v) if err != nil { return pkgerrors.Wrap(err, "DeploymentIntentGroup has no state info: "+di) } stateVal, err := state.GetCurrentStateFromStateInfo(s) if err != nil { return pkgerrors.Errorf("Error getting current state from DeploymentIntentGroup stateInfo: " + di) } switch stateVal { case state.StateEnum.Approved: return nil case state.StateEnum.Terminated: break case state.StateEnum.Created: break case state.StateEnum.Applied: return pkgerrors.Errorf("DeploymentIntentGroup is in an invalid state" + stateVal) case state.StateEnum.Instantiated: return pkgerrors.Errorf("DeploymentIntentGroup has already been instantiated" + di) default: return pkgerrors.Errorf("DeploymentIntentGroup is in an unknown state" + stateVal) } key := DeploymentIntentGroupKey{ Name: di, Project: p, CompositeApp: ca, Version: v, } a := state.ActionEntry{ State: state.StateEnum.Approved, ContextId: "", TimeStamp: time.Now(), } s.Actions = append(s.Actions, a) err = db.DBconn.Insert(c.db.storeName, key, nil, c.db.tagState, s) if err != nil { return pkgerrors.Wrap(err, "Error updating the stateInfo of the DeploymentIntentGroup: "+di) } return nil } func getOverrideValuesByAppName(ov []OverrideValues, a string) map[string]string { for _, eachOverrideVal := range ov { if eachOverrideVal.AppName == a { return eachOverrideVal.ValuesObj } } return map[string]string{} } /* findGenericPlacementIntent takes in projectName, CompositeAppName, CompositeAppVersion, DeploymentIntentName and returns the name of the genericPlacementIntentName. Returns empty value if string not found. */ func findGenericPlacementIntent(p, ca, v, di string) (string, error) { var gi string iList, err := NewIntentClient().GetAllIntents(p, ca, v, di) if err != nil { return gi, err } for _, eachMap := range iList.ListOfIntents { if gi, found := eachMap[GenericPlacementIntentName]; found { log.Info(":: Name of the generic-placement-intent found ::", log.Fields{"GenPlmtIntent": gi}) return gi, nil } } log.Info(":: generic-placement-intent not found ! ::", log.Fields{"Searched for GenPlmtIntent": GenericPlacementIntentName}) return gi, pkgerrors.New("Generic-placement-intent not found") } // GetSortedTemplateForApp returns the sorted templates. //It takes in arguments - appName, project, compositeAppName, releaseName, compositeProfileName, array of override values func GetSortedTemplateForApp(appName, p, ca, v, rName, cp string, overrideValues []OverrideValues) ([]helm.KubernetesResourceTemplate, error) { log.Info(":: Processing App ::", log.Fields{"appName": appName}) var sortedTemplates []helm.KubernetesResourceTemplate aC, err := NewAppClient().GetAppContent(appName, p, ca, v) if err != nil { return sortedTemplates, pkgerrors.Wrap(err, fmt.Sprint("Not finding the content of app:: ", appName)) } appContent, err := base64.StdEncoding.DecodeString(aC.FileContent) if err != nil { return sortedTemplates, pkgerrors.Wrap(err, "Fail to convert to byte array") } log.Info(":: Got the app content.. ::", log.Fields{"appName": appName}) appPC, err := NewAppProfileClient().GetAppProfileContentByApp(p, ca, v, cp, appName) if err != nil { return sortedTemplates, pkgerrors.Wrap(err, fmt.Sprintf("Not finding the appProfileContent for:: %s", appName)) } appProfileContent, err := base64.StdEncoding.DecodeString(appPC.Profile) if err != nil { return sortedTemplates, pkgerrors.Wrap(err, "Fail to convert to byte array") } log.Info(":: Got the app Profile content .. ::", log.Fields{"appName": appName}) overrideValuesOfApp := getOverrideValuesByAppName(overrideValues, appName) //Convert override values from map to array of strings of the following format //foo=bar overrideValuesOfAppStr := []string{} if overrideValuesOfApp != nil { for k, v := range overrideValuesOfApp { overrideValuesOfAppStr = append(overrideValuesOfAppStr, k+"="+v) } } sortedTemplates, err = helm.NewTemplateClient("", "default", rName, ManifestFileName).Resolve(appContent, appProfileContent, overrideValuesOfAppStr, appName) log.Info(":: Total no. of sorted templates ::", log.Fields{"len(sortedTemplates):": len(sortedTemplates)}) return sortedTemplates, err } /* Instantiate methods takes in projectName, compositeAppName, compositeAppVersion, DeploymentIntentName. This method is responsible for template resolution, intent resolution, creation and saving of context for saving into etcd. */ func (c InstantiationClient) Instantiate(p string, ca string, v string, di string) error { dIGrp, err := NewDeploymentIntentGroupClient().GetDeploymentIntentGroup(di, p, ca, v) if err != nil { return pkgerrors.Wrap(err, "Not finding the deploymentIntentGroup") } s, err := NewDeploymentIntentGroupClient().GetDeploymentIntentGroupState(di, p, ca, v) if err != nil { return pkgerrors.Errorf("Error retrieving DeploymentIntentGroup stateInfo: " + di) } stateVal, err := state.GetCurrentStateFromStateInfo(s) if err != nil { return pkgerrors.Errorf("Error getting current state from DeploymentIntentGroup stateInfo: " + di) } switch stateVal { case state.StateEnum.Approved: break case state.StateEnum.Terminated: break // TODO - ideally, should check that all resources have completed being terminated case state.StateEnum.Created: return pkgerrors.Errorf("DeploymentIntentGroup must be Approved before instantiating" + di) case state.StateEnum.Applied: return pkgerrors.Errorf("DeploymentIntentGroup is in an invalid state" + di) case state.StateEnum.Instantiated: return pkgerrors.Errorf("DeploymentIntentGroup has already been instantiated" + di) default: return pkgerrors.Errorf("DeploymentIntentGroup is in an unknown state" + stateVal) } rName := dIGrp.Spec.Version //rName is releaseName overrideValues := dIGrp.Spec.OverrideValuesObj cp := dIGrp.Spec.Profile gIntent, err := findGenericPlacementIntent(p, ca, v, di) if err != nil { return err } log.Info(":: The name of the GenPlacIntent ::", log.Fields{"GenPlmtIntent": gIntent}) log.Info(":: DeploymentIntentGroup, ReleaseName, CompositeProfile ::", log.Fields{"dIGrp": dIGrp.MetaData.Name, "releaseName": rName, "cp": cp}) allApps, err := NewAppClient().GetApps(p, ca, v) if err != nil { return pkgerrors.Wrap(err, "Not finding the apps") } cca, err := makeAppContextForCompositeApp(p, ca, v, rName) if err != nil { return err } context := cca.context ctxval := cca.ctxval compositeHandle := cca.compositeAppHandle var appOrderInstr struct { Apporder []string `json:"apporder"` } var appDepInstr struct { Appdep map[string]string `json:"appdependency"` } appdep := make(map[string]string) // Add composite app using appContext for _, eachApp := range allApps { appOrderInstr.Apporder = append(appOrderInstr.Apporder, eachApp.Metadata.Name) appdep[eachApp.Metadata.Name] = "go" sortedTemplates, err := GetSortedTemplateForApp(eachApp.Metadata.Name, p, ca, v, rName, cp, overrideValues) if err != nil { deleteAppContext(context) return pkgerrors.Wrap(err, "Unable to get the sorted templates for app") } log.Info(":: Resolved all the templates ::", log.Fields{"appName": eachApp.Metadata.Name, "SortedTemplate": sortedTemplates}) resources, err := getResources(sortedTemplates) if err != nil { deleteAppContext(context) return pkgerrors.Wrapf(err, "Unable to get the resources for app :: %s", eachApp.Metadata.Name) } specData, err := NewAppIntentClient().GetAllIntentsByApp(eachApp.Metadata.Name, p, ca, v, gIntent) if err != nil { deleteAppContext(context) return pkgerrors.Wrap(err, "Unable to get the intents for app") } // listOfClusters shall have both mandatoryClusters and optionalClusters where the app needs to be installed. listOfClusters, err := gpic.IntentResolver(specData.Intent) if err != nil { deleteAppContext(context) return pkgerrors.Wrap(err, "Unable to get the intents resolved for app") } log.Info(":: listOfClusters ::", log.Fields{"listOfClusters": listOfClusters}) //BEGIN: storing into etcd // Add an app to the app context apphandle, err := context.AddApp(compositeHandle, eachApp.Metadata.Name) if err != nil { deleteAppContext(context) return pkgerrors.Wrap(err, "Error adding App to AppContext") } err = addClustersToAppContext(listOfClusters, context, apphandle, resources) if err != nil { deleteAppContext(context) return pkgerrors.Wrap(err, "Error while adding cluster and resources to app") } err = verifyResources(listOfClusters, context, resources, eachApp.Metadata.Name) if err != nil { deleteAppContext(context) return pkgerrors.Wrap(err, "Error while verifying resources in app: ") } } jappOrderInstr, err := json.Marshal(appOrderInstr) if err != nil { deleteAppContext(context) return pkgerrors.Wrap(err, "Error marshalling app order instruction") } appDepInstr.Appdep = appdep jappDepInstr, err := json.Marshal(appDepInstr) if err != nil { deleteAppContext(context) return pkgerrors.Wrap(err, "Error marshalling app dependency instruction") } _, err = context.AddInstruction(compositeHandle, "app", "order", string(jappOrderInstr)) if err != nil { deleteAppContext(context) return pkgerrors.Wrap(err, "Error adding app dependency instruction") } _, err = context.AddInstruction(compositeHandle, "app", "dependency", string(jappDepInstr)) if err != nil { deleteAppContext(context) return pkgerrors.Wrap(err, "Error adding app dependency instruction") } //END: storing into etcd // BEGIN: scheduler code pl, mapOfControllers, err := getPrioritizedControllerList(p, ca, v, di) if err != nil { return pkgerrors.Wrap(err, "Error adding getting prioritized controller list") } log.Info("Priority Based List ", log.Fields{"PlacementControllers::": pl.pPlaCont, "ActionControllers::": pl.pActCont, "mapOfControllers::": mapOfControllers}) err = callGrpcForControllerList(pl.pPlaCont, mapOfControllers, ctxval) if err != nil { deleteAppContext(context) return pkgerrors.Wrap(err, "Error calling gRPC for placement controller list") } err = deleteExtraClusters(allApps, context) if err != nil { deleteAppContext(context) return pkgerrors.Wrap(err, "Error deleting extra clusters") } err = callGrpcForControllerList(pl.pActCont, mapOfControllers, ctxval) if err != nil { deleteAppContext(context) return pkgerrors.Wrap(err, "Error calling gRPC for action controller list") } // END: Scheduler code // BEGIN : Rsync code err = callRsyncInstall(ctxval) if err != nil { deleteAppContext(context) return pkgerrors.Wrap(err, "Error calling rsync") } // END : Rsyc code // BEGIN:: save the context in the orchestrator db record key := DeploymentIntentGroupKey{ Name: di, Project: p, CompositeApp: ca, Version: v, } a := state.ActionEntry{ State: state.StateEnum.Instantiated, ContextId: ctxval.(string), TimeStamp: time.Now(), } s.Actions = append(s.Actions, a) err = db.DBconn.Insert(c.db.storeName, key, nil, c.db.tagState, s) if err != nil { log.Warn(":: Error updating DeploymentIntentGroup state in DB ::", log.Fields{"Error": err.Error(), "GPIntent": gIntent, "DeploymentIntentGroup": di, "CompositeApp": ca, "CompositeAppVersion": v, "Project": p, "AppContext": ctxval.(string)}) return pkgerrors.Wrap(err, "Error adding DeploymentIntentGroup state to DB") } // END:: save the context in the orchestrator db record log.Info(":: Done with instantiation call to rsync... ::", log.Fields{"CompositeAppName": ca}) return err } /* Status takes in projectName, compositeAppName, compositeAppVersion, DeploymentIntentName. This method is responsible obtaining the status of the deployment, which is made available in the appcontext. */ func (c InstantiationClient) Status(p, ca, v, di, qInstance, qType, qOutput string, qApps, qClusters, qResources []string) (DeploymentStatus, error) { dIGrp, err := NewDeploymentIntentGroupClient().GetDeploymentIntentGroup(di, p, ca, v) if err != nil { return DeploymentStatus{}, pkgerrors.Wrap(err, "Not finding the deploymentIntentGroup") } diState, err := NewDeploymentIntentGroupClient().GetDeploymentIntentGroupState(di, p, ca, v) if err != nil { return DeploymentStatus{}, pkgerrors.Wrap(err, "deploymentIntentGroup state not found: "+di) } // Get all apps in this composite app apps, err := NewAppClient().GetApps(p, ca, v) if err != nil { return DeploymentStatus{}, pkgerrors.Wrap(err, "Not finding the apps") } allApps := make([]string, 0) for _, a := range apps { allApps = append(allApps, a.Metadata.Name) } statusResponse, err := status.PrepareStatusResult(diState, allApps, qInstance, qType, qOutput, qApps, qClusters, qResources) if err != nil { return DeploymentStatus{}, err } statusResponse.Name = di diStatus := DeploymentStatus{ Project: p, CompositeAppName: ca, CompositeAppVersion: v, CompositeProfileName: dIGrp.Spec.Profile, StatusResult: statusResponse, } return diStatus, nil } /* Terminate takes in projectName, compositeAppName, compositeAppVersion, DeploymentIntentName and calls rsync to terminate. */ func (c InstantiationClient) Terminate(p string, ca string, v string, di string) error { s, err := NewDeploymentIntentGroupClient().GetDeploymentIntentGroupState(di, p, ca, v) if err != nil { return pkgerrors.Wrap(err, "DeploymentIntentGroup has no state info: "+di) } stateVal, err := state.GetCurrentStateFromStateInfo(s) if err != nil { return pkgerrors.Errorf("Error getting current state from DeploymentIntentGroup stateInfo: " + di) } if stateVal != state.StateEnum.Instantiated { return pkgerrors.Errorf("DeploymentIntentGroup is not instantiated" + di) } currentCtxId := state.GetLastContextIdFromStateInfo(s) err = callRsyncUninstall(currentCtxId) if err != nil { return err } key := DeploymentIntentGroupKey{ Name: di, Project: p, CompositeApp: ca, Version: v, } a := state.ActionEntry{ State: state.StateEnum.Terminated, ContextId: currentCtxId, TimeStamp: time.Now(), } s.Actions = append(s.Actions, a) err = db.DBconn.Insert(c.db.storeName, key, nil, c.db.tagState, s) if err != nil { return pkgerrors.Wrap(err, "Error updating the stateInfo of the DeploymentIntentGroup: "+di) } return nil }