Add lifecycle test function; Add pidfile test.

Fixes #556

Signed-off-by: Liang Chenye <[email protected]>

validation/pidfile.go

@@ -0,0 +1,62 @@
+package main
+
+import (
+	"errors"
+	"io/ioutil"
+	"os"
+	"path/filepath"
+	"strconv"
+	"time"
+
+	tap "github.com/mndrix/tap-go"
+	"github.com/opencontainers/runtime-tools/validation/util"
+)
+
+func main() {
+	t := tap.New()
+	t.Header(0)
+
+	tempDir, err := ioutil.TempDir("", "oci-pid")
+	if err != nil {
+		util.Fatal(err)
+	}
+	tempPidFile := filepath.Join(tempDir, "pidfile")
+	defer os.RemoveAll(tempDir)
+
+	lifecycle := util.LifecycleFuncs{
+		Setup: func(r *util.Runtime) error {
+			r.PidFile = tempPidFile
+			return nil
+		},
+		PostCreate: func(r *util.Runtime) error {
+			pidData, err := ioutil.ReadFile(tempPidFile)
+			if err != nil {
+				return err
+			}
+			pid, err := strconv.Atoi(string(pidData))
+			if err != nil {
+				return err
+			}
+			state, err := r.State()
+			if err != nil {
+				return err
+			}
+			if state.Pid != pid {
+				return errors.New("Wrong pid in the pidfile")
+			}
+			return nil
+		},
+		PreStop: func(r *util.Runtime) error {
+			return util.WaitingForStatus(*r, util.LifecycleStatusCreated, time.Second*10, time.Second*1)
+		},
+	}
+
+	g := util.GetDefaultGenerator()
+	g.SetProcessArgs([]string{"true"})
+	err = util.RuntimeLifecycleValidate(g, &lifecycle, util.LifecycleActionCreate|util.LifecycleActionDelete)
+	if err != nil {
+		util.Fatal(err)
+	}
+
+	t.AutoPlan()
+}

validation/util/container.go

