luxolus/open-nomad
2
0
Fork 0
Code Issues 1 Pull requests Packages Releases Wiki Activity
open-nomad/website/source/docs/agent/configuration/atlas.html.md
Seth Vargo 4a1fa67f26
Separate agent configuration into its own pages 
I apologize in advance for the rather long PR, but unfortunately there
is not an easy way to break this up into smaller chunks. This separates
the agent configuration into smaller, more consumable pieces just like
the job specification.
2016-11-02 18:30:00 -04:00

2.3 KiB
Raw Blame History

layout page_title sidebar_current description
docs atlas Stanza - Agent Configuration docs-agent-configuration-atlas The `atlas` stanza configures Nomad's integration with HashiCorp's Atlas and Nomad Enterprise.

atlas Stanza

Placement **atlas**

The atlas stanza configures Nomad's integration with HashiCorp's Atlas and Nomad Enterprise.

atlas {
  infrastructure = "hashicorp/example"
  join           = true
}

~> Nomad integration with Atlas is currently in private beta and only available to select users. As the functionality becomes more widely available, additional examples and documented will be listed here.

atlas Parameters

  • endpoint (string: "https://atlas.hashicorp.com") - Specifies the address of the Atlas service to connect.

  • infrastructure (string: <required>) - Specifies the name of the Atlas infrastructure to connect the agent. This should be of the form <organization>/<infrastructure>, and requires a valid token

  • join (bool: false) - Specifies if the auto-join functionality should be enabled.

  • token (string: <required>) - Specifies the Atlas token to use for authentication. This token must have access to the provided infrastructure. This can also optionally be specified using the ATLAS_TOKEN environment variable.

atlas Examples

The following examples only show the atlas stanzas. Remember that the atlas stanza is only valid in the placements listed above.

Nomad Enterprise SaaS

This example connects to the public Nomad Enterprise service to the infrastructure named "hashicorp/example". The provided token must have permissions to manage the infrastructure or access will be denied.

atlas {
  infrastructure = "hashicorp/example"
  token          = "abcd.atlasv1.efghi...."
  join           = true
}

On-Premise Nomad Enterprise

This example connects to a custom Nomad Enterprise server, such as an on-premise installation.

atlas {
  endpoint       = "https://corp.atlas.local/"
  infrastructure = "acme/example"
  join           = true
}