Commit Graph

765 Commits

Author SHA1 Message Date
James Phillips f4f96c180d Update dns.html.markdown 2016-11-29 15:01:38 -08:00
Kyle Havlovitz d91854f3b0 Add monitor http endpoint 2016-11-28 18:36:26 -05:00
James Turnbull edd5739e90 Final dc pass 2016-11-25 13:29:55 -05:00
James Turnbull 25566a292b Removed two space after period exceptions 2016-11-25 13:25:09 -05:00
James Turnbull 39364aa937 Another catch 2016-11-25 13:14:09 -05:00
James Turnbull 38be465b7d And a handful more 2016-11-25 12:39:08 -05:00
James Turnbull 51bc365377 More consistency 2016-11-25 12:34:07 -05:00
James Turnbull dd4918fd16 Documentation pass
I was reviewing some docs and found a few issues.

1. Fixed some spelling mistakes.
2. Re-formatted some paragraphs.
3. Changed some potentially loaded language.
4. Fixed some grammar issues.
5. Tried to consistently use syntax-highlighting.
6. Fixed post-period spacing.
7. Fixed some formatting issues and inconsistency.
8. All "notes" are either proper notes or re-written.
2016-11-25 12:02:32 -05:00
Kyle Havlovitz 66dea6951a Fix keyring doc method wording 2016-11-22 20:10:43 -05:00
Kyle Havlovitz 79f339b5dc Combine keyring endpoints into one 2016-11-22 20:10:43 -05:00
Kyle Havlovitz b13c9dc5d3 Add version specific note to keyring http docs 2016-11-22 20:10:43 -05:00
Kyle Havlovitz 86ae45c78b Add keyring api website doc sections 2016-11-22 20:10:43 -05:00
James Phillips 2319624f69 Makes addresses blank in service definition. 2016-11-22 08:29:29 -08:00
James Phillips a34d968aeb Tweaks title of snapshot link. 2016-11-21 09:02:19 -08:00
Brian Shumate 71e00601ec
tweaks 2016-11-18 10:53:59 -05:00
Brian Shumate e7b21b6876
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 17bc5a80ba ~ docs: Typo in agent options page. 2016-11-16 07:58:24 -08:00
Benjamin Farley e52e0b2a5a Small change to how operator docs read 2016-11-16 09:01:51 +00:00
Brian Shumate a487aec803 Docs: Web UI config updates (#2411)
* Updates around Web UI directory configuration

* consistent terms
2016-11-12 13:08:15 -08:00
Brian Shumate 1d6917fa9f Updated broken Extended Key Usage link (#2500) 2016-11-10 08:09:39 -08:00
Sumit Gupta 14cfeb8f7c Remove Extra > (#2499) 2016-11-10 08:09:17 -08:00
James Phillips 60d0c66be0
Revert "Updates Circonus metrics library and adds support for display name and tags."
This reverts commit bd490ec937a5859ba43b07d9103b3cb8f037e9e5 from #2491.
2016-11-09 16:21:02 -08:00
matt maier c7f98fe988 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 dbf6232238 Adds version info to docs for new Circonus options. 2016-11-09 13:26:20 -08:00
matt maier 62fe94b3d6 Update Circonus integration expose Check Display Name and Check Tags configuration options. 2016-11-09 15:33:37 -05:00
Kyle Havlovitz 1ffdf04bd7 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 f4e34397ac Clarify -retry-join docs. (#2469) 2016-11-03 14:22:46 -07:00
Kyle McCullough 697ea0f8eb 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 18926728d4 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 1e2ca107c2
Small tweaks to docs and syntax 2016-11-03 13:04:42 -04:00
Kyle Havlovitz a3af480c42
Add support for ECS task roles as an auth mechanism 2016-11-02 18:48:15 -04:00
Kyle Havlovitz b9aa912e4c
Move EC2 discovery logic into retryJoin for robustness 2016-11-02 14:35:37 -04:00
Kyle Havlovitz c6f461aa25 Enable snapshots in dev mode (#2453) 2016-10-31 14:39:47 -04:00
James Phillips bc29610124 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 1adbcff059 Merge pull request #2383 from hashicorp/jbs-1462
Clarify retry_join addresses for #1462
2016-10-20 11:40:03 -07:00
Brian Shumate fd794ec0b4
Reworded and applied to -retry-join also 2016-10-20 14:14:55 -04:00
James Phillips 78815ea44d Adds a note about child process reaping going away. 2016-10-06 21:38:29 -07:00
Andreas Böttger 13c1315916 json syntax corrected 2016-10-04 15:40:53 +02:00
Brian Shumate 7fbec39f1f
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 df41000a94
Update variable value information as port must also be specified, fixes #2210 2016-09-29 12:50:00 -04:00
Brian Shumate a470c4901a
Finalize update for -bind 2016-09-27 18:36:19 -04:00
Brian Shumate bd43bd9981
Clarification 2016-09-27 12:38:32 -04:00
Brian Shumate ac9e1d6a10
Correct inaccurate bind reference, closes #2234 2016-09-27 12:05:22 -04:00
McKenna Jones 3390063ec6 cli flag formatting for agent docs and one guide 2016-09-26 21:22:01 -07:00
Seth Vargo 6a6d169ace
Clarify that hostname defaults to localhost for tcp 2016-09-21 12:20:36 -04:00
Brian Shumate af45d3463a
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 daa8a40993 Adds Operator endpoint link. 2016-09-15 13:13:09 -07:00
James Phillips 3b1f368fe5 Adds version note to near parameter. 2016-09-06 07:50:06 -07:00
James Phillips 6db4aea4c4 Tweaks options doc after latest merges. 2016-09-01 22:18:34 -07:00
James Phillips aed72ccc60 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 1924eccf71 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 ca71911eed
Tweaks documentation. 2016-09-01 21:50:46 -07:00
Pivotal DX129 2682410059 Merge remote-tracking branch 'upstream/master' 2016-09-01 10:15:32 -04:00
James Phillips d419a0ae0d
Changes default for `leave_on_terminate` based on server or client mode. 2016-08-31 23:39:11 -07:00
James Phillips 3304352272
Changes default DNS allow_stale to true. 2016-08-30 13:55:19 -07:00
James Phillips c063a1a8d0
Updates documentation with details on the Consul operator actions. 2016-08-30 13:15:37 -07:00
James Phillips 1b7a16b7d3
Adds new consul operator endpoint, CLI, and ACL and some basic Raft commands. 2016-08-30 00:02:50 -07:00
Pierre Delagrave a5fccc45db Added website documentation for the new recursor_timeout parameter 2016-08-29 14:41:30 -04:00
James Phillips 2f4c237cff
Adds a max raft multiplier and tweaks documentation. 2016-08-25 15:36:05 -07:00
James Phillips b339b0d2fc
Adds performance tuning capability for Raft, detuned defaults, and supplemental docs. 2016-08-24 21:58:37 -07:00
Brian Shumate b1164d256e Fix typo 2016-08-18 09:14:15 -04:00
James Phillips 1820de27fc 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 db4666c7e4 Update acl.html.markdown 2016-08-17 10:21:59 -07:00
James Phillips db9a72dde1
Merge branch 'master' into f-deregister-critical 2016-08-16 12:53:21 -07:00
James Phillips 607595f99e
Cleans up based on code review feedback. 2016-08-16 12:52:30 -07:00
James Phillips bc333335be
Adds an `X-Consul-Translate-Addresses` to signal translation is enabled. 2016-08-16 11:31:41 -07:00
James Phillips 817d7e93e4
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 f517f9ed0d
Fixes a typo and adds an admonition about only being in Consul 0.7+. 2016-08-16 09:27:20 -07:00
James Phillips b4f981c837
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 4ca26f68fd 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 3af9257cb8 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 ee2e161dfe
Updates docs for WAN address translation and tweaks some nearby unrelated docs. 2016-08-15 16:12:01 -07:00
Brian Shumate dc7824b0cd Add anchor 2016-08-15 16:48:54 -04:00
James Phillips 086a5af5ff
Finishes up DNS compression by adding opt-out, tests, and documentation. Fixes trim routine. 2016-08-11 16:27:08 -07:00
sweeneyb e8117ba622 Add support for dns port as a command line option 2016-08-10 04:05:56 +00:00
James Phillips ff64833b4a Adds a note about HTTP telemetry. 2016-08-09 16:03:59 -07:00
James Phillips 3585b5a4cb Merge pull request #2237 from hashicorp/f-acl-replication
Adds ACL replication.
2016-08-09 11:42:16 -07:00
James Phillips 5577b8ef66
Updates documentation for ACL replication. 2016-08-05 00:23:28 -07:00
rob dux 3bd9be7151 update ca tutorial to one more recent and relevant 2016-08-02 21:24:02 -05:00
Andrei Burd 06c0663082 Added missing comma 2016-08-01 18:46:43 +03:00
James Phillips 63ff6ebc2c Adds a cautionary note about the stats in the self API. 2016-07-29 13:45:25 -07:00
James Phillips 36b2ef619e Tweaks the agent docs for `EnableTagOverride`. 2016-07-23 14:48:54 -07:00
shalev67 0763f1a9f5 Added api agent docs enableTagOverride var 2016-07-22 20:21:07 +03:00
Jason Martin bda170a872
Escape verify_server_hostname angle-brackets 2016-07-20 15:57:07 -07:00
matt maier 9c3f14ce1b 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 51fbad91fd 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 ca5f42d61d Tweaks the docs a bit. 2016-07-19 15:54:52 -07:00
akbarahmed 99c1e0051d Merge remote-tracking branch 'upstream/master' 2016-07-19 11:01:55 -07:00
akbarahmed 25f6bc9d56 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 53936f336d Documentation for Circonus Telemetry integration 2016-07-18 16:24:49 -04:00
Stu Small 6a664a4669 Fixing minor punctuation mistake. 2016-07-13 16:50:19 -06:00
Ryan Uber 62d0edbdd4 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 c24fe9f8b5 small typo 2016-07-02 01:29:00 -04:00
Ryan Uber 53dc58ff27 website: document near parameter of prepared queries 2016-07-01 11:50:09 -07:00
James Phillips 055b6973f6 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 53f082b2af Adds a key metrics section to the telemetry guide. 2016-06-17 18:57:42 +01:00
Sheldon Kwok a3788d4ede 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 b862d3f044 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 0871236ca7 Fix typo
Simple typo fix.
2016-05-29 10:24:44 -07:00
Sean Chittenden 67b9104daf
Fix the href target for the `/v1/catalog/node/<node>` endpoint. 2016-05-27 00:12:17 -07:00
Sean Kilgore a60c0b630a 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 e786aafe70 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 ffcba3df58 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 b20f86b4c7
Speling police 2016-05-15 09:13:52 -07:00
James Phillips c786e1d457 Reduces the number of operations in a transaction to 64. 2016-05-14 21:40:46 -07:00
James Phillips a11f32a1da Adds a get-tree verb to KV transaction operations. 2016-05-13 16:57:39 -07:00
James Phillips 77ae55c692 Adds some size limiting features to transactions to help prevent abuse. 2016-05-13 13:39:01 -07:00
James Phillips 5fd99b13ef 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 2649a6336e Adds a read-only optimized path for transactions. 2016-05-13 00:34:05 -07:00
James Phillips 6daf26ada4 Adds documentation for the transaction endpoint. 2016-05-11 14:18:47 -07:00
James Phillips 76b90ccb17 Fixes and clarifies the only_passing docs. 2016-04-27 14:55:38 -07:00
James Phillips 03b0c196e0 Merge pull request #1762 from mshean/script-timeout
Add Timeout field to CheckMonitor
2016-04-24 23:08:06 -07:00
Sean Chittenden b0203278f2 Tweak discussion regarding reaping to advise against adjusting these
values.
2016-04-21 14:24:41 -07:00
Sean Chittenden 515a42e733 Fix broken markdown 2016-04-20 18:46:01 -04:00
James Phillips 6182a34600 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 bc6efbae18 Sets an anti-footgun floor for the configurable reap time. 2016-04-20 13:49:51 -07:00
Matt Shean f232a11291 Update documentation for CheckMonitor timeout 2016-04-20 11:43:49 -07:00
James Phillips 24c2bc44f1 Clarifies default behavior of blank service addresses. 2016-04-20 10:16:06 -07:00
Ryan Uber 1e9f3341d0 website: mention 4K output limit for checks 2016-04-14 14:35:35 -07:00
James Phillips 07e9c09a58 Merge pull request #1891 from romansky/patch-1
clerify RPC usage
2016-04-12 02:10:15 -07:00
James Phillips 86bb36f211 Updates some docs that say reaping is not configurable. 2016-04-11 00:56:03 -07:00
James Phillips 32389a9822 Makes reap time configurable for LAN and WAN. 2016-04-11 00:38:25 -07:00
Sean Chittenden 8156eb9953 Add a note re: pre-0.7 behavior 2016-03-31 18:06:58 -07:00
Sean Chittenden 9eaffc456f 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 bb17b99dbe fix correct RPC entity 2016-03-30 12:21:52 +03:00
Sean Chittenden 7603dcfd4b Reword `udp_answer_limit` for the better. 2016-03-29 23:48:22 -07:00
Sean Chittenden 0bf0f2a1ab 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 64c1c12752 Whitespace, indent markdown correctly 2016-03-29 19:27:36 -07:00
Sean Chittenden d1166307aa Trim UDP responses per configuration 2016-03-29 19:27:21 -07:00
Sean Chittenden f8a0e1fb1a 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 a29f6e8c8f 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 f0c30e8d0f clerify RPC usage 2016-03-29 15:10:28 +03:00
James Phillips 0f23210628 Fixes JSON in wildcard query example. 2016-03-23 14:33:20 -07:00
James Phillips 7ad0d9789f Merge pull request #1839 from foxel/patch-1
Clarification for advertise_addrs.rpc
2016-03-21 16:14:17 -07:00
Sean Chittenden 5a40caf2a8 Update the docs slightly re: only_passing
Signed-off by: @slackpad
2016-03-21 16:07:56 -07:00
Sayalic 85e3590a95 add inline code segment to enableTagOverride 2016-03-20 11:09:12 +08:00
Wim 508bc796a8 Allow [::] as a bind address (binds to first public IPv6 address) 2016-03-18 23:59:44 +01:00
Miquel Sabaté Solà 314a0913e2 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 4c3b2edfed Fixes a few bugs in the prepared query doc. 2016-03-17 23:42:27 -07:00
Andrey Kupreychik d3bce2b1af 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 ec82388e32 Merge pull request #1803 from tylert/doc-enc-update
Update agent encryption doc example
2016-03-10 20:06:02 -08:00
James Phillips ae7b45a6df 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 b2992a5e83 Adds a reference to the network ports from the security page. 2016-03-09 21:21:49 -08:00
Igor Dubinskiy 8a877c44eb Fix doc typo 2016-03-09 12:41:49 -08:00
Tyler Tidman df7f593747 Update agent encryption doc example 2016-03-09 11:18:48 -05:00
Igor Dubinskiy f4edb28ef3 Make sure UDP DNS responses aren't larger than allowed 2016-03-07 16:41:17 -08:00
James Phillips e634e91ae6 Fixes broken example JSON. 2016-03-07 10:45:39 -08:00
James Phillips 275c84a0cc Renames "debug" endpoint and structures to "explain". 2016-03-07 10:45:39 -08:00
James Phillips 8493640b09 Adds a prepared query debug endpoint. 2016-03-07 10:45:39 -08:00
James Phillips e6232a21e4 Adds basic docs for prepared query templates. 2016-03-07 10:45:39 -08:00
James Phillips bd4f2ee6b7 Adds a new PUT-based TTL check update endpoint. 2016-03-02 17:54:01 -08:00
James Phillips ecc617008a Merge pull request #1777 from hashicorp/b-port-docfix
TLS example and correcting error
2016-03-01 13:02:30 -08:00
James Phillips 807769e6bd Tweaks the address and advertise docs. 2016-03-01 13:01:13 -08:00
James Phillips 72f7c08a0a Cleans up the documents. 2016-02-24 18:05:58 -08:00
James Phillips c75256ac8b Adds a check for users re-submitting the redacted token. 2016-02-24 17:35:26 -08:00
James Phillips 2f7eac8b86 Renames "prepared_query" ACL policy to "query". 2016-02-24 17:02:06 -08:00
James Phillips a8ac27fa49 Refactors docs into a more complete state for prepared query ACLs. 2016-02-23 22:27:44 -08:00
James Phillips 633c231d67 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 b90e77421a 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 66feca5b5f 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 800910137d Adds documentation for WAN address translation. 2016-02-07 11:12:19 -08:00
James Phillips 4b3dede0fb Tweaks the telemetry docs. 2016-02-06 22:07:11 -08:00
Nate Brown 541a98c9c7 Option to disable hostnames from telemetry 2016-01-29 13:44:48 -08:00
Raja Nadar aa45c07f28 fixing small typo in json 2016-01-29 01:25:23 -08:00
Daryl c4860cad7d 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 e110abee9b Fix broken link 2016-01-13 19:32:30 -05:00
Seth Vargo dc9131a732 Use HTTPS + www. where appropriate 2016-01-13 17:44:01 -05:00
James Phillips 55970248bc Tweaks wording of reap config option section. 2016-01-06 22:29:03 -08:00
James Phillips df361afed5 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 f861f35da7 Merge pull request #1549 from kikitux/patch-1
[doc] fix identation on statsd_addr
2016-01-02 06:50:56 -08:00
Peter Schaadt 5a72fe2803 Fixing typos in Coordinate documentation. 2015-12-28 16:34:09 -08:00
Ryan Uber 579a08ec20 website: add docs for dev mode 2015-12-27 09:45:59 -06:00
Alvaro Miranda 92f0164f97 fix identation on statsd_addr
ditto
2015-12-27 18:19:31 +13:00
Ryan Uber 0fabf273e6 website: document the static ui flag 2015-12-24 22:21:34 -05:00
James Phillips e1d456a079 Changes sense of option to "reap" and uses nil for "not set". 2015-12-22 10:28:10 -08:00
James Phillips 1e4aa28c9d Adds child process reaping when Consul is running as PID 1. 2015-12-21 21:47:35 -08:00
James Phillips 43808ca120 Clarifies format of stats aggregator configurations as host:port. 2015-12-18 22:53:55 -08:00
William Jimenez 07c058cd04 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 d644ede899 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 232fc7d5fd Adds blank line to fix Docker check formatting. 2015-12-08 00:04:55 -08:00
Ryan Breen 3c9e983800 Update health.html.markdown
Correct json syntax in example.
2015-11-23 09:39:05 -05:00
Arnout Engelen ab22325b87 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 1144846ed0 Fixes a typo in the prepared queries doc. 2015-11-20 21:44:24 -08:00
James Phillips bcbf6d268e Removes old logging doc which was empty. 2015-11-18 14:41:50 -08:00
James Phillips 23536f2b97 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 dde0d26e18 Fix markdown's markup: 2^(64-1) != 2^(64)-1 2015-11-17 15:21:47 -08:00
James Phillips 9e29bb4238 Adds and updates docs for prepared queries. 2015-11-15 17:06:00 -08:00
James Phillips 26cf0a2974 Extends the session TTL max to 24 hours, and adds a warning to the docs. 2015-11-15 16:51:00 -08:00
talwai 3d64189bfa Add DogStatsD configuration options to documentation source 2015-11-11 14:30:37 -05:00
Diptanu Choudhury 1e379f45f0 Some more grammer corrections and formatting to docker check docs 2015-10-28 14:56:55 -07:00
Diptanu Choudhury b29a785614 Some changes to the docker check docs 2015-10-28 14:24:03 -07:00
Diptanu Choudhury c3cf24d022 Added some docs for the docker check 2015-10-28 14:19:57 -07:00
Cameron Stokes 46021ab4b4 Clarify format of the -atlas agent option. 2015-10-27 14:21:05 -07:00
Victor Trac adf4189707 Mote -> Note typo 2015-10-26 15:10:20 -05:00
James Phillips b3b1c6940b Updates docs for network coordinates. 2015-10-23 15:23:01 -07:00
James Phillips 3f11bfaea4 Adds coordinate of agent to self endpoint. 2015-10-23 15:23:01 -07:00
James Phillips a2bcef00a0 Adds endpoints for raw network coordinates. 2015-10-23 15:23:01 -07:00
James Phillips fecd639b02 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 ee1cf1e13b Adds distance sorting to health endpoint. Cleans up unit tests. 2015-10-23 15:23:01 -07:00
James Phillips 1724b9a6be Adds a magic "self" node name to distance queries. 2015-10-23 15:23:01 -07:00
James Phillips 033e8e6625 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 b63909cf67 Adds coordinate sorting support to catalog queries for nodes and service nodes. 2015-10-23 15:23:01 -07:00
Armon Dadgar d035dbd43b 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 5f175add40 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 4ec5013811 Updates docs about new "acquire when you already have it" behavior. 2015-10-15 14:59:09 -07:00
Jeff Wang 75c21693a8 Make service lookup DNS documentation consistent 2015-09-23 23:16:34 -07:00
Jeff Wang ac5af9bcbc Make node lookup DNS documentation consistent 2015-09-23 23:09:52 -07:00
James Phillips b25797a808 Merge pull request #1187 from sfncook/enable_tag_drift_03
Enable tag drift 03
2015-09-11 15:35:32 -07:00
Shawn Cook 451abfa206 Doc changes in response to review. 2015-09-11 15:26:30 -07:00
Shawn Cook 7d6f30da1c Docs - add verbage to anti-entropy page. 2015-09-11 14:27:54 -07:00
Anthony Scalisi 8d733b7fca remove various typos 2015-09-11 12:29:54 -07:00
Shawn Cook 7c85d588d5 Update documentation for service definition 2015-09-11 09:32:54 -07:00
James Phillips c601f64c3f Fixes a typo in the telemetry docs. 2015-09-02 21:37:31 -07:00
Ryan Breen a013095f62 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 46e614ae70 Position it alphabetically 2015-09-02 06:28:55 +02:00
Andy Lo-A-Foe e9ee1f9bea Update agent options section on the website 2015-09-02 05:36:09 +02:00
Ryan Uber 10c38f8c3a website: document precedence of Atlas endpoint inputs 2015-08-27 17:54:56 -07:00
Ryan Uber d9210f4a0c website: document atlas endpoint config 2015-08-27 11:31:29 -07:00
Ryan Uber aa30194328 Merge pull request #1199 from hashicorp/f-scada-reload
SCADA client is reload-able
2015-08-26 11:46:50 -07:00
Ryan Uber e533789088 website: add atlas token/infra to reloadable config 2015-08-25 17:21:29 -07:00
James Phillips 89d03026bc Clarifies services docs a bit. 2015-08-25 16:12:19 -07:00
Cameron Stokes 92b86f0631 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 403b42af99 Document `TCP` check type 2015-07-27 10:53:52 +10:00
ketzacoatl efc2d316c1 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 cb0043e8f8 website: adding tag/service name dns compliance docs 2015-06-25 09:08:38 -07:00
Ryan Uber 715f69cce8 Merge pull request #1004 from i0rek/advertise_addrs
Add advertise_addrs.
2015-06-23 12:32:07 -07:00
Hans Hasselberg 4598087df3 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 d529329944 website: link to check pass/fail endpoint docs from checks page 2015-06-22 10:21:50 -07:00
Ryan Uber faab022f89 website: document passing ACL tokens in catalog register/deregister 2015-06-15 11:45:30 -07:00
Christian Theune cdc00dc606 Wording. 2015-06-12 16:09:44 +02:00
Christian Theune 1bac706593 Make behaviour of keyprefixes always matching all keys in a prefix more clear. 2015-06-12 16:07:42 +02:00
Ryan Uber cf21fb1d0c website: document TTL check persistence 2015-06-05 17:15:57 -07:00
siddharthist be68db0136 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 b6e31a2e6f website: add status field for check registration in http docs 2015-05-28 13:09:33 -07:00
Ryan Uber 90f8c91761 website: document setting initial status of health checks in config 2015-05-28 13:03:01 -07:00
Armon Dadgar 2c9592c5ee consul: lower default query time and add small stagger 2015-05-14 17:59:43 -07:00
Armon Dadgar 97c87f4e4d website: document the new TLS changes 2015-05-11 16:22:10 -07:00
Cameron Ruatta dfbd466c71 Adding docs about configuration directory sub-directories 2015-05-11 10:36:50 -07:00
Cameron Ruatta 0b9bc7d2f5 Adding documentation about specifying multiple configuration directories 2015-05-11 10:19:04 -07:00
Ryan Uber 5d94a6bb7d website: Document peers api consistency. Fixes #880 2015-05-06 12:13:28 -07:00
Armon Dadgar e474e34528 Merge pull request #909 from hashicorp/f-create
Support ACL upsert behavior
2015-05-06 11:22:11 -07:00
Ryan Uber 9acc42b86e Merge pull request #891 from hashicorp/f-token
ACL tokens for service/check registration
2015-05-05 22:17:31 -07:00
Armon Dadgar 0473b40df2 website: Document new ACL upsert behavior 2015-05-05 19:25:27 -07:00
Armon Dadgar efaed93b91 Merge pull request #816 from pepov/master
Support different advertise address for WAN gossip
2015-05-04 15:40:25 -07:00
Ryan Uber 8ae6790b33 website: document statsite_prefix option 2015-05-03 16:54:19 -07:00
Ryan Uber af74095584 website: document service and check acl options 2015-04-28 14:28:06 -07:00
Vasily Vasilkov a7efaf061c Fix invalid link to sessions page 2015-04-22 12:40:27 +03:00
Cameron Ruatta b637683ffa Caps not necessary here 2015-04-20 20:59:45 -07:00
Cameron Ruatta a9761dca33 Updating the docs to include information about registering a check with
a serviceid.
2015-04-20 20:56:26 -07:00
Ryan Breen 1ac70f6179 Website: minor fix for docs/agent/http/agent.html. 2015-04-17 11:43:02 -04:00
Armon Dadgar f12abbe51f Merge pull request #844 from mkostrikin/patch-1
Small tip for gracefull kill
2015-04-10 10:43:09 -07:00
Ryan Uber b18d75120c website: fix typo 2015-04-08 09:59:23 -07:00
Maxim N. Kostrikin 1bf9ece0b9 Small tip for gracefull kill 2015-04-07 13:15:48 +05:00
Ryan Breen a817a398dc 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 70a71b9454 Website: GH-826 fix anchor links in /docs/agent/watches.html. 2015-03-31 17:22:50 -04:00
pepov 14c8c86fee update the docs: add advertise-wan cli and advertise_addr_wan json config 2015-03-28 16:08:20 +01:00
Ryan Uber 57da15e049 website: document minimum session TTL setting 2015-03-27 11:34:27 -07:00
Ryan Breen 60e89f0a75 Website: GH-730 for docs/agent/watches.html. 2015-03-26 14:18:51 -04:00
Ryan Breen d43b42ab70 Website: GH-730 for docs/agent/telemetry.html. 2015-03-25 08:56:40 -04:00
Ryan Breen 240b354594 Website: GH-730 for docs/agent/encryption.html 2015-03-24 15:30:35 -04:00
Ryan Breen 2d15f2f0f4 Website: GH-730 for docs/agent/dns.html. 2015-03-23 15:48:35 -04:00
Johannes 'fish' Ziemke 78cde71a22 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 e83598b043 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 ca7cd6496a Website: cleanup for intro/getting-started/checks.html. 2015-03-17 17:50:28 -04:00
Bob Potter 23cef6202e website: default health check is 'serfHealth' 2015-03-05 17:38:28 -08:00
Ryan Breen b3f2bbe753 Website: GH-751 Link to anti-entropy doc everywhere that the term is used. 2015-03-04 10:22:53 -05:00
Ryan Breen ad7d1b3090 Website: GH-747 change acl_master token to acl_master_token 2015-03-03 11:46:57 -05:00
Ryan Breen ce93505a16 Website: GH-747 Add docs on acl_master_token installation. 2015-03-03 11:33:49 -05:00
Seth Vargo e612549d45 Be consistent in docs about Consul Replicate vs consul-replicate 2015-02-24 20:29:41 -05:00
Ryan Breen 87fccbc40c 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 559084724a 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 d205512336 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 3f17f30691 Merge branch 'master' of github.com:hashicorp/consul 2015-02-23 14:45:00 -05:00
Ryan Breen 8ff0368aa4 Website: docs/agent/options.html Fix config-file reference. 2015-02-23 14:44:31 -05:00
Ryan Uber bb85d6f331 website: document -recursor arg for agent cli 2015-02-23 10:43:15 -08:00
Ryan Breen 53afd77e2d s/data center/datacenter/g 2015-02-19 17:45:47 -05:00
Armon Dadgar 52bdbdade9 website: Adding Atlas docs 2015-02-18 15:15:01 -08:00
Armon Dadgar 441b940280 website: Document new options 2015-02-18 15:15:01 -08:00
Ryan Breen e13bc41d3f Website: add some missing intra-page links in docs/agent/options 2015-02-16 20:51:04 -05:00
Ryan Breen 45a9c231be Website: clean up a few intra-page links in docs/agent/options 2015-02-16 20:42:21 -05:00
Ryan Breen 61f1955c31 Website: add intra-page links in docs/agent/options 2015-02-16 19:48:49 -05:00
Ryan Breen 5634061a9f Website: finalize edits for configuration file options in docs/agent/options. 2015-02-15 00:47:52 -05:00
Ryan Breen 9912be7e5f Website: edits for configuration file options in docs/agent/options. 2015-02-15 00:43:01 -05:00
Armon Dadgar 65bdd83187 Merge pull request #695 from ryanbreen/session
Website: cleanup for docs/agent/http/session
2015-02-13 17:21:24 -08:00
Ryan Breen 5cfed30179 Website: tweak cleanup for the docs/agent/options Command-line options section. 2015-02-13 15:19:17 -05:00
Ryan Breen f234f1af67 Website: cleanup for the docs/agent/options Command-line options section. 2015-02-13 14:58:05 -05:00
Ryan Breen 48d5f49cf8 Remove language about LockDelay parsing. 2015-02-12 20:34:40 -05:00
Armon Dadgar 9ec38a1fb9 Merge pull request #692 from ryanbreen/kv
Website: cleanup of docs/agent/http/kv
2015-02-12 16:53:49 -08:00
Ryan Breen 443cf2dd74 More cleanup for docs/agent/http/session. 2015-02-12 15:15:53 -05:00
Ryan Breen 4d60fa08dc Website: cleanup for docs/agent/http/session. 2015-02-12 14:50:54 -05:00
Ryan Breen bec260c9ba Website: finalize cleanup of docs/agent/http/kv 2015-02-11 23:44:10 -05:00
Ryan Breen 8c85a4e981 Website: cleanup of docs/agent/http/kv 2015-02-11 21:54:03 -05:00
Ryan Breen 9e527ee4b1 Website: finalize cleanup for docs/agent/http/health. 2015-02-10 15:52:22 -05:00
Ryan Breen 8ce89d87ce Website: cleanup for docs/agent/http/health. 2015-02-10 15:49:21 -05:00
Armon Dadgar 07618766a8 Merge pull request #678 from ryanbreen/agent
Cleanup for docs/agent/http/agent.
2015-02-09 09:54:53 -08:00
Armon Dadgar 98b09d025c Merge pull request #681 from ryanbreen/catalog
Website: cleanup of docs/agent/http/catalog
2015-02-09 09:53:57 -08:00
Ryan Breen 04b500b550 Website: cleanup for docs/agent/http/event. 2015-02-09 11:24:23 -05:00
Ryan Breen 3cf7b5c831 Website: finalize cleanup of docs/agent/http/catalog. 2015-02-08 12:49:02 -05:00
Ryan Breen eccd96dfaa Website: edits for docs/agent/http/catalog. 2015-02-08 12:44:36 -05:00
Ryan Breen f0bb4b4e31 Finalize cleanup of docs/agent/http/agent. 2015-02-07 17:43:43 -05:00