Deploy an application using an image from an ACR instance in the same account - Serverless App Engine

If your Serverless App Engine (SAE) application and Alibaba Cloud Container Registry (ACR) instance are in the same account, you must ensure that the application's network can access the ACR instance. You can then select an image from the ACR instance to deploy the application.

Prerequisites

Ensure the SAE application's network can access the ACR instance

The SAE application and the ACR instance must be in the same region.

For an ACR Enterprise Edition instance, you must also configure network access control for the virtual private cloud and add the VPC of the SAE application.
For an ACR Personal Edition instance, no additional configuration is required.

How to view the VPC of an SAE application

Before you deploy an application, you must plan its region and namespace. The region and namespace determine the VPC where the application resides.

Log on to the SAE console. In the top navigation bar, select a region. In the navigation pane on the left, choose Namespaces.
Click the target namespace in the list. In the navigation pane on the left, choose Basic Information. Click the Virtual Private Cloud (VPC) link to view details such as the VPC ID.

Procedure

On the SAE Application List page, select the target region and namespace in the top navigation bar, and then click Create Application.
Select an application edition.
Important
The Lightweight Edition and Professional Edition are in an invite-only beta testing phase. If you are not part of the beta test, the application is created as the Standard Edition, and you do not need to select an edition.
- Lightweight Edition: Provides the minimum feature set required to run an application. It does not support the Application Monitoring or Microservices Governance features.
- Standard Edition: Includes the Basic Application Monitoring feature. The Advanced Application Monitoring and Microservices Governance features must be enabled and purchased separately.
- Professional Edition: Includes the Advanced Application Monitoring and Microservices Governance features. They do not need to be enabled or purchased separately.
On the Create Application page, specify a custom Application Name and configure the following parameters.
1. Select the namespace type for the application. A namespace is equivalent to a Kubernetes namespace and can be used to isolate resources in different environments. You cannot change the namespace of an application after it is created. Plan accordingly.
  - System Created: Use the default namespace, vSwitch, and security group created by the system in the current region.
  - Existing Namespace: Select the Namespace, vSwitch, and Security Group that you previously created.
2. Set Application Deployment Method to Select Image Deployment, and then click Specify Image. On the Images of Current Alibaba Cloud Account tab, select your ACR image edition. Then, select the image repository and image version to deploy. If you use Container Registry Enterprise Edition, you can enable the image acceleration feature to improve application startup speed.
3. In the Capacity Settings section, set Resource Type, Single Instance Type, and Instances.
  Metric description - Resource Type
  Resource Type includes Default and Hygon. Hygon is in an invite-only beta testing phase. If you are not part of the beta test, Resource Type is automatically set to Default, and you do not need to select it manually.
  To deploy an application using Hygon resources, contact the relevant technical staff in the DingTalk group (ID: 32874633) to enable it. You also need to select a region and zone that support Hygon resources:
  Shanghai region: Supports Zone B, Zone G, and Zone L.
  Beijing region: Supports Zone H and Zone I.
  Hangzhou region: Supports Zone J.
(Optional) Click Next: Advanced Settings to configure the required features.
- Startup Command
  The startup command for an application is determined by the `CMD` or `ENTRYPOINT` set in the image, and no additional configuration is required in SAE. If you have special requirements, you can set a startup command to override the one set in the image.
- Runtime Environment and Lifecycle Management
  You can flexibly change variables or configuration files in the runtime environment after application deployment without rebuilding the image. To do this, you can set environment variables, set hosts bindings, inject configuration information, or inject confidential information.
  You can configure health checks to monitor whether application instances are running normally and are ready to handle business requests. Unhealthy instances are automatically restarted, and business requests are not sent to them until they are ready.
  You can use application lifecycle management to customize the commands that are executed after an application starts and before it stops, and to implement a graceful shutdown.
- Network Access and Service Invocation
  You can use service registration and discovery to enable service invocation between applications. Note: If you use MSE service registration and discovery, additional fees apply.
  You can enable external access to an application by attaching an NLB, attaching a CLB, or configuring a gateway route. Note: NLB, CLB, and gateway routes require additional fees.
  You can configure a NAT Gateway or attach an EIP to an application instance to allow the application to access external resources or services. Note: NAT Gateways and EIPs require additional fees.
- Data Persistence
  You can store application data in NAS, OSS, or a database to prevent data loss when an application is changed or stopped. Note: NAS, OSS, and databases require additional fees.
- Logging and Monitoring
  After you deploy an application, you can view real-time logs and view resource usage and payload without any additional configuration. You can also output logs to SLS or Kafka for centralized management and analysis. Note: SLS and Kafka require additional fees.
  ARMS Monitoring helps you monitor your application's running status, quickly locate faulty and slow interfaces, identify performance bottlenecks, and reproduce invocation parameters. This significantly improves the efficiency of diagnosing online issues.
  For Standard Edition applications, you can view ARMS Basic Edition monitoring data after deployment without additional configuration. In addition, you can purchase ARMS Premium Edition monitoring.
  For Professional Edition applications, after you enable Application Monitoring in the Advanced Settings and complete the deployment, you can View ARMS Premium Edition Monitoring Data. No additional fees are required.
- Other features
  Microservices Governance provides Graceful Start and Shutdown, Traffic Protection, End-to-end Canary Release, and Intra-zone Provider First for Java applications.
  For Standard Edition applications, you can go to the application details page after deployment to enable and purchase the MSE Microservices Governance feature.
  For Professional Edition applications, after you enable Microservices Governance in the Advanced Settings, you can configure Graceful Shutdown and Graceful Start. For more features, go to the application details page after deployment. No additional fees are required.
  You can enable the CPU Burst feature (available only for Standard and Professional editions) to prevent resource waste. This feature is useful when an application requires higher CPU specifications during its startup and loading phase than during normal operation.
  You can decouple and standardize non-business features from the main container by adding a Sidecar container.
Click Create Application with One Click or Create Application.
- The application takes about 1 to 2 minutes to create. You can check the change records to verify that the deployment was successful. If the deployment fails, an application instance is not created. You can troubleshoot the issue using the error message in the Change Details.
- You can view the created application on the Applications > Applications page. To change the application configuration after deployment, click the target application to go to its details page. Then, in the top navigation bar, click Deploy Application or Modify Application Configurations. Note that the application automatically restarts for the new configuration to take effect. We recommend that you perform this operation during off-peak hours.
- You can log on to an application instance using Webshell and interact with the application instance using console commands.
- After you create an application, you can manually adjust the number of instances and the instance type, or automatically adjust the number of instances by configuring an Auto Scaling policy. You can also reduce costs by enabling idle mode.