Commit Graph

667 Commits

Author SHA1 Message Date
Tim Gross 86d7ad6d7b docs: update metrics tables 2021-01-04 12:47:35 -05:00
Tim Gross c24f4d9925
client: improve alloc GC API error messages (#9488)
The client allocation GC API returns a misleading error message when the
allocation exists but is not yet eligible for GC. Make this clear in the error
response.

Note in the docs that the allocation will still show on the server responses.
2021-01-04 11:34:12 -05:00
James Rasell 2cf75537cd
Merge pull request #9584 from hashicorp/f-docs-api-job-reg-preserve-counts
docs: add PreserveCounts param to job API doc.
2021-01-04 16:01:17 +01:00
Aaron Harper 86275f5004
Fixed typo in index.mdx 2021-01-01 23:04:04 -05:00
Drew Bailey 793b5f242d
Docs/operator subpages (#9689)
* operator subpages

* line wrapping, fixed
2020-12-21 10:29:06 -05:00
Kris Hicks 16bacad930
docs: Remove network_speed client config field (#9685) 2020-12-21 07:26:25 -08:00
Michael Lange 3a8b1b58e1 Remove unlinked getting started pages. These are all on Learn now 2020-12-18 15:32:41 -08:00
Chris Baker d1b1d8303a
Merge pull request #9696 from hashicorp/docs-7655-lifecycle-json
docs: added lifecycle example to JSON Jobs API docs
2020-12-18 16:41:10 -06:00
Kris Hicks 4dacba3684
docs: Document required name for expose=true check (#9691) 2020-12-18 14:34:47 -08:00
Chris Baker 6092eb9f7d docs: added lifecycle example to JSON Jobs API docs 2020-12-18 22:26:30 +00:00
Chris Baker 4ae967ef96
Merge pull request #9693 from hashicorp/docs-7655-lifecycle-block
docs: more documentation for lifecycle stanza
2020-12-18 16:12:25 -06:00
Chris Baker 0cca9773c8 typo fixes 2020-12-18 22:12:12 +00:00
Tim Gross f4e107d6ae docs: data directory permissions 2020-12-18 16:43:01 -05:00
Chris Baker e85f841d10
Update website/pages/docs/job-specification/lifecycle.mdx
Co-authored-by: Tim Gross <tgross@hashicorp.com>
2020-12-18 14:30:44 -06:00
Chris Baker b5f4bb6bb6
Update website/pages/docs/job-specification/lifecycle.mdx
Co-authored-by: Tim Gross <tgross@hashicorp.com>
2020-12-18 14:30:17 -06:00
Chris Baker edc4d095b9 docs: more documentation for lifecycle stanza 2020-12-18 20:18:45 +00:00
Michael Lange a552023820 Enumerate job statuses and types in docs 2020-12-18 12:14:50 -08:00
Drew Bailey 207048e1ce
add job register preservecounts param, update job versions response (#9676)
* add job register preservecounts param, update job versions response

* include job version diffs param

* update
2020-12-18 14:54:39 -05:00
Kris Hicks c0be6d4081
docs: Add quota removal step to namespace apply (#9684) 2020-12-18 10:55:31 -08:00
Chris Baker ffc64a6076 docs: added examples of device responses to api docs 2020-12-18 17:30:26 +00:00
Tim Gross 5d81bd7ad4 docs: clarify behavior of plugin block merging
Although this behavior is unfortunate, we want to document the existing
behavior rather than break backwards compatibility.
2020-12-18 11:56:02 -05:00
Tim Gross 9c4f52c8aa
docs: document SIGHUP handling behavior 2020-12-18 11:55:00 -05:00
Tim Gross c422f8066a docs: describe gossip encryption encoding requirements 2020-12-18 09:58:42 -05:00
Tim Gross 37b1dd6f54 docs: clarify which address configurations can include ports 2020-12-18 09:42:06 -05:00
Seth Hoenig 63734619bc docs: improve gateway docs 2020-12-17 11:08:48 -06:00
Seth Hoenig 38f24a7d41
docs: gateway task docs changes
Co-authored-by: Tim Gross <tgross@hashicorp.com>
2020-12-17 10:37:02 -06:00
Seth Hoenig 939407e643
docs: gateway task docs changes
Co-authored-by: Tim Gross <tgross@hashicorp.com>
2020-12-17 10:36:56 -06:00
Seth Hoenig 9ea4d9793b
docs: gateway task docs changes
Co-authored-by: Tim Gross <tgross@hashicorp.com>
2020-12-17 10:36:42 -06:00
Seth Hoenig 3a3a175e1a consul/connect: enable configuring custom gateway task
Add the ability to configure the Task used for Connect gateways,
similar to how sidecar Task can be configured.

The implementation here simply re-uses the sidecar_task stanza,
and now gets applied whether connect.sidecar_service or
connect.gateway is the thing being defined. In retrospect,
connect.sidecar_task could have been more generically named
like connect.task to make it a little more re-usable.

Closes #9474
2020-12-17 08:51:52 -06:00
Mahmood Ali 5ad721e35c note that the mount flag was added in 1.0.1 2020-12-16 18:56:08 -05:00
Mahmood Ali 39fd59638a document the new /dev/disk1s5 on / (apfs, local, read-only, journaled)
devfs on /dev (devfs, local, nobrowse)
/dev/disk1s1 on /System/Volumes/Data (apfs, local, journaled, nobrowse)
/dev/disk1s4 on /private/var/vm (apfs, local, journaled, nobrowse)
map auto_home on /System/Volumes/Data/home (autofs, automounted, nobrowse)
/dev/disk2s1 on /Volumes/nRF Connect 3.6.1 (hfs, local, nodev, nosuid, read-only, noowners, quarantine, mounted by notnoop) syntax
2020-12-16 17:25:02 -05:00
Mahmood Ali 9c315540a4 Revert "docs: deactivate var-file section"
This reverts commit 4ad0a882ec5f3ced986a058b17e5199a23940b45.
2020-12-16 17:17:16 -05:00
Mahmood Ali 201af6b1a6 Revert "docs: remove envvar option"
This reverts commit 205a1de6f3bdf870649197a1cc6f12ec19e17b6a.
2020-12-16 17:17:09 -05:00
Tim Gross 1785822386
template: trigger change_mode for dynamic secrets on restore (#9636)
When a task is restored after a client restart, the template runner will
create a new lease for any dynamic secret (ex. Consul or PKI secrets
engines). But because this lease is being created in the prestart hook, we
don't trigger the `change_mode`.

This changeset uses the the existence of the task handle to detect a
previously running task that's been restored, so that we can trigger the
template `change_mode` if the template is changed, as it will be only with
dynamic secrets.
2020-12-16 13:36:19 -05:00
Mahmood Ali 62251e6fce
docs: more notes about hcl2 compatibility (#9634)
Make backward compatibility notes about Task Driver config options. Namely, call out the use of blocks with non-identifier attributes (like in docker systctl and storage_options) or nesting block syntax within an attribute assignment. Neither of these are valid HCL2. The solution is relatively simple: We can add = and quote the non-identifier attribute names.

Co-authored-by: Tim Gross <tgross@hashicorp.com>
2020-12-14 17:07:09 -05:00
Mahmood Ali 5351764b1b docs: remove envvar option 2020-12-11 13:34:53 -05:00
Michael Lange f265c7ba6d
Merge pull request #9599 from hashicorp/changli0617-patch-1
Highlight "alternative to Kubernetes"
2020-12-10 14:29:32 -08:00
Michael Lange a658295135
Merge pull request #9600 from hashicorp/changli0617-patch-2
Update index.jsx
2020-12-10 14:28:55 -08:00
Michael Lange ffc45ae5c5 Add a line break before the "learn why" cta on our home page 2020-12-10 12:26:53 -08:00
Michael Lange 0b0921ba6c Fix mismatched quotes in JSX strings 2020-12-10 12:04:11 -08:00
Seth Hoenig fcd95fab19
Merge pull request #9611 from hashicorp/b-gateway-concurrency
consul/connect: set default Envoy worker threads for gateways
2020-12-10 12:44:28 -06:00
Mahmood Ali 94016a2118
Apply suggestions from code review
Co-authored-by: Seth Hoenig <shoenig@hashicorp.com>
2020-12-10 12:21:01 -05:00
Mahmood Ali c7ad5d2b15 note environment variables needing to be valid unicode identifier 2020-12-10 12:03:19 -05:00
Mahmood Ali cbe742f1d8 docs: deactivate var-file section
--var-files has a bug where we don't honor it properly.  Let's remove it
from docs, to be enabled for 1.0.1.
2020-12-10 12:03:19 -05:00
Mahmood Ali 129dbd36ea docs: ensure meta keys are not quoted 2020-12-10 12:03:19 -05:00
Seth Hoenig 52c9dbbb91 consul/connect: set default Envoy worker threads for gateways
Applying the default --concurrency for gateways was missed before.
Set the default Envoy concurrency to 1 for connect gateways. The
same override value meta.connect.proxy_concurrency applies.
2020-12-10 10:36:29 -06:00
Mahmood Ali ef30655268 unquote env attributes 2020-12-10 11:30:01 -05:00
André Peters 29adb132e2 Update index.mdx
"Invalid argument name; Argument names must not be quoted."
2020-12-10 08:21:47 -05:00
changli0617 7210556b03
Update index.jsx
Replace a value card to show case "2 million container challenge"
2020-12-09 18:32:17 -08:00
James Rasell ccba39201a
docs: add PreserveCounts param to job API doc. 2020-12-09 14:30:08 +01:00
Michael Schurter ddea65f8c9
Merge pull request #9569 from hashicorp/docs-100
docs: 1.0.0 download link
2020-12-08 09:09:29 -08:00
Mike Wickett 0be0fb54b7
website: Update k8s comparison docs, ecosystem and community (#9557)
* website: add k8s vs callout to homepage

* website: move resources to community

* website: add k8s comparison, ecosytem to docs

* website: update redirects

* website: fix homepage link

* website: fix sidebar data

* Update website/pages/docs/nomad-vs-kubernetes/index.mdx

Co-authored-by: changli0617 <39781496+changli0617@users.noreply.github.com>

* Update website/pages/docs/nomad-vs-kubernetes/alternative.mdx

Co-authored-by: changli0617 <39781496+changli0617@users.noreply.github.com>

* Update website/pages/docs/nomad-vs-kubernetes/alternative.mdx

Co-authored-by: changli0617 <39781496+changli0617@users.noreply.github.com>

* Update website/pages/docs/nomad-vs-kubernetes/alternative.mdx

Co-authored-by: changli0617 <39781496+changli0617@users.noreply.github.com>

Co-authored-by: changli0617 <39781496+changli0617@users.noreply.github.com>
2020-12-08 12:09:15 -05:00
Michael Schurter 5df1780bd7 docs: 1.0.0 download link 2020-12-08 08:00:21 -08:00
Mahmood Ali 020f6268b1
Remove Beta tag from 1.0 features (#9562)
* docs: Remove 1.0 beta warning about HCL2.0 docs

* docs: multiregion is not beta anymore either

* docs: scaling isn't beta

* docs: neither is events api
2020-12-08 09:39:25 -05:00
davemay99 36022c9c59 nomad operator debug changelog / doc updates 2020-12-08 08:51:45 -05:00
Charlie Voiselle 02e09b673a Upgade links to guides 2020-12-08 08:51:21 -05:00
Shishir a1b5c60bce
Update containerd task driver docs. (#9550) 2020-12-07 16:51:19 -05:00
Mark Lewis 80a3b87ec7
docs: grammatical fixes in service jobspec 2020-12-07 15:41:44 -05:00
Mahmood Ali d0495e1b56
document some hcl2 quarks (#9545)
Mainly note that block labels need to be string literals, and that decimals without a leading significant digits aren't acceptable anymore (e.g. .9 are required to be 0.9).

Dynamic blocks can be used here, but feels too much of a hack, or a hammer to highlight it here, specially given the error reporting and debugging isn't so straightforward. I'd advocate internally for relaxing the restriction and allowing expressions in block labels instead.

Related to https://github.com/hashicorp/nomad/issues/9522
2020-12-07 12:31:25 -05:00
Luiz Aoqui 20796e5815
docs: update autoscaling docs for the new query interface (#8917)
* update autoscaling docs for the new query interface
* update default value for query_window in scaling policy
2020-12-07 10:43:08 -05:00
Seth Hoenig 07568b6a7e docs: note conflist extension for cni plugin configuration files 2020-12-07 09:36:39 -06:00
Drew Bailey c0bd238eb2
fix allocation spelling error, update docs (#9527)
* fix allocation spelling error, update docs

* assign TopicACLPolicy and TopicACLToken properly
2020-12-04 12:04:58 -05:00
Michael Schurter 39fdc47914 docs: publish v1.0.0-rc1 2020-12-03 14:03:57 -08:00
Michael Schurter eb56a75bdd docs: may->will after confirming with Consul
Consul 1.9 switched to agentless intentions which no longer require
synchronous communication from Envoy to Consul.
2020-12-03 13:48:06 -08:00
Michael Schurter e948e0a012 docs: clarify connect upgrade procedure
During testing we discovered old versions of Nomad and Consul seemed to
prevent Envoy from accepting new connections while the Nomad agent was
being upgraded.
2020-12-03 13:36:13 -08:00
Drew Bailey ce85288f2f
ensure node secret ID is not included in event stream (#9510) 2020-12-03 12:27:14 -05:00
Drew Bailey 17de8ebcb1
API: Event stream use full name instead of Eval/Alloc (#9509)
* use full name for events

use evaluation and allocation instead of short name

* update api event stream package and shortnames

* update docs

* make sync; fix typo

* backwards compat not from 1.0.0-beta event stream api changes

* use api types instead of string

* rm backwards compat note that only changed between prereleases

* remove backwards incompat that only existed in prereleases
2020-12-03 11:48:18 -05:00
Seth Hoenig 4398511c04 docs: fix link to windows docker issues 2020-12-03 09:19:22 -06:00
Charlie Voiselle 7d37cd3f53
Small website updates (#9504)
* systemd should be downcased
* containerd should be downcased
* spellchecking, adjust list item spacing
* QEMU should be upcased
* spelling, it's->its
* Fewer exclamation points; drive-by list spacing
* Update website/pages/docs/internals/security.mdx
* Namespace is not ent only now.
Co-authored-by: Tim Gross <tgross@hashicorp.com>
2020-12-02 19:02:03 -05:00
Chris Baker 4b31759ef0 formatting fix from github-based commit 2020-12-02 22:25:36 +00:00
Chris Baker a9c151be2c
Update website/pages/docs/job-specification/hcl2/index.mdx
Co-authored-by: Michael Schurter <mschurter@hashicorp.com>
2020-12-02 16:12:07 -06:00
Chris Baker e1010c9227 added some discussion of HCL parsing context 2020-12-02 20:41:53 +00:00
Tim Gross 74b8375fc9
docs: using interpolation for volumes (#9449)
Expand `volume` and `volume_mount` sections to describe how to use HCL2
dynamic blocks and interpolation to have finer-grained control over how
allocations get volumes.
2020-12-02 08:57:47 -05:00
Seth Hoenig 3b2b083cbf
Merge pull request #9487 from hashicorp/f-connect-sidecar-concurrency
consul/connect: default envoy concurrency to 1
2020-12-01 15:51:41 -06:00
Michael Schurter 8ed8d9f786
Merge pull request #9485 from hashicorp/docs-check-restart
docs: check_restart is broken for group networks
2020-12-01 11:39:45 -08:00
Seth Hoenig bf857684d1 consul/connect: default envoy concurrency to 1
Previously, every Envoy Connect sidecar would spawn as many worker
threads as logical CPU cores. That is Envoy's default behavior when
`--concurrency` is not explicitly set. Nomad now sets the concurrency
flag to 1, which is sensible for the default cpu = 250 Mhz resources
allocated for sidecar proxies. The concurrency value can be configured
in Client configuration by setting `meta.connect.proxy_concurrency`.

Closes #9341
2020-12-01 13:12:45 -06:00
Tim Gross 180d6c7ef5
docs: move agent lifecycle doc under Operations heading (#9411) 2020-12-01 11:55:08 -05:00
Michael Schurter c087a1d46f docs: check_restart is broken for group networks
Add a warning about check_restart being limited to task networks and
link to the relevant issue: #9176.
2020-12-01 08:52:00 -08:00
Tim Gross 154e62fd3b
docs: warn about Docker auth_soft_fail behavior
If Docker auth helpers are used but aith fails or the image isn't found, we
hard fail the task. Users may set `auth_soft_fail` to fallback to the public
Docker Hub on a per-job basis. But users that mix public and private images
have to set `auth_soft_fail=true` for every job using a public image if Docker
auth helpers are used.
2020-12-01 09:05:35 -05:00
Mark Lewis ec8361fab9 Update proxy.mdx 2020-12-01 08:26:32 -05:00
Mark Lewis 894851a756 Update reschedule.mdx 2020-12-01 08:26:12 -05:00
Mark Lewis 523dad369b Update restart.mdx 2020-12-01 08:22:13 -05:00
Luiz Aoqui 63d6d3b0d1
website: update general help guidance 2020-11-30 19:12:43 -05:00
Drew Bailey a0b7f05a7b
Remove Managed Sinks from Nomad (#9470)
* Remove Managed Sinks from Nomad

Managed Sinks were a beta feature in Nomad 1.0-beta2. During the beta
period it was determined that this was not a scalable approach to
support community and third party sinks.

* update comment

* changelog
2020-11-30 14:00:31 -05:00
Seth Hoenig fa6789a087
Merge pull request #9472 from hashicorp/f-connect-upstream-datacenter
consul/connect: enable setting datacenter in upstream
2020-11-30 12:29:05 -06:00
Seth Hoenig d38cd5268a docs: better clarify connect upstream datacenter 2020-11-30 12:28:08 -06:00
Seth Hoenig e81e9223ef consul/connect: enable setting datacenter in connect upstream
Before, upstreams could only be defined using the default datacenter.
Now, the `datacenter` field can be set in a connect upstream definition,
informing consul of the desire for an instance of the upstream service
in the specified datacenter. The field is optional and continues to
default to the local datacenter.

Closes #8964
2020-11-30 10:38:30 -06:00
Mark Lewis 338e8995e6
Update migrate.mdx 2020-11-30 10:35:25 -05:00
Mahmood Ali 7a629b7da9
docs: add sidebar title for cidrsubnets (#9469) 2020-11-30 10:34:51 -05:00
Seth Hoenig 49fd063324 docs: spell preceding the normal way 2020-11-30 09:29:24 -06:00
Mark Lewis 6334ad1b42 Update network.mdx 2020-11-30 08:53:17 -05:00
Mahmood Ali d1e139c3fb
Docs for HCL2 (#9322)
Add more detailed HCL2 docs, mostly lifted from Packer with tweaks for Nomad.

The function docs are basically verbatim taken from Packer with basic string substitutions. I commented out some for_each details as the examples are mostly driven towards Packer resources. I'll iterate on those with better Nomad examples.
2020-11-29 20:36:41 -05:00
James Rasell 1776047e6b
Merge pull request #9459 from hashicorp/ml4-patch-3
Update ephemeral_disk.mdx
2020-11-27 11:56:22 +01:00
James Rasell 1779d5f89c
Merge pull request #9460 from hashicorp/ml4-patch-4
Update group.mdx
2020-11-27 11:44:01 +01:00
James Rasell 4e378bb3f8
Merge pull request #9458 from hashicorp/ml4-patch-2-1
Update device.mdx
2020-11-27 11:36:02 +01:00
Mark Lewis 385a06d8e0
Update group.mdx
Typo
2020-11-27 07:37:44 +00:00
Mark Lewis fa3a5e5a7d
Update ephemeral_disk.mdx
Document says size is an `int`, but snippet shows string type.
2020-11-27 07:16:01 +00:00
Mark Lewis d5bfcba1fd
Update device.mdx
Fixed typos
2020-11-27 07:10:04 +00:00
Mark Lewis 1ac9d1c2bb
Update csi_plugin.mdx
typo
2020-11-27 06:56:13 +00:00
Tim Gross 4e79ddea45
csi/api: populate ReadAllocs/WriteAllocs fields (#9377)
The API is missing values for `ReadAllocs` and `WriteAllocs` fields, resulting
in allocation claims not being populated in the web UI. These fields mirror
the fields in `nomad/structs.CSIVolume`. Returning a separate list of stubs
for read and write would be ideal, but this can't be done without either
bloating the API response with repeated full `Allocation` data, or causing a
panic in previous versions of the CLI.

The `nomad/structs` fields are persisted with nil values and are populated
during RPC, so we'll do the same in the HTTP API and populate the `ReadAllocs`
and `WriteAllocs` fields with a map of allocation IDs, but with null
values. The web UI will then create its `ReadAllocations` and
`WriteAllocations` fields by mapping from those IDs to the values in
`Allocations`, instead of flattening the map into a list.
2020-11-25 16:44:06 -05:00