readthedocs-docker-images
readthedocs-docker-images copied to clipboard
Upgrade version of `asdf` to 0.17 (Go based)
We are currently using asdf v0.14.0 and we haven't had any issue so far.
There is a new version of asdf that was completely rewritten in Go, and the whole CLI was changed as well. Previous commands/subcommands would may not work in the newer versions +0.16: https://asdf-vm.com/guide/upgrading-to-v0-16.html
It's worth to note that asdf uses pyenv under the hoods to build the Python version. That's why we were able to compile the latest versions of Python, because those plugins update their own metadata.
I've upgraded to the Go version locally, but I haven't tried it on the Read the Docs Docker images nor the builds either. In theory, it shouldn't be a big problem to upgrade and almost everything should continue working in the same way.
It's also worth to note that I haven't found an immediate reason to perform the upgrade. At least, as long as the plugins we have installed in asdf (node, python, rust, ruby, etc) keep working with the older version, I'd say we are fine here.
If you build these tools locally, you may see the following message tho:
NOTICE:
You have tried to upgrade to asdf 0.16.0 or newer. Versions 0.16.0 is a
complete rewrite of asdf in Go. This text is being printed by the older
Bash implementation. If you are seeing this you have not migrated to
asdf 0.16.0. Please follow the instructions on the upgrade guide to
migrate to the new version.
Aside from this notice, this older Bash implementation works as it did
in asdf version 0.15.0 and older.
Migration guide: https://asdf-vm.com/guide/upgrading-to-v0-16
asdf website: https://asdf-vm.com
Source code: https://github.com/asdf-vm/asdf
It's not a problem and the tool is built correctly 👍🏼