container-optimized os（cos）是gcp专为容器设计的轻量、只读、自动更新linux发行版，不支持直接安装php或运行laravel，应用必须打包为容器镜像后通过gke部署。
Container-Optimized OS（COS）是 GCP 专为容器设计的轻量、只读、自动更新的 Linux 发行版，它不支持直接安装 PHP、Composer 或运行 Laravel 应用进程。你无法在 COS 节点上“配置 Laravel 11”——这不是权限或步骤问题，而是架构定位冲突：COS 只负责安全可靠地运行容器，所有应用逻辑必须打包进容器镜像里，由 Kubernetes（GKE）或 Container Registry 管理。
为什么 php -v 或 composer install 在 COS 上根本执行不了
COS 默认没有 php、composer、git、curl 等二进制文件，/usr/bin 和 /bin 下几乎全是精简过的系统工具；/etc 目录只读；apt、dnf、zypper 全部不存在。你 ssh 进去执行 php --version 会得到 bash: php: command not found，这不是环境变量没配好，是压根没装也不可能装。
正确路径：用 Docker 构建 Laravel 11 镜像，部署到 GKE
你真正要做的，是在本地或 CI 环境中构建一个包含 Laravel 11 的容器镜像，然后推送到 Google Artifact Registry 或 Container Registry，最后通过 GKE 部署。关键实操点：
- 基础镜像必须用官方 PHP 版本，例如
php:8.2-apache或更推荐的php:8.2-cli+ 自选 Web 服务器（如 Nginx Alpine） -
Dockerfile中不能出现composer create-project --no-interaction这类交互式命令——必须用COPY . /var/www/html+RUN composer install --no-dev --optimize-autoloader - Laravel 11 的
APP_KEY必须在容器启动时生成或从 Secret 注入，不能硬编码；推荐用docker-entrypoint.sh检查artisan key:generate是否已执行 - GKE Deployment 的
env字段必须映射 Secret（如数据库密码）、ConfigMap（如APP_ENV=production、APP_DEBUG=false），而不是往镜像里塞.env - Web 服务端口必须暴露为
80或8080，且健康检查路径（如/healthz）需返回 200，否则 COS 节点上的 kubelet 会反复重启 Pod
常见静默失败：GKE Pod CrashLoopBackOff 的真实原因
看到 Pod 状态是 CrashLoopBackOff，别急着改 YAML。先 kubectl logs <pod-name></pod-name>，90% 以上是以下几类：
-
PHP Fatal error: Uncaught ErrorException: require(/var/www/html/vendor/autoload.php): failed to open stream→composer install没跑成功，或VOLUME覆盖了 vendor 目录 -
SQLSTATE[HY000] [1045] Access denied for user 'root'@'10.x.x.x'→ 数据库 Secret 没挂载，或DB_HOST写成localhost（K8s 内必须用 Service 名） -
chown: changing ownership of '/var/www/html/storage': Operation not permitted→ COS 节点默认启用securityContext.fsGroup，Laravel storage 目录权限需适配，建议在 Dockerfile 末尾加RUN chgrp -R www-data /var/www/html/storage && chmod -R ug+rwx /var/www/html/storage - PHP 扩展缺失（如
mbstring），错误不会直接报出，但php artisan migrate会卡住或返回空响应 → 必须在 Dockerfile 中显式docker-php-ext-install mbstring pdo pdo_mysql xml tokenizer
最易被忽略的一点：COS 节点上的容器运行时（containerd）对 overlayfs 层有严格校验，如果你本地构建镜像用了 BuildKit（DOCKER_BUILDKIT=1）但没加 --platform linux/amd64，推到 GKE 后可能因架构不匹配直接拉取失败，日志里只显示 ImagePullBackOff，连容器都起不来。
