How To Track The Progress of a Terraform Enterprise Update

Use Case

While performing an upgrade, the status of the upgrade is not available in detail from the Terraform Enterprise UI or dashboard.

You can monitor the upgrade process via the Replicated CLI which provides deeper insight into the upgrade progress.

Procedure

• After executing /usr/local/bin/replicatedctl app-release apply to begin the application upgrade, execute the following commands:

  # List running tasks and locate the upgrade task ID
  replicatedctl task ls
  
  TASK ID STATUS CREATED FINISHED DESCRIPTION
  upgrade_to_version_428300989d80405c633bd21c172dc030_619 queued 2022-05-18 15:26:24.446688615 +0000 UTC 0001-01-01 00:00:00 +0000 UTC
  upgrade_to_version_428300989d80405c633bd21c172dc030_610 executing 2022-05-18 15:26:24.446319395 +0000 UTC 0001-01-01 00:00:00 +0000 UTC
  f3eb870d71e78431051622b74457062e sleeping 2022-04-20 21:22:45.450093923 +0000 UTC 2022-05-18 15:00:00.001627974 +0000 UTC
  f08646caaf6142ac931c9271f6d7deed sleeping 2022-04-20 21:22:45.44945145 +0000 UTC 2022-05-18 09:27:15.904153604 +0000 UTC
  fe45e5da36e34f48a2ccdeae28b9f67f sleeping 2022-04-20 21:22:45.449010792 +0000 UTC 2022-05-18 14:38:28.58946189 +0000 UTC
  
  # Stream task progress
  replicatedctl task attach <task-id>
  
  Waiting for all components to start

   

   

Additional Information

• watch replicatedctl app status Can be used after the upgrade has been completed to check the status of the application and version of Terraform Enterprise; this can also be confirmed via the WebUI.

• For further information on Terraform Enterprise visit: https://www.terraform.io/enterprise/admin/infrastructure/upgrades