From caf35c3d500144fe7f56957bc4aa3263afcdc46e Mon Sep 17 00:00:00 2001 From: Michael Schurter Date: Wed, 19 Feb 2020 08:29:58 -0800 Subject: [PATCH] docs: mention group service registration A few minor tweaks and cleanups as well. --- website/pages/docs/job-specification/service.mdx | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) diff --git a/website/pages/docs/job-specification/service.mdx b/website/pages/docs/job-specification/service.mdx index f1069953b..f73e3d93d 100644 --- a/website/pages/docs/job-specification/service.mdx +++ b/website/pages/docs/job-specification/service.mdx @@ -271,11 +271,12 @@ Nomad manages registering, updating, and deregistering services with Consul. It is important to understand when each of these steps happens and how they can be customized. -**Registration**: Nomad will only register a service and its checks into -Consul after the task has started. +**Registration**: Nomad will register `group` services and checks *before* +starting any tasks. Services and checks for a specific `task` are registered +*after* the task has started. -**Updating**: If the service or check definition is updated Nomad will update -the service in Consul as well. This occurs without restarting a task. +**Updating**: If a service or check definition is updated, Nomad will update +the service in Consul as well. Consul is updated without restarting a task. **Deregistering**: If a running task with a service stanza exits, the services and checks are immediately deregistered from Consul without delay. If however @@ -294,8 +295,8 @@ Nomad needs to kill a running task, the task is killed in the following order: 3. Send the [`kill_signal`][killsignal] to the task and wait for the task to exit. The task should use this time to gracefully drain and finish any existing requests. -4. If the task hasn't exited itself after the [`kill_timeout`][killtimeout], - Nomad will force kill the application. +4. If the task has not exited after the [`kill_timeout`][killtimeout], Nomad + will force kill the application. ## `service` Examples