配置应用生命周期的钩子和探针

背景信息

通常应用运行前后和停止前后都会有一些操作，例如运行前部署资源、停止前优雅下线应用或通知其他服务或应用。EDAS依托于K8s完美集成了配置生命周期钩子的功能，支持为容器的生命周期配置PostStart和PreStop钩子。

当您在K8s集群中部署应用时，需要读取Pod的存活状态并确定Pod是否准备好对外提供服务。EDAS依托于K8s完美集成了配置Pod探针的功能，通过配置Liveness探针确定何时重启容器，以及通过配置Readiness探针确定容器是否已经就绪可以接受流量。

在创建应用时配置应用生命周期的钩子和探针

1. 登录EDAS控制台，在左侧导航栏，单击应用管理 > 应用列表，在顶部菜单栏选择地域并在页面上方选择所属微服务空间，然后在应用列表页面左上角，单击创建应用。

2. 在应用基本信息页签，选择集群类型和应用运行环境，然后在页面最下方单击下一步。

   配置项	描述
   集群类型	选择Kubernetes集群。
   应用运行环境	根据选择的托管应用类型选择应用运行环境。 Java： Java：支持通用的JAR包部署，适用于Dubbo和Spring Boot应用。在选择后可更改Java环境。 Tomcat：支持通用的WAR包部署，适用于Dubbo和Spring应用。在选择后可更改Java环境和容器版本。 EDAS-Container（HSF）：适用于使用WAR或者FatJar部署HSF应用。在选择后可更改Java环境、Pandora版本和Ali-Tomcat版本。 自定义：适用于在K8s集群中使用自定义的镜像部署应用。 PHP：适用于运行在Apache HTTP Server中的PHP应用程序。 多语言Node.js、C++、Go...：适用于在K8s集群中使用自定义的镜像部署应用。

3. 在应用配置页签，设置应用的环境信息、基本信息、部署方式和资源参数，设置完成后单击下一步。

4. 在应用高级设置页签展开应用生命周期管理，设置以下参数。

   配置项	描述
   PostStart配置	一种容器钩子。该钩子在容器被创建后立刻触发，通知容器它已经被创建。该钩子不需要向其所对应的Hook Handler传入任何参数。如果该钩子对应的Hook Handler执行失败，则该容器会终止运行，并根据该容器的重启策略决定是否要重启该容器。更多信息，请参见Container Lifecycle Hooks。
   PreStop配置	一种容器钩子。该钩子在容器被删除前触发，其所对应的Hook Handler必须在删除该容器的请求发送给Docker Daemon之前完成。在该钩子对应的Hook Handler完成后不论执行的结果如何，Docker Daemon会发送一个SIGTERN信号给Docker Daemon来删除该容器。更多信息，请参见Container Lifecycle Hooks
   TerminationGracePeriod配置	设置Pod优雅终止超时时间。请确保PreStop操作和应用处理SIGTERM的时间能够在该时间段内完成。您也可以通过调整该配置，控制Pod删除时长。
   Liveness配置	一种探测容器状态的探针，探测应用是否处于健康状态。如果不健康，则删除并重建容器。更多信息，请参见Pod Lifecycle。
   Readiness配置	一种探测容器状态的探针，探测应用是否启动完成并且处于正常服务状态。如果不正常，则更新容器的状态。更多信息，请参见Pod Lifecycle。
   Startup配置	一种探测慢启动容器的存活性的探针，该启动探针可以避免慢启动容器在启动运行之前被杀掉。更多信息，请参见Pod Lifecycle。

5. 完成设置后单击创建应用。

6. 在应用创建完成页签确认应用基本信息、应用配置和应用高级设置等信息，确认完毕后单击确定创建应用。

   在应用总览页面顶部提示信息中，单击查看详情，可在变更记录页面查看变更流程。应用部署需要几分钟，请您耐心等待。变更完成后在应用总览页面的基本信息区域查看实例的运行状态，如果显示为Pod运行中，说明应用部署成功。

在更新应用时配置应用生命周期钩子和探针

