Upgrading to Waypoint 0.5.0 from 0.4.x

Warning

This content is part of the legacy version of Waypoint that is no longer actively maintained. For additional information on the new vision of Waypoint, check out this blog post and the HCP Waypoint documentation.

Waypoint 0.4.x can be upgraded to Waypoint 0.5.0 using a standard upgrade. There are no breaking changes in the protocol or waypoint.hcl configuration file. All Waypoint components (CLI, entrypoint, and server) are forwards and backwards compatible, but we encourage users to have all components on the same version.

Other Considerations

Server Image

waypoint install uses the hashicorp/waypoint:latest container image for Kubernetes, Nomad, ECS, and Docker. When upgrading, your platform may require you to pull the latest image instead of using a cache.

Kubernetes and Nomad both specify an "always pull" policy for :latest images so restarting the Deployment or Job should pull the latest released version. Docker may require an explicit docker pull and container recreate.

Verifying the Server Version with the UI

You can verify the server version by loading the UI and looking at the footer. You should see a version starting with v0.5. If you see an earlier version, your platform may be using an old cached image.

Verifying the Server Version with the CLI

You can verify both the CLI version and server version by running:

$ waypoint version
CLI: v0.5.0 (622f37bd1)
Server: v0.5.0