Configuration Management (Applicable to Engine 2.x)

Restrictions

• Configuration items are stored in plaintext. Do not include sensitive data.
• When the configuration item quota specified by the engine specifications is about to be used up, the engine allows new configuration items that exceed the remaining quota to be created to ensure capacity availability. Expand the capacity of the engine as soon as possible to prevent configuration creation failures.
• When editing or deleting a configuration item used by a microservice, the microservice may fail to read the configuration or read an incorrect configuration, causing service exceptions. Therefore, back up the configuration before modifying or deleting configuration items.

Creating an Application-Level Configuration

1. Log in to ServiceStage and choose Cloud Service Engine > Engines.
2. Select the target microservice engine from the Microservice Engine drop-down list in the upper part of the page.
3. Choose Configuration Management.
   • For microservice engines with security authentication disabled, go to 5.
   • For microservice engines with security authentication enabled, go to 4.

4. In the displayed Security Authentication dialog box, enter the account name and password, and click OK.
   

   • If you connect to the microservice engine for the first time, enter the account name root and the password entered when Creating a Microservice Engine.
   • For details about how to create an account, see Adding an Account.

5. Click Create Configuration Item and set parameters by referring to the following table. Parameters marked with an asterisk (*) are mandatory.

   Parameter	Description
   *Configuration Item	Enter a configuration item. The configuration item is the global ID of the configuration. In the coding phase, the configuration item is used to index and operate the configuration. You are advised to use the Java package naming rule (for example, cse.service.registry.address) to ensure the readability and uniqueness of the configuration. Configuration items starting with servicecomb.matchGroup. cannot be created during application-level configuration creation. Such configuration items conflict with the configuration generated during service scenario governance creation, so the service scenario cannot be displayed.
   Configuration Range	Select Application-level.
   *Application	Select or enter an application name. Select an environment.
   Configuration Format	Select a configuration format. Common configuration formats such as TEXT, YAML, JSON, Properties, INI and XML can be edited online. The default value is TEXT.
   *Configuration Content	Enter the configuration content.
   Enable Configuration	Determine whether to enable the configuration item. Enable now: The configuration item takes effect immediately once being created. Not Enabled: The configuration item does not take effect.

6. Click Create Now to enable the configuration item.

Creating a Microservice-Level Configuration

1. Log in to ServiceStage and choose Cloud Service Engine > Engines.
2. Select the target microservice engine from the Microservice Engine drop-down list in the upper part of the page.
3. Choose Configuration Management.
   • For microservice engines with security authentication disabled, go to 5.
   • For microservice engines with security authentication enabled, go to 4.

4. In the displayed Security Authentication dialog box, enter the account name and password, and click OK.
   

   • If you connect to the microservice engine for the first time, enter the account name root and the password entered when Creating a Microservice Engine.
   • For details about how to create an account, see Adding an Account.

5. Click Create Configuration Item and set parameters by referring to the following table. Parameters marked with an asterisk (*) are mandatory.

   Parameter	Description
   *Configuration Item	Enter a configuration item. The configuration item is the global ID of the configuration. In the coding phase, the configuration item is used to index and operate the configuration. You are advised to use the Java package naming rule (for example, cse.service.registry.address) to ensure the readability and uniqueness of the configuration.
   Configuration Range	Select Microservice-level.
   *Microservice	Select or enter a microservice name. Select or enter an application name. Select an environment.
   Configuration Format	Select a configuration format. Common configuration formats such as TEXT, YAML, JSON, Properties, INI and XML can be edited online. The default value is TEXT.
   *Configuration Content	Enter the configuration content.
   Enable Configuration	Determine whether to enable the configuration item. Enable now: The configuration item takes effect immediately once being created. Not Enabled: The configuration item does not take effect.

6. Click Create Now to enable the configuration item.

Creating a Customized Configuration Item

