From 52acfcd86708a956b7fae6fa88d13281ecbfe53e Mon Sep 17 00:00:00 2001
From: James Rasell <jrasell@users.noreply.github.com>
Date: Fri, 8 Apr 2022 17:29:19 +0200
Subject: [PATCH] docs: add nomad services template jobspec example. (#12514)

---
 .../docs/job-specification/template.mdx       | 52 ++++++++++++++-----
 1 file changed, 40 insertions(+), 12 deletions(-)

diff --git a/website/content/docs/job-specification/template.mdx b/website/content/docs/job-specification/template.mdx
index 7176a4786..99b2228d0 100644
--- a/website/content/docs/job-specification/template.mdx
+++ b/website/content/docs/job-specification/template.mdx
@@ -278,6 +278,38 @@ task "task" {
 }
 ```
 
+## Nomad Integration
+
+### Nomad Services
+
+Nomad service registrations can be queried using the `nomadService` and
+`nomadServices` functions. The requests are tied to the same namespace as the
+job which contains the template stanza.
+
+```hcl
+  template {
+    data = <<EOF
+# Configuration for a single NGINX upstream service.
+upstream my_app {
+  {{- range nomadService "my-app" }}
+  server {{ .Address }}:{{ .Port }};{{- end }}
+}
+
+# Configuration for all services registered in Nomad as an NGINX upstream
+# service.
+{{ range nomadServices }}
+# Configuration for service {{ .Name }}.
+upstream {{ .Name | toLower }} {
+  {{- range nomadService .Name }}
+  server {{ .Address}}:{{ .Port }};{{- end }}
+}
+{{ end -}}
+EOF
+
+    destination = "local/nginx.conf"
+  }
+```
+
 ## Consul Integration
 
 ### Consul KV
@@ -315,22 +347,18 @@ the [`connect`][ct_api_connect] function.
     data = <<EOF
 # Configuration for a single upstream service.
 upstream my_app {
-  {{range service "my_app"}}
-  server {{.Address}}:{{.Port}};
-  {{end}}
+  {{- range service "my-app" }}
+  server {{ .Address }}:{{ .Port }};{{- end }}
 }
 
 # Configuration for all services in the catalog.
-{{range services}}
-{{with service .Name}}
-{{with index . 0}}
-# Configuration for service {{.Name}}.
-upstream {{.Name | toLower}} {
-  {{range service .Name}}
-  server {{.Address}}:{{.Port}};
-  {{end}}
+{{ range services }}
+# Configuration for service {{ .Name }}.
+upstream {{ .Name | toLower }} {
+  {{- range service .Name }}
+  server {{ .Address}}:{{ .Port }};{{- end }}
 }
-{{end}}{{end}}{{end}}
+{{ end -}}
     EOF
 
     destination = "local/nginx.conf"