@@ -18,6 +18,7 @@ import (
 type Runtime struct {
 	RuntimeCommand string
 	BundleDir      string
+	PidFile        string
 	ID             string
 	stdout         *os.File
 	stderr         *os.File
@@ -63,7 +64,9 @@ func (r *Runtime) Create() (stderr []byte, err error) {
 	if r.ID != "" {
 		args = append(args, r.ID)
 	}
-
+	if r.PidFile != "" {
+		args = append(args, "--pid-file", r.PidFile)
+	}
 	if r.BundleDir != "" {
 		args = append(args, "--bundle", r.BundleDir)
 	}
@@ -146,23 +149,32 @@ func (r *Runtime) State() (rspecs.State, error) {
 }
 
 // Delete a container
-func (r *Runtime) Delete() error {
+func (r *Runtime) Delete() ([]byte, error) {
 	var args []string
+	var stderr []byte
 	args = append(args, "delete")
 	if r.ID != "" {
 		args = append(args, r.ID)
 	}
 
 	cmd := exec.Command(r.RuntimeCommand, args...)
-	return cmd.Run()
+	stdout, err := cmd.Output()
+	if e, ok := err.(*exec.ExitError); ok {
+		stderr = e.Stderr
+	}
+	if err != nil && len(stderr) == 0 {
+		stderr = stdout
+	}
+
+	return stderr, err
 }
 
 // Clean deletes the container.  If removeBundle is set, the bundle
 // directory is removed after the container is deleted succesfully or, if
 // forceRemoveBundle is true, after the deletion attempt regardless of
 // whether it was successful or not.
 func (r *Runtime) Clean(removeBundle bool, forceRemoveBundle bool) error {
-	err := r.Delete()
+	_, err := r.Delete()
 
 	if removeBundle && (err == nil || forceRemoveBundle) {
 		err2 := os.RemoveAll(r.bundleDir())

validation/util/test.go

@@ -1,6 +1,7 @@
 package util
 
 import (
+	"errors"
 	"fmt"
 	"io/ioutil"
 	"os"
@@ -21,6 +22,47 @@ var (
 	RuntimeCommand = "runc"
 )
 
+// LifecycleAction
+type LifecycleAction int
+
+const (
+	// LifecycleActionCreate creates a container
+	LifecycleActionCreate = 1 << iota
+	// LifecycleActionStart starts a container
+	LifecycleActionStart
+	// LifecycleActionDelete deletes a container
+	LifecycleActionDelete
+)
+
+// LifecycleStatus follows https://github.com/opencontainers/runtime-spec/blob/master/runtime.md#state
+type LifecycleStatus int
+
+const (
+	// LifecycleStatusCreating "creating"
+	LifecycleStatusCreating = 1 << iota
+	// LifecycleStatusCreated "created"
+	LifecycleStatusCreated
+	// LifecycleStatusRunning "running"
+	LifecycleStatusRunning
+	// LifecycleStatusStopped "stopped"
+	LifecycleStatusStopped
+)
+
+var lifecycleStatusMap = map[string]LifecycleStatus{
+	"creating": LifecycleStatusCreating,
+	"created":  LifecycleStatusCreated,
+	"running":  LifecycleStatusRunning,
+	"stopped":  LifecycleStatusStopped,
+}
+
+// LifecycleFuncs includes 4 phases for user to add his/her own operation.
+type LifecycleFuncs struct {
+	Setup      func(runtime *Runtime) error
+	PostCreate func(runtime *Runtime) error
+	PreStop    func(runtime *Runtime) error
+	PostStop   func(runtime *Runtime) error
+}
+
 // PreFunc initializes the test environment after preparing the bundle
 // but before creating the container.
 type PreFunc func(string) error
@@ -78,6 +120,28 @@ func GetDefaultGenerator() *generate.Generator {
 	return &g
 }
 
+// WaitingForStatus waits an expected runtime status, return error if
+// 1. fail to query the status
+// 2. timeout
+func WaitingForStatus(r Runtime, status LifecycleStatus, retryTimeout time.Duration, pollInterval time.Duration) error {
+	for start := time.Now(); time.Since(start) < retryTimeout; time.Sleep(pollInterval) {
+		state, err := r.State()
+		if err != nil {
+			return err
+		}
+		if v, ok := lifecycleStatusMap[state.Status]; ok {
+			if status&v != 0 {
+				return nil
+			}
+		} else {
+			// In spec, it says 'Additional values MAY be defined by the runtime'.
+			continue
+		}
+	}
+
+	return errors.New("timeout in waiting for the container status")
+}
+
 // RuntimeInsideValidate runs runtimetest inside a container.
 func RuntimeInsideValidate(g *generate.Generator, f PreFunc) (err error) {
 	bundleDir, err := PrepareBundle()
@@ -184,3 +248,74 @@ func RuntimeOutsideValidate(g *generate.Generator, f AfterFunc) error {
 	}
 	return nil
 }
+
+// RuntimeLifecycleValidate validate runtime lifecycle.
+func RuntimeLifecycleValidate(g *generate.Generator, lifecycle *LifecycleFuncs, actions LifecycleAction) error {
+	bundleDir, err := PrepareBundle()
+	if err != nil {
+		return err
+	}
+	r, err := NewRuntime(RuntimeCommand, bundleDir)
+	if err != nil {
+		os.RemoveAll(bundleDir)
+		return err
+	}
+	defer r.Clean(true, true)
+	err = r.SetConfig(g)
+	if err != nil {
+		return err
+	}
+	r.SetID(uuid.NewV4().String())
+
+	if lifecycle != nil && lifecycle.Setup != nil {
+		if err := lifecycle.Setup(&r); err != nil {
+			return err
+		}
+	}
+
+	if actions&LifecycleActionCreate != 0 {
+		stderr, err := r.Create()
+		if err != nil {
+			os.Stderr.WriteString("failed to create the container\n")
+			os.Stderr.Write(stderr)
+			return err
+		}
+	}
+
+	if lifecycle != nil && lifecycle.PostCreate != nil {
+		if err := lifecycle.PostCreate(&r); err != nil {
+			return err
+		}
+	}
+
+	if actions&LifecycleActionStart != 0 {
+		stderr, err := r.Start()
+		if err != nil {
+			os.Stderr.WriteString("failed to start the container\n")
+			os.Stderr.Write(stderr)
+			return err
+		}
+	}
+
+	if lifecycle != nil && lifecycle.PreStop != nil {
+		if err := lifecycle.PreStop(&r); err != nil {
+			return err
+		}
+	}
+
+	if actions&LifecycleActionDelete != 0 {
+		stderr, err := r.Delete()
+		if err != nil {
+			os.Stderr.WriteString("failed to delete the container\n")
+			os.Stderr.Write(stderr)
+			return err
+		}
+	}
+
+	if lifecycle != nil && lifecycle.PostStop != nil {
+		if err := lifecycle.PostStop(&r); err != nil {
+			return err
+		}
+	}
+	return nil
+}