1. Log in to ServiceStage and choose Cloud Service Engine > Engines.
2. Select the target microservice engine from the Microservice Engine drop-down list in the upper part of the page.
3. Choose Configuration Management.
   • For microservice engines with security authentication disabled, go to 5.
   • For microservice engines with security authentication enabled, go to 4.

4. In the displayed Security Authentication dialog box, enter the account name and password, and click OK.
   

   • If you connect to the microservice engine for the first time, enter the account name root and the password entered when Creating a Microservice Engine.
   • For details about how to create an account, see Adding an Account.

5. Click Create Configuration Item and set parameters by referring to the following table. Parameters marked with an asterisk (*) are mandatory.

   Parameter	Description
   *Configuration Item	Enter a configuration item. The configuration item is the global ID of the configuration. In the coding phase, the configuration item is used to index and operate the configuration. You are advised to use the Java package naming rule (for example, cse.service.registry.address) to ensure the readability and uniqueness of the configuration.
   Configuration Range	Select Customize.
   Labels	If application-level and microservice-level configurations cannot meet service requirements, you can use labels to customize configurations.
   Configuration Format	Select a configuration format. Common configuration formats such as TEXT, YAML, JSON, Properties, INI and XML can be edited online. The default value is TEXT.
   *Configuration Content	Enter the configuration content.
   Enable Configuration	Determine whether to enable the configuration item. Enable now: The configuration item takes effect immediately once being created. Not Enabled: The configuration item does not take effect.

6. Click Create Now to enable the configuration item.

Importing Configurations

1. Log in to ServiceStage and choose Cloud Service Engine > Engines.
2. Select the target microservice engine from the Microservice Engine drop-down list in the upper part of the page.
3. Choose Configuration Management.
   • For microservice engines with security authentication disabled, go to 5.
   • For microservice engines with security authentication enabled, go to 4.

4. In the displayed Security Authentication dialog box, enter the account name and password, and click OK.
   

   • If you connect to the microservice engine for the first time, enter the account name root and the password entered when Creating a Microservice Engine.
   • For details about how to create an account, see Adding an Account.

5. Click Import in the upper right corner and set parameters by referring to the following table.

   Parameter	Description
   Import to a specific environment	Disabled: The imported configuration does not change the environment label. Enabled: Importing the configuration to a specific environment will change the environment label.
   Same Configuration	Terminate: If a configuration is the same as that in the system, the import terminates. Skip: During import, if a configuration is the same as that in the system, the configuration is skipped and other configurations are imported. Overwrite: During import, if a configuration is the same as that in the system, the value of the configuration will be replaced.
   Configuration File	Click Import and select the target file. The file size cannot exceed 2 MB.

6. Click Close.

Exporting Configurations

1. Log in to ServiceStage and choose Cloud Service Engine > Engines.
2. Select the target microservice engine from the Microservice Engine drop-down list in the upper part of the page.
3. Choose Configuration Management.
   • For microservice engines with security authentication disabled, go to 5.
   • For microservice engines with security authentication enabled, go to 4.

4. In the displayed Security Authentication dialog box, enter the account name and password, and click OK.
   

   • If you connect to the microservice engine for the first time, enter the account name root and the password entered when Creating a Microservice Engine.
   • For details about how to create an account, see Adding an Account.

5. Select the configuration items to be exported and click Export. In the displayed dialog box, click Export. Alternatively, click Export All in the upper right corner to export all configurations.

Comparing Configuration Versions

1. Log in to ServiceStage and choose Cloud Service Engine > Engines.
2. Select the target microservice engine from the Microservice Engine drop-down list in the upper part of the page.
3. Choose Configuration Management.
   • For microservice engines with security authentication disabled, go to 5.
   • For microservice engines with security authentication enabled, go to 4.

4. In the displayed Security Authentication dialog box, enter the account name and password, and click OK.
   

   • If you connect to the microservice engine for the first time, enter the account name root and the password entered when Creating a Microservice Engine.
   • For details about how to create an account, see Adding an Account.

