如何通过Java API将容器部署至GCP虚拟机？

要实现GCP控制台中“将容器镜像部署到此VM实例”的功能（对应gcloud compute instances create-with-container命令），核心是为虚拟机配置容器优化操作系统（Container-Optimized OS），并通过实例元数据指定容器的启动参数。以下是具体实现方案：

所需Maven依赖 #

<dependency>
    <groupId>com.google.cloud</groupId>
    <artifactId>google-cloud-compute</artifactId>
    <version>1.21.0</version>
</dependency>

1. 使用容器优化操作系统镜像 #

容器优化OS预装了Docker和容器运行时，是GCP官方推荐的容器部署专用系统。你可以通过镜像家族获取最新稳定版：

// 获取容器优化OS镜像的自链接
String imageFamily = "cos-stable";
String imageProject = "cos-cloud";
Image image = computeClient.images().get(imageProject, imageFamily).execute();
String sourceImage = image.getSelfLink();

2. 配置容器相关元数据 #

在构建Instance对象时，通过Metadata添加容器配置参数，这部分对应gcloud命令中的各类容器选项：

Metadata metadata = Metadata.newBuilder()
    // 必填：指定容器镜像地址（支持GCR、Docker Hub等仓库）
    .addItems(Metadata.Items.newBuilder()
        .setKey("google-container-image")
        .setValue("gcr.io/your-project/your-image:tag")
        .build())
    // 可选：覆盖容器默认启动命令
    .addItems(Metadata.Items.newBuilder()
        .setKey("google-container-command")
        .setValue("java -jar app.jar")
        .build())
    // 可选：设置容器环境变量，多组用逗号分隔
    .addItems(Metadata.Items.newBuilder()
        .setKey("google-container-env")
        .setValue("ENV=production,PORT=8080")
        .build())
    // 可选：指定容器暴露端口，GCP会自动配置对应防火墙规则
    .addItems(Metadata.Items.newBuilder()
        .setKey("google-container-port")
        .setValue("8080")
        .build())
    .build();

3. 完整的实例构建与创建代码 #

将容器配置整合到你的现有VM创建逻辑中：

Instance instanceResource = Instance.newBuilder()
    .setName(instanceName)
    .setMachineType(MACHINE_TYPE)
    .addDisks(disk)
    // 绑定容器优化OS镜像
    .setSourceImage(sourceImage)
    // 添加容器配置元数据
    .setMetadata(metadata)
    // 配置网络（按需调整为你的网络）
    .addNetworkInterfaces(NetworkInterface.newBuilder()
        .setName("global/networks/default")
        .build())
    .build();

// 提交实例创建请求
computeClient.instances().insert(projectId, zone, instanceResource).execute();

核心原理说明 #

GCP的“容器部署到VM”功能本质是通过容器优化OS的google-container-agent服务读取实例元数据，自动拉取指定镜像、配置容器并启动。所有容器相关的配置都通过元数据传递，和gcloud compute instances create-with-container命令的底层逻辑完全一致。

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