dockerzhang commented on code in PR #3646: URL: https://github.com/apache/incubator-inlong/pull/3646#discussion_r848305204
########## docker/kubernetes/README.md: ########## @@ -1,21 +1,65 @@ -## The Helm Chart for Apache InLong +# The Helm Chart for Apache InLong -### Prerequisites +## Prerequisites - Kubernetes 1.10+ - Helm 3.0+ - A dynamic provisioner for the PersistentVolumes(`production environment`) -### Usage +## Usage -#### Install +### Install + +If the namespace named `inlong` does not exist, create it first by running: ```shell kubectl create namespace inlong +``` + +To install the chart with a namespace named `inlong`, try: + +```shell helm upgrade inlong --install -n inlong ./ ``` -#### Configuration +### Access InLong Dashboard + +If `ingress.enabled` in [values.yaml](values.yaml) is set to `true`, you just access `http://${ingress.host}/dashboard` in browser. + +Otherwise, when `dashboard.service.type` is set to `ClusterIP`, you need to execute the port-forward command like: + +```shell +export DASHBOARD_POD_NAME=$(kubectl get pods -l "app.kubernetes.io/name=inlong-dashboard,app.kubernetes.io/instance=inlong" -o jsonpath="{.items[0].metadata.name}" -n inlong) +export DASHBOARD_CONTAINER_PORT=$(kubectl get pod $DASHBOARD_POD_NAME -o jsonpath="{.spec.containers[0].ports[0].containerPort}" -n inlong) +kubectl port-forward $DASHBOARD_POD_NAME 8181:$DASHBOARD_CONTAINER_PORT -n inlong +``` + +And then access [http://127.0.0.1:8181](http://127.0.0.1:8181) + +> Tip: If the error of `unable to do port forwarding: socat not found` appears, you need to install `socat` at first. + +Or when `dashboard.service.type` is set to `NodePort`, you need to execute the following commands: + +```shell +export DASHBOARD_NODE_IP=$(kubectl get nodes -o jsonpath="{.items[0].status.addresses[0].address}" -n inlong) +export DASHBOARD_NODE_PORT=$(kubectl get svc inlong-dashboard -o jsonpath="{.spec.ports[0].nodePort}" -n inlong) +``` + +And then access `http://$DASHBOARD_NODE_IP:$DASHBOARD_NODE_PORT` + +When `dashboard.service.type` is set to `LoadBalancer`, you need to execute the following command: + +```shell +export DASHBOARD_SERVICE_IP=$(kubectl get svc inlong-dashboard --template "{{"{{ range (index .status.loadBalancer.ingress 0) }}{{.}}{{ end }}"}}" -n inlong) +``` + +And then access `http://$DASHBOARD_SERVICE_IP:30080` + +> NOTE: It may take a few minutes for the `LoadBalancer` IP to be available. You can check the status by running `kubectl get svc inlong-dashboard -n inlong -w` + +The default username and password are `inlong`. You can access the InLong Dashboard through them. Review Comment: `admin` `inlong` -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