5. Click the configuration item to be compared.
6. Click View Historical Version.
7. In Historical Versions on the left, select the historical version to be viewed.

   In the Configuration file on the right, you can view the differences between the current and historical versions.

   

   A maximum of 100 historical versions can be displayed.

Rolling Back a Version

1. Log in to ServiceStage and choose Cloud Service Engine > Engines.
2. Select the target microservice engine from the Microservice Engine drop-down list in the upper part of the page.
3. Choose Configuration Management.
   • For microservice engines with security authentication disabled, go to 5.
   • For microservice engines with security authentication enabled, go to 4.

4. In the displayed Security Authentication dialog box, enter the account name and password, and click OK.
   

   • If you connect to the microservice engine for the first time, enter the account name root and the password entered when Creating a Microservice Engine.
   • For details about how to create an account, see Adding an Account.

5. Click the target configuration item.
6. Click View Historical Version.
7. In Historical Versions on the left, select the target historical version.
8. In Configuration file on the right, click Roll Back to the Selected Version.

Viewing Historical Versions

1. Log in to ServiceStage and choose Cloud Service Engine > Engines.
2. Select the target microservice engine from the Microservice Engine drop-down list in the upper part of the page.
3. Choose Configuration Management.
   • For microservice engines with security authentication disabled, go to 5.
   • For microservice engines with security authentication enabled, go to 4.

4. In the displayed Security Authentication dialog box, enter the account name and password, and click OK.
   

   • If you connect to the microservice engine for the first time, enter the account name root and the password entered when Creating a Microservice Engine.
   • For details about how to create an account, see Adding an Account.

5. Click View Historical Version in the Operation column of a configuration item. On the Historical Versions page that is displayed, you can view the historical versions of the configuration item. On this page, you can compare the configuration version with the rollback version.

Editing a Configuration Item

1. Log in to ServiceStage and choose Cloud Service Engine > Engines.
2. Select the target microservice engine from the Microservice Engine drop-down list in the upper part of the page.
3. Choose Configuration Management.
   • For microservice engines with security authentication disabled, go to 5.
   • For microservice engines with security authentication enabled, go to 4.

4. In the displayed Security Authentication dialog box, enter the account name and password, and click OK.
   

   • If you connect to the microservice engine for the first time, enter the account name root and the password entered when Creating a Microservice Engine.
   • For details about how to create an account, see Adding an Account.

5. Click Edit in the Operation column of the target configuration item. You can also click the target configuration item and then click Edit on the displayed configuration details page.
6. Enter the configuration information in the Configuration Content text box and click Save.

Disabling a Configuration Item

1. Log in to ServiceStage and choose Cloud Service Engine > Engines.
2. Select the target microservice engine from the Microservice Engine drop-down list in the upper part of the page.
3. Choose Configuration Management.
   • For microservice engines with security authentication disabled, go to 5.
   • For microservice engines with security authentication enabled, go to 4.

4. In the displayed Security Authentication dialog box, enter the account name and password, and click OK.
   

   • If you connect to the microservice engine for the first time, enter the account name root and the password entered when Creating a Microservice Engine.
   • For details about how to create an account, see Adding an Account.

5. In the Operation column of the target configuration item, click More > Disable.
6. Click OK.

Deleting a Configuration Item

1. Log in to ServiceStage and choose Cloud Service Engine > Engines.
2. Select the target microservice engine from the Microservice Engine drop-down list in the upper part of the page.
3. Choose Configuration Management.
   • For microservice engines with security authentication disabled, go to 5.
   • For microservice engines with security authentication enabled, go to 4.

4. In the displayed Security Authentication dialog box, enter the account name and password, and click OK.
   

   • If you connect to the microservice engine for the first time, enter the account name root and the password entered when Creating a Microservice Engine.
   • For details about how to create an account, see Adding an Account.

5. Click Delete in the Operation column of the target configuration item. You can also click the target configuration item and then click Delete on the displayed configuration details page.
6. Click OK.