How to lock Docker version in Centos/RHEL

Expected Outcome

Prevent Docker from upgrading during a maintenance or patch update.

Prerequisites

• Terraform Enterprise
• Docker CE
• root or sudo access
• RHEL 7/8

Use Case

Follow these steps to ensure the version of Docker meets the Terraform Enterprise requirements.

Procedure

• First, install a required package     
  

  For RHEL 7
  # yum install yum-plugin-versionlock
  
  For RHEL 8
  # yum install python3-dnf-plugin-versionlock

• Verify the installed versions, ex:  

  yum list docker-ce docker-ce-cli docker-ce-rootless-extras containerd.io --showduplicates | sort -r|grep @
  docker-ce.x86_64 3:20.10.17-3.el7 @docker-ce-stable
  docker-ce-rootless-extras.x86_64 23.0.1-1.el7 @docker-ce-stable
  docker-ce-cli.x86_64 1:20.10.17-3.el7 @docker-ce-stable
  containerd.io.x86_64 1.6.18-3.1.el7 @docker-ce-stable

• Lock the version of the packages listed above    
  

  sudo yum versionlock docker-ce-20.10.17-3.el7 docker-ce-cli-20.10.17-3.el7 docker-ce-rootless-extras-23.0.1-1.el7 containerd.io-1.6.18-3.1.el7
  Loaded plugins: fastestmirror, versionlock
  Adding versionlock on: 0:docker-ce-rootless-extras-23.0.1-1.el7
  Adding versionlock on: 1:docker-ce-cli-20.10.17-3.el7
  Adding versionlock on: 3:docker-ce-20.10.17-3.el7
  Adding versionlock on: 0:containerd.io-1.6.18-3.1.el7
  versionlock added: 4

• Before upgrading Docker remove the lock      

  sudo yum versionlock clear

Additional Information

• Terraform run doesn't execute in Terraform Enterprise

• For additional assistance please contact HashiCorp Support.