为SAE应用设置启动和运行时的命令和参数 - Serverless 应用引擎

通过SAE控制台使用容器镜像或代码包方式部署应用时，SAE会根据预设的启动参数来启动容器。如果需要在容器启动执行特殊配置（例如Nginx）或不采用预设的启动参数，您可以通过SAE自定义容器的启动命令，以实现特殊配置或覆盖镜像的启动默认参数。

背景信息

在制作镜像时，容器的启动配置已经配置在Dockerfile文件中的ENTRYPOINT或CMD。容器启动时，Dockerfile文件中的内容会被优先执行。

例如，Dockerfile中设置的以下命令，在容器启动时将被第一个执行。

FROM ubuntu
ENTRYPOINT [nginx, '-g', 'daemon off;']

使用说明

启动命令既可以在创建应用过程中，也可以在部署应用过程中配置。配置路径如下。

创建应用：在创建应用页面的应用部署配置配置向导页面配置。
部署应用：
- 当实例数大于等于1时，在目标应用的基本信息页面，单击部署应用，在部署应用页面配置。
- 当实例数等于0时，在目标应用的基本信息页面，单击修改应用配置，在修改应用配置页面配置。
  说明
  应用配置修改后，在下一次应用实例数大于0时，部署应用才会生效。

不同部署方式及应用环境操作步骤类似，但可配置的启动命令不同，您可以根据实际界面配置。

应用托管概述
设置镜像部署应用的启动命令
设置JAR包部署应用的启动命令
设置WAR包部署应用的启动命令
设置ZIP包部署应用的启动命令

设置镜像部署应用的启动命令

以创建Java应用为例，在应用部署配置配置向导页面选择应用部署方式为镜像，展开启动命令设置区域并输入相关配置项。当启动方式选择Docker原生方式，启动命令示例如下。

设置镜像部署启动命令

以ENTRYPOINT: [nginx, '-g', 'daemon off;']为例，参数说明如下。

配置项

说明

启动命令

输入启动命令，例如nginx。

启动参数

输入启动参数，例如-g。

单击+添加，可以在新的参数行中增加输入参数daemon off。

设置JAR包部署应用的启动命令

Java应用启动和运行时需要定义启动命令和参数，如Java的JVM参数、GC策略等。

SAE将上传的JAR包自动编译为镜像，并上传至镜像仓库，且以容器方式运行应用。在编译过程中，SAE会内置启动命令和参数，并指定JAR包的存放路径。您可以登录SAE控制台修改JAR包默认的启动命令及命令参数。

重要

如果您对原有Dockerfile镜像的ENTRYPOINT和CMD配置内容不熟悉，请勿自定义或者修改启动命令和启动参数，错误的启动命令将导致应用创建失败。

以创建Java应用为例，在应用部署配置配置向导页面选择应用部署方式为JAR包部署，展开启动命令设置区域并输入相关配置项。启动命令示例如下。

配置启动命令

配置项	说明
系统默认启动命令	SAE默认的启动命令。
options设置	配置JVM参数。关于参数详情，请参见JVM参数配置说明、Tuning Java Virtual Machines和JVM Tuning: How to Prepare Your Environment for Performance Tuning。如果您需要使用应用的远程调试功能，请根据JDK版本配置所需命令。 JDK 11和JDK 17 `-agentlib:jdwp=transport=dt_socket,address=*:9000,server=y,suspend=n` 其他JDK版本 `-agentlib:jdwp=transport=dt_socket,address=9000,server=y,suspend=n` 参数说明如下。 transport：远程调试间的数据传输方式。 address：远程调试的地址。与开启远程调试时设置的调试端口保持一致。远程调试的详细说明，请参见远程调试。重要以WAR包、JAR包方式部署应用的启动命令不同，请勿共用启动命令。本示例中的远程调试命令，适用于以上两种部署方式。
args设置	配置标准输出和错误输出的重定向命令，例如`1>>/tmp/std.log>&1`。
options快捷设置	只有Java环境为Dragonwell时可以设置。开启微服务性能提升（Wisp 2协程）：默认开启，开启后可以提升运行时多线程性能。开启应用内存优化（G1）：默认开启，开启后可以针对多CPU与大容量内存场景，降低GC时间，适用于GC需要优化、大数据等场景。开启应用启动加速（Quickstart）：只有Java环境为Dragonwell 11时可以设置。选中开启应用启动加速（Quickstart）并设置持久化目录后，可以提升应用启动效率。重要开启应用启动加速前，需要先设置NAS存储。具体操作，请参见设置NAS存储。持久化目录：开启应用加速后需要设置，设置的持久化目录推荐为NAS存储的目录或者子目录，达到跨实例间的加速效果。关于如何设置NAS存储，请参见设置NAS存储。

设置WAR包部署应用的启动命令

以创建Java应用为例，在应用部署配置配置向导页面选择应用部署方式为WAR包部署，展开启动命令设置区域并输入相关配置项。启动命令示例如下。

配置启动参数-WAR包部署应用到SAE

配置项	说明
系统默认启动命令	SAE默认的启动命令。
options设置	配置JVM参数。关于参数详情，请参见JVM参数配置说明、Tuning Java Virtual Machines和JVM Tuning: How to Prepare Your Environment for Performance Tuning。如果您需要使用应用的远程调试功能，请根据JDK版本配置所需命令。 JDK 11和JDK 17 `-agentlib:jdwp=transport=dt_socket,address=*:9000,server=y,suspend=n` 其他JDK版本 `-agentlib:jdwp=transport=dt_socket,address=9000,server=y,suspend=n` 参数说明如下。 transport：远程调试间的数据传输方式。 address：远程调试的地址。与开启远程调试时设置的调试端口保持一致。远程调试的详细说明，请参见远程调试。重要以WAR包、JAR包方式部署应用的启动命令不同，请勿共用启动命令。本示例中的远程调试命令，适用于以上两种部署方式。
options快捷设置	只有Java环境为Dragonwell时可以设置。开启微服务性能提升（Wisp 2协程）：默认开启，开启后可以提升运行时多线程性能。开启应用内存优化（G1）：默认开启，开启后可以针对多CPU与大容量内存场景，降低GC时间，适用于GC需要优化、大数据等场景。开启应用启动加速（Quickstart）：只有Java环境为Dragonwell 11时可以设置。选中开启应用启动加速（Quickstart）并设置持久化目录后，可以提升应用启动效率。重要开启应用启动加速前，需要先设置NAS存储。具体操作，请参见设置NAS存储。持久化目录：开启应用加速后需要设置，设置的持久化目录推荐为NAS存储的目录或者子目录，达到跨实例间的加速效果。关于如何设置NAS存储，请参见设置NAS存储。

设置ZIP包部署应用的启动命令

以创建Python应用为例，在应用部署配置配置向导页面选择应用部署方式为ZIP包部署，展开启动命令设置区域并输入相关配置项。当启动方式选择Shell脚本方式，启动命令示例如下。

gunicorn -w 3 -b 0.0.0.0:8080 app.hello:app

sc_startup_command_for_ptyhon_application_via_shell