docs.coopcloud.tech/docs/abra/upgrade.md

38 lines
1.9 KiB
Markdown
Raw Normal View History

2022-01-27 09:27:23 +00:00
---
title: Upgrade
---
2022-02-04 12:19:49 +00:00
## Release channels
### Stable
2022-01-27 09:27:23 +00:00
```
abra upgrade
```
2022-02-04 12:19:49 +00:00
### Release candidate
2022-01-27 09:27:23 +00:00
```
abra upgrade --rc
```
2022-02-04 12:19:49 +00:00
## Migration guides
### `v0.3.x` -> `v0.4.x`
Make sure to back up your `~/.abra/servers` configurations first for safety.
2022-03-13 22:29:27 +00:00
- Please run `mv ~/.abra/apps ~/.abra/recipes`.
2022-02-04 12:19:49 +00:00
- "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.
2022-03-13 22:29:27 +00:00
2022-02-04 12:19:49 +00:00
- `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.
2022-03-13 22:29:27 +00:00
- CLI flag/args handling has been made more flexible. We're workign 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`.
2022-04-19 12:46:45 +00:00
- `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.