Kubernetes容器生命周期 —— 钩子函数详解(postStart、preStop)

本文涉及的产品
日志服务 SLS,月写入数据量 50GB 1个月
容器服务 Serverless 版 ACK Serverless,317元额度 多规格
容器服务 Serverless 版 ACK Serverless,952元额度 多规格
简介: 4.2 结论• postStart不会挡住主进程的启动;• postStart的执行相对于容器主进程的执行是异步的,它会在容器start后立刻触发,并不能保证PostStart钩子在容器ENTRYPOINT指令执行完毕之前运行。5、使用场景

1、概述

  容器生命周期钩子(Container Lifecycle Hooks)监听容器生命周期的特定事件,并在事件发生时执行已注册的回调函数。

  钩子函数能够感知自身生命周期中的事件,并在相应的时刻到来时运行用户指定的程序代码。

  kubernetes在主容器的启动之后和停止之前提供了两个钩子函数:

  1. postStart:一种容器钩子。该钩子在容器被创建后立刻触发,通知容器它已经被创建。该钩子不需要向其所对应的Hook Handler传入任何参数。如果该钩子对应的Hook Handler执行失败,则该容器会终止运行,并根据该容器的重启策略决定是否要重启该容器。更多信息,请参见Container Lifecycle Hooks
  2. preStop :一种容器钩子。该钩子在容器被删除前触发,其所对应的Hook Handler必须在删除该容器的请求发送给Docker Daemon之前完成。在该钩子对应的Hook Handler完成后不论执行的结果如何,Docker Daemon会发送一个SIGTERN信号给Docker Daemon来删除该容器。更多信息,请参见Container Lifecycle Hooks 以及《详解Kubernetes Pod优雅退出》这篇博文。

2、钩子函数定义方式

  钩子的回调函数支持两种方式定义动作,下面以 postStart 为例讲解,preStop 定义方式与其一致:

2.1 exec模式

在容器中执行指定的命令。如果命令退出时返回码为0,判定为执行成功。

示例:

1

2

3

4

5

6

lifecycle:

    postStart:

      exec:

        command:

        - cat

        - /var/lib/redis.conf

2.2 httpGet模式

对容器中的指定端点执行HTTP GET请求,如果响应的状态码大于等于200且小于400,判定为执行成功。

httpGet模式支持以下配置参数:

  • Host:HTTP请求主机地址,不设置时默认为Pod的IP地址。
  • Path:HTTP请求路径,默认值是/。
  • Port:HTTP请求端口号。
  • Scheme:协议类型,支持HTTP和HTTPS协议,默认是HTTP。
  • HttpHeaders:自定义HTTP请求头。

示例:访问 http://192.168.2.150:80/users

1

2

3

4

5

6

7

lifecycle:

   postStart:

     httpGet:

       path: /users

       port: 80

       host: 192.168.2.150

       scheme: HTTP  # 或者HTTPS

3、源码讲解

3.1 PostStart

Kubernetes源码(1.21.5,已在源码中移除dockershim模块):

pkg/kubelet/kuberuntime/kuberuntime_container.go:

开始容器方法主要包括拉取镜像、创建容器、start容器、运行容器postStart钩子函数。

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

81

82

83

84

85

86

87

88

89

90

91

92

93

94

95

96

97

98

99

100

101

102

103

104

105

106

107

108

109

110

// startContainer starts a container and returns a message indicates why it is failed on error.

// It starts the container through the following steps:

// * pull the image

// * create the container

// * start the container

// * run the post start lifecycle hooks (if applicable)

