Commit Graph

96 Commits

Author SHA1 Message Date
Luiz Aoqui
ea1204a3e4 Merge pull request #8811 from hashicorp/docs/fix-local-service-port
docs: fix type for `local_service_port`
2020-09-17 10:04:36 -04:00
Mahmood Ali
57bd79e4da Merge pull request #8789 from hashicorp/docs-fix-group-link
docs: Fix group link in job spec docs
2020-09-17 08:30:49 -05:00
Mahmood Ali
c320e91407 Update website with network mbit deprecation 2020-09-16 11:06:35 -04:00
Luiz Aoqui
09709e84ce docs: add entry for volume_mount in task 2020-09-01 18:59:05 -04:00
Luiz Aoqui
27cb2c1562 docs: fix type for local_service_port 2020-09-01 18:38:01 -04:00
Mahmood Ali
f1f972ac15 docs: Fix group link in job spec docs 2020-08-31 20:36:57 -04:00
Seth Hoenig
9ffdeed904 consul/connect: add initial support for ingress gateways
This PR adds initial support for running Consul Connect Ingress Gateways (CIGs) in Nomad. These gateways are declared as part of a task group level service definition within the connect stanza.

```hcl
service {
  connect {
    gateway {
      proxy {
        // envoy proxy configuration
      }
      ingress {
        // ingress-gateway configuration entry
      }
    }
  }
}
```

A gateway can be run in `bridge` or `host` networking mode, with the caveat that host networking necessitates manually specifying the Envoy admin listener (which cannot be disabled) via the service port value.

Currently Envoy is the only supported gateway implementation in Consul, and Nomad only supports running Envoy as a gateway using the docker driver.

Aims to address #8294 and tangentially #8647
2020-08-21 16:21:54 -05:00
Seth Hoenig
a22a7caf71 consul: clarify consecutive checks in docs 2020-08-10 14:08:09 -05:00
Seth Hoenig
e664f9b69a consul: able to set pass/fail thresholds on consul service checks
This change adds the ability to set the fields `success_before_passing` and
`failures_before_critical` on Consul service check definitions. This is a
feature added to Consul v1.7.0 and later.
  https://www.consul.io/docs/agent/checks#success-failures-before-passing-critical

Nomad doesn't do much besides pass the fields through to Consul.

