All Products
Search
Document Center

Enterprise Distributed Application Service:Configure a startup command

Last Updated:Mar 11, 2026

When you deploy applications to Kubernetes clusters through Enterprise Distributed Application Service (EDAS), the container runs the startup command defined in your Dockerfile by default. To override this default -- for example, to pass custom JVM arguments or change the entrypoint binary -- configure a startup command in the EDAS console.

How startup commands map to Docker directives

The EDAS console fields map directly to Docker directives:

EDAS console fieldDocker equivalentDescription
Startup CommandENTRYPOINTThe executable that runs when the container starts
Startup ParametersCMDArguments passed to the startup command

The following table describes the override behavior when you set these fields in the EDAS console:

ConfigurationBehavior
Startup Command onlyOverrides the Dockerfile ENTRYPOINT. The Dockerfile CMD is ignored (not passed as arguments).
Startup Parameters onlyThe Dockerfile ENTRYPOINT runs with the parameters you specified, replacing the Dockerfile CMD.
Both fieldsReplaces the full ENTRYPOINT + CMD combination from the Dockerfile.
Neither fieldThe container uses the Dockerfile ENTRYPOINT and CMD as-is.

Because only one ENTRYPOINT takes effect at runtime, the values in the EDAS console always take precedence over the Dockerfile.

Important

If you are unfamiliar with the ENTRYPOINT or CMD directives in your Dockerfile, do not customize the startup command. Invalid commands prevent the application from being created.

Example

Given this Dockerfile:

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

The equivalent EDAS console configuration is:

FieldValue
Startup Commandnginx
Startup Parameters-g (first row), daemon off; (second row)

To run a complex command that involves pipes or shell features, wrap it in a shell invocation:

FieldValue
Startup Command/bin/sh
Startup Parameters-c (first row), your-script.sh && echo done (second row)

Configure a startup command during application creation

  1. Log on to the EDAS console.

  2. In the left-side navigation pane, choose Application Management > Applications.

  3. In the top navigation bar, select a region. In the upper part of the page, select a namespace.

  4. In the upper-left corner, click Create Application.

  5. In the Basic Information step, set Cluster Type to Kubernetes Clusters and select an Application Runtime Environment, then click Next.

    Runtime environmentWhen to use
    Java > CustomDeploy with a custom image
    Java > JavaDeploy a Dubbo or Spring Boot application from a JAR package. Set the Java Environment parameter after selection.
    Java > TomcatDeploy a Dubbo or Spring application from a WAR package. Set the Java Environment and Container Version parameters after selection.
    Java > EDAS-Container (HSF)Deploy a High-speed Service Framework (HSF) application from a WAR or FatJar package. Set the Java Environment, Pandora Version, and Ali-Tomcat Version parameters after selection.
    PHPDeploy a PHP application on Apache HTTP Server
    Node.js, C++, Go, and Other LanguagesDeploy with a custom image. The configuration process for multi-language applications is not described in this topic.
  6. In the Configurations step, configure the environment, basic information, deployment method, and resource parameters, then click Next.

  7. In the Advanced Settings step, expand Startup Command and set the following parameters:

    ParameterDescription
    Startup CommandThe executable to run, for example, nginx.
    Startup ParametersOne argument per row. Click Add to add more rows. For example, enter -g in one row and daemon off; in the next.

    Startup Command

  8. Click Create Application.

  9. On the Creation Completed page, review the settings in the Basic Information, Configurations, and Advanced Settings sections, then click Create Application. In the upper part of the Application Overview page, click View Details. On the Change List page, view the application change process. Wait a few minutes for deployment to complete. After the change process is complete, check the instance status in the Basic Information section of the Application Overview page. If a pod is running, the application is deployed.

Configure a startup command for a deployed application

Updating the startup command triggers an application restart. Perform this operation during off-peak hours.

  1. Log on to the EDAS console.

  2. In the left-side navigation pane, choose Application Management > Applications.

  3. In the top navigation bar, select a region. In the upper part of the page, select a namespace.

  4. From the Cluster Type drop-down list, select Container Service or Serverless Kubernetes Cluster.

  5. Click the application name to open its details page.

  6. In the upper-right corner of the Overview or Basic information page, choose Deploy > Deploy.

  7. On the Select Deployment Mode page, select a deployment mode and click Start Deployment.

  8. Specify the deployment package and environment, expand Startup Command, and configure the parameters described in the following table. Then click OK.

    ParameterDescription
    Startup CommandThe executable to run, for example, nginx.
    Startup ParametersOne argument per row. Click Add to add more rows. For example, enter -g in one row and daemon off; in the next.

    Startup Command

Important

The application restarts after you click OK. Perform this operation during off-peak hours.

Verify the result

After deployment completes, confirm the startup command took effect using one of the following methods:

  • Check change records: In the left-side navigation pane of the application details page, click Change Records. If the Change Status column shows Success, the configuration is applied.

  • Check pod status: On the Application Overview page, click Running Pods (Click View) next to Running Status. In the Pod section of the App Configurations panel, check the Status column. A green dot indicates the application is running with the new configuration.