除在创建应用时可以配置应用生命周期钩子和探针，您也可以在部署应用时配置或更新钩子和探针。

1. 登录EDAS控制台。

2. 在左侧导航栏，单击应用管理 > 应用列表，在顶部菜单栏选择地域并在页面上方选择所属微服务空间，在集群类型下拉列表，选择K8s集群，然后在页面单击具体的应用名称。

3. 在应用总览或基本信息页面的右上角，选择部署 > 部署。

4. 在选择部署模式页面，选择具体的部署方式，然后在所选方式区域的右上角，单击开始部署。

5. 设置应用的环境和部署包信息后展开应用生命周期管理，根据您的需求完成配置后单击确定。

   配置项	描述
   PostStart配置	一种容器钩子。该钩子在容器被创建后立刻触发，通知容器它已经被创建。该钩子不需要向其所对应的Hook Handler传入任何参数。如果该钩子对应的Hook Handler执行失败，则该容器会终止运行，并根据该容器的重启策略决定是否要重启该容器。更多信息，请参见Container Lifecycle Hooks。
   PreStop配置	一种容器钩子。该钩子在容器被删除前触发，其所对应的Hook Handler必须在删除该容器的请求发送给Docker Daemon之前完成。在该钩子对应的Hook Handler完成后不论执行的结果如何，Docker Daemon会发送一个SIGTERN信号给Docker Daemon来删除该容器。更多信息，请参见Container Lifecycle Hooks
   TerminationGracePeriod配置	设置Pod优雅终止超时时间。请确保PreStop操作和应用处理SIGTERM的时间能够在该时间段内完成。您也可以通过调整该配置，控制Pod删除时长。
   Liveness配置	一种探测容器状态的探针，探测应用是否处于健康状态。如果不健康，则删除并重建容器。更多信息，请参见Pod Lifecycle。
   Readiness配置	一种探测容器状态的探针，探测应用是否启动完成并且处于正常服务状态。如果不正常，则更新容器的状态。更多信息，请参见Pod Lifecycle。
   Startup配置	一种探测慢启动容器的存活性的探针，该启动探针可以避免慢启动容器在启动运行之前被杀掉。更多信息，请参见Pod Lifecycle。

   重要

   单击确定后，该应用将会被重启，请在业务较少的时间段进行。

配置应用生命周期管理

PostStart和PreStop配置

下面以PostStart的配置为例，讲解如何在EDAS中配置应用的PostStart和PreStop容器生命周期钩子。

• Exec模式

  例如，容器在创建成功后，执行以下命令。

  echo "container started"

  在EDAS中有以下两种配置方式：

  • 方式一：将命令拆分为不同的参数。该方式适合命令较短，参数较少的情况。

    

  • 方式二：启动一个Shell，在Shell中执行命令。该方式适合命令较长，参数较多的情况。

    

• HttpGet模式

  以PostStart的HttpGet钩子为例，在容器启动后会向http://example.com:8080/healthz地址发送GET请求。

  

  说明

  如果PostStart或PreStop钩子执行失败，容器会被自动重启，您可以在应用的变更记录中查询PostStart或PreStop执行失败的信息。

Liveness、Readiness和Startup配置

以Liveness配置为例，使用TcpSocket模式，探测的地址为空，因此默认目标地址是Pod的IP地址，探测端口是18081。在容器启动后60秒才开始进行首次探测，探测周期为10秒，只要有1次探测成功即认为Pod存活。每次探测的超时时间是5秒，出现连续3次探测失败，K8s就会终结容器，然后根据重启策略重启容器。

结果验证

配置应用生命周期钩子后，可通过以下示例步骤验证配置结果。

例如，在启动应用前，配置了Hello from the postStart handler的写入脚本。应用部署后，使用Webshell执行以下命令。

cat /usr/share/message

如果文件中存在Hello from the postStart handler，表示配置成功。

EDAS容器服务K8s和Serverless K8s交流群

如果您在EDAS中使用容器服务K8s集群和Serverless K8s集群过程中有任何疑问或建议，请使用钉钉搜索钉钉群号23197114加入钉钉群进行反馈。