wso2 / wso2/docs-integrator

Improve the documentation on installing ICP in a Kubernetes cluster

Open
#53 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
TypeScript
Stars
7
Forks
78
Avg merge
3d 8h
Merged PRs (30d)
22

Description

The ICP documentation(https://mi.docs.wso2.com/en/latest/observe-and-manage/working-with-integration-control-plane/) mentions the configurations to be provided in the ICP side for it to identify the integration nodes(MI or Ballerina). But it does not mention the need of exposing the management API for these nodes in order for node registration to work as expected.

In a k8s environment, I faced an issue where the node registration did not work as expected. For each heartbeat sent from the node, it tries to register again and again because the node registration fails each time.
To overcome this, in a ballerina deployment, I had to specifically expose the management API by exposing the port on which the icp service(https://github.com/ballerina-platform/module-ballerinax-wso2.controlplane/blob/main/ballerina/icpService.bal#L32) is running. Then, we need to define a separate service that exposes this icpService and had to provide that service's URL as the mgtApiUrl which is not clearly mentioned in the documentation.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the linked ICP installation documentation page and review the referenced icpService.bal entry. Document that Kubernetes deployments must expose the integration node management API through a separate service and provide that service URL as mgtApiUrl. Done when the page explains the required exposure and node registration setup clearly.

Written by the indexing model from the issue text.

Assessment

Tech stack
kubernetes
Domain
devops, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.