func (m *kubeGenericRuntimeManager) startContainer(podSandboxID string, podSandboxConfig *runtimeapi.PodSandboxConfig, spec *startSpec, pod *v1.Pod, podStatus *kubecontainer.PodStatus, pullSecrets []v1.Secret, podIP string, podIPs []string) (string, error) {

    container := spec.container

 

    // Step 1: pull the image.

    imageRef, msg, err := m.imagePuller.EnsureImageExists(pod, container, pullSecrets, podSandboxConfig)

    if err != nil {

        s, _ := grpcstatus.FromError(err)

        m.recordContainerEvent(pod, container, "", v1.EventTypeWarning, events.FailedToCreateContainer, "Error: %v", s.Message())

        return msg, err

    }

 

    // Step 2: create the container.

    // For a new container, the RestartCount should be 0

    restartCount := 0

    containerStatus := podStatus.FindContainerStatusByName(container.Name)

    if containerStatus != nil {

        restartCount = containerStatus.RestartCount + 1

    }

 

    target, err := spec.getTargetID(podStatus)

    if err != nil {

        s, _ := grpcstatus.FromError(err)

        m.recordContainerEvent(pod, container, "", v1.EventTypeWarning, events.FailedToCreateContainer, "Error: %v", s.Message())

        return s.Message(), ErrCreateContainerConfig

    }

 

    containerConfig, cleanupAction, err := m.generateContainerConfig(container, pod, restartCount, podIP, imageRef, podIPs, target)

    if cleanupAction != nil {

        defer cleanupAction()

    }

    if err != nil {

        s, _ := grpcstatus.FromError(err)

        m.recordContainerEvent(pod, container, "", v1.EventTypeWarning, events.FailedToCreateContainer, "Error: %v", s.Message())

        return s.Message(), ErrCreateContainerConfig

    }

 

    err = m.internalLifecycle.PreCreateContainer(pod, container, containerConfig)

    if err != nil {

        s, _ := grpcstatus.FromError(err)

        m.recordContainerEvent(pod, container, "", v1.EventTypeWarning, events.FailedToCreateContainer, "Internal PreCreateContainer hook failed: %v", s.Message())

        return s.Message(), ErrPreCreateHook

    }

 

    containerID, err := m.runtimeService.CreateContainer(podSandboxID, containerConfig, podSandboxConfig)

    if err != nil {

        s, _ := grpcstatus.FromError(err)

        m.recordContainerEvent(pod, container, containerID, v1.EventTypeWarning, events.FailedToCreateContainer, "Error: %v", s.Message())

        return s.Message(), ErrCreateContainer

    }

    err = m.internalLifecycle.PreStartContainer(pod, container, containerID)

    if err != nil {

        s, _ := grpcstatus.FromError(err)

        m.recordContainerEvent(pod, container, containerID, v1.EventTypeWarning, events.FailedToStartContainer, "Internal PreStartContainer hook failed: %v", s.Message())

        return s.Message(), ErrPreStartHook

    }

    m.recordContainerEvent(pod, container, containerID, v1.EventTypeNormal, events.CreatedContainer, fmt.Sprintf("Created container %s", container.Name))

 

    // Step 3: start the container.

    err = m.runtimeService.StartContainer(containerID)

    if err != nil {

        s, _ := grpcstatus.FromError(err)

        m.recordContainerEvent(pod, container, containerID, v1.EventTypeWarning, events.FailedToStartContainer, "Error: %v", s.Message())

        return s.Message(), kubecontainer.ErrRunContainer

    }

    m.recordContainerEvent(pod, container, containerID, v1.EventTypeNormal, events.StartedContainer, fmt.Sprintf("Started container %s", container.Name))

 

    // Symlink container logs to the legacy container log location for cluster logging

    // support.

    // TODO(random-liu): Remove this after cluster logging supports CRI container log path.

    containerMeta := containerConfig.GetMetadata()

    sandboxMeta := podSandboxConfig.GetMetadata()

    legacySymlink := legacyLogSymlink(containerID, containerMeta.Name, sandboxMeta.Name,

        sandboxMeta.Namespace)

    containerLog := filepath.Join(podSandboxConfig.LogDirectory, containerConfig.LogPath)

    // only create legacy symlink if containerLog path exists (or the error is not IsNotExist).

    // Because if containerLog path does not exist, only dangling legacySymlink is created.

    // This dangling legacySymlink is later removed by container gc, so it does not make sense

    // to create it in the first place. it happens when journald logging driver is used with docker.

    if _, err := m.osInterface.Stat(containerLog); !os.IsNotExist(err) {

        if err := m.osInterface.Symlink(containerLog, legacySymlink); err != nil {

            klog.ErrorS(err, "Failed to create legacy symbolic link""path", legacySymlink,

                "containerID", containerID, "containerLogPath", containerLog)

        }

    }

 

    // Step 4: execute the post start hook.

    if container.Lifecycle != nil && container.Lifecycle.PostStart != nil {

        kubeContainerID := kubecontainer.ContainerID{

            Type: m.runtimeName,

            ID:   containerID,

        }

        msg, handlerErr := m.runner.Run(kubeContainerID, pod, container, container.Lifecycle.PostStart)

        if handlerErr != nil {

            m.recordContainerEvent(pod, container, kubeContainerID.ID, v1.EventTypeWarning, events.FailedPostStartHook, msg)

            if err := m.killContainer(pod, kubeContainerID, container.Name, "FailedPostStartHook", reasonFailedPostStartHook, nil); err != nil {

                klog.ErrorS(fmt.Errorf("%s: %v", ErrPostStartHook, handlerErr), "Failed to kill container""pod", klog.KObj(pod),

                    "podUID", pod.UID, "containerName", container.Name, "containerID", kubeContainerID.String())

            }

            return msg, fmt.Errorf("%s: %v", ErrPostStartHook, handlerErr)

        }

    }

 

    return "", nil

}

