Docker部署Yugabyte时容器退出报error code 132如何解决

Docker部署YugabyteDB返回error code 132，本质是进程收到SIGILL（非法指令）信号触发异常退出，90%以上的触发场景是宿主机CPU不支持YugabyteDB默认编译版本启用的AVX2指令集，常见于老款消费级CPU、部分云厂商入门级云实例、跨架构模拟运行的环境；剩余少量场景由镜像层损坏、容器资源配额不足、架构转译配置错误导致。

• 优先验证宿主机CPU指令集支持情况，在宿主机终端执行命令grep avx2 /proc/cpuinfo，如果命令执行后无任何输出，可直接确认是AVX2指令集不兼容导致的报错。
• 若确认CPU支持AVX2，先检查本地镜像完整性，执行docker inspect yugabytedb/yugabyte查看本地镜像层哈希，排除拉取过程中断导致的镜像文件损坏问题。
• 检查Docker容器资源配额，确认分配给Yugabyte容器的内存不低于4GB、CPU核心数不低于2核，资源阈值不足时部分版本的数据库初始化逻辑会触发非法指令报错。
• 拉取容器启动全量日志，执行docker logs <对应Yugabyte容器ID>，如果日志末尾出现Illegal instruction关键字，可100%锁定为指令集执行异常问题。

• 针对CPU不支持AVX2的场景：
  • 直接替换官方提供的无AVX2依赖镜像版本启动，将启动命令或compose配置中的镜像tag替换为标注noavx的稳定版本即可正常启动，例如yugabytedb/yugabyte:2.18.0.0-b55-noavx。
  • 如果是VMware、VirtualBox等本地虚拟机环境，先关闭虚拟机，在CPU高级设置中开启AVX/AVX2指令集透传选项，保存配置重启虚拟机后再重新启动容器。
• 针对镜像损坏的场景：执行docker rmi -f yugabytedb/yugabyte删除本地损坏镜像，重新拉取官方稳定版镜像，拉取过程中保持网络连接稳定不要中断。
• 针对资源配额不足的场景：启动容器时明确指定资源阈值，docker run启动参考命令如下：

docker run -d --name yugabyte \
  -p 7000:7000 -p 9000:9000 -p 5433:5433 \
  --cpus=2 --memory=4G \
  yugabytedb/yugabyte:latest bin/yugabyted start --daemon=false

如果使用docker compose部署，在服务配置段添加资源限制即可，参考配置：

services:
  yugabyte:
    image: yugabytedb/yugabyte:latest
    ports:
      - "7000:7000"
      - "9000:9000"
      - "5433:5433"
    command: bin/yugabyted start --daemon=false
    deploy:
      resources:
        limits:
          cpus: '2'
          memory: 4G

• 针对Apple Silicon芯片Mac运行x86镜像的场景：在Docker Desktop设置中开启Rosetta 2 x86转译，或者直接拉取ARM64架构的官方原生镜像，避免跨架构转译导致的指令识别错误。

内容的提问来源于stack exchange，提问作者dark