Commit Graph

1009 Commits

Author SHA1 Message Date
Ryan Uber 53dc58ff27 website: document near parameter of prepared queries 2016-07-01 11:50:09 -07:00
James Phillips 2dc98dee32 Adds a note about prepared queries to the coordinates internals guide. 2016-06-28 23:02:00 -07:00
janisz 05539d91b5 Added allegor/marathon-consul in community tools
With @dankraw we authored https://github.com/allegro/marathon-consul/ this is fork of https://github.com/CiscoCloud/marathon-consul that is no longer developed (see this comment https://github.com/CiscoCloud/marathon-consul/issues/17#issuecomment-161678453).
2016-06-24 23:42:07 +02: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
James Phillips f2228f9988 Adds a link to the changelog. 2016-06-17 14:04:18 +01:00
Pawel Szymczyk b2967ebd06 Add embedded-consul to download_tools page 2016-06-17 08:56:51 +02:00
fusiondog b9eb3b1979 Added an and 2016-06-09 17:05:00 -07: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
fusiondog 832eb77103 Adding more detail about best use case. 2016-06-09 14:29:54 -07:00
Justin P 6716fc496a Update install.html.markdown OS X Instructions
Homebrew is phasing out the use of the homebrew-cask add-on, moving it all over to just using `brew install <app>`.

Also, if you type `brew info consul` you can see that you can even automatically install the web-ui through brew as well.
2016-06-08 06:38:23 -05:00
Evan Gilman 6235467a9a
Document `consul lock` shell execution
Consul lock executes children under a shell, which was previously
undocumented. Document it, and warn against cases where this can cause
children to leak when the lock is lost.

I have made this a dedicated section so it can easily be removed
later when we move to exec

https://github.com/hashicorp/consul/issues/1692
2016-06-03 17:01:05 -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
Andrew Widdersheim 01798b32b4 Fix typo 2016-05-26 10:46:55 -04: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
Seth Vargo 86a9ebb073
Add note about paid training 2016-05-16 16:46:14 -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
captainill 69cf3692f1 add height to fix svg in announcement bnr 2016-05-03 17:41:55 -07:00
Seth Vargo cf9d243240
Track enhanced links 2016-05-02 15:55:04 -04:00
fusiondog 9c10bd0b23 Clarify need for recursors option.
Reiterating that the iptables option requires recursors to be set to resolve for any domain besides .consul
2016-04-29 16:45:59 -07:00
fusiondog aa8dda5149 DNS forwarding with iptables
Adding notes on using iptables to forward ports
2016-04-28 23:27:28 -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
Seth Vargo 05ea1aac2a
Do not allow referrer to modify the sender
http://mathiasbynens.github.io/rel-noopener/
2016-04-22 23:31:45 -04: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
James Phillips 0ed56d6606 Adds a note about template query ACLs. 2016-03-17 08:21:58 -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
Alexandr Burdiyan cf12896d08 Update Consul Tools links
Docker Consul and Registrator projects were moved to another repositories.
2016-03-10 18:42:51 +01: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
James Phillips 9d38282db5 Adds a reference to the health endpoint in the intro.
Fixes #1739.
2016-03-09 16:42:15 -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
James Phillips dc81459857 Merge pull request #1813 from hashicorp/f-dns-trim
Makes sure UDP DNS responses aren't larger than allowed.
2016-03-08 23:26:04 -08:00
captainill a46acfeb25 refactor to encapsulate all side affects of displaying announcement bnr in one file 2016-03-08 14:59:06 -08:00
captainill a3996491a2 fix header on subpages when displaying annoucement bnr 2016-03-08 14:50:34 -08: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
vishalnayak 86edf5f5ba minor docs fix 2016-03-07 11:13:58 -05:00
James Phillips 29caa7d052 Merge pull request #1789 from hashicorp/jt-enterprise-bnr
add announcement banner for Consul Enterprise
2016-03-04 17:33:05 -08:00
James Phillips 5dd137056c Fixes name of new query ACL. 2016-03-04 16:32:53 -08:00
Kevin Fishner bcbf906ebd fix UTMs 2016-03-03 15:20:24 -08:00
Kevin Fishner 1c07280c38 update copyedit to add the word build 2016-03-03 15:19:05 -08:00
captainill 95337b7211 add announcement banner for Consul Enterprise launch 2016-03-03 12:23:30 -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 0ea990f3d2 Adds an upgrade note about the new ACL behavior. 2016-02-24 01:33:10 -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
csawyerYumaed 793195b7d8 Update documentation - add Network Ports.
Update security.html.markdown add section on Network Port usage.
TODO: add Atlas port usage.
2016-02-23 11:27:15 -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
Kim Toms a3f49a1f21 Update leader-election.html.markdown
Remove duplicate 'leader'
2016-02-14 09:32:23 -05: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 48a29b5a31 Fixes a typo. 2016-02-09 16:37:06 -08:00
Michael de Jong 8582b33276 Added a reference to Consultant in the Community Tools section. 2016-02-08 16:09:30 +01:00
James Phillips 9fabd05157 Merge pull request #1698 from hashicorp/pr-1547-slackpad
Implements WAN address translation.
2016-02-07 14:26:04 -08:00
James Phillips 800910137d Adds documentation for WAN address translation. 2016-02-07 11:12:19 -08:00
James Phillips 498c8e1d9c Merge pull request #1609 from kevinsimper/patch-1
Updating dns forwarding
2016-02-06 22:21:00 -08:00
James Phillips 4b3dede0fb Tweaks the telemetry docs. 2016-02-06 22:07:11 -08:00
James Phillips a599e88507 Merge pull request #1284 from nbrownus/telemetry
Option to disable hostnames from telemetry
2016-02-06 22:00:14 -08:00
James Phillips 43a8eb8189 Adds a warning about DoS-ing the cluster with consul exec. 2016-02-05 17:36:19 -08:00
Seth Vargo 8150cedbaf Order 2016-02-04 12:12:58 -05:00
Justin Plock 894d444449 Add dropwizard-consul to the Community Tools page 2016-02-04 12:00:06 -05:00
Sean Chittenden c1c3daed9a Iterate on the DNS forwarding docs
Specifically:

