CloudOps Orchestration Service:Extensions

Limits

• The ECS instance must be in the Running state.

• The Cloud Assistant agent is installed on the ECS instance and has a status of Normal.

• Supported operating systems include Alibaba Cloud Linux, CentOS, Ubuntu, Debian, Fedora, and Windows Server. The operating systems that are supported by a specific extension are displayed in the console.

• You can install or uninstall application performance acceleration only on the product pages of Yitian instances (g8y, c8y, and r8y).

The preceding limits apply to public extensions. To install a custom extension, you must also meet the following requirements:

• A custom extension is created, and the installation package of the extension is stored in an Object Storage Service (OSS) bucket.

• To install a custom extension across accounts, the account that owns the extension must first share the extension with the target account, which must be an Alibaba Cloud account. For more information, see Share extensions.

Procedure

If you want to install a custom extension across accounts, you must share the extension first: use the account that owns the extension to go to the details page of the extension, click Add Sharing in the Sharing Status section, and then share the extension with the target account, which must be an Alibaba Cloud account. Then, use the target account to perform the following operations. For more information, see Share extensions.

1. Log on to the OOS console.

2. In the left-side navigation pane, click Quick Setup.

3. On the Configuration Library tab, click Create in the Extensions section.

4. On the Extensions page, configure the parameters, and then click Create.

   The following table describes the main parameters.

   Parameter		Description
   Configuration Description		The description of the main content configured for this feature. The description must be 1 to 256 characters in length.
   Cross-account Configuration	Current Account	The default option. You can select resources that belong to the current logged-on account.
   	Across Accounts (Resource Directory)	You can manage resources that belong to multiple accounts. Before you use this option, you must enable Resource Directory and complete the settings by using the management account or a delegated administrator account. When you enable trusted access, set Resource Orchestration Service (ROS) as a trusted service. For more information, see Manage delegated administrator accounts.
   Select Instances	Select Region	The region selection. The following methods are supported: Deploy in Current Region: Only the managed instances in the region that is selected in the current console are used as the targets. Deploy in Another Region: Select the regions to which you want to apply the configuration.
   	Target Instance	Select the target instances. The available selection methods vary based on the region selection method: If you deploy the configuration in the current region, you can manually select instances, specify tags, specify a resource group, or select all instances. If you deploy the configuration in specified regions, you can specify tags or select all instances.
   Configure Parameters	Extension Type	Select the type of the extension that you want to install. The following types are supported: Public Extension: an extension that is provided by Alibaba Cloud. Custom Extension: an extension that you create. To install the extension across accounts, you must first share the extension with the target account.
   	Extensions to install	The extensions that are available for selection vary based on the selected extension type and target instances. The actual options that are displayed on the page prevail.
   	Action	Install, uninstall, and update operations are supported.
   	Extension Version	The extension version is automatically selected. No action is required.
   	Command Parameters	The parameters that you must configure vary based on the selected extension. Configure the parameters as prompted on the page. Note If No parameters are required for the extension. is displayed, no additional parameters are required for the selected extension.

   To configure the concurrency ratio for task execution, go to Advanced.

   (Optional) Advanced settings

   • Rate Control:

     • Concurrency-based Control: The specified concurrency rate is maintained until all tasks are complete. This mode is suitable for scenarios in which you want to control resource usage and prevent excessive resource consumption.

     • Batch-based Control: Tasks are divided into multiple batches in advance, and the next batch runs only after the current batch is complete. This mode is suitable for scenarios in which you want to control the execution pace, reduce instantaneous pressure, or ensure the order of data processing.

   • Concurrency: Specify a number or a percentage to control the concurrency rate. In this example, the value is set to 1, which indicates that the task runs on one instance at a time.

   • Error Threshold: Specify the maximum number of errors that are allowed before the task stops. You can specify a number or a percentage. The default value is 0, which indicates that the entire task ends when one error occurs. If you set this parameter to 100%, the entire task is successful regardless of the number of errors that occur.

5. In the Confirm Configuration dialog box that appears, verify the configuration parameters and click OK.

   If you install a custom extension across accounts, the OSS Bucket Policy Confirmation page appears. To install an extension across accounts, you must configure an OSS bucket policy that allows the stack group execution role of the member account to read the installation package of the extension in the Alibaba Cloud account. After you verify the bucket name and the policy content that are displayed on the page, click Confirm and Create.

   Note

   After you confirm the operation, the policy that is displayed on the page is merged into the existing policy of the bucket. Other statements are not overwritten.

   After the configuration is complete, you can view the extension configuration on the Configurations tab.