hs-test: point gdb to vpp source files
[vpp.git] / extras / hs-test / container.go
index 3128a8e..76d08c7 100644 (file)
@@ -2,30 +2,350 @@ package main
 
 import (
        "fmt"
+       "os"
+       "os/exec"
+       "strings"
+       "text/template"
 
        "github.com/edwarnicke/exechelper"
 )
 
+const (
+       logDir string = "/tmp/hs-test/"
+)
+
+var (
+       workDir, _ = os.Getwd()
+)
+
+type Volume struct {
+       hostDir          string
+       containerDir     string
+       isDefaultWorkDir bool
+}
+
 type Container struct {
-       name string
+       suite            *HstSuite
+       isOptional       bool
+       runDetached      bool
+       name             string
+       image            string
+       extraRunningArgs string
+       volumes          map[string]Volume
+       envVars          map[string]string
+       vppInstance      *VppInstance
 }
 
-func (c *Container) run() error {
+func newContainer(yamlInput ContainerConfig) (*Container, error) {
+       containerName := yamlInput["name"].(string)
+       if len(containerName) == 0 {
+               err := fmt.Errorf("container name must not be blank")
+               return nil, err
+       }
+
+       var container = new(Container)
+       container.volumes = make(map[string]Volume)
+       container.envVars = make(map[string]string)
+       container.name = containerName
+
+       if image, ok := yamlInput["image"]; ok {
+               container.image = image.(string)
+       } else {
+               container.image = "hs-test/vpp"
+       }
+
+       if args, ok := yamlInput["extra-args"]; ok {
+               container.extraRunningArgs = args.(string)
+       } else {
+               container.extraRunningArgs = ""
+       }
+
+       if isOptional, ok := yamlInput["is-optional"]; ok {
+               container.isOptional = isOptional.(bool)
+       } else {
+               container.isOptional = false
+       }
+
+       if runDetached, ok := yamlInput["run-detached"]; ok {
+               container.runDetached = runDetached.(bool)
+       } else {
+               container.runDetached = true
+       }
+
+       if _, ok := yamlInput["volumes"]; ok {
+               r := strings.NewReplacer("$HST_DIR", workDir)
+               for _, volu := range yamlInput["volumes"].([]interface{}) {
+                       volumeMap := volu.(ContainerConfig)
+                       hostDir := r.Replace(volumeMap["host-dir"].(string))
+                       containerDir := volumeMap["container-dir"].(string)
+                       isDefaultWorkDir := false
+
+                       if isDefault, ok := volumeMap["is-default-work-dir"]; ok {
+                               isDefaultWorkDir = isDefault.(bool)
+                       }
+
+                       container.addVolume(hostDir, containerDir, isDefaultWorkDir)
+
+               }
+       }
+
+       if _, ok := yamlInput["vars"]; ok {
+               for _, envVar := range yamlInput["vars"].([]interface{}) {
+                       envVarMap := envVar.(ContainerConfig)
+                       name := envVarMap["name"].(string)
+                       value := envVarMap["value"].(string)
+                       container.addEnvVar(name, value)
+               }
+       }
+       return container, nil
+}
+
+func (c *Container) getWorkDirVolume() (res Volume, exists bool) {
+       for _, v := range c.volumes {
+               if v.isDefaultWorkDir {
+                       res = v
+                       exists = true
+                       return
+               }
+       }
+       return
+}
+
+func (c *Container) getHostWorkDir() (res string) {
+       if v, ok := c.getWorkDirVolume(); ok {
+               res = v.hostDir
+       }
+       return
+}
+
+func (c *Container) getContainerWorkDir() (res string) {
+       if v, ok := c.getWorkDirVolume(); ok {
+               res = v.containerDir
+       }
+       return
+}
+
+func (c *Container) getContainerArguments() string {
+       args := "--ulimit nofile=90000:90000 --cap-add=all --privileged --network host --rm"
+       args += c.getVolumesAsCliOption()
+       args += c.getEnvVarsAsCliOption()
+       if *vppSourceFileDir != "" {
+               args += fmt.Sprintf(" -v %s:%s", *vppSourceFileDir, *vppSourceFileDir)
+       }
+       args += " --name " + c.name + " " + c.image
+       args += " " + c.extraRunningArgs
+       return args
+}
+
+func (c *Container) create() error {
+       cmd := "docker create " + c.getContainerArguments()
+       c.suite.log(cmd)
+       return exechelper.Run(cmd)
+}
+
+func (c *Container) start() error {
+       cmd := "docker start " + c.name
+       c.suite.log(cmd)
+       return exechelper.Run(cmd)
+}
+
+func (c *Container) prepareCommand() (string, error) {
        if c.name == "" {
-               return fmt.Errorf("create volume failed: container name is blank")
+               return "", fmt.Errorf("run container failed: name is blank")
        }
 
-       exechelper.Run(fmt.Sprintf("mkdir -p /tmp/%s/sync", c.name))
-       syncPath := fmt.Sprintf("-v /tmp/%s/sync:/tmp/sync", c.name)
-       cmd := "docker run --cap-add=all -d --privileged --network host --rm "
-       cmd += syncPath
-       cmd += " --name " + c.name + " hs-test/vpp"
-       fmt.Println(cmd)
-       err := exechelper.Run(cmd)
+       cmd := "docker run "
+       if c.runDetached {
+               cmd += " -d"
+       }
+       cmd += " " + c.getContainerArguments()
+
+       c.suite.log(cmd)
+       return cmd, nil
+}
+
+func (c *Container) combinedOutput() (string, error) {
+       cmd, err := c.prepareCommand()
        if err != nil {
-               return fmt.Errorf("create volume failed: %s", err)
+               return "", err
        }
 
+       byteOutput, err := exechelper.CombinedOutput(cmd)
+       return string(byteOutput), err
+}
+
+func (c *Container) run() error {
+       cmd, err := c.prepareCommand()
+       if err != nil {
+               return err
+       }
+
+       return exechelper.Run(cmd)
+}
+
+func (c *Container) addVolume(hostDir string, containerDir string, isDefaultWorkDir bool) {
+       var volume Volume
+       volume.hostDir = hostDir
+       volume.containerDir = containerDir
+       volume.isDefaultWorkDir = isDefaultWorkDir
+       c.volumes[hostDir] = volume
+}
+
+func (c *Container) getVolumesAsCliOption() string {
+       cliOption := ""
+
+       if len(c.volumes) > 0 {
+               for _, volume := range c.volumes {
+                       cliOption += fmt.Sprintf(" -v %s:%s", volume.hostDir, volume.containerDir)
+               }
+       }
+
+       return cliOption
+}
+
+func (c *Container) addEnvVar(name string, value string) {
+       c.envVars[name] = value
+}
+
+func (c *Container) getEnvVarsAsCliOption() string {
+       cliOption := ""
+       if len(c.envVars) == 0 {
+               return cliOption
+       }
+
+       for name, value := range c.envVars {
+               cliOption += fmt.Sprintf(" -e %s=%s", name, value)
+       }
+       return cliOption
+}
+
+func (c *Container) newVppInstance(cpus []int, additionalConfigs ...Stanza) (*VppInstance, error) {
+       vpp := new(VppInstance)
+       vpp.container = c
+       vpp.cpus = cpus
+       vpp.additionalConfig = append(vpp.additionalConfig, additionalConfigs...)
+       c.vppInstance = vpp
+       return vpp, nil
+}
+
+func (c *Container) copy(sourceFileName string, targetFileName string) error {
+       cmd := exec.Command("docker", "cp", sourceFileName, c.name+":"+targetFileName)
+       return cmd.Run()
+}
+
+func (c *Container) createFile(destFileName string, content string) error {
+       f, err := os.CreateTemp("/tmp", "hst-config")
+       if err != nil {
+               return err
+       }
+       defer os.Remove(f.Name())
+
+       if _, err := f.Write([]byte(content)); err != nil {
+               return err
+       }
+       if err := f.Close(); err != nil {
+               return err
+       }
+       c.copy(f.Name(), destFileName)
        return nil
 }
 
+/*
+ * Executes in detached mode so that the started application can continue to run
+ * without blocking execution of test
+ */
+func (c *Container) execServer(command string, arguments ...any) {
+       serverCommand := fmt.Sprintf(command, arguments...)
+       containerExecCommand := "docker exec -d" + c.getEnvVarsAsCliOption() +
+               " " + c.name + " " + serverCommand
+       c.suite.T().Helper()
+       c.suite.log(containerExecCommand)
+       c.suite.assertNil(exechelper.Run(containerExecCommand))
+}
+
+func (c *Container) exec(command string, arguments ...any) string {
+       cliCommand := fmt.Sprintf(command, arguments...)
+       containerExecCommand := "docker exec" + c.getEnvVarsAsCliOption() +
+               " " + c.name + " " + cliCommand
+       c.suite.T().Helper()
+       c.suite.log(containerExecCommand)
+       byteOutput, err := exechelper.CombinedOutput(containerExecCommand)
+       c.suite.assertNil(err)
+       return string(byteOutput)
+}
+
+func (c *Container) getLogDirPath() string {
+       testId := c.suite.getTestId()
+       testName := c.suite.T().Name()
+       logDirPath := logDir + testName + "/" + testId + "/"
+
+       cmd := exec.Command("mkdir", "-p", logDirPath)
+       if err := cmd.Run(); err != nil {
+               c.suite.T().Fatalf("mkdir error: %v", err)
+       }
+
+       return logDirPath
+}
+
+func (c *Container) saveLogs() {
+       cmd := exec.Command("docker", "inspect", "--format='{{.State.Status}}'", c.name)
+       if output, _ := cmd.CombinedOutput(); !strings.Contains(string(output), "running") {
+               return
+       }
+
+       testLogFilePath := c.getLogDirPath() + "container-" + c.name + ".log"
+
+       cmd = exec.Command("docker", "logs", "--details", "-t", c.name)
+       output, err := cmd.CombinedOutput()
+       if err != nil {
+               c.suite.T().Fatalf("fetching logs error: %v", err)
+       }
+
+       f, err := os.Create(testLogFilePath)
+       if err != nil {
+               c.suite.T().Fatalf("file create error: %v", err)
+       }
+       fmt.Fprint(f, string(output))
+       f.Close()
+}
+
+func (c *Container) log() string {
+       cmd := "docker logs " + c.name
+       c.suite.log(cmd)
+       o, err := exechelper.CombinedOutput(cmd)
+       c.suite.assertNil(err)
+       return string(o)
+}
+
+func (c *Container) stop() error {
+       if c.vppInstance != nil && c.vppInstance.apiChannel != nil {
+               c.vppInstance.saveLogs()
+               c.vppInstance.disconnect()
+       }
+       c.vppInstance = nil
+       c.saveLogs()
+       return exechelper.Run("docker stop " + c.name + " -t 0")
+}
+
+func (c *Container) createConfig(targetConfigName string, templateName string, values any) {
+       template := template.Must(template.ParseFiles(templateName))
+
+       f, err := os.CreateTemp("/tmp/hs-test/", "hst-config")
+       c.suite.assertNil(err)
+       defer os.Remove(f.Name())
+
+       err = template.Execute(f, values)
+       c.suite.assertNil(err)
+
+       err = f.Close()
+       c.suite.assertNil(err)
+
+       c.copy(f.Name(), targetConfigName)
+}
+
+func init() {
+       cmd := exec.Command("mkdir", "-p", logDir)
+       if err := cmd.Run(); err != nil {
+               panic(err)
+       }
+}