(1)关注下创建容器,kubelet调用docker csi,相当于执行 docker create 命令快讯

pkg/kubelet/cri/remote/remote_runtime.go:

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

// CreateContainer creates a new container in the specified PodSandbox.

func (r *remoteRuntimeService) CreateContainer(podSandBoxID string, config *runtimeapi.ContainerConfig, sandboxConfig *runtimeapi.PodSandboxConfig) (string, error) {

    klog.V(10).InfoS("[RemoteRuntimeService] CreateContainer""podSandboxID", podSandBoxID, "timeout", r.timeout)

    ctx, cancel := getContextWithTimeout(r.timeout)

    defer cancel()

 

    resp, err := r.runtimeClient.CreateContainer(ctx, &runtimeapi.CreateContainerRequest{

        PodSandboxId:  podSandBoxID,

        Config:        config,

        SandboxConfig: sandboxConfig,

    })

    if err != nil {

        klog.ErrorS(err, "CreateContainer in sandbox from runtime service failed""podSandboxID", podSandBoxID)

        return "", err

    }

 

    klog.V(10).InfoS("[RemoteRuntimeService] CreateContainer""podSandboxID", podSandBoxID, "containerID", resp.ContainerId)

    if resp.ContainerId == "" {

        errorMessage := fmt.Sprintf("ContainerId is not set for container %q", config.GetMetadata())

        err := errors.New(errorMessage)

        klog.ErrorS(err, "CreateContainer failed")

        return "", err

    }

 

    return resp.ContainerId, nil

}

(2)start容器,kubelet调用docker csi,相当于执行 docker start 命令:

pkg/kubelet/cri/remote/remote_runtime.go:

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

// StartContainer starts the container.

func (r *remoteRuntimeService) StartContainer(containerID string) error {

    klog.V(10).InfoS("[RemoteRuntimeService] StartContainer""containerID", containerID, "timeout", r.timeout)

    ctx, cancel := getContextWithTimeout(r.timeout)

    defer cancel()

 

    _, err := r.runtimeClient.StartContainer(ctx, &runtimeapi.StartContainerRequest{

        ContainerId: containerID,

    })

    if err != nil {

        klog.ErrorS(err, "StartContainer from runtime service failed""containerID", containerID)

        return err

    }

    klog.V(10).InfoS("[RemoteRuntimeService] StartContainer Response""containerID", containerID)

 

    return nil

}

(3)运行容器postStart钩子函数(kubelet):

pkg/kubelet/lifecycle/handlers.go:

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

func (hr *handlerRunner) Run(containerID kubecontainer.ContainerID, pod *v1.Pod, container *v1.Container, handler *v1.Handler) (string, error) {

    switch {

    case handler.Exec != nil:

        var msg string

        // TODO(tallclair): Pass a proper timeout value.

        output, err := hr.commandRunner.RunInContainer(containerID, handler.Exec.Command, 0)

        if err != nil {

            msg = fmt.Sprintf("Exec lifecycle hook (%v) for Container %q in Pod %q failed - error: %v, message: %q", handler.Exec.Command, container.Name, format.Pod(pod), err, string(output))

            klog.V(1).ErrorS(err, "Exec lifecycle hook for Container in Pod failed""execCommand", handler.Exec.Command, "containerName", container.Name, "pod", klog.KObj(pod), "message", string(output))

        }

        return msg, err

    case handler.HTTPGet != nil:

        msg, err := hr.runHTTPHandler(pod, container, handler)

        if err != nil {

            msg = fmt.Sprintf("HTTP lifecycle hook (%s) for Container %q in Pod %q failed - error: %v, message: %q", handler.HTTPGet.Path, container.Name, format.Pod(pod), err, msg)

            klog.V(1).ErrorS(err, "HTTP lifecycle hook for Container in Pod failed""path", handler.HTTPGet.Path, "containerName", container.Name, "pod", klog.KObj(pod))

        }

        return msg, err

    default:

        err := fmt.Errorf("invalid handler: %v", handler)

        msg := fmt.Sprintf("Cannot run handler: %v", err)

        klog.ErrorS(err, "Cannot run handler")

        return msg, err

    }

}

cri-dockerd源码:

(1)创建容器

core/container_create.go:

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

81

82

83

84

85

86

87

88

89

90

91

92

93

94

95

96

97

98

99

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

// CreateContainer creates a new container in the given PodSandbox

// Docker cannot store the log to an arbitrary location (yet), so we create an

