diff --git a/documentation/asciidoc/stories/assembly_connecting_clusters.adoc b/documentation/asciidoc/stories/assembly_connecting_clusters.adoc index dbb43b5..5bcbc72 100644 --- a/documentation/asciidoc/stories/assembly_connecting_clusters.adoc +++ b/documentation/asciidoc/stories/assembly_connecting_clusters.adoc @@ -9,6 +9,7 @@ After you configure and deploy {brandname} clusters you can establish remote con include::{topics}/proc_connecting_console.adoc[leveloffset=+1] include::{topics}/proc_connecting_cli.adoc[leveloffset=+1] include::{topics}/proc_connecting_clients_internal.adoc[leveloffset=+1] +include::{topics}/proc_obtaining_IP_address.adoc[leveloffset=+2] include::{topics}/proc_connecting_clients_external.adoc[leveloffset=+1] include::{topics}/proc_connecting_rest.adoc[leveloffset=+1] diff --git a/documentation/asciidoc/topics/proc_obtaining_IP_address.adoc b/documentation/asciidoc/topics/proc_obtaining_IP_address.adoc new file mode 100644 index 0000000..3c5b457 --- /dev/null +++ b/documentation/asciidoc/topics/proc_obtaining_IP_address.adoc @@ -0,0 +1,24 @@ +[id='obtaining_IP_addresses_{context}'] += Obtaining IP addresses for all {brandname} pods + +[role="_abstract"] +You can retrieve a list of all IP addresses for running {brandname} pods. + +[IMPORTANT] +==== +link:{helm_docs}#connecting-clients-internal_connecting-clusters[Connecting Hot Rod clients running on {k8s}] is the recommended approach as it ensures the initial connection to one of the available pods. +==== + +.Procedure +Obtain all the IP addresses for a running {brandname} pods in the following ways: + +* Using the {k8s} API: +** Access `${APISERVER}/api/v1/namespaces//endpoints/` to retrieve the `endpoints` {k8s} resource associated with the `` service. + +* Using the {k8s} DNS service: +** Query the DNS service for the name `-ping` to obtain IPs for all the nodes in a cluster. + +[role="_additional-resources"] +.Additional resources +* link:https://kubernetes.io/docs/tasks/run-application/access-api-from-pod/[Accessing the Kubernetes API from a Pod] +* link:https://kubernetes.io/docs/concepts/services-networking/dns-pod-service/[DNS for Services and Pods] \ No newline at end of file