From fa2328a07d9ad42fc3757d8075349c2a9398a5f3 Mon Sep 17 00:00:00 2001 From: Ryan Breen Date: Tue, 24 Feb 2015 22:38:25 -0500 Subject: [PATCH] Website: GH-730 links for /docs/guides/atlas.html --- .../source/docs/guides/atlas.html.markdown | 27 ++++++++++--------- 1 file changed, 15 insertions(+), 12 deletions(-) diff --git a/website/source/docs/guides/atlas.html.markdown b/website/source/docs/guides/atlas.html.markdown index 510a826473..dd920e448d 100644 --- a/website/source/docs/guides/atlas.html.markdown +++ b/website/source/docs/guides/atlas.html.markdown @@ -10,7 +10,7 @@ description: |- [Atlas](https://atlas.hashicorp.com) is a service provided by HashiCorp to deploy applications and manage infrastructure. Starting with Consul 0.5, it is possible to integrate Consul with Atlas. This is done by registering a node as part -of an Atlas infrastructure (specified with the `-atlas` flag). Consul maintains a long-running connection to the +of an Atlas infrastructure (specified with the [`-atlas`](/docs/agent/options.html#_atlas) flag). Consul maintains a long-running connection to the [SCADA](http://scada.hashicorp.com) service which allows Atlas to retrieve data and control nodes. Data acquisition allows Atlas to display the state of the Consul cluster in its dashboard and set up alerts @@ -19,9 +19,11 @@ based on health checks. Remote control enables Atlas to provide features like au ## Enabling Atlas Integration To enable Atlas integration, you must specify the name of the Atlas infrastructure and the Atlas authentication -token. The Atlas infrastructure name can be set either with the `-atlas` CLI flag, or with the `atlas_infrastructure` -[configuration option](/docs/agent/options.html). The Atlas token is set with the `-atlas-token` CLI flag, `atlas_token` -configuration option, or `ATLAS_TOKEN` environment variable. +token. The Atlas infrastructure name can be set either with the [`-atlas`](/docs/agent/options.html#_atlas) +CLI flag or with the [`atlas_infrastructure`](/docs/agent/options.html#atlas_infrastructure) config option. +The Atlas token is set with the [`-atlas-token`](/docs/agent/options.html#_atlas_token) CLI flag, +[`-atlas-token`](/docs/agent/options.html#atlas_token) configuration option, or `ATLAS_TOKEN` +environment variable. To verify the integration, either run the agent with `debug`-level logging or use `consul monitor -log-level=debug` and look for a line like: @@ -36,22 +38,23 @@ Once integrated with Atlas, the auto-join feature can be used to have nodes auto peers in their datacenter. Server nodes will automatically join peer LAN nodes and other WAN nodes. Client nodes will only join other LAN nodes in their datacenter. -Auto-join is enabled with the `-atlas-join` CLI flag or the `atlas_join` configuration option. +Auto-join is enabled with the [`-atlas-join`](/docs/agent/options.html#_atlas_join) CLI flag or the +[`atlas_join`](/docs/agent/options.html#atlas_join) configuration option. ## Securing Atlas The connection to Atlas does not have elevated privileges. API requests made by Atlas are served in the same way any other HTTP request is handled. If ACLs are enabled, it is possible, via -the `atlas_acl_token` configuration option, to force an Atlas ACL token to be used instead of the -agent's default token. +the [`atlas_acl_token`](/docs/agent/options.html#atlas_acl_token) configuration option, to force an +Atlas ACL token to be used instead of the agent's default token. The resolution order for ACL tokens is: 1. Request-specific token provided by `?token=`. These tokens are set in the Atlas UI. -2. The agent's `atlas_acl_token`, if configured. -3. The agent's `acl_token`, if configured. +2. The agent's [`atlas_acl_token`](/docs/agent/options.html#atlas_acl_token), if configured. +3. The agent's [`acl_token`](/docs/agent/options.html#acl_token), if configured. 4. The `anonymous` token. -Because the `acl_token` typically has elevated permissions compared to the `anonymous` token, -the `atlas_acl_token` can be set to `anonymous` to drop privileges that would otherwise be -inherited from the agent. +Because the [`acl_token`](/docs/agent/options.html#acl_token) typically has elevated permissions +compared to the `anonymous` token, the [`atlas_acl_token`](/docs/agent/options.html#atlas_acl_token) +can be set to `anonymous` to drop privileges that would otherwise be inherited from the agent.