AWS CodeDeploy执行screen命令报错：Must be connected to a terminal

Bitbucket CI/CD流水线通过AWS CodeDeploy执行部署脚本时，screen命令报错Must be connected to a terminal，本地直接运行脚本正常。

相关配置 #

appspec.yml

version: 0.0
os: linux

files:
  - source: scripts/osgi-deploy.sh
    destination: /home/jboss
    overwrite: true
file_exists_behavior: OVERWRITE
hooks:
  AfterInstall:
    - location: scripts/osgi-deploy.sh
      timeout: 180
      runas: jboss

osgi-deploy.sh

echo "about to deploy to osgi-app ($USER) ..."
screen -d -m -R "karaf" bash /home/jboss/scripts/build-start-osgi.sh &

报错输出 #

about to deploy to osgi-app (jboss) ...
Must be connected to a terminal.

原因 #

AWS CodeDeploy的Hook进程运行在无TTY的非交互式环境中，screen作为终端复用工具，即使使用-d -m参数，部分系统仍会检查终端存在性，触发报错。

解决方案 #

方案1：调整screen命令参数并模拟终端环境 #

修改osgi-deploy.sh中的screen命令，添加终端环境变量并使用更适配无头环境的参数：

echo "about to deploy to osgi-app ($USER) ..."
TERM=xterm screen -dmS karaf bash /home/jboss/scripts/build-start-osgi.sh

• TERM=xterm：模拟终端环境，绕过终端检查
• -dmS：组合参数直接后台创建并分离会话，避免-R恢复会话时的终端依赖

方案2：改用nohup实现后台运行（轻量替代） #

如果不需要终端复用功能，nohup更适合无头环境：

echo "about to deploy to osgi-app ($USER) ..."
nohup bash /home/jboss/scripts/build-start-osgi.sh > /home/jboss/osgi-start.log 2>&1 &

• 进程脱离终端，忽略挂起信号
• 输出重定向到日志文件，方便后续排查问题

方案3：用systemd托管服务（生产环境推荐） #

对于长期运行的服务，systemd能提供进程监控、开机自启等能力，彻底摆脱终端依赖：

1. 创建systemd服务文件/etc/systemd/system/karaf-osgi.service（需root权限）：

[Unit]
Description=Karaf OSGI Service
After=network.target

[Service]
User=jboss
WorkingDirectory=/home/jboss
ExecStart=/home/jboss/scripts/build-start-osgi.sh
Restart=always
RestartSec=5
StandardOutput=journal+console
StandardError=journal+console

[Install]
WantedBy=multi-user.target

2. 修改osgi-deploy.sh脚本：

echo "about to deploy to osgi-app ($USER) ..."
sudo systemctl daemon-reload
sudo systemctl enable --now karaf-osgi.service

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