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

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 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 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 instead of 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 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 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 and that entry for more.

• abra server add --traefik went away, it was too unreliable & hard to maintain.