Installing Sermant Injector
Sermant Agent is automatically mounted to CCE-deployed Spring Cloud applications through the Sermant Injector plug-in. These applications are connected to the ServiceComb engine with security authentication disabled through Sermant Agent. Compared with Spring Cloud Huawei, Sermant Agent allows you to access and use functions such as application registry and discovery, full-link dark launch, graceful startup and shutdown, and label routing without modifying code. However, microservice governance is not supported. For details about Sermant Agent, see Sermant-agent User Manual.
Use either Sermant Agent or Spring Cloud Huawei to connect Spring Cloud applications to the ServiceComb engine. Do not use them at the same time to avoid conflicts.
This section describes how to install Sermant Injector.
Prerequisites
- A Kubernetes environment has been created. For details, see Creating an Environment.
- A CCE cluster later than 1.15 has been bound in the environment. For details, see Binding a CCE Cluster.
- Namespace cse of the bound CCE cluster 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 about namespaces, see Managing Namespaces.
- For details about configuration items, see Managing Configuration Items.
- For details about keys, see Managing Secrets.
- For details about workloads, see Workloads.
- For details about services, see Services.
- CSE 2.4.0 or later with security authentication disabled has been managed in the environment. For details, see Managing Resources.
Procedure
- Log in to ServiceStage.
- On the Environment Management page, click the target environment.
- In the Resource area, choose Cloud Container Engine from Compute.
- In the plug-in list on the left of the Settings tab, select Sermant Injector and click Install.
- Set the installation parameters in the installation dialog box.
- CCE Cluster: By default, a managed CCE cluster in the current environment is selected.
- Associated CSE Engine: Select the engine of the application to be connected.Notice
- Only one Sermant Injector plug-in can be installed in an environment, and one plug-in can be associated with only one CSE. Select an associated CSE based on service requirements.
- Spring Cloud applications that use Sermant Agent to access the ServiceComb engine do not support microservice governance.
- 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 5.
NOTE:If the CCE cluster selected in 5 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 5, create a configuration item named sermant-injector.
Key
In namespace cse of the CCE cluster selected in 5, create a key named sermant-injector-secret.
Workload
In namespace cse of the CCE cluster selected in 5, create a workload named sermant-injector.
Service
In namespace cse of the CCE cluster selected in 5, create a service named sermant-injector.
- If the Sermant Injector plug-in fails to be installed, try again by referring to Reinstalling Sermant Injector.
- After the Sermant Injector plug-in is successfully installed, the content listed in the following table is created.
- Prerequisites
- Procedure