Cloud Assistant Overview
Updated at：2025-10-20
Overview
Baidu AI Cloud's cloud assistant serves as the native operation and maintenance (O&M) deployment tool for Baidu Cloud Compute (BCC) and bare metal BBC. Without requiring remote instance access, the cloud assistant can automatically execute commands such as PowerShell or Shell in batches, enabling tasks like running automated maintenance scripts, installing/uninstalling software, updating applications, and applying patches.
Application scenarios
- Automated O&M script upload and execution
- Execution of existing scripts on running instances
- Batch code deployment
- Batch software/application installation
- Software lifecycle management
- Patch installation or security updates
- Hostname or user login password modification
Product advantages
- Free: Cloud assistant BCC and BBC instances provide complimentary O&M tools without additional charges
- Best practice: Baidu AI Cloud has compiled a variety of commonly used cloud assistant commands, suitable for one-click command execution or command customization by modifying them
- Unified permission: All cloud assistant operations require authentication; only users with cloud assistant permissions can use them
Terminology
Before using cloud assistant, you should understand the following core concepts:
| Term | Meaning |
|---|---|
| Cloud assistant client (BSM-Agent) | A lightweight plugin is installed in BCC instances, allowing all commands within the instance to be executed through the client. In Windows operating systems, the task process is identified as baiduyun.service, while in Linux systems, the task process is also named baiduyun.service. |
| Command | Execute specific commands within the instance, such as running a Shell script or PowerShell script. |
| Custom parameters | Command variables are denoted as {{key}}, allowing custom parameter values to be set as {{"key":"value"}}during execution. Due to quota limitations on cloud assistant commands you can retain in a region, it is recommended to enhance command flexibility and multi-scenario applicability by setting custom parameters. You can also specify built-in environment parameters as custom parameters and manually assign values to parameters during command execution. |
| Execution plan | Support for immediate execution: Instantly run commands on one or multiple instances. |
Task status description
For tasks executed on BCC instances, the task status displays execution progress. The task status and their corresponding status are as follows:
| Status | Description |
|---|---|
| Execution in progress | The command is currently being executed, indicating that for selected instances (some or all), execution status is "In Progress." |
| Execution failed | The command cannot be executed, or the process remains incomplete after exceeding the Timeout duration. |
| Execution completed | The command has been successfully executed. Completion of execution does not guarantee success. You need to check the actual Output and ExitCode of the command process to view whether it is successfully executed as expected. |
| Partial failure | The command execution has failed on certain instances. |
Cloud assistant usage restrictions
| Restrictions | Restriction |
|---|---|
| Support region | North China-Beijing, North China-Baoding, South China-Guangzhou, East China-Suzhou, Central China-Wuhan (Financial) |
| Maximum script command size | 18KB |
| Maximum count of custom parameters for a single command | 20 counts |
| Maximum instance count per command execution | 1,000 units |
| Maximum upload file size | 36KB |
| Cloud assistant client supported OS | Linux OS (including CentOS 7.1-7.9, CentOS 8.0-8.4; Ubuntu 16.04/18.04/20.04; Debian 9.1/9.9/9.13/10.3-10.10 or later) and Windows OS |