257 lines
9 KiB
Go
257 lines
9 KiB
Go
/*
|
|
Copyright 2016 The Kubernetes 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.
|
|
*/
|
|
|
|
// This test references
|
|
// persistent_volumes.go
|
|
// volumes.go
|
|
|
|
package e2e
|
|
|
|
import (
|
|
"fmt"
|
|
"time"
|
|
|
|
. "github.com/onsi/ginkgo"
|
|
. "github.com/onsi/gomega"
|
|
metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
|
|
"k8s.io/kubernetes/pkg/api/v1"
|
|
"k8s.io/kubernetes/pkg/client/clientset_generated/clientset"
|
|
"k8s.io/kubernetes/test/e2e/framework"
|
|
)
|
|
|
|
type testBody func(c clientset.Interface, f *framework.Framework, clientPod *v1.Pod, pvc *v1.PersistentVolumeClaim, pv *v1.PersistentVolume)
|
|
type disruptiveTest struct {
|
|
testItStmt string
|
|
runTest testBody
|
|
}
|
|
type kubeletOpt string
|
|
|
|
const (
|
|
MinNodes = 2
|
|
NodeStateTimeout = 1 * time.Minute
|
|
kStart kubeletOpt = "start"
|
|
kStop kubeletOpt = "stop"
|
|
kRestart kubeletOpt = "restart"
|
|
)
|
|
|
|
var _ = framework.KubeDescribe("PersistentVolumes [Disruptive]", func() {
|
|
|
|
f := framework.NewDefaultFramework("disruptive-pv")
|
|
var (
|
|
c clientset.Interface
|
|
ns string
|
|
nfsServerPod *v1.Pod
|
|
nfsPVconfig persistentVolumeConfig
|
|
nfsServerIP, clientNodeIP string
|
|
clientNode *v1.Node
|
|
)
|
|
|
|
nfsServerConfig := VolumeTestConfig{
|
|
namespace: v1.NamespaceDefault,
|
|
prefix: "nfs",
|
|
serverImage: NfsServerImage,
|
|
serverPorts: []int{2049},
|
|
serverArgs: []string{"-G", "777", "/exports"},
|
|
}
|
|
|
|
BeforeEach(func() {
|
|
// To protect the NFS volume pod from the kubelet restart, we isolate it on its own node.
|
|
framework.SkipUnlessNodeCountIsAtLeast(MinNodes)
|
|
c = f.ClientSet
|
|
ns = f.Namespace.Name
|
|
|
|
// Start the NFS server pod.
|
|
if nfsServerPod == nil {
|
|
framework.Logf("[BeforeEach] Initializing NFS Server Pod")
|
|
nfsServerPod = startVolumeServer(c, nfsServerConfig)
|
|
|
|
framework.Logf("[BeforeEach] Configuring PersistentVolume")
|
|
nfsServerIP = nfsServerPod.Status.PodIP
|
|
Expect(nfsServerIP).NotTo(BeEmpty())
|
|
nfsPVconfig = persistentVolumeConfig{
|
|
namePrefix: "nfs-",
|
|
pvSource: v1.PersistentVolumeSource{
|
|
NFS: &v1.NFSVolumeSource{
|
|
Server: nfsServerIP,
|
|
Path: "/exports",
|
|
ReadOnly: false,
|
|
},
|
|
},
|
|
}
|
|
}
|
|
// Get the first ready node IP that is not hosting the NFS pod.
|
|
if clientNodeIP == "" {
|
|
framework.Logf("Designating test node")
|
|
nodes := framework.GetReadySchedulableNodesOrDie(c)
|
|
for _, node := range nodes.Items {
|
|
if node.Name != nfsServerPod.Spec.NodeName {
|
|
clientNode = &node
|
|
clientNodeIP = framework.GetNodeExternalIP(clientNode)
|
|
Expect(clientNodeIP).NotTo(BeEmpty())
|
|
break
|
|
}
|
|
}
|
|
}
|
|
})
|
|
|
|
AddCleanupAction(func() {
|
|
if nfsServerPod != nil && c != nil {
|
|
By("Deleting NFS server pod")
|
|
nfsServerPodCleanup(c, nfsServerConfig)
|
|
nfsServerPod = nil
|
|
}
|
|
})
|
|
|
|
Context("when kubelet restarts", func() {
|
|
|
|
var (
|
|
clientPod *v1.Pod
|
|
pv *v1.PersistentVolume
|
|
pvc *v1.PersistentVolumeClaim
|
|
)
|
|
|
|
BeforeEach(func() {
|
|
framework.Logf("Initializing test spec")
|
|
clientPod, pv, pvc = initTestCase(f, c, nfsPVconfig, ns, clientNode.Name)
|
|
})
|
|
|
|
AfterEach(func() {
|
|
framework.Logf("Tearing down test spec")
|
|
tearDownTestCase(c, f, ns, clientPod, pvc, pv)
|
|
pv, pvc, clientPod = nil, nil, nil
|
|
})
|
|
|
|
// Test table housing the It() title string and test spec. runTest is type testBody, defined at
|
|
// the start of this file. To add tests, define a function mirroring the testBody signature and assign
|
|
// to runTest.
|
|
disruptiveTestTable := []disruptiveTest{
|
|
{
|
|
testItStmt: "Should test that a file written to the mount before kubelet restart is stat-able after restart.",
|
|
runTest: testKubeletRestartsAndRestoresMount,
|
|
},
|
|
{
|
|
testItStmt: "Should test that a volume mounted to a pod that is deleted while the kubelet is down unmounts when the kubelet returns.",
|
|
runTest: testVolumeUnmountsFromDeletedPod,
|
|
},
|
|
}
|
|
|
|
// Test loop executes each disruptiveTest iteratively.
|
|
for _, test := range disruptiveTestTable {
|
|
func(t disruptiveTest) {
|
|
It(t.testItStmt, func() {
|
|
By("Executing Spec")
|
|
t.runTest(c, f, clientPod, pvc, pv)
|
|
})
|
|
}(test)
|
|
}
|
|
})
|
|
})
|
|
|
|
// testKubeletRestartsAndRestoresMount tests that a volume mounted to a pod remains mounted after a kubelet restarts
|
|
func testKubeletRestartsAndRestoresMount(c clientset.Interface, f *framework.Framework, clientPod *v1.Pod, pvc *v1.PersistentVolumeClaim, pv *v1.PersistentVolume) {
|
|
By("Writing to the volume.")
|
|
file := "/mnt/_SUCCESS"
|
|
_, err := podExec(clientPod, "touch "+file)
|
|
Expect(err).NotTo(HaveOccurred())
|
|
|
|
By("Restarting kubelet")
|
|
kubeletCommand(kRestart, c, clientPod)
|
|
|
|
By("Testing that written file is accessible.")
|
|
_, err = podExec(clientPod, "cat "+file)
|
|
Expect(err).NotTo(HaveOccurred())
|
|
framework.Logf("Pod %s detected %s after kubelet restart", clientPod.Name, file)
|
|
}
|
|
|
|
// testVolumeUnmountsFromDeletedPod tests that a volume unmounts if the client pod was deleted while the kubelet was down.
|
|
func testVolumeUnmountsFromDeletedPod(c clientset.Interface, f *framework.Framework, clientPod *v1.Pod, pvc *v1.PersistentVolumeClaim, pv *v1.PersistentVolume) {
|
|
nodeIP, err := framework.GetHostExternalAddress(c, clientPod)
|
|
Expect(err).NotTo(HaveOccurred())
|
|
nodeIP = nodeIP + ":22"
|
|
|
|
By("Expecting the volume mount to be found.")
|
|
result, err := framework.SSH("mount | grep "+string(clientPod.UID), nodeIP, framework.TestContext.Provider)
|
|
Expect(err).NotTo(HaveOccurred())
|
|
Expect(result.Code).To(BeZero())
|
|
|
|
By("Restarting the kubelet.")
|
|
kubeletCommand(kStop, c, clientPod)
|
|
deletePod(f, c, clientPod.Namespace, clientPod)
|
|
kubeletCommand(kStart, c, clientPod)
|
|
|
|
By("Expecting the volume mount not to be found.")
|
|
result, err = framework.SSH("mount| grep "+string(clientPod.UID), nodeIP, framework.TestContext.Provider)
|
|
Expect(err).NotTo(HaveOccurred())
|
|
Expect(result.Code).NotTo(BeZero())
|
|
|
|
framework.Logf("Volume mount detected on pod and written file is readable post-restart.")
|
|
}
|
|
|
|
// initTestCase initializes spec resources (pv, pvc, and pod) and returns pointers to be consumed by the test
|
|
func initTestCase(f *framework.Framework, c clientset.Interface, pvConfig persistentVolumeConfig, ns, nodeName string) (*v1.Pod, *v1.PersistentVolume, *v1.PersistentVolumeClaim) {
|
|
pv, pvc := createPVPVC(c, pvConfig, ns, false)
|
|
pod := makePod(ns, pvc.Name)
|
|
pod.Spec.NodeName = nodeName
|
|
framework.Logf("Creating nfs client Pod %s on node %s", pod.Name, nodeName)
|
|
pod, err := c.Core().Pods(ns).Create(pod)
|
|
Expect(err).NotTo(HaveOccurred())
|
|
err = framework.WaitForPodRunningInNamespace(c, pod)
|
|
Expect(err).NotTo(HaveOccurred())
|
|
|
|
pod, err = c.Core().Pods(ns).Get(pod.Name, metav1.GetOptions{})
|
|
Expect(err).NotTo(HaveOccurred())
|
|
pvc, err = c.Core().PersistentVolumeClaims(ns).Get(pvc.Name, metav1.GetOptions{})
|
|
Expect(err).NotTo(HaveOccurred())
|
|
pv, err = c.Core().PersistentVolumes().Get(pv.Name, metav1.GetOptions{})
|
|
Expect(err).NotTo(HaveOccurred())
|
|
return pod, pv, pvc
|
|
}
|
|
|
|
// tearDownTestCase destroy resources created by initTestCase.
|
|
func tearDownTestCase(c clientset.Interface, f *framework.Framework, ns string, pod *v1.Pod, pvc *v1.PersistentVolumeClaim, pv *v1.PersistentVolume) {
|
|
deletePod(f, c, ns, pod)
|
|
deletePersistentVolumeClaim(c, pvc.Name, ns)
|
|
deletePersistentVolume(c, pv.Name)
|
|
}
|
|
|
|
// kubeletCommand performs `start`, `restart`, or `stop` on the kubelet running on the node of the target pod.
|
|
// Allowed kubeltOps are `kStart`, `kStop`, and `kRestart`
|
|
func kubeletCommand(kOp kubeletOpt, c clientset.Interface, pod *v1.Pod) {
|
|
nodeIP, err := framework.GetHostExternalAddress(c, pod)
|
|
Expect(err).NotTo(HaveOccurred())
|
|
nodeIP = nodeIP + ":22"
|
|
sshResult, err := framework.SSH("sudo /etc/init.d/kubelet "+string(kOp), nodeIP, framework.TestContext.Provider)
|
|
Expect(err).NotTo(HaveOccurred())
|
|
framework.LogSSHResult(sshResult)
|
|
|
|
// On restart, waiting for node NotReady prevents a race condition where the node takes a few moments to leave the
|
|
// Ready state which in turn short circuits WaitForNodeToBeReady()
|
|
if kOp == kStop || kOp == kRestart {
|
|
if ok := framework.WaitForNodeToBeNotReady(c, pod.Spec.NodeName, NodeStateTimeout); !ok {
|
|
framework.Failf("Node %s failed to enter NotReady state", pod.Spec.NodeName)
|
|
}
|
|
}
|
|
if kOp == kStart || kOp == kRestart {
|
|
if ok := framework.WaitForNodeToBeReady(c, pod.Spec.NodeName, NodeStateTimeout); !ok {
|
|
framework.Failf("Node %s failed to enter Ready state", pod.Spec.NodeName)
|
|
}
|
|
}
|
|
}
|
|
|
|
// podExec wraps RunKubectl to execute a bash cmd in target pod
|
|
func podExec(pod *v1.Pod, bashExec string) (string, error) {
|
|
return framework.RunKubectl("exec", fmt.Sprintf("--namespace=%s", pod.Namespace), pod.Name, "--", "/bin/sh", "-c", bashExec)
|
|
}
|