// symlink at LogPath, linking to the actual path of the log.

func (ds *dockerService) CreateContainer(

    _ context.Context,

    r *v1.CreateContainerRequest,

) (*v1.CreateContainerResponse, error) {

    podSandboxID := r.PodSandboxId

    config := r.GetConfig()

    sandboxConfig := r.GetSandboxConfig()

 

    if config == nil {

        return nil, fmt.Errorf("container config is nil")

    }

    if sandboxConfig == nil {

        return nil, fmt.Errorf("sandbox config is nil for container %q", config.Metadata.Name)

    }

 

    labels := makeLabels(config.GetLabels(), config.GetAnnotations())

    // Apply a the container type label.

    labels[containerTypeLabelKey] = containerTypeLabelContainer

    // Write the container log path in the labels.

    labels[containerLogPathLabelKey] = filepath.Join(sandboxConfig.LogDirectory, config.LogPath)

    // Write the sandbox ID in the labels.

    labels[sandboxIDLabelKey] = podSandboxID

 

    apiVersion, err := ds.getDockerAPIVersion()

    if err != nil {

        return nil, fmt.Errorf("unable to get the docker API version: %v", err)

    }

 

    image := ""

    if iSpec := config.GetImage(); iSpec != nil {

        image = iSpec.Image

    }

    containerName := makeContainerName(sandboxConfig, config)

    mounts := config.GetMounts()

    terminationMessagePath, _ := config.Annotations["io.kubernetes.container.terminationMessagePath"]

 

    sandboxInfo, err := ds.client.InspectContainer(r.GetPodSandboxId())

    if err != nil {

        return nil, fmt.Errorf("unable to get container's sandbox ID: %v", err)

    }

    createConfig := dockerbackend.ContainerCreateConfig{

        Name: containerName,

        Config: &container.Config{

            Entrypoint: strslice.StrSlice(config.Command),

            Cmd:        strslice.StrSlice(config.Args),

            Env:        libdocker.GenerateEnvList(config.GetEnvs()),

            Image:      image,

            WorkingDir: config.WorkingDir,

            Labels:     labels,

            // Interactive containers:

            OpenStdin: config.Stdin,

            StdinOnce: config.StdinOnce,

            Tty:       config.Tty,

            // Disable Docker's health check until we officially support it

            // (https://github.com/kubernetes/kubernetes/issues/25829).

            Healthcheck: &container.HealthConfig{

                Test: []string{"NONE"},

            },

        },

        HostConfig: &container.HostConfig{

            Mounts: libdocker.GenerateMountBindings(mounts, terminationMessagePath),

            RestartPolicy: container.RestartPolicy{

                Name: "no",

            },

            Runtime: sandboxInfo.HostConfig.Runtime,

        },

    }

 

    // Only request relabeling if the pod provides an SELinux context. If the pod

    // does not provide an SELinux context relabeling will label the volume with

    // the container's randomly allocated MCS label. This would restrict access

    // to the volume to the container which mounts it first.

    if selinuxOpts := config.GetLinux().GetSecurityContext().GetSelinuxOptions(); selinuxOpts != nil {

        mountLabel, err := selinuxMountLabel(selinuxOpts)

        if err != nil {

            return nil, fmt.Errorf("unable to generate SELinux mount label: %v", err)

        }

        if mountLabel != "" {

            // Equates to "Z" in the old bind API

            const shared = false

            for _, m := range mounts {

                if m.SelinuxRelabel {

                    if err := label.Relabel(m.HostPath, mountLabel, shared); err != nil {

                        return nil, fmt.Errorf("unable to relabel %q with %q: %v", m.HostPath, mountLabel, err)

                    }

                }

            }

        }

    }

 

    hc := createConfig.HostConfig

    err = ds.updateCreateConfig(

        &createConfig,

        config,

        sandboxConfig,

        podSandboxID,

        securityOptSeparator,

        apiVersion,

    )

    if err != nil {

        return nil, fmt.Errorf("failed to update container create config: %v", err)

    }

    // Set devices for container.

    devices := make([]container.DeviceMapping, len(config.Devices))

    for i, device := range config.Devices {

        devices[i] = container.DeviceMapping{

            PathOnHost:        device.HostPath,

            PathInContainer:   device.ContainerPath,

            CgroupPermissions: device.Permissions,

        }

    }

    hc.Resources.Devices = devices

 

    securityOpts, err := ds.getSecurityOpts(

        config.GetLinux().GetSecurityContext().GetSeccomp(),

        securityOptSeparator,

    )

    if err != nil {

        return nil, fmt.Errorf(

            "failed to generate security options for container %q: %v",

            config.Metadata.Name,

            err,

        )

    }

 

    hc.SecurityOpt = append(hc.SecurityOpt, securityOpts...)

 

    cleanupInfo, err := ds.applyPlatformSpecificDockerConfig(r, &createConfig)

    if err != nil {

        return nil, err

    }

 

    createResp, createErr := ds.client.CreateContainer(createConfig)

    if createErr != nil {

        createResp, createErr = recoverFromCreationConflictIfNeeded(

            ds.client,

            createConfig,

            createErr,

        )

    }

 

    if createResp != nil {

        containerID := createResp.ID

 

        if cleanupInfo != nil {

            // we don't perform the clean up just yet at that could destroy information

            // needed for the container to start (e.g. Windows credentials stored in

            // registry keys); instead, we'll clean up when the container gets removed

            ds.setContainerCleanupInfo(containerID, cleanupInfo)

        }

        return &v1.CreateContainerResponse{ContainerId: containerID}, nil

    }

 

    // the creation failed, let's clean up right away - we ignore any errors though,

    // this is best effort

    ds.performPlatformSpecificContainerCleanupAndLogErrors(containerName, cleanupInfo)

 

    return nil, createErr

}

