8000 Tags · ausimian/castle · GitHub
[go: up one dir, main page]

Skip to content

Tags

Tags

1.3.1

Toggle 1.3.1's commit message
- A consumer upgrade that moves Castle from 1.0.0, 1.0.1, 1.1.0, 1.2.…

…0-rc.1,

  1.2.0, 1.2.1 or 1.3.0 to 1.3.1 stays hot under `auto`, since Castle's appup
  covers each.

- The lines `unpack`, `install`, `commit` and `remove` log now reach the node's
  log on a node using Elixir's default `Logger` handler. In 1.3.0 that handler's
  `remote_gl` filter dropped them, because they were logged under the group
  leader of the `rpc` that ran the command, which is on another node. The
  `unpack` and `install` that bring 1.3.1 are run by 1.3.0, so those two are
  still not logged. ([#63](#63))

1.3.0

Toggle 1.3.0's commit message
- `unpack`, `install`, `commit` and `remove` log what they report on …

…the running

  node, at `info` level in the `[:castle]` logger domain, so the node's own log
  records each change to the deployment. The install that brings this version
  is run by the previous Castle, so that one install is not logged.

- Castle now requires Forecastle 1.2.2 or later. Its hot relups take an
  application they remove off the code path, so a later upgrade with an optional
  dependency on it no longer finds it present, and they start an added
  application that has no modules, which used to stay stopped until the node
  restarted. ([forecastle#72](ausimian/forecastle#72))
- A consumer upgrade that moves Castle from 1.0.0, 1.0.1, 1.1.0, 1.2.0-rc.1,
  1.2.0 or 1.2.1 to 1.3.0 stays hot under `auto`, since Castle's appup covers
  each.

1.2.1

Toggle 1.2.1's commit message
- Castle now requires Forecastle 1.2.1 or later, whose hot relups sta…

…rt the

  applications they add in dependency order and stop the ones they remove in
  reverse, instead of in the alphabetical order of the `.rel` file. An added
  application started before one it depends on used to stay stopped until the
  node restarted.
  ([forecastle#66](ausimian/forecastle#66))
- A consumer upgrade that moves Castle from 1.0.0, 1.0.1, 1.1.0, 1.2.0-rc.1 or
  1.2.0 to 1.2.1 stays hot under `auto`, since Castle's appup covers each.

1.2.0

Toggle 1.2.0's commit message
- `CASTLE_ENV_FILE`: when the supervisor sets it, `install` and `comm…

…it` source

  the file it names before resolving the target's config providers, as
  Forecastle's `env.sh` does at boot. A hot install and a restart now configure
  each version from the same values, and a variable written for the target
  reaches `runtime.exs` and `config_change/3`. A relative name is a file in the
  target's own version directory, `releases/<vsn>/`, which the deployment writes
  after `unpack`, so a rollback reads the file its version was installed with.
  The target's own Castle sources the file, so this works from the upgrade that
  brings this version. A file that is missing, unreadable or fails refuses the
  operation, and nothing changes.
  ([#56](#56))
- A guide, *Configuring from environment variables*, covering how to set up the
  file, how to deploy a version with it, and how to write `runtime.exs` and
  `config_change/3` for hot upgrades.

- Castle now requires Forecastle 1.2 or later, whose `env.sh` sources
  `CASTLE_ENV_FILE` at boot, so a start reads the same file that `install` and
  `commit` do.
- A consumer upgrade that moves Castle from 1.0.0, 1.0.1, 1.1.0 or 1.2.0-rc.1 to
  1.2.0 stays hot under `auto`, since Castle's appup covers each.

1.2.0-rc.1

Toggle 1.2.0-rc.1's commit message
- `CASTLE_ENV_FILE`: when the supervisor sets it, `install` and `comm…

…it` source

  the file it names before resolving the target's config providers, as
  Forecastle's `env.sh` does at boot. A hot install and a restart now configure
  each version from the same values, and a variable written for the target
  reaches `runtime.exs` and `config_change/3`. A relative name is a file in the
  target's own version directory, `releases/<vsn>/`, which the deployment writes
  after `unpack`, so a rollback reads the file its version was installed with.
  The target's own Castle sources the file, so this works from the upgrade that
  brings this version. A file that is missing, unreadable or fails refuses the
  operation, and nothing changes.
  ([#56](#56))
- A guide, *Configuring from environment variables*, covering how to set up the
  file, how to deploy a version with it, and how to write `runtime.exs` and
  `config_change/3` for hot upgrades.

1.1.0

Toggle 1.1.0's commit message
- Castle now requires Forecastle 1.1 or later, which adds the

  `require_relup: true` release option: a build that sets it and has no
  `upgrade_from:` is rejected before assembly instead of producing a release
  with no relup.
- A consumer upgrade that moves Castle from 1.0.0 or 1.0.1 to 1.1.0 stays hot
  under `auto`, since Castle's appup covers both.

1.0.1

Toggle 1.0.1's commit message
- Castle now ships an appup, so a consumer upgrade that moves Castle …

…from 1.0.0

  is a hot upgrade under `auto`. Previously, unless the consumer supplied an
  appup for Castle under `rel/appups`, Forecastle generated an emulator restart
  for any upgrade that changed Castle's version.

- Castle now uses the same releases directory as `:release_handler`, following
  the SASL `releases_dir` option, then `RELDIR`, then `<root>/releases`, with a
  relative directory resolved against the release root. Previously it always
  used `<root>/releases`. On a deployment that set either override, it wrote
  `RELEASES` and the target's configuration where the handler never read them.
- Configuring a target release now uses the deployment's root for its
  applications and emulator, rather than the directory two levels above the
  version directory, so it works when the releases directory has been moved.

1.0.0

Toggle 1.0.0's commit message
Castle 1.0 resolves each target release's configuration with that rel…

…ease's

own code and config providers, and adds upgrades that restart the emulator under
an external supervisor. It requires Forecastle 1.x and Elixir 1.18 or later.
Two changes break existing pipelines: `mix forecastle.relup` is now
`mix castle.relup`, and `Castle.generate/1` has been removed.

- `Castle.customize/1`, the release integration API. It adds Forecastle's steps
  around `:assemble` and defaults missing release steps to `[:assemble, :tar]`.
  ([#12](#12))
- Relup generation during assembly. Name baselines in `upgrade_from:` (a shipped
  `tar:` archive, an assembled `rel:` release or a `ref:` git ref) and one
  `mix release` produces a tarball carrying both its upgrade and downgrade
  instructions.
  ([forecastle#28](ausimian/forecastle#28),
  [forecastle#40](ausimian/forecastle#40))
- Upgrade tooling from Forecastle:
  - `mix castle.appup`, which checks that an appup covers every module that
    changed between two builds.
    ([forecastle#27](ausimian/forecastle#27))
  - `mix castle.appup.gen`, which drafts missing appup entries for review,
    including for dependencies with `--app <dep>`.
    ([forecastle#29](ausimian/forecastle#29),
    [forecastle#30](ausimian/forecastle#30))
  - `mix castle.relup --dry-run`, which reports whether a transition can be hot
    without writing a relup.
    ([forecastle#31](ausimian/forecastle#31))
  - `Forecastle.UpgradeCase` and `Forecastle.Deployment`, a harness for testing
    upgrades against a shipped artifact.
    ([forecastle#32](ausimian/forecastle#32))
- Target configuration resolved in a temporary VM running the target release's
  boot script, emulator and config providers.
  ([#13](#13))
- `Castle.upgradable/0`, and matching checks in `unpack/1` and `install/1`, which
  refuse nodes running a release record synthesised by `:release_handler` and
  explain how to recover.
- `Castle.running/1`, which confirms that a version is running and has finished
  booting.
- One-stage `restart_emulator` upgrades under systemd, Docker, Kubernetes and
  other external supervisors.
  ([#14](#14))

- **Breaking:** `mix forecastle.relup` is now `mix castle.relup`. There is no
  compatibility alias, so build pipelines calling the old name must be updated.
  `mix compile.appup` is unchanged.
  ([forecastle#24](ausimian/forecastle#24))
- Release commands raise `Castle.Error` on a refusal or an error from
  `:release_handler`, so `bin/castle` exits non-zero. Output on success is
  unchanged. ([#10](#10))
- Installs and commits on a node are serialised with configuration resolution.
- The minimum supported Elixir version is 1.18.

- **Breaking:** `Castle.generate/1` and the `build.config` configuration path.
  Each target release is now configured by its own config providers.

- `install/1` reports an upgrade that replaces the emulator, kernel, stdlib or
  sasl instead of crashing with `CaseClauseError`.
- `releases/0` prints nothing when no release is installed instead of raising
  `Enum.EmptyError`.
- `make_releases/0` reports `RELEASES` read and write errors instead of raising
  `MatchError`, and finds the release directory from the running emulator rather
  than the current working directory.
- Resolved configuration is staged with owner-only permissions and published
  atomically, keeping the original `sys.config` mode.
- Commands that modify a deployment refuse a release whose emulator root differs
  from the release root, including one built with `include_erts: false`, instead
  of letting `:release_handler` modify the shared Erlang installation.

0.3.0

Toggle 0.3.0's commit message
v0.3.0

0