Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: mention env var changes in upgrade docs #4099

Merged
merged 2 commits into from
Apr 9, 2018
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Next Next commit
docs: mention env var changes in upgrade docs
Mention the changes from #3760 in the upgrade docs as applications
expecting underscores will break.
  • Loading branch information
schmichael committed Apr 9, 2018
commit e71944c71f1ac929b05cd8429af78f545e25da09
26 changes: 25 additions & 1 deletion website/source/docs/upgrade/upgrade-specific.html.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ standard upgrade flow.

## Nomad 0.8.0

#### Raft Protocol Version Compatibility
### Raft Protocol Version Compatibility

When upgrading to Nomad 0.8.0 from a version lower than 0.7.0, users will need to
set the [`-raft-protocol`](/docs/agent/options.html#_raft_protocol) option to 1 in
Expand Down Expand Up @@ -51,6 +51,30 @@ Raft Protocol versions supported by each Consul version:
In order to enable all [Autopilot](/guides/cluster/autopilot.html) features, all servers
in a Nomad cluster must be running with Raft protocol version 3 or later.

### Periods in Environment Variable Names No Longer Escaped
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add to backwards incompatible section of change log


*Applications which expect periods in environment variable names to be replaced
with underscores must be updated.*

In Nomad 0.7 periods (`.`) in environment variables names were replaced with an
underscore in both the [`env`](/docs/job-specification/env.html) and
[`template`](/docs/job-specification/template.html) stanzas.

In Nomad 0.8 periods are *not* replaced and will be included in environment
variables verbatim.

For example the following stanza:

```text
env {
registry.consul.addr = "${NOMAD_IP_http}:8500"
}
```

In Nomad 0.7 would be exposed to the task as
`registry_consul_addr=127.0.0.1:8500`. In Nomad 0.8 it will now appear exactly
as specified: `registry.consul.addr=127.0.0.1:8500`.

## Nomad 0.6.0

### Default `advertise` address changes
Expand Down