调用CreateContainer方法(libdocker/kube_docker_client.go),然后作为 docker 客户端调用 docker 服务端 ContainerCreate 方法。

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

func (d *kubeDockerClient) CreateContainer(

    opts dockerbackend.ContainerCreateConfig,

) (*dockercontainer.CreateResponse, error) {

    ctx, cancel := context.WithTimeout(context.Background(), d.timeout)

    defer cancel()

    // we provide an explicit default shm size as to not depend on docker daemon.

    if opts.HostConfig != nil && opts.HostConfig.ShmSize <= 0 {

        opts.HostConfig.ShmSize = defaultShmSize

    }

    createResp, err := d.client.ContainerCreate(

        ctx,

        opts.Config,

        opts.HostConfig,

        opts.NetworkingConfig,

        nil,

        opts.Name,

    )

    if ctxErr := contextError(ctx); ctxErr != nil {

        return nil, ctxErr

    }

    if err != nil {

        return nil, err

    }

    return &createResp, nil

}

vendor/github.com/docker/docker/client/container_create.go:

+ View Code

(2)start容器

core/container_start.go

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

// StartContainer starts the container.

func (ds *dockerService) StartContainer(

    _ context.Context,

    r *v1.StartContainerRequest,

) (*v1.StartContainerResponse, error) {

    err := ds.client.StartContainer(r.ContainerId)

 

    // Create container log symlink for all containers (including failed ones).

    if linkError := ds.createContainerLogSymlink(r.ContainerId); linkError != nil {

        // Do not stop the container if we failed to create symlink because:

        //   1. This is not a critical failure.

        //   2. We don't have enough information to properly stop container here.

        // Kubelet will surface this error to user via an event.

        return nil, linkError

    }

 

    if err != nil {

        err = transformStartContainerError(err)

        return nil, fmt.Errorf("failed to start container %q: %v", r.ContainerId, err)

    }

 

    return &v1.StartContainerResponse{}, nil

}

libdocker/kube_docker_client.go

1

2

3

4

5

6

7

8

9

func (d *kubeDockerClient) StartContainer(id string) error {

    ctx, cancel := context.WithTimeout(context.Background(), d.timeout)

    defer cancel()

    err := d.client.ContainerStart(ctx, id, dockercontainer.StartOptions{})

    if ctxErr := contextError(ctx); ctxErr != nil {

        return ctxErr

    }

    return err

}

github.com/docker/docker/client/container_start.go

1

2

3

4

5

6

7

8

9

10

11

12

13

14

// ContainerStart sends a request to the docker daemon to start a container.

func (cli *Client) ContainerStart(ctx context.Context, containerID string, options container.StartOptions) error {

    query := url.Values{}

    if len(options.CheckpointID) != 0 {

        query.Set("checkpoint", options.CheckpointID)

    }

    if len(options.CheckpointDir) != 0 {

        query.Set("checkpoint-dir", options.CheckpointDir)

    }

 

    resp, err := cli.post(ctx, "/containers/"+containerID+"/start", query, nil, nil)

    ensureReaderClosed(resp)

    return err

}

moby源码(docker改名为moby):

(1)创建容器

api/server/router/container/container.go:

1

router.NewPostRoute("/containers/create", r.postContainersCreate),

api/server/router/container/container_routes.go:

+ View Code

(2)start容器

api/server/router/container/container.go:

1

router.NewPostRoute("/containers/{name:.*}/start", r.postContainersStart),

daemon/start.go:

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

81

82

83

84

