使用HLF Operator在EKS部署Fabric时链码安装报错：docker build被禁用

报错核心：'InstallChaincode': could not build chaincode: docker build failed: docker build is disabled，该问题通常源于Peer节点链码构建模式配置错误，或是EKS集群权限、容器运行时环境的限制导致。

解决步骤 #

1. 检查Peer节点链码构建模式配置 #

hlf-operator部署的Peer默认可能禁用本地Docker构建，或使用了不匹配的构建模式：

• 查看Peer的自定义资源（CR）YAML配置，确认是否设置了chaincode.builder、chaincode.env等参数，确保启用适配EKS环境的构建方式。
• 若使用Fabric 2.x及以上版本，优先采用链码生命周期的外部构建模式，或配置Peer使用k8s构建模式（hlf-operator支持将链码构建任务提交为Kubernetes Job）。

2. 验证EKS集群权限配置 #

• 检查Peer所属ServiceAccount的权限：确保其绑定的ClusterRole/Role包含jobs/create、pods/create、pods/exec等权限，因为链码构建可能需要创建临时Pod/Job。
• 确认EKS节点IAM角色权限：允许容器访问ECR（若使用AWS镜像仓库），确保Peer节点能拉取链码构建所需的基础镜像。

3. 适配EKS容器运行时（containerd） #

EKS默认使用containerd而非Docker，需调整Peer配置适配该环境：

• 确保Peer容器配置了正确的containerd套接字路径/run/containerd/containerd.sock，而非Docker的/var/run/docker.sock。
• 在Peer的CR配置中设置chaincode.runtime: containerd，指定链码构建与运行使用containerd。

4. 改用预构建链码镜像 #

若节点端构建始终受限，可跳过节点构建步骤：

• 提前在本地或CI环境构建链码镜像，并推送到ECR仓库。
• 安装链码时直接指定镜像地址，绕开节点上的构建流程。

关键命令参考 #

• 查看Peer的CR配置：

  kubectl get peers.hlf.kungfusoftware.es <peer-name> -o yaml
  

• 检查ServiceAccount权限：

  kubectl describe sa <peer-sa> -n <namespace>
  

• 查看Peer节点链码相关日志：

  kubectl logs <peer-pod-name> -n <namespace> | grep "chaincode"
  

内容的提问来源于stack exchange，提问作者Carlos Daniel Ospina Salazar