DL平台实例启动脚本未执行问题排查求助

算力阿峰

2026-7-15

启动脚本未运行的可能原因及解决方法

本地脚本路径错误：--metadata-from-file startup-script=gce/bootstrap.sh指定的是本地文件路径，请确认执行gcloud命令的当前目录下，是否存在gce/bootstrap.sh文件。如果路径不存在，GCE无法读取该脚本，实例上不会有启动脚本元数据，自然不会执行。

元数据参数格式问题：多个--metadata-from-file键值对用逗号分隔可能出现解析异常，建议拆分为两个独立参数：

gcloud compute instances create $(INSTANCE) \
    --machine-type a2-highgpu-1g \
    --provisioning-model=SPOT \
    --image-family $(IMAGE) \
    --image-project deeplearning-platform-release \
    --metadata install-nvidia-driver=True \
    --metadata-from-file startup-script=gce/bootstrap.sh \
    --metadata-from-file code=/tmp/code.tar

启动脚本服务状态异常：登录实例后，先检查启动脚本服务是否存在并启用：
```
sudo systemctl status google-startup-scripts.service
```
如果服务未启用，手动启动并实时查看日志：
```
sudo systemctl start google-startup-scripts.service
sudo journalctl -u google-startup-scripts.service -f
```
脚本内容或权限问题：即使脚本成功上传，若存在语法错误、缺少可执行权限，可能导致执行失败。可以先在本地检查脚本语法（比如bash脚本用bash -n gce/bootstrap.sh），或登录实例后查看元数据中的脚本内容：
```
curl http://metadata.google.internal/computeMetadata/v1/instance/attributes/startup-script -H "Metadata-Flavor: Google"
```
确认脚本是否正确传入。