如何在GitLab CI中运行本地可执行文件？执行smctl时提示未找到

核心原因 #

你遇到的./smctl: not found错误并非文件真的不存在，而是可执行文件依赖的系统库在当前容器环境中缺失。

具体来说，docker/compose:1.29.0镜像基于Alpine Linux，Alpine使用轻量级的musl libc库；而如果你的smctl是基于GNU的glibc编译的（绝大多数非Alpine环境编译的Linux程序都是如此），在Alpine容器中会找不到对应的依赖库，系统就会抛出这个极具误导性的“文件未找到”错误。

验证方法 #

可在CI脚本中添加以下命令确认依赖情况：

# 检查smctl的依赖库
ldd smctl

如果输出中出现not found的库（比如libc.so.6这类glibc相关库），即可确认是该问题。

解决办法 #

• 换用基于glibc的镜像
  将CI使用的镜像替换为Ubuntu、Debian这类基于glibc的镜像，比如：

  image: docker/compose:1.29.0-debian
  

  带-debian后缀的docker-compose镜像基于Debian（glibc环境），可兼容大多数普通Linux可执行文件。

• 在Alpine镜像中安装glibc兼容层
  若必须使用Alpine镜像，可在CI脚本中先安装glibc兼容包：

  # 安装glibc兼容层
  apk add --no-cache libc6-compat
  

  安装完成后再运行smctl即可。

• 重新编译smctl适配Alpine
  若有权限，可在Alpine环境下重新编译smctl，生成基于musl libc的可执行文件，就能直接在目标容器中运行。

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