* add Dnsmasq examples for reverse DNS for most of the RFC1918, 5735, and 6598 netblocks.
* Highlight some example options for dnsmasq that are probably of interest.
* Add a small section on reverse DNS testing
* Break out BINDs troubleshooting with Dnsmasq's troubleshooting

Not an exhaustive sweep, but should be helpful when introducing consul to new environments.
2016-02-02 15:06:25 -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
Jamie Kelly 08eefe7c31 Edit intro to present Consul instead of Terraform.
As this is Consul, not Terraform, it makes sense to use Consul in this intro instead of Terraform.
2016-01-27 20:44:10 +00:00
Justin Wilson 423725feea Update services.html.markdown 2016-01-27 14:06:38 -06:00
Seth Vargo b7c502c15a Add structured data 2016-01-24 13:27:30 -05:00
Brent Rojas e94a92902a Update hashicorp-ecosystem.html.markdown
Remove slash from link to blog, which was causing 404 error.
2016-01-22 15:09:12 -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
Kevin Simper 759e535f54 Updating dns forwarding
It is not really clear that you only have to do one of the following and not all three.
2016-01-14 22:53:14 +01:00
Jon Benson d79139760a Fix semaphore typo 2016-01-13 16:56:40 -08:00
Seth Vargo e110abee9b Fix broken link 2016-01-13 19:32:30 -05:00
Seth Vargo e77dc8e6ee Remove bad CSS 2016-01-13 19:31:52 -05:00
Seth Vargo d906108b30 Merge pull request #1599 from hashicorp/sethvargo/image_optim
Optimize images
2016-01-13 18:03:26 -05:00
Seth Vargo b15bbc3c85 Optimize images 2016-01-13 18:00:47 -05:00
Seth Vargo dc9131a732 Use HTTPS + www. where appropriate 2016-01-13 17:44:01 -05:00
captainill b161727711 fix consul logo position in safari 2016-01-12 11:58:30 -08:00
captainill 3b4bdc00b3 fix header fonts safari 2016-01-12 11:31:22 -08:00
James Phillips 6d35366228 Adds a note about 2X memory provisioning. 2016-01-08 19:15:42 -08:00
James Phillips 6bfc266657 Adds a cautionary note about data fitting into RAM. 2016-01-08 18:49:31 -08:00
James Phillips 55970248bc Tweaks wording of reap config option section. 2016-01-06 22:29:03 -08:00
James Phillips 6dd0835319 Makes the timeout behavior more intuitive.
Previously, it would try once "up to" the timeout, but in practice it would
just fall through. This modifies the behavior to block until the timeout has
been reached.
2016-01-06 09:40:20 -08:00
James Phillips 87dd758199 Defaults monitor retries to 3 retries @ 1s for the consul lock command. 2016-01-05 18:34:22 -08:00
James Phillips 9323276b58 Adds monitor retries to the consul lock command. 2016-01-05 18:22:36 -08:00
James Phillips 3348cf4c0b Adds "try" support to locks and semaphores. 2016-01-05 18:22:36 -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
Ryan Uber 3f8d25e689 website: address comments 2016-01-05 09:48:04 -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 f37c0facbe agent: enable ui for dev mode 2015-12-26 20:39:42 -05:00
Ryan Uber 256a2ad36a website: update setup instructions for self-hosted ui 2015-12-24 23:14:40 -05: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 09b1924cce Tweaks RTT command docs. 2015-12-21 15:16:48 -08:00
James Phillips 9e3c171648 Merge pull request #1522 from sboily/patch-1
Update documentation to use consul rtt command with https
2015-12-21 15:14:57 -08:00
captainill 3fa4451d05 position edit this page link to bottom of page 2015-12-19 22:29:11 -08:00
captainill fcf35a2337 make sure #demo h2 color is readable 2015-12-19 22:08:49 -08:00
captainill b276b8f06c capital C in header by hashicorp lockup 2015-12-19 22:05:17 -08:00
captainill 3ac1b7321d Merge branch 'master' into new_header 2015-12-19 21:39:34 -08:00
captainill 2573f15882 cleanup 2015-12-19 21:39:03 -08:00
James Phillips 43808ca120 Clarifies format of stats aggregator configurations as host:port. 2015-12-18 22:53:55 -08:00