Fixes #6913
2020-08-10 14:08:09 -05:00
Tim Gross
135041375e docs: always use -ignore-system on node drain with CSI (#8606)
Postrun hooks for allocation runners don't currently block the registration of
terminal health with the servers, which is what allows system jobs to be
drained. So draining nodes with jobs that claim CSI volumes requires the
`-ignore-system` job to ensure that the postrun hook for service jobs gets a
chance to execute.
2020-08-07 11:22:28 -04:00
Luiz Aoqui
4334647dd1 docs: fix Consul Connect log_level meta key 2020-08-05 17:01:03 -04:00
Buck Doyle
281caa8927 Change capitalisation
Co-authored-by: Tim Gross <tgross@hashicorp.com>
2020-07-30 10:09:47 -05:00
Buck Doyle
16fdf8f3ff Add documentation for job name parameter 2020-07-30 10:03:50 -05:00
Buck Doyle
2645932c72 Fix placement invocations (#8558) 2020-07-30 09:56:58 -05:00
Drew Bailey
19810365f6 oss compoments for multi-vault namespaces
adds in oss components to support enterprise multi-vault namespace feature

upgrade specific doc on vault multi-namespaces

vault docs

update test to reflect new error
2020-07-24 10:14:59 -04:00
James Rasell
d75acf8b1c docs: clarify scaling stanza is not supported within system jobs. 2020-07-24 10:05:38 +02:00
Michael Schurter
b2dea4ca5b docs: s/hearbeat/heartbeat and fix link
Also fixed the same typo in a test. Fixing the typo fixes the link, but
the link was still broken when running the website locally due to the
trailing slash. It would have worked in prod thanks to redirects, but
using the canonical URL seems ideal.
2020-07-23 11:33:34 -07:00
Nick Ethier
6e0ead7765 website: remove usage of task network stanza (#8498)
* website: remove usage of task network stanza and add documentation for group network and service stanzas

* docs: fix broken link in client config

* Update website/pages/docs/job-specification/group.mdx

Co-authored-by: Seth Hoenig <shoenig@hashicorp.com>

* Update website/pages/docs/job-specification/group.mdx

Co-authored-by: Seth Hoenig <shoenig@hashicorp.com>

Co-authored-by: Seth Hoenig <shoenig@hashicorp.com>
2020-07-23 09:18:59 -04:00
Charlie Voiselle
2611a98f74 [docs] Reschedule does happen during deployments 2020-07-14 16:29:30 -04:00
Michael Schurter
f6f697a3fb Merge pull request #7042 from hashicorp/docs-healthy-deadline
docs: clarify healthy/progress_deadline relationship
2020-07-13 08:40:11 -07:00
Seth Hoenig
d484eda7ec Merge pull request #8417 from hashicorp/docs-docker-kill-signal
docs: clarify kill_signal default for docker
2020-07-10 11:50:21 -05:00
Seth Hoenig
1def2ee2a9 docs: clarify kill_signal default for docker
Before docker, the only default was `SIGINT` for `kill_signal`. The
docker driver however defaults to `SIGTERM`, and we should document
as such.

Fixes #7140
2020-07-10 09:57:49 -05:00
James Rasell
7d8a4333b2 docs: fix minor incorrect syntax in autoscaling plugin docs.
This changes fixes a syntax error in the autoscaling apm plugin
docs as well as updates the scaling stanza doc. The stazna wording
implied its use was only for external autoscalers, whereas it also
is used by the UI.
2020-07-10 16:07:29 +02:00
Nick Ethier
3367f6d94a docs: add CNI and host_network docs (#8391)
Co-authored-by: Seth Hoenig <shoenig@hashicorp.com>
2020-07-08 15:45:04 -04:00
Seth Hoenig
44df264452 consul/connect: infer task name in service if possible
Before, the service definition for a Connect Native service would always
require setting the `service.task` parameter. Now, that parameter is
automatically inferred when there is only one task in the task group.

Fixes #8274
2020-07-08 13:31:44 -05:00
Tim Gross
f87d278d01 docs: note MRD is beta and removing regions doesn't work (#8370) 2020-07-06 16:02:10 -04:00
Chris Baker
f015e02002 added scaling->min default discussion to group->count documentation 2020-07-04 18:33:19 +00:00
Michael Schurter
0f67feb93b docs: clarify healthy/progress_deadline relationship
Validation code already enforces this, but I think documenting it makes
it more immediately clear how the 2 settings interact.
2020-06-26 09:02:32 -04:00
Tim Gross
7202322955 docs: spellcheck fix for multiregion (#8286) 2020-06-25 12:56:40 -04:00
Seth Hoenig
41b94eedc2 Merge pull request #8011 from hashicorp/f-cnative-host
consul/connect: implement initial support for connect native
2020-06-24 10:33:12 -05:00
Seth Hoenig
ef52328eb4 connect/native: doc and comment tweaks from PR 2020-06-24 10:13:22 -05:00
Jeff Escalante
b56428862f Dependency updates and improvements 2020-06-23 17:43:43 -04:00
Seth Hoenig
520d35e085 consul/connect: split connect native flag and task in service 2020-06-23 10:22:22 -05:00
Mahmood Ali
8febccf97e Merge pull request #8031 from BijanJohn/reschedule_delay_requirement
add notes about delay requirement for reschedule
2020-06-23 08:39:03 -04:00
Seth Hoenig
7e8d5c2392 consul/connect: add support for running connect native tasks
This PR adds the capability of running Connect Native Tasks on Nomad,
particularly when TLS and ACLs are enabled on Consul.

The `connect` stanza now includes a `native` parameter, which can be
set to the name of task that backs the Connect Native Consul service.

There is a new Client configuration parameter for the `consul` stanza
called `share_ssl`. Like `allow_unauthenticated` the default value is
true, but recommended to be disabled in production environments. When
enabled, the Nomad Client's Consul TLS information is shared with
Connect Native tasks through the normal Consul environment variables.
This does NOT include auth or token information.

If Consul ACLs are enabled, Service Identity Tokens are automatically
and injected into the Connect Native task through the CONSUL_HTTP_TOKEN
environment variable.

Any of the automatically set environment variables can be overridden by
the Connect Native task using the `env` stanza.

Fixes #6083
2020-06-22 14:07:44 -05:00
Tim Gross
8ce13f304e docs: fix for multiregion count explanation (#8202) 2020-06-19 07:52:58 -04:00
Nick Ethier
e9ff8a8daa Task DNS Options (#7661)
Co-Authored-By: Tim Gross <tgross@hashicorp.com>
Co-Authored-By: Seth Hoenig <shoenig@hashicorp.com>
2020-06-18 11:01:31 -07:00
Tim Gross
6fd4f3e985 docs: multiregion deployment feature (#8185) 2020-06-18 08:41:22 -04:00
Seth Hoenig
c371a31e00 docs: update cronexpr github link 2020-06-15 08:48:32 -05:00
G
3f47a67f88 docs: static port incorrectly declared as a string (#8046)
static attribute of the port stanza is supposed to be an integer but is incorrectly declared as a string in the example.
2020-05-26 08:51:16 -04:00
BijanJohn
f8e7a9f0ab add notes about delay requirement for reschedule 2020-05-20 11:57:12 -05:00
Tim Gross
c2dd6f9dba docs: notice to operators about script check timeouts (#8015)
The tasklet passes the timeout for the script check into the task
driver's `Exec`, and its up to the task driver to enforce that via a
golang `context.WithDeadline`. In practice, this deadline is started
before the task driver starts setting up the execution
environment (because we need it to do things like timeout Docker API
calls).

Under even moderate load, the time it takes to set up the execution
context for the script check regularly exceeds a full second or
two. This can cause script checks to unexpected timeout or even never
execute if the context expires before the task driver ever gets a
chance to `execve`.

This changeset adds a notice to operators about setting script check
timeouts with plenty of padding and what to monitor for problems.
2020-05-20 10:28:14 -04:00
Jeff Escalante
e69fc1f459 fix shell-session snippet error 2020-05-18 16:53:06 -04:00
Chris Baker
5bd876acb0 Merge pull request #7950 from hashicorp/docs-dst
docs: clarify periodic dst behavior
2020-05-13 15:44:41 -05:00
Tim Gross
2209ef3342 docs for stop_on_client_disconnect stanza (#7938) 2020-05-13 16:39:24 -04:00
Michael Schurter
1b3e969355 docs: clarify periodic dst behavior 2020-05-13 13:24:35 -07:00
Mahmood Ali
31a8a861ea document daylight saving change 2020-05-13 08:21:19 -04:00
Seth Hoenig
b6fc382d60 Merge pull request #7891 from hashicorp/docs-improve-connect-examples
docs: improve some connect examples
2020-05-08 09:50:31 -06:00
Tim Gross
0940a50eaf volume_mount doc tweak (#7900) 2020-05-08 11:14:16 -04:00
Seth Hoenig
e9d31c977c docs: replace use of test/test with runnable examples
A few connect examples reference a fake 'test/test' image.
By replacing those with `hashicorpnomad/counter-api` we can
turn them into runnable examples.
2020-05-07 14:16:27 -06:00