Serverless App Engine:Deploy a Java web application by using a WAR package in the SAE console

Procedure

1. Log on to the SAE console.

2. In the left-side navigation pane, click Applications. In the top navigation bar, select a region. Then, click Create Application.

3. In the Basic Information step, configure the parameters and click Next: Application Deployment Configurations.

   Parameter	Description
   Application Name	Enter a custom application name.
   VPC	Select a configuration method for the VPC. Valid values: Custom Configuration: If you select this option, you must manually specify the namespace, VPC, vSwitch, and security group for the application that you want to create. Automatic Configuration: If you select this option, SAE automatically specifies the namespace, VPC, vSwitch, and security group for the application.
   Namespace	This parameter is required if you set the VPC parameter to Custom Configuration. Select an existing namespace from the drop-down list. Namespaces and VPCs are in one-to-one mapping relationships. For information about how to modify a VPC, see Create and manage a VPC.
   vSwitch	This parameter is required if you set the VPC parameter to Custom Configuration. Click Select vSwitch. In the Select vSwitch dialog box, select the required vSwitches. You must specify at least one vSwitch. We recommend that you specify no more than three vSwitches. Each vSwitch must match at least one application instance.
   Security Group	This parameter is required if you set the VPC parameter to Custom Configuration. Select a security group from the drop-down list. If you have not created a security group in your VPC, click Create Security Group to create a security group as prompted. For more information, see Create a security group.
   Application Instances	Select the number of instances that you want to create.
   VCPU	Select a CPU specification for the instances that you want to create.
   Memory	Select a memory specification for the instances that you want to create.
   Application Description	Enter a description for the application.

4. In the Deployment Configurations step, configure the parameters.
   
   1. Configure the parameters that are used to deploy an application.

      Parameter	Description
      Technology Stack Programming Language	Select Java.
      Application Deployment Method	Select Deployment with WAR Packages.
      Application Runtime Environment	apache-tomcat-XXX: This option is suitable for Spring Boot applications or Dubbo applications. EDAS-Container-XXX: This option is suitable for high-speed service framework (HSF) applications.
      Java Environment	Dragonwell X (recommended): supports OpenJDK. If you select this option, the startup and runtime of the application are accelerated and garbage collection (GC) efficiency is improved. For more information, see Configure a startup command. Open JDK X: This environment is based on the CentOS operating system and the size of the base image is large. openjdk-XXXXX-jdk-alpine3.9: This environment is based on the Alpine operating system and the size of the base image is small. Note Compared with the CentOS operating system, the Java environment that is based on the Alpine operating system supports fewer tools or commands. If you select openjdk-XXXXX-jdk-alpine3.9, some commands in the webshell may fail to be run. Select an environment based on your business scenario.
      File Upload Method	Select Upload WAR Package or WAR Package Address. Upload WAR Package: Click Select File and select the WAR package that you want to use to deploy the application. WAR Package Address: Enter the directory in which the WAR package is stored. Note The name of the package that you want to use to deploy an application can contain only letters, digits, hyphens (-), and underscores (_).
      Version	The version number of the application. Enter a version number or click Use Timestamp as Version Number.
      Time Zone Settings	Select the time zone of the application. Example: UTC+8.

   2. Optional:Configure the advanced settings based on your business requirements.
      

      Advanced setting	References
      Startup Command Settings	Configure a startup command
      Java Tomcat Settings	Configure Java Tomcat parameters Note You can configure Tomcat settings only if the Application Deployment Method parameter is set to Deployment with WAR Packages.
      Environment Variable Settings	Configure environment variables
      Service Registration and Discovery	Configure application access based on Kubernetes Service names Use the SAE built-in Nacos registry
      Hosts Binding Settings	Configure hosts binding
      Application Health Check	Configure application health checks
      Application Outbound/Inbound Internet Access	Bind an EIP to a NAT gateway Enable Internet access for SAE instances based on EIPs
      Application Lifecycle Management	Configure application lifecycle management
      Log Collection Service	Configure log collection to Simple Log Service Configure log collection to ApsaraMQ for Kafka
      Persistent Storage	Configure NAS storage
      Configuration Management	Inject configurations
      Graceful Start and Shutdown of Microservices	Configure graceful start of microservices Configure graceful shutdown of microservices Note If you set the Application Deployment Method parameter to Deployment with WAR Packages or Deployment with JAR Packages, and set the Application Runtime Environment to EDAS-Container-XXX, this section is not displayed.

5. Click Next: Confirm Specifications.

6. In the Specification Confirmation step, view the details of the application and the fee for the selected specifications. Then, click Confirm.

   The Creation Completed step appears. You can click Application Details to go to the Basic Information page of the application.

Verify the deployment result

After an application is deployed, you can use one of the following methods to verify the deployment result for the application.

• View the running status of application instances.

  1. Log on to the SAE console.

  2. In the left-side navigation pane, click Applications. On the Applications page, click the name of the application that you want to manage.

  3. On the Basic Information page, click the Instance Deployment Information tab to view the running status of the instances.

     If Running or Completed is displayed in the Status column, the application is deployed.

• Add an Internet-facing Classic Load Balancer (CLB) instance to the application.

  After an application is deployed, you can configure a CLB instance to allow access to the application within a specified period of time for other applications.

  CLB instances are classified into the following types:

  • Internal-facing CLB instance: provides an access portal in the VPC where the application resides to ensure that the application can be accessed by other applications in the same VPC.

  • Internet-facing CLB instance: SAE can automatically purchase an Internet-facing CLB instance for an application, or you can use an Internet-facing SLB instance that you purchased in the CLB console. This helps ensure that the application can be accessed by other applications over the Internet.

  Note

  You can allow access to an application by using an Internet-facing CLB instance the same way you allow access to an application by using an internal-facing CLB instance. For more information, see Bind a CLB instance to an application. After a CLB instance is bound to an application, you can enter a URL that consists of the IP address, port, and access path of the CLB instance in the address bar of your browser to access the application. Example: 192.168.XX.XX:80/image.

View application metrics

After an application is deployed, you can view the key performance metrics of the application in the Application Monitoring module.

1. Log on to the SAE console.

2. In the left-side navigation pane, click Applications. In the top navigation bar, select a region. Then, click the name of the application that you want to manage.

3. In the left-side navigation pane, view application monitoring data based on your business requirements.

   • Application Overview: Choose Application Monitoring > Application Overview. The Application Overview page displays the key performance metrics of the application, such as the total number of requests and the average response time.

   • Application Details: Choose Application Monitoring > Application Details. The Application Details page displays more comprehensive application monitoring data, such as the data for JVM monitoring and exception analysis.

   • API Operation Calls: Choose Application Monitoring > API Operation Calls. The API Operation Calls page displays the monitoring data by API operation, such as the call topology, upstream and downstream links.

   • Advanced Monitoring: Choose Application Monitoring > Advanced Monitoring. The Advanced Monitoring page displays higher-performance monitoring and management data, such as global application topology, data of SQL exception analysis, and local call stack.

References