85

86

87

88

89

90

91

92

93

94

95

96

97

98

99

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

// containerStart prepares the container to run by setting up everything the

// container needs, such as storage and networking, as well as links

// between containers. The container is left waiting for a signal to

// begin running.

func (daemon *Daemon) containerStart(container *container.Container, checkpoint string, checkpointDir string, resetRestartManager bool) (err error) {

    start := time.Now()

    container.Lock()

    defer container.Unlock()

 

    if resetRestartManager && container.Running { // skip this check if already in restarting step and resetRestartManager==false

        return nil

    }

 

    if container.RemovalInProgress || container.Dead {

        return errdefs.Conflict(errors.New("container is marked for removal and cannot be started"))

    }

 

    if checkpointDir != "" {

        // TODO(mlaventure): how would we support that?

        return errdefs.Forbidden(errors.New("custom checkpointdir is not supported"))

    }

 

    // if we encounter an error during start we need to ensure that any other

    // setup has been cleaned up properly

    defer func() {

        if err != nil {

            container.SetError(err)

            // if no one else has set it, make sure we don't leave it at zero

            if container.ExitCode() == 0 {

                container.SetExitCode(128)

            }

            if err := container.CheckpointTo(daemon.containersReplica); err != nil {

                logrus.Errorf("%s: failed saving state on start failure: %v", container.ID, err)

            }

            container.Reset(false)

 

            daemon.Cleanup(container)

            // if containers AutoRemove flag is set, remove it after clean up

            if container.HostConfig.AutoRemove {

                container.Unlock()

                if err := daemon.ContainerRm(container.ID, &types.ContainerRmConfig{ForceRemove: true, RemoveVolume: true}); err != nil {

                    logrus.Errorf("can't remove container %s: %v", container.ID, err)

                }

                container.Lock()

            }

        }

    }()

 

    if err := daemon.conditionalMountOnStart(container); err != nil {

        return err

    }

 

    if err := daemon.initializeNetworking(container); err != nil {

        return err

    }

 

    spec, err := daemon.createSpec(container)

    if err != nil {

        return errdefs.System(err)

    }

 

    if resetRestartManager {

        container.ResetRestartManager(true)

        container.HasBeenManuallyStopped = false

    }

 

    if err := daemon.saveAppArmorConfig(container); err != nil {

        return err

    }

 

    if checkpoint != "" {

        checkpointDir, err = getCheckpointDir(checkpointDir, checkpoint, container.Name, container.ID, container.CheckpointDir(), false)

        if err != nil {

            return err

        }

    }

 

    shim, createOptions, err := daemon.getLibcontainerdCreateOptions(container)

    if err != nil {

        return err

    }

 

    ctx := context.TODO()

 

    err = daemon.containerd.Create(ctx, container.ID, spec, shim, createOptions)

    if err != nil {

        if errdefs.IsConflict(err) {

            logrus.WithError(err).WithField("container", container.ID).Error("Container not cleaned up from containerd from previous run")

            // best effort to clean up old container object

            daemon.containerd.DeleteTask(ctx, container.ID)

            if err := daemon.containerd.Delete(ctx, container.ID); err != nil && !errdefs.IsNotFound(err) {

                logrus.WithError(err).WithField("container", container.ID).Error("Error cleaning up stale containerd container object")

            }

            err = daemon.containerd.Create(ctx, container.ID, spec, shim, createOptions)

        }

        if err != nil {

            return translateContainerdStartErr(container.Path, container.SetExitCode, err)

        }

    }

 

    // TODO(mlaventure): we need to specify checkpoint options here

    pid, err := daemon.containerd.Start(context.Background(), container.ID, checkpointDir,

        container.StreamConfig.Stdin() != nil || container.Config.Tty,

        container.InitializeStdio)

    if err != nil {

        if err := daemon.containerd.Delete(context.Background(), container.ID); err != nil {

            logrus.WithError(err).WithField("container", container.ID).

                Error("failed to delete failed start container")

        }

        return translateContainerdStartErr(container.Path, container.SetExitCode, err)

    }

 

    container.HasBeenManuallyRestarted = false

    container.SetRunning(pid, true)

    container.HasBeenStartedBefore = true

    daemon.setStateCounter(container)

 

    daemon.initHealthMonitor(container)

 

    if err := container.CheckpointTo(daemon.containersReplica); err != nil {

        logrus.WithError(err).WithField("container", container.ID).

            Errorf("failed to store container")

    }

 

    daemon.LogContainerEvent(container, "start")

    containerActions.WithValues("start").UpdateSince(start)

 

    return nil

}

