Configuring Container Lifecycle Parameters

Scenario

CCE provides callback functions for the lifecycle management of containerized applications. For example, if you want a container to perform a certain operation before stopping, you can register a hook function.

CCE provides the following lifecycle callback functions:

Startup Command: executed to start a container. For details, see Startup Commands.
Post-Start: executed immediately after a container is started. For details, see Post-Start Processing.
Pre-Stop: executed before a container is stopped. The pre-stop processing function helps you ensure that the services running on the pods can be completed in advance in the case of pod upgrade or deletion. For details, see Pre-Stop Processing.

Startup Commands

By default, the default command is executed during image start. To run a specific command or rewrite the default image setting, you must perform specific operations.

A Docker image has metadata that stores image information. If lifecycle commands and arguments are not set, CCE runs the default commands and arguments, that is, Docker instructions ENTRYPOINT and CMD, provided during image creation.

If the commands and arguments used to run a container are set during application creation, the default commands ENTRYPOINT and CMD are overwritten during image build. The rules are as follows:

**Table 1** Commands and arguments used to run a container
Image ENTRYPOINT	Image CMD	Command to Run a Container	Parameters to Run a Container	Command Executed
[touch]	[/root/test]	Not set	Not set	[touch /root/test]
[touch]	[/root/test]	[mkdir]	Not set	[mkdir]
[touch]	[/root/test]	Not set	[/opt/test]	[touch /opt/test]
[touch]	[/root/test]	[mkdir]	[/opt/test]	[mkdir /opt/test]

Enter a command and arguments on the Startup Command tab page.

**Table 2** Container startup command
Configuration Item	Procedure
Command	Enter an executable command, for example, /run/server. If there are multiple executable commands, write them in different lines. NOTE: In the case of multiple commands, you are advised to run /bin/sh or other shell commands. Other commands are used as parameters.
Args	Enter the argument that controls the container running command, for example, --port=8080. If there are multiple arguments, separate them in different lines.

Post-Start Processing

Set the post-start processing parameters on the Post-Start tab page.

**Table 3** Post-start processing parameters
Parameter	Description
CLI	Set commands to be executed in the container for post-start processing. The command format is Command Args[1] Args[2].... Command is a system command or a user-defined executable program. If no path is specified, an executable program in the default path will be selected. If multiple commands need to be executed, write the commands into a script for execution. Commands that are executed in the background or asynchronously are not supported. Example command: exec: command: - /install.sh - install_agent Enter /install install_agent in the script. This command indicates that install.sh will be executed after the container is created successfully.
HTTP request	Send an HTTP request for post-start processing. The related parameters are described as follows: Path: (optional) request URL. Port: (mandatory) request port. Host: (optional) requested host IP address. The default value is the IP address of the pod.

Pre-Stop Processing

Set the pre-start processing parameters on the Pre-Stop tab page.

**Table 4** Pre-stop processing parameters
Parameter	Description
CLI	Set commands to be executed in the container for pre-stop processing. The command format is Command Args[1] Args[2].... Command is a system command or a user-defined executable program. If no path is specified, an executable program in the default path will be selected. If multiple commands need to be executed, write the commands into a script for execution. Example command: exec: command: - /uninstall.sh - uninstall_agent Enter /uninstall uninstall_agent in the script. This command indicates that uninstall.sh will be executed before the container completes its execution and stops running.
HTTP request	Send an HTTP request for pre-stop processing. The related parameters are described as follows: Path: (optional) request URL. Port: (mandatory) request port. Host: (optional) requested host IP address. The default value is the IP address of the pod.

YAML Example

This section uses Nginx as an example to describe how to set the container lifecycle.

In the following configuration file, the postStart command is defined to run the install.sh command in the /bin/bash directory. preStop is defined to run the uninstall.sh command.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx
spec:
  replicas: 1
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - image: nginx 
        command:
        - sleep 3600                        # Startup command
        imagePullPolicy: Always
        lifecycle:
          postStart:
            exec:
              command:
              - /bin/bash
              - install.sh                  # Post-start command
          preStop:
            exec:
              command:
              - /bin/bash
              - uninstall.sh                 # Pre-stop command
        name: nginx
      imagePullSecrets:
      - name: default-secret