3rd party service creation

3rd party service creation

There are still two entries for the creation of third-party services, namelyto create-->to create a third-party componenton the left navigation of the team view andto add a third-party componentbutton on the application Dashboard page. The creation process is the same.

Create a static third-party service

  • Select the service registration method as static registration

  • Fill in the mailing address of the service

    For example, the service has two running instances, and the IP addresses are 192.168.0.1 and 192.168.0.2. For the convenience of setting, we can fill in the port configuration when filling in the first instance, that is, provide the following data to inform the Rainbond service that the listening port is 8080 , and are consistent.

    192.168.0.1:8080

    192.168.0.2

  • Submit the creation and go to the Dashboard page of the service to configure the service port, connection information, and health check properties.

Create a Kubernetes third-party service (Beta)

  • Select the service registration method as Kubernetes
  • Fill in the Namespace, the default is the Namespace where the current team is located
  • Fill in Service, Service should belong to the Namespace filled in above
  • Submit the creation, enter the port interface to configure, the newly added port must be consistent with the service configuration port to be able to access normally

Create third-party services based on API registration

  • Select the service registration method as API registration

  • Submit the creation and go to the Dashboard page of the service to configure the service port, connection information, and health check properties.

  • After the creation is completed, the communication address of the service can be dynamically changed by calling the API according to theAPI addressandkeydisplayed on the overview page.

The API provides three calling methods: GET, PUT, DELETE, which correspond to the query, addition (or modification) and deletion of the service address, respectively.

GET

Below is an example of the API for querying an instance:

  1. curl -s -G \
  2. --url http://ip:port/console/third_party/8ad4b1c7ffb305f2b59b6de625b1ee6a \
  3. --data secret_key=6RW0mYM3

After executing the curl request, you will get a response similar to the following:

  1. {
  2. "msg": "success",
  3. "code": 200,
  4. "msg_show": "query success",
  5. "data": {
  6. "list": [
  7. {
  8. "status": "healthy",
  9. "ip": "192.168.0.1",
  10. "is_static": true,
  11. "is_online": true
  12. },
  13. ...
  14. ]
  15. }
  16. }

Description of request parameters:

parameterIs it requiredillustrate
secret_keyYeskey

Response parameter description:

parametertypeillustrate
codeintbusiness code
msgstringA detailed description of the response to the request
msg_showstringA description of the response to the request, for display
statusstringStatus of the instance, possible values are: healthy, unhealthy, unknown
ipstringIP address of the instance
is_staticboolWhether the instance is of static type, true: static type; false: dynamic type
is_onlineboolWhether the instance is online, true: online; false: offline
PUT

Below is an example of the API that modifies the instance:

  1. curl -X PUT \
  2. --url http://192.168.1.200:7070/console/third_party/8d545c3e8e7780b228b6dcc77561388b \
  3. -H "Content-Type: application/json" \
  4. -d '{"secret_key":"4FsL5PWK" ,"ip":"192.168.0.1","is_online":true}'

After executing the curl request, you will get a response similar to the following:

  1. {
  2. "msg": "success",
  3. "code": 200,
  4. "msg_show": "Modified successfully"
  5. }

Description of request parameters:

parameterIs it requiredtypeillustrate
secret_keyYesstringkey
ipYesstringService instance address, ipv4 format
is_onlinenoboolWhether online, default true

Response parameter description:

parametertypeillustrate
codeintbusiness code
msgstringA detailed description of the response to the request
msg_showstringA description of the response to the request, for display
DELETE

Here is an example of the API for deleting an instance:

  1. curl -X DELETE \
  2. --url http://192.168.1.200:7070/console/third_party/8d545c3e8e7780b228b6dcc77561388b \
  3. -H "Content-Type: application/json" \
  4. -d '{"secret_key":"4FsL5PWK" ,"ip":"192.168.1.107","is_online":true}'

After executing the curl request, you will get a response similar to the following:

  1. {
  2. "msg": "success",
  3. "code": 200,
  4. "msg_show": "Delete successful"
  5. }

Description of request parameters:

parameterIs it requiredtypeillustrate
secret_keyYesstringkey
ipYesstringService instance address, ipv4 format

Response parameter description:

parametertypeillustrate
codeintbusiness code
msgstringA detailed description of the response to the request
msg_showstringA description of the response to the request, for display

The request content of the PUT and DELETE methods is of type application/json

Third-party service creation example

Docking with internal services

Such as the rbd-app-ui or rbd-monitor components of the Rainbond platform

3rd party service creation - 图1

After the creation is complete, you need to go online manually.

For example, if you don’t want to open port 7070 to the outside world or want to access the console through 80/443, you can do this in this way.

Docking with Alibaba Cloud RDS

Rainbond provides corresponding support for domain name instances of third-party components, allowing users to add domain name instance addresses of third-party components, and provide internal services of the rainbond platform. Combined with the existing logic that domain names can be resolved to multiple IP addresses, the rainbond platform only allows adding one domain name instance address to third-party components.

static registration

In the process of creating static third-party components, there will be logic for address verification. If there are multiple addresses filled in by the user and the number of domain name addresses is greater than or equal to one, the verification cannot be passed. In other words, a third-party service added by domain name can only add one domain name instance address.

Dynamic registration method

In the process of creating dynamic third-party components, especially when adding instance addresses through dynamic discovery such as etcd, there will also be address verification logic. If it is found that the data contains a domain name, the first domain name will be used as the third party. The instance address of the component.

The adjustment process is the same as that of connecting to the internal services of the platform. There are a few points to note. If the platform application needs to rely on the MYSQL installed by the third service, it needs to enable internal access and manually add application connection information.

3rd party service creation - 图2