3.2 PreStop

  源码分析见《详解Kubernetes Pod优雅退出》这篇博文,本文不再赘余。

4、postStart 异步执行

  在第三章节讲述开始容器方法时,我们已经很清晰知道,开始容器方法先运行容器,再运行运行容器 postStart 钩子函数

  需要注意的事,docker start 命令在启动容器时,并不会等待 ENTRYPOINT 命令执行完毕后才返回。它只会等待容器的主进程启动并确认其正常运行,然后立即返回。换句话说,docker start 命令返回时,ENTRYPOINT 命令已经开始执行,但不一定已经执行完毕。

  所以PostStart的执行相对于容器主进程的执行是异步的,它会在容器start后立刻触发,并不能保证PostStart钩子在容器ENTRYPOINT执行完毕之前运行。

4.1 关于postStart异步执行测试

1

2

3

4

5

6

7

8

9

10

11

12

13

apiVersion: v1

kind: Pod

metadata:

  name: test-post-start

spec:

  containers:

  - name: test-post-start-container

    image: busybox

    command: ["/bin/sh", "-c", "sleep 5 && echo $(date) 'written by entrypoint' >> log.log && sleep 600"]

    lifecycle:

      postStart:

        exec:

          command: ["/bin/sh", "-c", "sleep 10 && echo $(date) 'written by post start' >> log.log"]

创建上面的pod,通过进入pod,查看log.log打印日志,证明:

  • postStart是否会挡住主进程的启动
  • postStart是否是异步执行

如果 postStart 会阻挡 ENTRYPOINT 的启动,则日志文件内容应该是:

1

2

(时间点 T)written by post start

(时间点 T + 约 10 秒)written by entrypoint

否则内容应该是:

1

2

(时间点 T)written by entrypoint

(时间点 T + 约 5 秒)written by post start

实验结果(打印时间相差5秒):

1

2

3

/ # cat log.log

Thu Jun 4 06:14:50 UTC 2020 written by entrypoint

Thu Jun 4 06:14:55 UTC 2020 written by post start

修改YAML文件:

1

2

3

4

5

6

7

8

9

10

11

12

13

apiVersion: v1

kind: Pod

metadata:

  name: test-post-start

spec:

  containers:

  - name: test-post-start-container

    image: busybox

    command: ["/bin/sh", "-c", "sleep 15 && echo $(date) 'written by entrypoint' >> log.log && sleep 600"]

    lifecycle:

      postStart:

        exec:

          command: ["/bin/sh", "-c", "sleep 10 && echo $(date) 'written by post start' >> log.log"]

如果 PostStart 不是异步执行,则日志文件内容应该是:

1

2

(时间点 T)written by entrypoint

(时间点 T + 约 5 秒)written by post start

否则内容应该是:

1

2

(时间点 T)written by post start

(时间点 T + 约 5 秒)written by entrypoint

实验结果(时间相差5秒):

1

2

3

4

5

[root@master k8s]# kubectl exec -it test-post-start sh

/ # cat log.log

Thu Jun 4 06:17:54 UTC 2020 written by post start

Thu Jun 4 06:17:59 UTC 2020 written by entrypoint

/ #

4.2 结论

  • postStart不会挡住主进程的启动;
  • postStart的执行相对于容器主进程的执行是异步的,它会在容器start后立刻触发,并不能保证PostStart钩子在容器ENTRYPOINT指令执行完毕之前运行。

5、使用场景

5.1 postStart

  • 数据库连接:在容器启动后,可以使用 postStart 钩子来建立数据库连接,并确保应用程序在启动时可以正常访问数据库;
  • 文件下载:容器启动后,可以使用 postStart 钩子从外部下载文件,并将其放置在容器内部以供应用程序使用;
  • 启动后台任务:在容器启动后,可以使用 postStart 钩子来启动或触发后台任务,例如数据同步、日志收集等。

5.2 preStop

  • 优雅终止:在容器终止之前,可以使用 preStop 钩子发送信号或通知给应用程序,让应用程序优雅地处理未完成的请求或任务,并进行清理操作;
  • 数据持久化:在容器终止之前,可以使用 preStop 钩子将容器中的数据持久化到外部存储,以确保数据不会丢失;
  • 日志上传:在容器终止之前,可以使用 preStop 钩子将容器中的日志上传到中央日志系统,以便进一步分析和存档。

6、总结

  容器生命周期钩子(postStart和preStop)提供在容器启动后和停止前执行自定义操作的能力,适用于数据库连接、文件下载、优雅终止等场景。postStart平时用的场景不是很多,重点关注preStop。

