Managing Sermant Injector
Sermant Agent is automatically mounted to container-deployed Spring Cloud applications through the Sermant Injector plug-in. These applications are connected to the ServiceComb engine or registry/configuration center with security authentication disabled through Sermant Agent. For details about Sermant Agent, see Sermant-agent User Manual.
Compared with Spring Cloud Huawei, Sermant Agent allows you to access the engine and use functions such as application registry and discovery, full-link dark launch, graceful startup and shutdown, and label routing without modifying application code. However, microservice governance is not supported.
Use either Sermant Agent or Spring Cloud Huawei to connect Spring Cloud applications to the exclusive ServiceComb engine or registry/configuration center. Do not use them at the same time to avoid conflicts.
Before using Sermant Agent to connect a Spring Cloud application to an exclusive ServiceComb engine or registry/configuration center, Installing Sermant Injector.
Prerequisites
- A CCE cluster later than 1.15 has been bound in the environment. For details, see Binding a Cluster.
- If the bound CCE cluster has the cse namespace, the namespace cannot contain the configuration item sermant-injector, key sermant-injector-secret, workload sermant-injector, or service sermant-injector. Otherwise, the plug-in installation will fail.
- For details, see Managing Namespaces.
- For details about configuration items, see Managing Configuration Items.
- For details about secrets, see Managing Secrets.
- For details about workloads, see Overview.
- For details about services, see Overview.
- An exclusive ServiceComb engine 2.4.0 or later or registry/configuration center with security authentication disabled has been managed in the environment. For details, see Managing Basic Resources.
Installing Sermant Injector
- Log in to ServiceStage.
- Choose Environment Management. The Environment Management page is displayed.
- Click the target environment. The Overview page is displayed.
- Choose Plug-in Management.
- Select Sermant Injector under Addons.
- Set parameters by referring to the following table.
Parameter
Description
CCE Cluster
By default, a bound CCE cluster in the current environment is selected.
Server Type
Select the same CPU architecture as the master node of the selected CCE cluster.
- x86_64
- AArch64
Associated Microservice Engine
Select the exclusive ServiceComb engine or registry/configuration center for installing the plug-in.
- Click OK.
- After the Sermant Injector plug-in is successfully installed, the content listed in the following table is created.
Name
Description
Namespace
Create a namespace named cse in the CCE cluster selected in 6.
NOTE:If the CCE cluster selected in 6 already has a namespace named cse, the namespace will be reused when the Sermant Injector plug-in is installed.
Configuration item
In namespace cse of the CCE cluster selected in 6, create a configuration item named sermant-injector.
Key
In namespace cse of the CCE cluster selected in 6, create a key named sermant-injector-secret.
Workload
In namespace cse of the CCE cluster selected in 6, create a workload named sermant-injector.
Service
In namespace cse of the CCE cluster selected in 6, create a service named sermant-injector.
- If the Sermant Injector plug-in fails to be installed, try again by referring to Reinstalling Sermant Injector.
- If a CCE cluster with the Sermant Injector plug-in installed is bound to another environment, manage the exclusive ServiceComb engine or registry/configuration center associated with the Sermant Injector plug-in in that environment. Otherwise, the Sermant Injector plug-in will be unavailable in that environment.
For details about how to manage exclusive ServiceComb engines, see Managing Basic Resources.
- After the Sermant Injector plug-in is successfully installed, the content listed in the following table is created.
Upgrading Sermant Injector
Upgrade the Sermant Injector plug-in to the latest version.
Sermant Agent cannot be mounted during the Sermant Injector load upgrade. As a result, the service instances restarted during this period may fail to be connected to the ServiceComb engine or registry/configuration center.
- Log in to ServiceStage.
- Choose Environment Management. The Environment Management page is displayed.
- Click the target environment. The Overview page is displayed.
- Choose Plug-in Management.
- Select Sermant Injector under Addons.
- For a non-HA environment, click Upgrade.
- For an HA environment, click the AZ tab of the CCE cluster where the Sermant Injector plug-in is to be upgraded, and click Upgrade.
- In the displayed dialog box, click OK.
Restarting the Sermant Injector Load
Restart the Sermant Injector load.
Sermant Agent cannot be mounted during the Sermant Injector load restart. As a result, the service instances restarted during this period may fail to be connected to the ServiceComb engine or registry/configuration center.
- Log in to ServiceStage.
- Choose Environment Management. The Environment Management page is displayed.
- Click the target environment. The Overview page is displayed.
- Choose Plug-in Management.
- Select Sermant Injector under Addons.
- For a non-HA environment, click Restart.
- For an HA environment, click the AZ tab of the CCE cluster where the Sermant Injector plug-in is to be restarted, and click Restart.
- In the displayed dialog box, click OK.
Reinstalling Sermant Injector
Reinstall Sermant Injector if it fails to be installed.
- Log in to ServiceStage.
- Choose Environment Management. The Environment Management page is displayed.
- Click the target environment. The Overview page is displayed.
- Choose Plug-in Management.
- Select Sermant Injector under Addons.
- For a non-HA environment, click Redeploy.
- For an HA environment, click the AZ tab of the CCE cluster where the Sermant Injector plug-in fails to be installed, and click Redeploy.
Deleting Sermant Injector
After the installed Sermant Injector plug-in is deleted, Sermant Agent cannot be used to connect microservice instances to the ServiceComb engine or registry/configuration center.
If the Sermant Injector plug-in is deleted, the content listed in the following table is deleted.
Name |
Description |
---|---|
Configuration item |
Configuration item sermant-injector created in namespace cse of the CCE cluster selected during Installing Sermant Injector. For details about configuration items, see Managing Configuration Items. |
Key |
Secret sermant-injector-secret created in namespace cse of the CCE cluster selected during Installing Sermant Injector. For details about secrets, see Managing Secrets. |
Workload |
Workload sermant-injector created in namespace cse of the CCE cluster selected during Installing Sermant Injector. For details about workloads, see . |
Service |
Service sermant-injector created in namespace cse of the CCE cluster selected during Installing Sermant Injector. For details about services, see . |
- Log in to ServiceStage.
- Choose Environment Management. The Environment Management page is displayed.
- Click the target environment. The Overview page is displayed.
- Choose Plug-in Management.
- Select Sermant Injector under Addons.
- For a non-HA environment, click Delete.
- For an HA environment, click the AZ tab of the CCE cluster where the Sermant Injector plug-in is to be deleted, and click Delete.
- Click OK.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot