Terraform Enterprise FDO Podman RHEL 9 docker-sock error

Problem

When following the installation guide for Terraform Enterprise FDO Podman on Red Hat Enterprise Linux 9, an error occurs during the Apply the deployment configuration step.

After running the podman kube play command, the operation fails with the following error message.

$ podman kube play <path_to_YAML_file>

Error: failed to create volume "docker-sock": in parsing HostPath in YAML: faccessat /var/run/docker.sock: no such file or directory

Cause

This error occurs because the podman.socket service is not enabled or the podman-docker compatibility package is not installed on the Terraform Enterprise instance. These components are required to emulate the Docker socket that Terraform Enterprise expects.

Solution

Follow these steps to resolve the error and complete the installation.

1. Ensure you have followed the instructions to install Podman on RHEL 9. The container-tools meta-package, which includes the required podman-docker package, should be installed using a privileged user.

   # dnf install -y container-tools

2. Enable and start the Podman socket service by following the instructions for preparing the host and enabling the Podman socket.

   # systemctl enable --now podman.socket

3. If a failed Terraform Enterprise container exists, remove it.

   $ podman container rm terraform-enterprise-terraform-enterprise

4. Apply the deployment configuration again.

   $ podman kube play <path_to_YAML_file>

5. After the command succeeds, continue with the Apply the deployment configuration guide.