相关实践学习
通过Ingress进行灰度发布
本场景您将运行一个简单的应用,部署一个新的应用用于新的发布,并通过Ingress能力实现灰度发布。
容器应用与集群管理
欢迎来到《容器应用与集群管理》课程,本课程是“云原生容器Clouder认证“系列中的第二阶段。课程将向您介绍与容器集群相关的概念和技术,这些概念和技术可以帮助您了解阿里云容器服务ACK/ACK Serverless的使用。同时,本课程也会向您介绍可以采取的工具、方法和可操作步骤,以帮助您了解如何基于容器服务ACK Serverless构建和管理企业级应用。 学习完本课程后,您将能够: 掌握容器集群、容器编排的基本概念 掌握Kubernetes的基础概念及核心思想 掌握阿里云容器服务ACK/ACK Serverless概念及使用方法 基于容器服务ACK Serverless搭建和管理企业级网站应用
相关文章
|
8天前
|
Kubernetes Cloud Native Docker
云原生时代的容器化实践:Docker和Kubernetes入门
【10月更文挑战第37天】在数字化转型的浪潮中,云原生技术成为企业提升敏捷性和效率的关键。本篇文章将引导读者了解如何利用Docker进行容器化打包及部署,以及Kubernetes集群管理的基础操作,帮助初学者快速入门云原生的世界。通过实际案例分析,我们将深入探讨这些技术在现代IT架构中的应用与影响。
34 2
|
18天前
|
Kubernetes 监控 开发者
掌握容器化:Docker与Kubernetes的最佳实践
【10月更文挑战第26天】本文深入探讨了Docker和Kubernetes的最佳实践,涵盖Dockerfile优化、数据卷管理、网络配置、Pod设计、服务发现与负载均衡、声明式更新等内容。同时介绍了容器化现有应用、自动化部署、监控与日志等开发技巧,以及Docker Compose和Helm等实用工具。旨在帮助开发者提高开发效率和系统稳定性,构建现代、高效、可扩展的应用。
|
10天前
|
存储 Kubernetes Docker
【赵渝强老师】Kubernetes中Pod的基础容器
Pod 是 Kubernetes 中的基本单位,代表集群上运行的一个进程。它由一个或多个容器组成,包括业务容器、基础容器、初始化容器和临时容器。基础容器负责维护 Pod 的网络空间,对用户透明。文中附有图片和视频讲解,详细介绍了 Pod 的组成结构及其在网络配置中的作用。
【赵渝强老师】Kubernetes中Pod的基础容器
|
10天前
|
运维 Kubernetes Shell
【赵渝强老师】K8s中Pod的临时容器
Pod 是 Kubernetes 中的基本调度单位,由一个或多个容器组成,包括业务容器、基础容器、初始化容器和临时容器。临时容器用于故障排查和性能诊断,不适用于构建应用程序。当 Pod 中的容器异常退出或容器镜像不包含调试工具时,临时容器非常有用。文中通过示例展示了如何使用 `kubectl debug` 命令创建临时容器进行调试。
|
10天前
|
Kubernetes 调度 容器
【赵渝强老师】K8s中Pod中的业务容器
Pod 是 Kubernetes 中的基本调度单元,由一个或多个容器组成。除了业务容器,Pod 还包括基础容器、初始化容器和临时容器。本文通过示例介绍如何创建包含业务容器的 Pod,并提供了一个视频讲解。示例中创建了一个名为 &quot;busybox-container&quot; 的业务容器,并使用 `kubectl create -f firstpod.yaml` 命令部署 Pod。
|
10天前
|
Kubernetes 容器 Perl
【赵渝强老师】K8s中Pod中的初始化容器
Kubernetes的Pod包含业务容器、基础容器、初始化容器和临时容器。初始化容器在业务容器前运行,用于执行必要的初始化任务。本文介绍了初始化容器的作用、配置方法及优势,并提供了一个示例。
|
10天前
|
Kubernetes 监控 Java
如何在Kubernetes中配置镜像和容器的定期垃圾回收
如何在Kubernetes中配置镜像和容器的定期垃圾回收
|
10天前
|
存储 Kubernetes 调度
深度解析Kubernetes中的Pod生命周期管理
深度解析Kubernetes中的Pod生命周期管理
|
14天前
|
关系型数据库 MySQL API
|
7天前
|
缓存 监控 开发者
掌握Docker容器化技术:提升开发效率的利器
在现代软件开发中,Docker容器化技术成为提升开发效率和应用部署灵活性的重要工具。本文介绍Docker的基本概念,并分享Dockerfile最佳实践、容器网络配置、环境变量和秘密管理、容器监控与日志管理、Docker Compose以及CI/CD集成等技巧,帮助开发者更高效地利用Docker。

推荐镜像

更多