Skip to main content

Upgrade aqua from v1 to v2

The release of v2 includes several breaking changes.

Most important change is that only standard registry is allowed by default. If you use Checksum Verification, changing the specification of require_checksum is also important. These changes make aqua secure by default.

Other changes are not so important as the registry restriction, but these changes makes aqua simple.

Pull Requests and Issues

Breaking Changes

Removed some features.

How to migrate

  • Guide. If you use non Standard Registry, please create a policy file and set AQUA_POCLICY_CONFIG
  • Guide. If you enable Checksum Verification and require_checksum, run aqua update-checksum before installing packages. We recommend updating aqua-checksums.json by GitHub Actions
  • Guide. Stop using aqua install's --test flag
  • Guide. Stop using aqua update-checksum's --deep flag

If you maintain Registry,

  • Guide. Maybe you have to set files[].name explicitly to some packages that are set name
  • Guide. If you define complicated version_constraint, please check if aqua v2 supports it
  • Guide. Replace go package to go_install package
  • Guide. Replace supported_if to supported_envs