Skip to content

Commit ef143ef

Browse files
committed
added doc for accessing webui when using external nomad
1 parent a328df3 commit ef143ef

File tree

1 file changed

+11
-4
lines changed

1 file changed

+11
-4
lines changed

docs/server-admin-4.8/modules/operator/pages/introduction-to-nomad-cluster-operation.adoc

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -90,13 +90,20 @@ Complete the following steps to get logs from the allocation of the specified jo
9090

9191
Nomad provides a web UI for inspecting your Nomad cluster. If you are using an internalized Nomad deployment, which is the default setup with CircleCI server, follow the instructions in this section to temporarily access the UI for troubleshooting purposes. For a more permanent solution, consider externalizing Nomad and consult the official Nomad documentation for setting up routing.
9292

93-
. Nomad binds to its Pod IP. To port-forward to the Nomad service, you need to set up a lightweight tunneling mechanism within the cluster as follows:
93+
. When using Nomad in k8s, it binds to its Pod IP. Use below command to fetch the IP of the Nomad server:
9494
+
9595
[source,bash]
9696
----
97-
export NOMAD_IP=$(kubectl get svc nomad-server -o jsonpath='{.spec.clusterIP}' -n <server-namespace>)
97+
export NOMAD_ADDR=$(kubectl get svc nomad-server -o jsonpath='{.spec.clusterIP}' -n <server-namespace>)
98+
----
99+
100+
. If using Externalized Nomad, Use Nomad Network Load Balancer or DNS address to port-forward to access webui.
98101

99-
kubectl run nomad-tunnel --rm -it --restart=Never --image=alpine/socat -n <server-namespace> -- TCP-LISTEN:4646,fork,reuseaddr TCP:$NOMAD_IP:4646
102+
. To port-forward to the Nomad service, you need to set up a lightweight tunneling mechanism within the cluster as follows:
103+
+
104+
[source,bash]
105+
----
106+
kubectl run nomad-tunnel --rm -it --restart=Never --image=alpine/socat -n <server-namespace> -- TCP-LISTEN:4646,fork,reuseaddr TCP:$NOMAD_ADDR:4646
100107
----
101108

102109
. In another terminal, run the following command to set up port forwarding:
@@ -106,7 +113,7 @@ kubectl run nomad-tunnel --rm -it --restart=Never --image=alpine/socat -n <serve
106113
kubectl port-forward pod/nomad-tunnel 4646:4646 -n <server-namespace>
107114
----
108115

109-
. Navigate to ++`http://localhost:4646/ui`++ in your browser to access the Nomad UI. For more information on utilizing the Nomad UI, refer to the link:https://developer.hashicorp.com/nomad/tutorials/web-ui[Nomad documentation].
116+
. Navigate to `http[s]://localhost:4646/ui` in your browser to access the Nomad UI. For more information on utilizing the Nomad UI, refer to the link:https://developer.hashicorp.com/nomad/tutorials/web-ui[Nomad documentation].
110117

111118
[#shutting-down-a-nomad-client]
112119
=== Shutting down a Nomad client

0 commit comments

Comments
 (0)