Commit Graph

957 Commits

Author SHA1 Message Date
Kyle Havlovitz dcdadd012f Fix keyring doc method wording 2016-11-22 20:10:43 -05:00
Kyle Havlovitz 6bd65c668b Combine keyring endpoints into one 2016-11-22 20:10:43 -05:00
Kyle Havlovitz 31453c7dbd Add version specific note to keyring http docs 2016-11-22 20:10:43 -05:00
Kyle Havlovitz 345e2366eb Add keyring api website doc sections 2016-11-22 20:10:43 -05:00
James Phillips 4ed6770cfa Makes addresses blank in service definition. 2016-11-22 08:29:29 -08:00
James Phillips ea58d6795d Tweaks title of snapshot link. 2016-11-21 09:02:19 -08:00
Brian Shumate 940232890e
tweaks 2016-11-18 10:53:59 -05:00
Brian Shumate 3871c4810e
Attempt to describe entire response (for #2393)
Describe fields returned by /v1/catalog/service/<service>
2016-11-18 10:33:37 -05:00
Cameron Stokes 74cfcd3014 ~ docs: Typo in agent options page. 2016-11-16 07:58:24 -08:00
Benjamin Farley 58fa50e06d Small change to how operator docs read 2016-11-16 09:01:51 +00:00
Brian Shumate df51fde7b0 Docs: Web UI config updates (#2411)
* Updates around Web UI directory configuration

* consistent terms
2016-11-12 13:08:15 -08:00
Brian Shumate 486fa06eec Updated broken Extended Key Usage link (#2500) 2016-11-10 08:09:39 -08:00
Sumit Gupta 2f97f65ed9 Remove Extra > (#2499) 2016-11-10 08:09:17 -08:00
James Phillips 16f8e04bfe
Revert "Updates Circonus metrics library and adds support for display name and tags."
This reverts commit bd490ec937 from #2491.
2016-11-09 16:21:02 -08:00
matt maier bd490ec937 Updates Circonus metrics library and adds support for display name and tags.
* Update circonus-gometrics

`vendor circonus-labs/circonus-gometrics`
`vendor circonus-labs/circonus-gometrics/api`
`vendor circonus-labs/circonus-gometrics/checkmgr`
`vendor circonus-labs/circonusllhist`
`vendor hashicorp/go-retryablehttp`

* Update Circonus integration expose Check Display Name and Check Tags configuration options.

* Adds version info to docs for new Circonus options.
2016-11-09 13:26:43 -08:00
James Phillips 08448015b1 Adds version info to docs for new Circonus options. 2016-11-09 13:26:20 -08:00
matt maier 91a8b43d5a Update Circonus integration expose Check Display Name and Check Tags configuration options. 2016-11-09 15:33:37 -05:00
Kyle Havlovitz 8e621eb9c8 Set MaxStale default to 10 years and add a stale counter (#2481)
Default MaxStale to 10 years and add a counter at `consul.dns.stale_queries` that tracks when an agent serves a query that's stale by at least 5 seconds. Previously, MaxStale defaulted to 5 seconds and DNS would become unavailable after a short period of time with no leader. This new default allows DNS requests to still be served in the event of a long outage.

Fixes #2460.
2016-11-08 14:45:12 -05:00
Cameron Stokes e6e35d9013 Clarify -retry-join docs. (#2469) 2016-11-03 14:22:46 -07:00
Kyle McCullough 73b281a27c Add setting to skip ssl certificate verification for HTTP checks (#1984)
* http check: add setting to skip ssl certificate verification

* update http check documentation

* fix typo in documentation

* Add TLSSkipVerify to agent api
2016-11-03 13:17:30 -07:00
James Phillips 233a3a101b Supports WAN and LAN Serf Bind Addresses. (#2468)
* * adding cli config and config file support for specifying the serf wan and lan bind addresses
* updating documentation for serf wan and lan options
Fixes #2007

* Cleans up some small things from #2380.

* Uses the bind default for the agent test for Serf WAN and LAN.
2016-11-03 12:58:58 -07:00
Kyle Havlovitz 1de39d23d1
Small tweaks to docs and syntax 2016-11-03 13:04:42 -04:00
Kyle Havlovitz f3efab5f84
Add support for ECS task roles as an auth mechanism 2016-11-02 18:48:15 -04:00
Kyle Havlovitz d4d6e2b482
Move EC2 discovery logic into retryJoin for robustness 2016-11-02 14:35:37 -04:00
Kyle Havlovitz 3be132863f Enable snapshots in dev mode (#2453) 2016-10-31 14:39:47 -04:00
James Phillips c01a3871c9 Adds support for snapshots and restores. (#2396)
* Updates Raft library to get new snapshot/restore API.

* Basic backup and restore working, but need some cleanup.

* Breaks out a snapshot module and adds a SHA256 integrity check.

* Adds snapshot ACL and fills in some missing comments.

* Require a consistent read for snapshots.

* Make sure snapshot works if ACLs aren't enabled.

* Adds a bit of package documentation.

* Returns an empty response from restore to avoid EOF errors.

* Adds API client support for snapshots.

* Makes internal file names match on-disk file snapshots.

* Adds DC and token coverage for snapshot API test.

* Adds missing documentation.

* Adds a unit test for the snapshot client endpoint.

* Moves the connection pool out of the client for easier testing.

* Fixes an incidental issue in the prepared query unit test.

I realized I had two servers in bootstrap mode so this wasn't a good setup.

* Adds a half close to the TCP stream and fixes panic on error.

* Adds client and endpoint tests for snapshots.

* Moves the pool back into the snapshot RPC client.

* Adds a TLS test and fixes half-closes for TLS connections.

* Tweaks some comments.

* Adds a low-level snapshot test.

This is independent of Consul so we can pull this out into a library
later if we want to.

* Cleans up snapshot and archive and completes archive tests.

* Sends a clear error for snapshot operations in dev mode.

Snapshots require the Raft snapshots to be readable, which isn't supported
in dev mode. Send a clear error instead of a deep-down Raft one.

* Adds docs for the snapshot endpoint.

* Adds a stale mode and index feedback for snapshot saves.

This gives folks a way to extract data even if the cluster has no
leader.

* Changes the internal format of a snapshot from zip to tgz.

* Pulls in Raft fix to cancel inflight before a restore.

* Pulls in new Raft restore interface.

* Adds metadata to snapshot saves and a verify function.

* Adds basic save and restore snapshot CLI commands.

* Gets rid of tarball extensions and adds restore message.

* Fixes an incidental bad link in the KV docs.

* Adds documentation for the snapshot CLI commands.

* Scuttle any request body when a snapshot is saved.

* Fixes archive unit test error message check.

* Allows for nil output writers in snapshot RPC handlers.

* Renames hash list Decode to DecodeAndVerify.

* Closes the client connection for snapshot ops.

* Lowers timeout for restore ops.

* Updates Raft vendor to get new Restore signature and integrates with Consul.

* Bounces the leader's internal state when we do a restore.
2016-10-25 19:20:24 -07:00
James Phillips 104b12040a Merge pull request #2383 from hashicorp/jbs-1462
Clarify retry_join addresses for #1462
2016-10-20 11:40:03 -07:00
Brian Shumate 17dfb0b196
Reworded and applied to -retry-join also 2016-10-20 14:14:55 -04:00
James Phillips b073ec72f3 Adds a note about child process reaping going away. 2016-10-06 21:38:29 -07:00
Andreas Böttger cb8deabdc3 json syntax corrected 2016-10-04 15:40:53 +02:00
Brian Shumate 320b07c025
Clarify retry_join addresses for #1462
- Initial pass at adding note about address formats for retry_join;
  IPv4 is a list of IPs only, whereas IPv6 are bracketed IPs + port
2016-10-03 12:15:24 -04:00
Brian Shumate ba5bbf8ca2
Update variable value information as port must also be specified, fixes #2210 2016-09-29 12:50:00 -04:00
Brian Shumate 775c32539f
Finalize update for -bind 2016-09-27 18:36:19 -04:00
Brian Shumate 59a90d68a9
Clarification 2016-09-27 12:38:32 -04:00
Brian Shumate 49a410a2da
Correct inaccurate bind reference, closes #2234 2016-09-27 12:05:22 -04:00
McKenna Jones 34043357da cli flag formatting for agent docs and one guide 2016-09-26 21:22:01 -07:00
Seth Vargo e1c8b14a6b
Clarify that hostname defaults to localhost for tcp 2016-09-21 12:20:36 -04:00
Brian Shumate 2c9501a1b0
Remove references to the 'unknown' state.
- Remove reference to 'unknown' state in catalog endpoint docs
- Remove reference to 'unknown' state in health endpoint docs
2016-09-21 09:50:12 -04:00
James Phillips 6f0a3b9bf5 Adds Operator endpoint link. 2016-09-15 13:13:09 -07:00
James Phillips 0a34741d72 Adds version note to near parameter. 2016-09-06 07:50:06 -07:00
James Phillips 08d6bfbc9b Tweaks options doc after latest merges. 2016-09-01 22:18:34 -07:00
James Phillips f686d34483 Merge pull request #2263 from sweeneyb/dnsPort
Add support for dns port as a command line option
2016-09-01 22:16:15 -07:00
James Phillips d19995c067 Merge pull request #2322 from hashicorp/pr-2321-slackpad
Adds a configurable timeout for DNS recursor client.
2016-09-01 22:11:54 -07:00
James Phillips 951f597cde
Tweaks documentation. 2016-09-01 21:50:46 -07:00
Pivotal DX129 fe61650ef0 Merge remote-tracking branch 'upstream/master' 2016-09-01 10:15:32 -04:00
James Phillips 55ef6c54a6
Changes default for `leave_on_terminate` based on server or client mode. 2016-08-31 23:39:11 -07:00
James Phillips ed7356dd5c
Changes default DNS allow_stale to true. 2016-08-30 13:55:19 -07:00
James Phillips 2c9885d10d
Updates documentation with details on the Consul operator actions. 2016-08-30 13:15:37 -07:00
James Phillips e5850d8a26
Adds new consul operator endpoint, CLI, and ACL and some basic Raft commands. 2016-08-30 00:02:50 -07:00
Pierre Delagrave 578602f248 Added website documentation for the new recursor_timeout parameter 2016-08-29 14:41:30 -04:00
James Phillips 17b70c7efd
Adds a max raft multiplier and tweaks documentation. 2016-08-25 15:36:05 -07:00
James Phillips 57db4bcce6
Adds performance tuning capability for Raft, detuned defaults, and supplemental docs. 2016-08-24 21:58:37 -07:00
Brian Shumate 3d71951c97 Fix typo 2016-08-18 09:14:15 -04:00
James Phillips 861efcc8c8 Merge pull request #2235 from robwdux/patch-1
update ca tutorial to one more recent and relevant
2016-08-17 18:00:03 -07:00
James Phillips 9d154a55ad Update acl.html.markdown 2016-08-17 10:21:59 -07:00
James Phillips 4c7a0ed3b0
Merge branch 'master' into f-deregister-critical 2016-08-16 12:53:21 -07:00
James Phillips ba60afd5d8
Cleans up based on code review feedback. 2016-08-16 12:52:30 -07:00
James Phillips 9f7a973ace
Adds an `X-Consul-Translate-Addresses` to signal translation is enabled. 2016-08-16 11:31:41 -07:00
James Phillips fbdd021ab9
Adds an "lan" tagged address so we have a way to get them all.
If we didn't have this, then there would be no way to know the LAN
address if address translation was turned on.
2016-08-16 10:49:03 -07:00
James Phillips 231f5a957f
Fixes a typo and adds an admonition about only being in Consul 0.7+. 2016-08-16 09:27:20 -07:00
James Phillips 4a3d7db24f
Adds ability to deregister a service based on critical check state longer than a timeout. 2016-08-16 01:00:26 -07:00
James Phillips 315b9d4ea4 Tweaks translate_wan_addr documentation.
Adds a note about HTTP being 0.7 and later only.
2016-08-15 16:23:01 -07:00
James Phillips affbb27416 Merge pull request #2275 from hashicorp/pr-2118-slackpad
Translates node addresses to WAN addresses where appropriate.
2016-08-15 16:16:56 -07:00
James Phillips b8fa011972
Updates docs for WAN address translation and tweaks some nearby unrelated docs. 2016-08-15 16:12:01 -07:00
Brian Shumate f150a8a7a9 Add anchor 2016-08-15 16:48:54 -04:00
James Phillips bcb0f71759
Finishes up DNS compression by adding opt-out, tests, and documentation. Fixes trim routine. 2016-08-11 16:27:08 -07:00
sweeneyb 14ec3290fa Add support for dns port as a command line option 2016-08-10 04:05:56 +00:00
James Phillips 7b80f5d278 Adds a note about HTTP telemetry. 2016-08-09 16:03:59 -07:00
James Phillips 95930e3cb7 Merge pull request #2237 from hashicorp/f-acl-replication
Adds ACL replication.
2016-08-09 11:42:16 -07:00
James Phillips c499c4e7d3
Updates documentation for ACL replication. 2016-08-05 00:23:28 -07:00
rob dux 376a0cbf6f update ca tutorial to one more recent and relevant 2016-08-02 21:24:02 -05:00
Andrei Burd 094d7cb9e0 Added missing comma 2016-08-01 18:46:43 +03:00
James Phillips 85bd2a5459 Adds a cautionary note about the stats in the self API. 2016-07-29 13:45:25 -07:00
James Phillips 4fb97a2ef9 Tweaks the agent docs for `EnableTagOverride`. 2016-07-23 14:48:54 -07:00
shalev67 f66bf3114a Added api agent docs enableTagOverride var 2016-07-22 20:21:07 +03:00
Jason Martin a1b38ececb
Escape verify_server_hostname angle-brackets 2016-07-20 15:57:07 -07:00
matt maier 5d020e72ed Change circonus_broker_search_tag to circonus_broker_select_tag to match same change to command/agent/config.go 2016-07-20 11:44:38 -04:00
James Phillips cfbe8f430e Merge pull request #2193 from hashicorp/pr-2188-slackpad
Adds Circonus support for telemetry metrics.
2016-07-19 17:15:29 -07:00
James Phillips 129db848c7 Tweaks the docs a bit. 2016-07-19 15:54:52 -07:00
akbarahmed 79dd717f41 Merge remote-tracking branch 'upstream/master' 2016-07-19 11:01:55 -07:00
akbarahmed 591f6ca3ef Unnest TaggedAddresses. Add sentence to mention that multiple Checks may
be specified as an array. Closes hashicorp/consul#2176
2016-07-19 10:55:46 -07:00
matt maier 1b6dd97864 Documentation for Circonus Telemetry integration 2016-07-18 16:24:49 -04:00
Stu Small 450d3dbe91 Fixing minor punctuation mistake. 2016-07-13 16:50:19 -06:00
Ryan Uber 5023c4add1 Merge pull request #1847 from mssola/dc-to-datacenter
[proposal] command: deprecated the -dc flag in the agent CLI
2016-07-05 13:01:51 -07:00
Sean Macdonald 525d977bd4 small typo 2016-07-02 01:29:00 -04:00
Ryan Uber 01b28b9581 website: document near parameter of prepared queries 2016-07-01 11:50:09 -07:00
James Phillips af30e17dcd Merge pull request #2123 from hashicorp/f-key-metrics
Adds a key metrics section to the telemetry guide.
2016-06-18 04:01:15 +01:00
James Phillips 4c82c45ee9 Adds a key metrics section to the telemetry guide. 2016-06-17 18:57:42 +01:00
Sheldon Kwok 14abdbf5ad Update agent.html.markdown
The documentation was not clear and I had to try with the cli to figure it out.
2016-06-09 16:48:18 -07:00
lihz 392c2605f3 add tcp in service/register
I found consul /service/register interface supprt TCP check as well.
2016-06-03 19:29:05 +08:00
Michael Barrow 9c3e2f1aef Fix typo
Simple typo fix.
2016-05-29 10:24:44 -07:00
Sean Chittenden 446d76b432
Fix the href target for the `/v1/catalog/node/<node>` endpoint. 2016-05-27 00:12:17 -07:00
Sean Kilgore edc31a9391 docs: clarify address specification for telemetry
Earlier on this page, under `addresses`, we say "For TCP addresses, these should simply be an IP address without the port. For example: 10.0.0.1, not 10.0.0.1:8500." Since we expect the port to be included for `_address` for telemetry, call it out specifically.
2016-05-24 12:55:23 -07:00
Saif Abid 8211555d0d Fix json for /v1/catalog/node in markdown
add in a missing comma after the "Address" field
2016-05-19 14:41:41 -04:00
James Phillips 0f5aabcbbd Merge pull request #2028 from hashicorp/f-atomic-kv
Adds support for atomic transactions spanning multiple KV entries.
2016-05-15 13:46:05 -07:00
Sean Chittenden 92298e3d02
Speling police 2016-05-15 09:13:52 -07:00
James Phillips 653387637a Reduces the number of operations in a transaction to 64. 2016-05-14 21:40:46 -07:00
James Phillips 778b975e7a Adds a get-tree verb to KV transaction operations. 2016-05-13 16:57:39 -07:00
James Phillips 570d46aa5f Adds some size limiting features to transactions to help prevent abuse. 2016-05-13 13:39:01 -07:00
James Phillips fbfb90a694 Removes null results for deletes, and preps for more than one result from an operation. 2016-05-13 01:47:55 -07:00
James Phillips a37bf9de56 Adds a read-only optimized path for transactions. 2016-05-13 00:34:05 -07:00
James Phillips 17cd0ac4ec Adds documentation for the transaction endpoint. 2016-05-11 14:18:47 -07:00
James Phillips c6bde826a4 Fixes and clarifies the only_passing docs. 2016-04-27 14:55:38 -07:00
James Phillips ceac68c5eb Merge pull request #1762 from mshean/script-timeout
Add Timeout field to CheckMonitor
2016-04-24 23:08:06 -07:00
Sean Chittenden 0c7f697244 Tweak discussion regarding reaping to advise against adjusting these
values.
2016-04-21 14:24:41 -07:00
Sean Chittenden bb7c3b75a3 Fix broken markdown 2016-04-20 18:46:01 -04:00
James Phillips c11e1506c5 Merge pull request #1935 from hashicorp/f-reap-time
Makes reap time configurable for LAN and WAN.
2016-04-20 13:50:21 -07:00
James Phillips cf00c11221 Sets an anti-footgun floor for the configurable reap time. 2016-04-20 13:49:51 -07:00
Matt Shean fa575db15c Update documentation for CheckMonitor timeout 2016-04-20 11:43:49 -07:00
James Phillips 963916e990 Clarifies default behavior of blank service addresses. 2016-04-20 10:16:06 -07:00
Ryan Uber 8855ec0e2d website: mention 4K output limit for checks 2016-04-14 14:35:35 -07:00
James Phillips 724707649c Merge pull request #1891 from romansky/patch-1
clerify RPC usage
2016-04-12 02:10:15 -07:00
James Phillips 7f55f9825f Updates some docs that say reaping is not configurable. 2016-04-11 00:56:03 -07:00
James Phillips eedeba682b Makes reap time configurable for LAN and WAN. 2016-04-11 00:38:25 -07:00
Sean Chittenden bd05093986 Add a note re: pre-0.7 behavior 2016-03-31 18:06:58 -07:00
Sean Chittenden 5994c9efbf skip_leave_on_int's default changes based on agent mode
`skip_leave_on_int`'s behavior now changes based on whether or not the agent is acting as a client or server.

Fixes: 1687
2016-03-31 17:45:14 -07:00
Roman Landenband 2a034373ed fix correct RPC entity 2016-03-30 12:21:52 +03:00
Sean Chittenden fe0a7283d3 Reword `udp_answer_limit` for the better. 2016-03-29 23:48:22 -07:00
Sean Chittenden fcee9779ae Use industry jargon re: DNS round-robin
s/randomized DNS round-robin/round-robin DNS/
2016-03-29 23:07:42 -07:00
Sean Chittenden d4f7f143f2 Whitespace, indent markdown correctly 2016-03-29 19:27:36 -07:00
Sean Chittenden c5c8daf07a Trim UDP responses per configuration 2016-03-29 19:27:21 -07:00
Sean Chittenden 4b5674bee3 Merge branch 'b-dns-single-record' of ssh://github.com/hashicorp/consul into b-dns-single-record
# Conflicts:
#	command/agent/dns.go
2016-03-29 19:24:53 -07:00
Sean Chittenden 9fb64ab114 Allow adjusting the number of DNS records in a response...
Based on work done by @fusiondog in #1583, extend the concept to use an integer instead of a boolean.

Fixes: #1583 && #1481
2016-03-29 19:23:56 -07:00
Roman Landenband aebae0349b clerify RPC usage 2016-03-29 15:10:28 +03:00
James Phillips 77ad084229 Fixes JSON in wildcard query example. 2016-03-23 14:33:20 -07:00
James Phillips e60a095207 Merge pull request #1839 from foxel/patch-1
Clarification for advertise_addrs.rpc
2016-03-21 16:14:17 -07:00
Sean Chittenden f33b2722d8 Update the docs slightly re: only_passing
Signed-off by: @slackpad
2016-03-21 16:07:56 -07:00
Sayalic bb9ddee4a0 add inline code segment to enableTagOverride 2016-03-20 11:09:12 +08:00
Wim b5d45322b4 Allow [::] as a bind address (binds to first public IPv6 address) 2016-03-18 23:59:44 +01:00
Miquel Sabaté Solà 4567963d8e command: deprecated the -dc flag in the agent CLI
The `-dc` flag from the agent CLI command has been deprecated in favor of
`-datacenter`. This is done this way because:

- Other CLI commands used `-datacenter`. See: event, exec and watch.
- The agent configuration file uses `datacenter`.

Signed-off-by: Miquel Sabaté Solà <msabate@suse.com>
2016-03-18 15:44:35 +01:00
James Phillips 6b2ace6f6b Fixes a few bugs in the prepared query doc. 2016-03-17 23:42:27 -07:00
Andrey Kupreychik f4cc8e7620 Clarification for advertise_addrs.rpc
Clarification for advertise_addrs.rpc as it sets the server RPC port (default 8300)
2016-03-16 12:10:54 +05:00
James Phillips adea7cda81 Merge pull request #1803 from tylert/doc-enc-update
Update agent encryption doc example
2016-03-10 20:06:02 -08:00
James Phillips 01ae1e7dfe Merge pull request #1820 from hashicorp/f-port-docs
Adds a reference to the network ports from the security guide.
2016-03-09 21:22:41 -08:00
James Phillips c1de5b7a13 Adds a reference to the network ports from the security page. 2016-03-09 21:21:49 -08:00
Igor Dubinskiy bc7b65452c Fix doc typo 2016-03-09 12:41:49 -08:00
Tyler Tidman 43312b4a69 Update agent encryption doc example 2016-03-09 11:18:48 -05:00
Igor Dubinskiy 3a25860270 Make sure UDP DNS responses aren't larger than allowed 2016-03-07 16:41:17 -08:00
James Phillips aa8cd2619d Fixes broken example JSON. 2016-03-07 10:45:39 -08:00
James Phillips eb7004f2b8 Renames "debug" endpoint and structures to "explain". 2016-03-07 10:45:39 -08:00
James Phillips d7288e3a5e Adds a prepared query debug endpoint. 2016-03-07 10:45:39 -08:00
James Phillips fbd8e40cd5 Adds basic docs for prepared query templates. 2016-03-07 10:45:39 -08:00
James Phillips 7ebad899da Adds a new PUT-based TTL check update endpoint. 2016-03-02 17:54:01 -08:00
James Phillips ef1a588b7a Merge pull request #1777 from hashicorp/b-port-docfix
TLS example and correcting error
2016-03-01 13:02:30 -08:00
James Phillips b92243d8d0 Tweaks the address and advertise docs. 2016-03-01 13:01:13 -08:00
James Phillips dca480e284 Cleans up the documents. 2016-02-24 18:05:58 -08:00
James Phillips 7d392118d2 Adds a check for users re-submitting the redacted token. 2016-02-24 17:35:26 -08:00
James Phillips 483898abe5 Renames "prepared_query" ACL policy to "query". 2016-02-24 17:02:06 -08:00
James Phillips 880cd21667 Refactors docs into a more complete state for prepared query ACLs. 2016-02-23 22:27:44 -08:00
James Phillips 67de77482e Creates new "prepared-query" ACL type and new token capture behavior.
Prior to this change, prepared queries had the following behavior for
ACLs, which will need to change to support templates:

1. A management token, or a token with read access to the service being
   queried needed to be provided in order to create a prepared query.

2. The token used to create the prepared query was stored with the query
   in the state store and used to execute the query.

3. A management token, or the token used to create the query needed to be
   supplied to perform and CRUD operations on an existing prepared query.

This was pretty subtle and complicated behavior, and won't work for
templates since the service name is computed at execution time. To solve
this, we introduce a new "prepared-query" ACL type, where the prefix
applies to the query name for static prepared query types and to the
prefix for template prepared query types.

With this change, the new behavior is:

1. A management token, or a token with "prepared-query" write access to
   the query name or (soon) the given template prefix is required to do
   any CRUD operations on a prepared query, or to list prepared queries
   (the list is filtered by this ACL).

2. You will no longer need a management token to list prepared queries,
   but you will only be able to see prepared queries that you have access
   to (you get an empty list instead of permission denied).

3. When listing or getting a query, because it was easy to capture
   management tokens given the past behavior, this will always blank out
   the "Token" field (replacing the contents as <hidden>) for all tokens
   unless a management token is supplied. Going forward, we should
   discourage people from binding tokens for execution unless strictly
   necessary.

4. No token will be captured by default when a prepared query is created.
   If the user wishes to supply an execution token then can pass it in via
   the "Token" field in the prepared query definition. Otherwise, this
   field will default to empty.

5. At execution time, we will use the captured token if it exists with the
   prepared query definition, otherwise we will use the token that's passed
   in with the request, just like we do for other RPCs (or you can use the
   agent's configured token for DNS).

6. Prepared queries with no name (accessible only by ID) will not require
   ACLs to create or modify (execution time will depend on the service ACL
   configuration). Our argument here is that these are designed to be
   ephemeral and the IDs are as good as an ACL. Management tokens will be
   able to list all of these.

These changes enable templates, but also enable delegation of authority to
manage the prepared query namespace.
2016-02-23 17:12:43 -08:00
Michael Crilly 4c8725ef63 TLS example and correcting error
The example configuration file omits TLS support in the HTTP API. This is fine, but a second example demonstrating how to enable TLS over the HTTP API is harmless and, in fact, should be default practice.

Using the format `ip:port` in the "addresses" block will cause Consul to crash on reload/start. See issue (#1727)[https://github.com/hashicorp/consul/issues/1727#issuecomment-184980751]
2016-02-17 15:24:37 +10:00
Sean Chittenden d2745081f3 Allow adjusting the number of DNS records in a response...
Based on work done by @fusiondog in #1583, extend the concept to use an integer instead of a boolean.

Fixes: #1583 && #1481
2016-02-12 12:18:25 -08:00
James Phillips 590ab94d8d Adds documentation for WAN address translation. 2016-02-07 11:12:19 -08:00
James Phillips d2d6b51fe4 Tweaks the telemetry docs. 2016-02-06 22:07:11 -08:00
Nate Brown 43a4f3fe02 Option to disable hostnames from telemetry 2016-01-29 13:44:48 -08:00
Raja Nadar cd17cdc03d fixing small typo in json 2016-01-29 01:25:23 -08:00
Daryl b2f8ef9f32 Correcting count of checks
I saw there were 5 checks listed - script, tcp, http, ttl, docker.
2016-01-19 22:50:27 -05:00
Seth Vargo f5ffa8fb79 Fix broken link 2016-01-13 19:32:30 -05:00
Seth Vargo cae0ff354a Use HTTPS + www. where appropriate 2016-01-13 17:44:01 -05:00
James Phillips 203d8101eb Tweaks wording of reap config option section. 2016-01-06 22:29:03 -08:00
James Phillips c1fe9092ed Merge pull request #1550 from hashicorp/f-devmode
Add a `-dev` mode for easy prototyping
2016-01-05 10:01:41 -08:00
James Phillips ebad52ffc2 Merge pull request #1549 from kikitux/patch-1
[doc] fix identation on statsd_addr
2016-01-02 06:50:56 -08:00
Peter Schaadt b15d02e431 Fixing typos in Coordinate documentation. 2015-12-28 16:34:09 -08:00
Ryan Uber c4e73275b0 website: add docs for dev mode 2015-12-27 09:45:59 -06:00
Alvaro Miranda bbf67d83fb fix identation on statsd_addr
ditto
2015-12-27 18:19:31 +13:00
Ryan Uber e040616df1 website: document the static ui flag 2015-12-24 22:21:34 -05:00
James Phillips 0b1c346990 Changes sense of option to "reap" and uses nil for "not set". 2015-12-22 10:28:10 -08:00
James Phillips 2b257c922e Adds child process reaping when Consul is running as PID 1. 2015-12-21 21:47:35 -08:00
James Phillips 63b3e7f16a Clarifies format of stats aggregator configurations as host:port. 2015-12-18 22:53:55 -08:00
William Jimenez 9f0594a9e1 Update options.html.markdown
clarify that setting `acl_default_policy` won't have any effect unless ACL support is also enabled by setting `acl_datacenter`
2015-12-18 14:26:35 -08:00
Sep Nasiri 48c2f68edc Change example filename to use .json instead of .js
Since only .json files are loaded using .js as an example here is confusing.
2015-12-08 18:42:32 -08:00
James Phillips 4c47f2d57f Adds blank line to fix Docker check formatting. 2015-12-08 00:04:55 -08:00
Ryan Breen 4d42ff66e3 Update health.html.markdown
Correct json syntax in example.
2015-11-23 09:39:05 -05:00
Arnout Engelen afc77a4634 Include 'Service'/'Address' field in example
Add the `Service`/`Address` field to the example output for the `/v1/health/service/\<service\>` endpoint.

Even though it's an optional value, this is probably the one consumers are looking for (rather than the `Node` address)
2015-11-23 15:01:24 +01:00
James Phillips d861f87851 Fixes a typo in the prepared queries doc. 2015-11-20 21:44:24 -08:00
James Phillips ab63122a32 Removes old logging doc which was empty. 2015-11-18 14:41:50 -08:00
James Phillips 95c708f65e Adds Docker checks support to client API.
Also changed `DockerContainerId` to `DockerContainerID`, and updated the agent
API docs to reflect their support for Docker checks.
2015-11-18 07:40:02 -08:00
Sean Chittenden e4d7bfee6a Fix markdown's markup: 2^(64-1) != 2^(64)-1 2015-11-17 15:21:47 -08:00
James Phillips 800e946bf1 Adds and updates docs for prepared queries. 2015-11-15 17:06:00 -08:00
James Phillips f1f9d30ade Extends the session TTL max to 24 hours, and adds a warning to the docs. 2015-11-15 16:51:00 -08:00
talwai 0a5434f2a0 Add DogStatsD configuration options to documentation source 2015-11-11 14:30:37 -05:00
Diptanu Choudhury c25d0f044f Some more grammer corrections and formatting to docker check docs 2015-10-28 14:56:55 -07:00
Diptanu Choudhury 1633cf9d1c Some changes to the docker check docs 2015-10-28 14:24:03 -07:00
Diptanu Choudhury e4f2887ba3 Added some docs for the docker check 2015-10-28 14:19:57 -07:00
Cameron Stokes 442461b030 Clarify format of the -atlas agent option. 2015-10-27 14:21:05 -07:00
Victor Trac 2b00e1cd6a Mote -> Note typo 2015-10-26 15:10:20 -05:00
James Phillips cef9402ab9 Updates docs for network coordinates. 2015-10-23 15:23:01 -07:00
James Phillips f9da231a1c Adds coordinate of agent to self endpoint. 2015-10-23 15:23:01 -07:00
James Phillips 33e3505aea Adds endpoints for raw network coordinates. 2015-10-23 15:23:01 -07:00
James Phillips 9c9195746f Changes ?near=self to a safer ?near=_agent, which is also clearer about what it does. 2015-10-23 15:23:01 -07:00
James Phillips 9caa5b3653 Adds distance sorting to health endpoint. Cleans up unit tests. 2015-10-23 15:23:01 -07:00
James Phillips e47eea3f3a Adds a magic "self" node name to distance queries. 2015-10-23 15:23:01 -07:00
James Phillips 36c78f5042 Adds sort of DCs in catalog queries based on RTT. Cleans up.
* Makes the catalog endpoint respect disabling coordinates for all
  RTT-sorting query types.
2015-10-23 15:23:01 -07:00
James Phillips 89c7203f31 Adds coordinate sorting support to catalog queries for nodes and service nodes. 2015-10-23 15:23:01 -07:00
Armon Dadgar 6a350d5d19 Merge pull request #1318 from daveadams/f-http-header-token
Allow specifying Consul token in an HTTP request header
2015-10-22 13:33:47 -07:00
David Adams b7bcb2a414 Add HTTP request header X-Consul-Token
Add support for an X-Consul-Token HTTP request header to specify the
token with which this request should be fulfilled. The header would have
precedence over the responding Agent's default token, but would have
lower precedence than a token specified in the query string.
2015-10-19 11:26:01 -05:00
James Phillips dc05fb728a Updates docs about new "acquire when you already have it" behavior. 2015-10-15 14:59:09 -07:00
Jeff Wang 0488dfd366 Make service lookup DNS documentation consistent 2015-09-23 23:16:34 -07:00
Jeff Wang ce66db8157 Make node lookup DNS documentation consistent 2015-09-23 23:09:52 -07:00
James Phillips 2f9ebdb135 Merge pull request #1187 from sfncook/enable_tag_drift_03
Enable tag drift 03
2015-09-11 15:35:32 -07:00
Shawn Cook 1f330add02 Doc changes in response to review. 2015-09-11 15:26:30 -07:00
Shawn Cook 598526eba2 Docs - add verbage to anti-entropy page. 2015-09-11 14:27:54 -07:00
Anthony Scalisi 10e028d599 remove various typos 2015-09-11 12:29:54 -07:00
Shawn Cook 4caf049c4c Update documentation for service definition 2015-09-11 09:32:54 -07:00
James Phillips 1387aba91b Fixes a typo in the telemetry docs. 2015-09-02 21:37:31 -07:00
Ryan Breen 80d26f9156 Merge pull request #1167 from railsguru/master
Add -http-port option to change the HTTP API port
2015-09-02 01:15:55 -04:00
Andy Lo-A-Foe bb5422af14 Position it alphabetically 2015-09-02 06:28:55 +02:00
Andy Lo-A-Foe 00b906774b Update agent options section on the website 2015-09-02 05:36:09 +02:00
Ryan Uber 4adc0b5c66 website: document precedence of Atlas endpoint inputs 2015-08-27 17:54:56 -07:00
Ryan Uber b8e82eee1c website: document atlas endpoint config 2015-08-27 11:31:29 -07:00
Ryan Uber b0fcb6c234 Merge pull request #1199 from hashicorp/f-scada-reload
SCADA client is reload-able
2015-08-26 11:46:50 -07:00
Ryan Uber 96e7b1869c website: add atlas token/infra to reloadable config 2015-08-25 17:21:29 -07:00
James Phillips 103fe83b4a Clarifies services docs a bit. 2015-08-25 16:12:19 -07:00
Cameron Stokes 23db28a5db Added detail about left/failed nodes and 72h reaping
Ref: https://groups.google.com/forum/#!searchin/consul-tool/left/consul-tool/KVl0u91uCdw/bfzrUO4r-1QJ
2015-08-06 17:37:48 -07:00
Peter Fern 916ff7e5fa Document `TCP` check type 2015-07-27 10:53:52 +10:00
ketzacoatl b63041c3b0 Minor improvement to `acl_master_token` docs
Confirm the expected format, and what happens if not provided.
2015-07-01 15:34:35 -04:00
Ryan Uber 6290cb93bd website: adding tag/service name dns compliance docs 2015-06-25 09:08:38 -07:00
Ryan Uber d0348d1291 Merge pull request #1004 from i0rek/advertise_addrs
Add advertise_addrs.
2015-06-23 12:32:07 -07:00
Hans Hasselberg 267e0caf81 Implement advertise_addrs for SerfLan, SerfWan and RPC.
Fixes #550.
This will make it possible to configure the advertised adresses for
SerfLan, SerfWan and RPC. It will enable multiple consul clients on a
single host which is very useful in a container environment.

This option might override advertise_addr and advertise_addr_wan
depending on the configuration.

It will be configureable with advertise_addrs. Example:

{
  "advertise_addrs": {
    "serf_lan": "10.0.120.91:4424",
    "serf_wan": "201.20.10.61:4423",
    "rpc": "10.20.10.61:4424"
  }
}
2015-06-23 21:23:45 +02:00
Ryan Uber c8b3e48cbf website: link to check pass/fail endpoint docs from checks page 2015-06-22 10:21:50 -07:00
Ryan Uber c8f76b5e2c website: document passing ACL tokens in catalog register/deregister 2015-06-15 11:45:30 -07:00
Christian Theune 74ac30c601 Wording. 2015-06-12 16:09:44 +02:00
Christian Theune 7211876688 Make behaviour of keyprefixes always matching all keys in a prefix more clear. 2015-06-12 16:07:42 +02:00
Ryan Uber e872587e19 website: document TTL check persistence 2015-06-05 17:15:57 -07:00
siddharthist 0dac1ea126 Clarify how intervals are parsed
Current docs only show second intervals and do not specify
other valid options, this commit specifically outlines how the times are
parsed.
2015-06-03 12:53:09 -05:00
Ryan Uber 32820fc9d2 website: add status field for check registration in http docs 2015-05-28 13:09:33 -07:00
Ryan Uber 1ae7710024 website: document setting initial status of health checks in config 2015-05-28 13:03:01 -07:00
Armon Dadgar ab3632e409 consul: lower default query time and add small stagger 2015-05-14 17:59:43 -07:00
Armon Dadgar 90d6204a1a website: document the new TLS changes 2015-05-11 16:22:10 -07:00
Cameron Ruatta 587cd35c6c Adding docs about configuration directory sub-directories 2015-05-11 10:36:50 -07:00
Cameron Ruatta 9271d94532 Adding documentation about specifying multiple configuration directories 2015-05-11 10:19:04 -07:00
Ryan Uber dd57071240 website: Document peers api consistency. Fixes #880 2015-05-06 12:13:28 -07:00
Armon Dadgar f3a8f907fb Merge pull request #909 from hashicorp/f-create
Support ACL upsert behavior
2015-05-06 11:22:11 -07:00
Ryan Uber 739d1fdf03 Merge pull request #891 from hashicorp/f-token
ACL tokens for service/check registration
2015-05-05 22:17:31 -07:00
Armon Dadgar c0f92c3256 website: Document new ACL upsert behavior 2015-05-05 19:25:27 -07:00
Armon Dadgar a86f31517b Merge pull request #816 from pepov/master
Support different advertise address for WAN gossip
2015-05-04 15:40:25 -07:00
Ryan Uber 5f140f1972 website: document statsite_prefix option 2015-05-03 16:54:19 -07:00
Ryan Uber 8d2834fb12 website: document service and check acl options 2015-04-28 14:28:06 -07:00
Vasily Vasilkov 3f5e767c30 Fix invalid link to sessions page 2015-04-22 12:40:27 +03:00
Cameron Ruatta c7d560bd7e Caps not necessary here 2015-04-20 20:59:45 -07:00
Cameron Ruatta b3c084382e Updating the docs to include information about registering a check with
a serviceid.
2015-04-20 20:56:26 -07:00
Ryan Breen 17c2644e39 Website: minor fix for docs/agent/http/agent.html. 2015-04-17 11:43:02 -04:00
Armon Dadgar eccd5a18f9 Merge pull request #844 from mkostrikin/patch-1
Small tip for gracefull kill
2015-04-10 10:43:09 -07:00
Ryan Uber e5797d9a86 website: fix typo 2015-04-08 09:59:23 -07:00
Maxim N. Kostrikin 362e44e678 Small tip for gracefull kill 2015-04-07 13:15:48 +05:00
Ryan Breen 0ad25ece43 Website: GH-831, mention that https port must be specified to start an https listener. 2015-04-03 22:12:00 -04:00
Ryan Breen 3035abd446 Website: GH-826 fix anchor links in /docs/agent/watches.html. 2015-03-31 17:22:50 -04:00
pepov 80dcc7fa08 update the docs: add advertise-wan cli and advertise_addr_wan json config 2015-03-28 16:08:20 +01:00
Ryan Uber 2fc6d530f3 website: document minimum session TTL setting 2015-03-27 11:34:27 -07:00
Ryan Breen 6e261622f8 Website: GH-730 for docs/agent/watches.html. 2015-03-26 14:18:51 -04:00
Ryan Breen f09817ada6 Website: GH-730 for docs/agent/telemetry.html. 2015-03-25 08:56:40 -04:00
Ryan Breen 220accc7d7 Website: GH-730 for docs/agent/encryption.html 2015-03-24 15:30:35 -04:00
Ryan Breen 0c21136a28 Website: GH-730 for docs/agent/dns.html. 2015-03-23 15:48:35 -04:00
Johannes 'fish' Ziemke f935a8a506 Add -domain command line flag to agent
This makes it possible to configure the domain on the command line
additionally to the config file.
2015-03-20 16:05:41 +01:00
tummychow 81545e9499 Add doc notes for HTTPS API
- the HTTPS API address can be configured just like any other address
- the verify_incoming setting also applies to the HTTPS API
2015-03-18 16:08:41 -07:00
Ryan Breen 8920da59ee Website: cleanup for intro/getting-started/checks.html. 2015-03-17 17:50:28 -04:00
Bob Potter 7386c49fd6 website: default health check is 'serfHealth' 2015-03-05 17:38:28 -08:00
Ryan Breen 57a9928d48 Website: GH-751 Link to anti-entropy doc everywhere that the term is used. 2015-03-04 10:22:53 -05:00
Ryan Breen 30b7cf7f1f Website: GH-747 change acl_master token to acl_master_token 2015-03-03 11:46:57 -05:00
Ryan Breen caf1783366 Website: GH-747 Add docs on acl_master_token installation. 2015-03-03 11:33:49 -05:00
Seth Vargo a022dfcb32 Be consistent in docs about Consul Replicate vs consul-replicate 2015-02-24 20:29:41 -05:00
Ryan Breen b9e72887e9 Website: Add links to options and commands referenced in docs/agent/basics.html and docs/guide/bootstrapping.html. 2015-02-24 14:11:11 -05:00
Ryan Breen f41dce97fd Manually specify anchors for each LI in options.html. This is necessary because the middleman-hashicorp logic only inserts anchors if the body of the LI contains no links. For consistent presentation, we need to specify all anchors rather than relying on middleman. 2015-02-24 12:30:17 -05:00
Ryan Breen 26ec7ca600 Website: /docs/agent/options Fix internal links in options.html to match the anchors created by middleman-hashicorp. 2015-02-23 15:34:46 -05:00
Ryan Breen a5b5eff31c Merge branch 'master' of github.com:hashicorp/consul 2015-02-23 14:45:00 -05:00
Ryan Breen 16600d498e Website: docs/agent/options.html Fix config-file reference. 2015-02-23 14:44:31 -05:00
Ryan Uber 2c3995b8c5 website: document -recursor arg for agent cli 2015-02-23 10:43:15 -08:00
Ryan Breen b78eb40ef4 s/data center/datacenter/g 2015-02-19 17:45:47 -05:00
Armon Dadgar 05ac51ca26 website: Adding Atlas docs 2015-02-18 15:15:01 -08:00
Armon Dadgar c650deb076 website: Document new options 2015-02-18 15:15:01 -08:00
Ryan Breen 802804a6cf Website: add some missing intra-page links in docs/agent/options 2015-02-16 20:51:04 -05:00
Ryan Breen abfe4061a8 Website: clean up a few intra-page links in docs/agent/options 2015-02-16 20:42:21 -05:00
Ryan Breen bfcdd210b7 Website: add intra-page links in docs/agent/options 2015-02-16 19:48:49 -05:00
Ryan Breen 3f23ac2fc7 Website: finalize edits for configuration file options in docs/agent/options. 2015-02-15 00:47:52 -05:00
Ryan Breen 0c22eb0039 Website: edits for configuration file options in docs/agent/options. 2015-02-15 00:43:01 -05:00
Armon Dadgar 9791cb1298 Merge pull request #695 from ryanbreen/session
Website: cleanup for docs/agent/http/session
2015-02-13 17:21:24 -08:00
Ryan Breen 75335db84f Website: tweak cleanup for the docs/agent/options Command-line options section. 2015-02-13 15:19:17 -05:00
Ryan Breen 96c4aecc17 Website: cleanup for the docs/agent/options Command-line options section. 2015-02-13 14:58:05 -05:00
Ryan Breen 679c5ddc50 Remove language about LockDelay parsing. 2015-02-12 20:34:40 -05:00
Armon Dadgar 20e936ead7 Merge pull request #692 from ryanbreen/kv
Website: cleanup of docs/agent/http/kv
2015-02-12 16:53:49 -08:00
Ryan Breen f325791590 More cleanup for docs/agent/http/session. 2015-02-12 15:15:53 -05:00
Ryan Breen d2bc6f156d Website: cleanup for docs/agent/http/session. 2015-02-12 14:50:54 -05:00
Ryan Breen 22162efccf Website: finalize cleanup of docs/agent/http/kv 2015-02-11 23:44:10 -05:00
Ryan Breen 1b6b1e09bd Website: cleanup of docs/agent/http/kv 2015-02-11 21:54:03 -05:00
Ryan Breen 03fad82b09 Website: finalize cleanup for docs/agent/http/health. 2015-02-10 15:52:22 -05:00
Ryan Breen 01c74378a5 Website: cleanup for docs/agent/http/health. 2015-02-10 15:49:21 -05:00
Armon Dadgar c6ec9dd844 Merge pull request #678 from ryanbreen/agent
Cleanup for docs/agent/http/agent.
2015-02-09 09:54:53 -08:00
Armon Dadgar d3df3673fa Merge pull request #681 from ryanbreen/catalog
Website: cleanup of docs/agent/http/catalog
2015-02-09 09:53:57 -08:00
Ryan Breen 6c9edb4eba Website: cleanup for docs/agent/http/event. 2015-02-09 11:24:23 -05:00
Ryan Breen b8beec0311 Website: finalize cleanup of docs/agent/http/catalog. 2015-02-08 12:49:02 -05:00
Ryan Breen 3df08cb7ab Website: edits for docs/agent/http/catalog. 2015-02-08 12:44:36 -05:00
Ryan Breen 75f9327fe4 Finalize cleanup of docs/agent/http/agent. 2015-02-07 17:43:43 -05:00
Ryan Breen b90fa33929 Cleanup for docs/agent/http/agent. 2015-02-07 17:36:10 -05:00
Ryan Breen 9e54778fbe Fixes for docs/agent/http/status 2015-02-06 13:47:32 -05:00
Ryan Uber 6cc9478c38 website: document http check timeout configuration 2015-02-05 23:30:08 -08:00
Armon Dadgar 7724fd8774 Merge pull request #673 from ryanbreen/watches
Very minor tweaks to docs/agent/watches
2015-02-05 09:43:54 -08:00
Ryan Breen a02bd2f586 Finalize cleanups for docs/agent/http/acl. 2015-02-05 12:02:03 -05:00
Ryan Breen 1fcded43af Cleanups for docs/agent/http/acl. 2015-02-05 11:52:29 -05:00
Ryan Breen f381aa554a Pare off unnecessary space. 2015-02-04 22:28:10 -05:00
Ryan Breen 6c30b2f39a Minor fixes for docs/agent/watches. 2015-02-04 22:25:29 -05:00
Ryan Breen b51730ddd7 Finalize telemetry docs edits. 2015-02-04 14:07:33 -05:00
Ryan Breen c9a23fca9d Cleanup docs/agent/telemetry 2015-02-04 00:10:25 -05:00
Ryan Breen 8975c49c96 Cleanup docs/agent/rpc 2015-02-03 17:20:50 -05:00
Ryan Breen 4c1cd629ae Cleanup docs/agent/rpc 2015-02-03 17:07:03 -05:00
Ryan Breen 0d8ec87456 Some further cleanups to the root http doc. 2015-02-02 00:14:16 -05:00
Ryan Breen 27c145e2f8 Begin editing the docs/agent/http. 2015-02-01 17:42:02 -05:00
Ryan Breen 3a184a06f7 Final edits to encryption doc. 2015-01-31 22:05:00 -05:00
Ryan Breen 02c7ed0e94 Final edits to encryption doc. 2015-01-31 22:01:33 -05:00
Ryan Breen b18b6491ff Final edits to encryption doc. 2015-01-31 21:59:59 -05:00
Ryan Breen 0cd1739ebc Tighten up TLS setting language a bit. 2015-01-31 18:59:11 -05:00
Ryan Breen 26bbda57d0 Tighten up TLS mode language a bit. 2015-01-31 18:55:58 -05:00
Ryan Breen edeab6a0d2 Substantial and potentially inaccurate rewrite to docs/agent/encryption. 2015-01-31 18:33:29 -05:00
Ryan Breen 499d3b26ff Clean up double 'is'. 2015-01-31 13:36:31 -05:00
Ryan Breen 18602f0db8 Final tweaks to DNS doc. 2015-01-31 13:17:43 -05:00
Ryan Breen fbbb765bf9 More heavy-handed reorg of content for flow. 2015-01-31 13:07:21 -05:00
Ryan Breen 7a0515817a Restructure opening paragraphs to have better flow. 2015-01-31 13:01:00 -05:00
Ryan Breen a7357aae65 Finish first pass of DNS updates. 2015-01-31 12:59:03 -05:00
Ryan Breen b56720d41a Update docs for standard DNS queries. 2015-01-31 12:51:28 -05:00
Ryan Breen e0d139c6b9 Minor cleanups to docs/agent/dns. 2015-01-30 23:32:57 -05:00
Ryan Breen 9a597d2351 Make capitalization of agent more consistent. 2015-01-30 14:49:58 -05:00
Ryan Breen 4a8305e022 Minor cleanups to docs/agent/basics. 2015-01-30 14:48:20 -05:00
Ryan Breen 7fd0b148ac A bit more language cleanup to checks. 2015-01-29 17:17:02 -05:00
Ryan Breen cf033f448d No need to confine the example to a web app. 2015-01-29 17:14:19 -05:00
Ryan Breen a8470991cd Some reorg of the TTL description. 2015-01-29 17:12:20 -05:00
Ryan Breen cef8305bd0 Make it clear that checks persist with the node, period, not just across runs of the agent but across reboots as well. 2015-01-29 17:10:15 -05:00
Ryan Breen eea0029f2d Add a bit more detail around checks and clarify some language. 2015-01-29 17:08:56 -05:00
Ryan Breen 8afcf9f152 Language touch-ups for the checks docs. 2015-01-29 16:45:19 -05:00
Ryan Breen 1346cf1a00 Move the note about checks to its own line. 2015-01-28 19:46:28 -05:00
Ryan Breen 917b10417d Grammatical cleanup in services.html. 2015-01-28 19:43:52 -05:00
Emil Hessman 6f3215f0a8 website: fix minor typos in docs 2015-01-23 22:11:15 +01:00
Armon Dadgar e1a5d537d4 Merge pull request #625 from hashicorp/f-maintcmd
New "maint" command
2015-01-22 11:56:49 -08:00
Armon Dadgar cf04d6ae31 Merge pull request #622 from hashicorp/f-sockets
Unix domain sockets
2015-01-21 16:30:03 -08:00
Ryan Uber 52ff08b6c0 website: document reason flag for http api 2015-01-21 14:33:01 -08:00
Ryan Uber f4f9b5c94b website: update maintenance mode endpoint 2015-01-21 11:15:15 -08:00
Ryan Uber a975903b63 website: fix health endpoint page 2015-01-20 22:50:33 -08:00
Ryan Uber 90ee967bc4 website: move content from monolithic http page 2015-01-20 22:50:30 -08:00
Ryan Uber 2968a20cb5 website: separate pages for top-level endpoints 2015-01-20 22:49:41 -08:00
Ryan Uber 99b92a6fb0 website: beginning http docs update 2015-01-20 22:49:41 -08:00
Ryan Uber 674be58e55 agent: support multiple checks per service 2015-01-20 21:48:42 -08:00
Ryan Uber 5a8703bb00 website: add notice about socket permission portability 2015-01-20 19:16:17 -08:00
Ryan Uber bae6334c60 website: document unix_sockets config 2015-01-20 16:29:22 -08:00
Ryan Uber 853cb504d6 website: document node maintenance mode 2015-01-16 15:38:13 -08:00
Ryan Uber 9ee1e6e858 agent: maintenance mode api's are idempotent 2015-01-16 15:37:52 -08:00
Ryan Uber 1f749ce3f2 website: document service maintenance endpoint 2015-01-16 15:37:52 -08:00
Ryan Uber 7a585d7a9b website: update docs for agent socket options 2015-01-16 13:06:49 -08:00
Ryan Uber bf48651c58 agent: only ignore errors on IsNotExist() 2015-01-16 09:14:52 -08:00
Jeff Mitchell 5a9bcd36ef Update option text to describe how to use Unix listening sockets. 2015-01-14 20:22:59 +00:00
Armon Dadgar 713d30c73e Merge pull request #592 from nicholascapo/check-http
command/agent: Add simple HTTP check type
2015-01-13 12:11:50 -08:00
Nicholas Capo e0c3c22748 Update HTTP Check documentation: 503 -> 429 2015-01-13 00:10:05 +00:00
Evan Broder ee6d59d4dd Add "only_passing" option to DNS config
This excludes nodes from DNS results if their healthchecks are in any
non-passing state, not just if they're critical.
2015-01-10 13:17:11 +01:00
Nicholas Capo fb5ba8d97d command/agent: Add simple HTTP check type
These checks make an `HTTP GET` request every Interval to the specified URL.
The status of the service depends on the HTTP Response Code.
`200` is passing, `503` is warning and anything else is failing.
2015-01-09 16:43:24 -06:00
Emil Hessman 880e21837c website: omit excessive use of the word lastly
Simplify wording by removing various uses of the word lastly.
2015-01-09 06:37:26 +01:00
Emil Hessman 91c2939294 website: fix typo
s/patameters/parameters/
2015-01-09 05:59:06 +01:00
Armon Dadgar a4db77df11 website: Documenting ?cas with KV DELETE 2015-01-08 17:34:41 -08:00
Armon Dadgar 1abce8cddf website: Updating the documentation 2015-01-08 12:08:29 -08:00
Armon Dadgar 401437ca1f website: Update session API documentation 2015-01-07 15:19:27 -08:00
Armon Dadgar b3f974dee0 website: Link to consul-replicate. Fixes #439 2015-01-07 13:30:30 -08:00
Armon Dadgar f86d7c3a09 Merge pull request #558 from ceh/http-api-response-headers
add ability to specify response headers on the HTTP API
2015-01-05 11:36:08 -08:00
Emil Hessman bf0e284756 website: fix typo, casing and links
Fix typo in Leader Election guide: s/blog/blob/

Also fix various casing issues and prefer HTTPS links
for HashiCorp projects.
2015-01-04 12:58:58 +01:00
Armon Dadgar 73eeb2566e Merge pull request #556 from darron/master
Docs: It's not key - it's service.
2015-01-02 21:54:53 +05:30
Thordur Bjornsson 5ef79e747e Revert "correct the doc for obtaining formatted json"
This reverts commit cf3b9ec4fe.
2015-01-02 08:00:09 +01:00
Emil Hessman cb764c35e5 add ability to specify response headers on the HTTP API
Add an config object that allows adding HTTP header response fields to every
HTTP API response.

Each specified header is added to every response from all HTTP API endpoints.
Each individual endpoint may overwrite the specified header, which makes sure
that Consul headers such as 'X-Consul-Index' is enforced by the API.
2014-12-28 19:17:08 +01:00
darron froese a5ba33ae06 It's not key - it's service.
It's right in the description, but the example seems to be wrong.
2014-12-26 21:51:48 -08:00
Michael H. Oshita a03436e4b2 minor grammer fix 2014-12-11 19:02:29 +09:00
Dan Frost 284814a515 docs: agent/watches: minor fixes 2014-11-26 13:48:33 +00:00
Dan Frost 1b94c804f3 docs: agent/checks: minor fixes 2014-11-26 13:42:53 +00:00
Dan Frost 65ffbed02e docs: agent/dns: minor fixes 2014-11-26 13:33:55 +00:00
Dan Frost 3bbb226e2b docs: agent/basics: minor fixes 2014-11-26 13:15:41 +00:00
Ryan Uber f126bb7381 website: Improve docs for reloading config. Fixes #407 2014-11-25 19:03:14 -08:00
Brandon Wilson cf3b9ec4fe correct the doc for obtaining formatted json
was "?pretty" should be "?pretty=1"
2014-11-21 12:27:48 -08:00
Ryan Uber ab5fbe4094 agent: ignore -encrypt if provided when keyring exists 2014-11-19 16:37:40 -08:00
Ryan Uber 80c25e3320 website: document new behavior of the -encrypt option 2014-11-19 16:36:01 -08:00
Ryan Uber 026ebcef58 website: remove keyring persistence options from agent page 2014-11-19 16:31:06 -08:00
Ryan Uber cea2b49c15 website: update consul keys documentation 2014-11-19 16:30:22 -08:00
Armon Dadgar 6be29e17c2 Merge pull request #478 from amalaviy/https
Added HTTPS support via a new HTTPS Port configuration option
2014-11-19 11:17:10 -08:00
Atin Malaviya 0904c651a8 Change names to StartJoinWan, RetryJoinWan etc 2014-11-17 17:14:59 -05:00
Atin Malaviya f4fd8453ed Added HTTPS support via a new HTTPS Port configuration option similar to the HTTP Port. 2014-11-17 14:29:35 -05:00
Atin Malaviya 5b41170f47 Add start-wan-join, retry-wan-join and related configuration options and commandline options 2014-11-14 10:56:39 -05:00
Ryan Uber 3facf1bdf4 website: better description of config merging in agent options. Closes #470 2014-11-13 12:04:09 -08:00
Danny Berger 3da9291ae1 Fix some typos in website docs 2014-11-04 21:33:42 -07:00
Armon Dadgar cd936793ad Support old recursor config for backwards compatibility 2014-11-03 11:28:21 -08:00
Armon Dadgar 632bbcdd54 Merge pull request #448 from foostan/multiple_recursor
Add multiple recursor definition support
2014-11-03 11:18:37 -08:00
foostan 35b006d884 Add multiple recursor definition support 2014-11-01 04:26:26 +09:00
Laurent Raufaste 26916b03e6 Rephrase 2014-10-30 21:46:19 -04:00
Laurent Raufaste 33c0de708d ACL doc clarification
Fixes #443
2014-10-30 21:44:23 -04:00
Ryan Uber d472825181 website: fix JSON in multiple checks documentation 2014-10-27 11:58:01 -07:00
Ryan Uber f03bbb8daa website: update docs for multiple checks in config 2014-10-26 13:25:48 -07:00
Alexander Simmerl 461c1e18a5 Add multiple service definition support
This change-set adds another key to the configuration decoding called
`services`, which is expected to be a list of service definitions. It
follows the established convention of only allowing one of the keys:
`service`, `check`, `services`. For every entry in the list it calls
the corresponding decode method and appends it to the Servics of the
resulting Config.

While a similar result could be achieved with changing the Services
member of the Config struct to have named mapstruct tag it lacks the
proper time conversions provided by DecodeServiceDefinition.
2014-10-23 22:50:40 -04:00
Armon Dadgar 21c3e606a2 website: Fixing formatting 2014-10-23 17:14:40 -07:00
Armon Dadgar c7d5330471 Merge pull request #427 from blalor/agent_http_links
website: Improve navigability of agent HTTP API categories
2014-10-23 16:46:58 -07:00
Ryan Uber 805a9f7ec2 website: document retry_join and retry_interval flags for config file 2014-10-23 16:40:49 -07:00
Brian Lalor 914db50a52 Add links for status endpoints 2014-10-23 07:59:58 -04:00
Brian Lalor dd251dd323 Add links for event endpoints 2014-10-23 07:59:05 -04:00
Brian Lalor f09d1b32c9 Add links for ACL endpoints 2014-10-23 07:57:55 -04:00
Brian Lalor 8d6b8f4309 Add links for session endpoints 2014-10-23 07:56:28 -04:00
Brian Lalor 03be420bce Add links for health endpoints 2014-10-23 07:54:46 -04:00
Brian Lalor c7125bad12 Add links for catalog endpoints 2014-10-23 07:53:11 -04:00
Brian Lalor 98ebb94afa Add links for agent endpoints 2014-10-23 07:50:54 -04:00
Brian Lalor 351d722a15 Improve navigability of agent HTTP API categories 2014-10-23 07:44:20 -04:00
Leo Cassarani 64f710518f Fix spelling of "separator" in the HTTP API docs 2014-10-23 12:31:41 +01:00
Seth Vargo 869b194127 Use new Markdown syntaxes and add SEO descriptions 2014-10-19 19:42:13 -04:00
Seth Vargo 302789bf76 Use codeblocks for code 2014-10-19 19:41:11 -04:00
Armon Dadgar bee5fe280c Merge pull request #396 from ryanuber/f-retry-join
agent: Retry failed joins on agent start
2014-10-13 10:46:10 -07:00
Ryan Uber bec34b0c46 website: document retry join 2014-10-12 12:31:47 -07:00
Theo Hultberg 5560d2700b Fix mistake in the watches documentation 2014-10-11 17:04:52 +02:00
Alex Wheeler bb613cf467 Added the dns_config option enable_truncate to the docs. 2014-09-30 15:31:28 -04:00
Armon Dadgar 6d4b8bbd56 website: fixing formatting 2014-09-24 16:59:43 -07:00
Sneha More 5d6391904a removed repeated 'can' 2014-09-18 11:11:00 +05:30
lalyos 29f933c554 json sample fixed for PUT /v1/acl/create 2014-09-06 01:55:38 +02:00
Armon Dadgar feb3fa27fa website: Documenting new options 2014-09-02 14:36:25 -07:00
Armon Dadgar bb16e94b0c website: document addresses config 2014-09-02 12:49:52 -07:00
Armon Dadgar 98acc0a908 agent: statsd support. Fixes #247 2014-09-02 11:26:17 -07:00
Armon Dadgar 2d7be20431 website: Updating docs 2014-09-01 15:03:37 -07:00
Joseph Anthony Pasquale Holsten 52dafc8347 alphabetize config options in docs. Fixes #221 2014-08-31 02:03:01 +00:00
Joonas Bergius e90d67a4a7 Fixed a small typo 2014-08-28 22:23:01 -04:00
Armon Dadgar db99bc3a23 website: typo fixes 2014-08-28 17:54:58 -07:00
Armon Dadgar 088e024417 website: Adding docs 2014-08-28 17:22:56 -07:00
Armon Dadgar e08e66367c website: Document node lifecycle. Fixes #282. 2014-08-22 15:54:48 -07:00
Armon Dadgar e0a815772a agent: Support encrypt CLI flag. Fixes #245. 2014-08-22 15:08:15 -07:00
Armon Dadgar 7e6452387e website: Document client auth for TLS. Fixes #255. 2014-08-22 15:00:07 -07:00
Armon Dadgar 8bd92ff663 website: Document data dir requirements. Fixes #264. 2014-08-22 14:58:10 -07:00
Armon Dadgar 54316d2b30 website: Minor cleanups 2014-08-21 17:35:05 -07:00
Armon Dadgar dce716f4b2 website: Document watches 2014-08-21 17:25:42 -07:00
Armon Dadgar e2118d2a80 website: Fixing docs 2014-08-19 10:02:43 -07:00
Armon Dadgar ca1aeb8fa8 Merge pull request #288 from gmr/rfc-2782-srv-lookups
Add RFC-2782 style SRV lookups
2014-08-18 16:01:18 -07:00
Armon Dadgar 781ff2048d website: ACL internals 2014-08-18 15:46:59 -07:00
Armon Dadgar b802dd16eb website: Documenting ACL endpoints 2014-08-18 15:46:59 -07:00
Armon Dadgar 8a0eeae269 website: document configuration 2014-08-18 15:46:58 -07:00
Gavin M. Roy 6000f6977d Add RFC-2782 style SRV lookups 2014-08-18 15:45:56 -04:00
Armon Dadgar 09a1c40444 website: More port use docs 2014-08-05 10:46:52 -07:00
Laurent Raufaste 2b6bb395ca Some breath 2014-08-03 20:52:36 -04:00
Laurent Raufaste c098720a41 Add a ports used section to the doc 2014-08-03 20:51:43 -04:00
Armon Dadgar d77a458bdc website: Clarify the ?pretty docs 2014-08-01 13:38:03 -07:00
Eric Connell ed6dd856dc updated website documentation with the "pretty" parameter 2014-08-01 14:16:21 -06:00
William Tisäter dd9c59b6c4 Short doc note about DNS case-insensitivity 2014-07-23 23:42:22 +02:00
Armon Dadgar 140a910fed website: remove old docs on the -encrypt flag 2014-07-15 09:50:49 -07:00
Nelson Elhage 825dcd04f4 There is no `-statsite` command-line flag. 2014-07-10 18:06:36 -07:00
Ben Scofield 3d1e09c263 Improve clarity around changing the `-client` param
This is a small change that (IMO) makes more explicit the effect
of changing `-client` -- namely, that you'll have to provide
`-rpc-addr` to every other consul command you run.
2014-07-02 21:21:37 +02:00
Armon Dadgar d313349807 Updating documentation for new bootstrap method 2014-07-01 15:02:26 -07:00
Philip K. Warren f3ac3ce6fc Fix a small typo in RPC docs. 2014-06-19 13:53:43 -05:00
Armon Dadgar 961a00c496 Adding server_name configuration for TLS 2014-06-13 11:10:27 -07:00
Rob Holland cca6f83b3a Improve clarity of ?keys behaviour.
I read the previous version initially as meaning that it would return a list of keys which have no value set, which I couldn't understand. I think this removes some ambiguity.
2014-06-13 12:20:24 +01:00
Armon Dadgar 4542933139 website: Mention reload command in addition to SIGHUP 2014-06-11 11:03:59 -07:00
Armon Dadgar 8331367707 website: Document reload RPC command 2014-06-11 10:54:36 -07:00
Armon Dadgar 82c27cb902 agent: Adding SyslogFacility configuration 2014-06-11 10:18:19 -07:00
Armon Dadgar 33a8beae1e website: Document the check_update_interval config 2014-06-09 12:51:12 -07:00
Armon Dadgar 10f3007aa2 consul: Adding support for optional session name 2014-06-09 11:42:28 -07:00
Armon Dadgar 93fb12ecdf Merge pull request #200 from hashicorp/f-dns
Adding support for DNS TTLs and stale reads
2014-06-09 11:13:47 -07:00
Armon Dadgar fed38165fe website: clarify unique per-ndoe 2014-06-08 17:31:44 -07:00
Armon Dadgar bd4610bcd1 website: Documenting DNS settings 2014-06-08 17:26:41 -07:00
David Pelaez e7b5f29191 Fix typo in check update endpoints
The current website says that you can send output with the update of a check using the `?node` parameter. It wasn't working and I check [the source](3874498374/command/agent/agent_endpoint.go (L110)) to find that it was (the more logical noun of) note! I changed the indication to replace `?node` for `?note`
2014-06-04 22:55:17 -05:00
Armon Dadgar 753cec4cfa agent: Omit certains keys from the /self endpoint 2014-05-29 11:24:37 -07:00
William Tisäter d794a18761 Return both member and config in `/v1/agent/self` 2014-05-28 00:09:28 +02:00
William Tisäter d0e447d29b Add `/v1/agent/self` and return local agent config 2014-05-27 01:15:33 +02:00
Armon Dadgar e55a6fb6d6 Support wildcard for check lookup. Fixes #152 2014-05-21 12:45:12 -07:00
Armon Dadgar de309057ff Support rejoin after leave. Fixes #110. 2014-05-21 12:32:24 -07:00
Armon Dadgar 0836a222bf agent: syslog support. Fixes #105. 2014-05-21 12:06:03 -07:00
Armon Dadgar 88d91c6ee0 agent: Support for raw key lookup. Fixes #150. 2014-05-20 16:53:43 -07:00
Armon Dadgar fa4cb49feb website: Document DNS truncation. Fixes #144. 2014-05-20 16:43:44 -07:00
Armon Dadgar 55951c9f87 website: Document KV changes 2014-05-20 16:25:30 -07:00
Armon Dadgar a12c52ca2d website: Documenting the session endpoints 2014-05-20 16:25:30 -07:00
Armon Dadgar 246ad6c681 agent: Support -advertise cli flag. Fixes #156. 2014-05-16 10:49:55 -07:00
Carl Jackson 5295d8c9fd s/direclty/directly/ 2014-05-08 17:48:29 -07:00
Armon Dadgar 359807375e website: mention client_addr 2014-05-08 13:44:59 -07:00
Armon Dadgar d5a8e79b65 agent: Correct spelling of separator. Fixes #101. 2014-05-07 15:25:17 -07:00
Armon Dadgar 3d527e174a website: update docs, CLI flag no longer available 2014-05-07 15:11:56 -07:00
Nelson Elhage 0b9ad9e882 docs: The config key is "encrypt", not "encrypt_key" 2014-05-07 15:04:50 -07:00
William Tisäter 963f1e2ff6 Merge pull request #128 from carlosdp/pid-file
Add pid-file flag to agent
2014-05-06 19:57:12 +02:00
Armon Dadgar 58a896ad28 website: improve the docs for the agent TTL endpoints 2014-05-06 10:44:42 -07:00
Carlos Diaz-Padron dd1ce61fb1 Add pid-file option to agent docs 2014-05-05 23:39:26 -04:00
Armon Dadgar 4c2b8562bf website: Fixing old reference to dns_addr 2014-05-04 13:26:21 -07:00
Shayan Pooya c3ac3f8434 website: fix a couple of typos. 2014-05-03 19:16:55 -04:00
Armon Dadgar 08235411c3 website: Document the KV API changes 2014-04-30 23:44:27 -04:00
Armon Dadgar f9ff14531f website: Document the ui-dir flags 2014-04-30 23:43:56 -04:00
Gavin M. Roy 2d62fb3207 Revert the interval and TTL values 2014-04-30 15:46:20 -04:00
Gavin M. Roy 11f0d0fe3f Minor documentation fixes
- Correct spotted typos
- Ran JSON snippets through jsonpp for consistent display of JSON results
- Unfortunately my editor stripped EOL whitespace so there's a bit of whitespace diff
2014-04-30 15:26:07 -04:00
Masahito Zembutsu b2ed730b41 fix typo 2014-04-25 23:09:17 +09:00
Armon Dadgar b8d185af40 website: Adding the output key to docs examples 2014-04-21 16:21:52 -07:00
Armon Dadgar 554a8478ac website: typo fix 2014-04-21 16:09:36 -07:00
Armon Dadgar 81a0a56fac agent: Support server-side filtering of passing checks. Fixes #57. 2014-04-21 16:08:26 -07:00
Armon Dadgar 03adb99a91 website: Document HTTP changes 2014-04-21 13:40:16 -07:00
Armon Dadgar 0d490096f9 website: Typo. Fixes #43. 2014-04-17 11:31:25 -07:00
Jacques Fuentes ccddd16821 Round 2: Fix typos, grammar errors, and misspellings 2014-04-16 00:01:12 -04:00
Armon Dadgar a8d9fefdfe agent: Adding support for -join flag. Fixes #33. 2014-04-11 16:59:16 -07:00
Armon Dadgar 657da8eaf6 website: Document the port configurations 2014-04-11 16:31:33 -07:00
Armon Dadgar 3758f235b2 website: Documentation cleanup 2014-04-11 16:23:16 -07:00
Armon Dadgar 304cb516e1 website: Documentation cleanup 2014-04-09 11:06:27 -07:00
Armon Dadgar 8c2e660244 website: Clarify the DNS documentation 2014-04-08 12:18:05 -07:00
Armon Dadgar f02ae31041 website: More info on TLS encryption 2014-04-07 15:07:21 -07:00
Armon Dadgar 5436d208b1 website: Document new TLS flags 2014-04-07 15:07:00 -07:00
Armon Dadgar 7905f1b6b3 website: Mention that telemetry can be streamed 2014-04-04 14:55:23 -07:00
Armon Dadgar 7c31a313db website: Correct some empty lists to null 2014-04-03 14:40:05 -07:00
Armon Dadgar 6e26f463a5 website: Updating the tags documentation 2014-04-03 14:18:57 -07:00
Armon Dadgar cfa4ba2d34 website: Document the Key/Value API 2014-03-31 21:15:46 -07:00
Armon Dadgar ffca4f5544 agent: Support protocol version setting 2014-03-09 15:57:03 -07:00
Armon Dadgar fad3e4d97c website: Documenting the info command 2014-02-23 17:09:59 -08:00
Armon Dadgar 0a19fdd10a website: document registering checks and services better. Fixes #6 2014-02-22 18:53:31 -08:00
Armon Dadgar 5726da7b59 website: Clarify the ?index parameter. Fixes #7 2014-02-22 18:47:09 -08:00
Armon Dadgar 13af774cb9 agent: Switch to -data-dir, better error if missing. Fixes #2. 2014-02-22 17:34:57 -08:00
Armon Dadgar dca8c79576 agent: Adding support for statsite telemetry 2014-02-20 14:59:54 -08:00