relaysh/gcp-step-instance-list

gcp-step-instance-list 镜像文档

镜像概述

gcp-step-instance-list是一个GCP步骤容器，主要用于获取和描述Google Cloud Platform (GCP) 中的实例及其元数据信息。该镜像能够输出实例的详细属性，帮助用户了解GCP实例的配置、状态和相关元数据。

核心功能和特性

• 实例信息收集：获取GCP项目中的实例列表及其基本属性，包括实例ID、名称、状态等
• 元数据展示：提供实例的元数据详情，如指纹信息（fingerprint）、创建时间戳（creationTimestamp）、删除保护状态（deletionProtection）等
• 完整资源链接：包含实例的selfLink、zone和machineType等完整资源路径，便于进一步操作
• 标准化输出：以JSON数组格式输出实例信息，便于后续解析和处理

使用场景和适用范围

• GCP实例管理与监控：快速查看项目中所有实例的状态和配置信息
• 自动化部署流程：在CI/CD流程中集成，获取实例信息用于后续部署或扩展操作
• 实例审计与报告：收集实例元数据用于合规性检查或资源使用分析
• 故障排查：获取实例详细信息辅助诊断实例相关问题

使用方法和配置说明

前置条件

• 需配置GCP认证凭据（如通过挂载gcloud配置文件或设置服务账号密钥）
• 需具有访问GCP Compute Engine API的权限

基本使用方式

bash
docker run --rm \
  -v ~/.config/gcloud:/root/.config/gcloud \  # 挂载本地gcloud配置
  gcp-step-instance-list

环境变量（可选）

示例输出

instances 输出示例：

json
[
    {
        "id":"3900850146904586699",
        "kind":"compute#instance",
        "fingerprint":"14ejPjxPT7A=",
        "labelFingerprint":"42WmSpB8rSM=",
        "creationTimestamp":"2020-06-17T14:12:04.484-07:00",
        "deletionProtection":false,
        "description":"",
        "name":"instance-1",
        "metadata":{
            "fingerprint":"jucTflKX3gU=",
            "kind":"compute#metadata"
        },
        "selfLink":"[***]",
        "status":"TERMINATED",
        "tags":{
            "fingerprint":"42WmSpB8rSM="
        },
        "zone":"[***]",
        "machineType":"[***]"
    }
]