decentral1se
b6d92dc1b8
All checks were successful
continuous-integration/drone/push Build is passing
56 lines
2.7 KiB
Markdown
56 lines
2.7 KiB
Markdown
---
|
|
title: Upgrade
|
|
---
|
|
|
|
## Release channels
|
|
|
|
### Stable
|
|
|
|
```
|
|
abra upgrade
|
|
```
|
|
|
|
### Release candidate
|
|
|
|
```
|
|
abra upgrade --rc
|
|
```
|
|
|
|
## Migration guides
|
|
|
|
### `0.5.x-beta` -> `0.6.x-beta`
|
|
|
|
- Using `{{ .Domain }}` in recipe `.envrc.sample` files went away because it
|
|
was portable enough. We revert to replacing e.g `gitea.example.com` with the
|
|
domain. See
|
|
[`8fad34e`](https://git.coopcloud.tech/coop-cloud/abra/commit/8fad34e) for
|
|
more.
|
|
|
|
- If your `abra.sh` scripts depend on `/bin/sh` and `/bin/bash` is available in
|
|
the container then `/bin/bash` will be used from now on. `/bin/sh` is only
|
|
now used if `/bin/bash` is not available. See
|
|
[`7f745ff`](https://git.coopcloud.tech/coop-cloud/abra/commit/7f745ff) for
|
|
more.
|
|
|
|
### `v0.4.x` -> `v0.5.x`
|
|
|
|
- The only breaking change was making `abra` understand that the JSON dump for the recipes listing lives on [recipes.coopcloud.tech/recipes.json](https://recipes.coopcloud.tech) instead of [recipes.coopcloud.tech](https://recipes.coopcloud.tech).
|
|
|
|
### `v0.3.x` -> `v0.4.x`
|
|
|
|
Make sure to back up your `~/.abra/servers` configurations first for safety.
|
|
|
|
- Please run `mv ~/.abra/apps ~/.abra/recipes`.
|
|
|
|
- "app name" as a concept went away, `abra` now uses the domain name of an app as the identifier. However, we don't expect to see breaking behaviour if you have `.env` files like `~/.abra/servers/foo.com/mycoolapp.env` and you still want to run `abra app ps mycoolapp`. `abra` still reads the filename to figure out the identifier. When running `abra app new <recipe>`, `abra` will now take the domain name as the name of the `.env` file.
|
|
|
|
- `abra` has a new SSH implementation which enforces SSH host key checking. You may run into connection issues as a result of this code churn, please see [this entry](/abra/trouble/#ssh-connection-issues) for help navigating a fix.
|
|
|
|
- CLI flag/args handling has been made more flexible. We're working within the constraints of an upstream library issue but have hopefully made it easier to mange passing flags to commands with `abra`. See [this troubleshooting entry](/abra/trouble/#command-line-flag-handling-is-weird) for the full review.
|
|
|
|
- A number of short style flags have been re-mapped and/or added. This is again related to an issue with the upstream CLI library which sometimes understands short style flags as long style flags. E.g. `--ch` instead of `-ch` for `--chaos`. As a concrete example, `--ch` is now `-C` on `abra app deploy`.
|
|
|
|
- `abra app backup` & `abra app restore` are ready for alpha-testing! See [this entry](https://docs.coopcloud.tech/maintainers/handbook/#how-do-i-configure-backuprestore) and [that entry](https://docs.coopcloud.tech/operators/handbook/#how-do-i-backuprestore-my-app) for more.
|
|
|
|
- `abra server add --traefik` went away, it was too unreliable & hard to maintain.
|