Serverless App Engine (SAE) provides a built-in webshell feature that lets you upload files to and download files from application containers directly in the console. This is useful for quick debugging tasks such as extracting logs, pushing configuration files, or inspecting container state without setting up external tools.
Prerequisites
Before you begin, make sure that you have:
A deployed SAE application with at least one running instance
Access to the SAE console
Limitations
| Constraint | Detail |
|---|---|
| Maximum file size | 10 MB per file (upload and download) |
| Intended use | Temporary debugging only. Files are lost when the container restarts. |
For persistent storage or files larger than 10 MB, use File Storage NAS or OSS.
In earlier SAE versions that do not support webshell file transfer, use the OSS command-line tool ossutil to upload and download files. For more information, see Perform routine checks on applications.
Open the webshell terminal
The following steps apply to both uploading and downloading files.
Log on to the SAE console.
In the left-side navigation pane, choose .
In the top navigation bar, select a region. From the Namespace drop-down list, select a namespace. Then click the name of the application that you want to manage.
On the Basic Information page, click the Instances tab.
On the Instances tab, expand the Default Group section. In the Actions column of the target instance, click Webshell. The webshell terminal window opens with a command prompt.
Upload a file
In the upper-right corner of the webshell window, move the pointer over the
icon and select Upload.In the Upload File dialog box, select the file that you want to upload and specify the Destination Path parameter. Destination Path is the absolute path on the container where the file will be stored, for example
/tmp/myfile.log.Click Upload. After the upload completes, a success message appears. To verify, run
ls <destination-path>in the webshell terminal.
Download a file
In the upper-right corner of the webshell window, move the pointer over the
icon and select Download.In the Download File dialog box, specify the Destination Path parameter. Destination Path is the absolute path of the file on the container that you want to download, for example
/home/admin/logs/app.log.Click Download. The file downloads to your local machine through the browser.
Alternatives
| Scenario | Recommended tool |
|---|---|
| Quick debugging with small files (up to 10 MB) | Webshell upload and download |
| Persistent file storage across container restarts | File Storage NAS |
| Large files or automated, scripted transfers | OSS |
| Earlier SAE versions without webshell file transfer | ossutil |