Integration Server 10.15 | Microservices Runtime Guide | Consul Support | Configuring Connections to Consul Server
 
Configuring Connections to Consul Server
You can configure Microservices Runtime to interact with a Consul server by using the public services in the WmConsul package. To connect to a Consul server, configure one or more server aliases. You must create at least one server alias for the services to execute successfully. An alias name used as the registryAlias input parameter value for a WmConsul public service must exist in the Microservice Consul Registry Server alias list.
Note:
The WmConsul package is deprecated. The WmConsul package is compatible with Consul version 1.6.9 or earlier. You can develop services that work with the latest Consul API by following the Consul API documentation at https://www.consul.io/api-docs.
*To create an alias to the Consul server
1. Open Microservices Runtime Administrator.
2. Go to Packages > Management.
3. Click the icon for the WmConsul package.
4. On the Microservice Consul Registry Servers page, click Create Microservice Consul Registry Server Alias.
5. Under Microservice Consul Registry Server Alias Properties, provide the following information.
For this field
Specify
Alias
Name for the server alias.
Host Name or IP Address
Location of the Consul server as a host name or IP address.
Port Number
Port on which to connect to the Consul server.
Enable Consul Health Check
Whether to enable a health check for microservices registered using this alias. Consul uses the health check to keep track of the health of a registered microservice . Select Yes to enable health checks.
User Name
Optional. If the Consul server is configured to use a user name and password, the user name.
Password
Optional. If the Consul server is configured to use a user name and password, the password.
Use SSL
Whether to use a secure connection to connect to the Consul server. To use SSL, select Yes and then provide truststore and possibly keystore information.
Note:
If you select yes, the Consul server must be configured to accept HTTPS requests.
Keystore Alias
Optional. Keystore alias that contains the client certificates to use for the secure connection. You need to provide this information only if Use SSL is set to Yes and the registry server requires client certificates.
Key Alias
Optional. Key alias for the private key and certificates to use for establishing a secure connection. You need to provide this information only if Use SSL is set to Yes and the Consul server requires client certificates .
Truststore Alias
Optional. Truststore alias that contains the Consul server's certificate authority certificates. You need to provide this information only if Use SSL is set to Yes.
6. Click Save Changes.