nikolajdl/gcloud-sdk-nodejs

gcloud-sdk-nodejs

镜像概述

gcloud-sdk-nodejs是一个整合了Google Cloud SDK与Node.js运行环境的Docker镜像，旨在为开发者提供一站式的云服务开发与部署工具链。该镜像将Google Cloud平台的命令行工具（如gcloud、gsutil）与Node.js运行环境集成在同一容器中，简化了依赖配置流程。

核心功能与特性

• 双环境集成：同时包含完整的Google Cloud SDK和Node.js运行环境，无需单独安装配置
• 工具链完整：提供gcloud命令行工具、Cloud Storage工具（gsutil）及Node.js生态（node、npm）
• 环境一致性：基于官方基础镜像构建，确保开发、测试与部署环境的一致性
• 轻量便捷：精简镜像体积，适合本地开发、CI/CD流程及云环境部署

使用场景

• Google Cloud平台上的Node.js应用开发与调试
• 云资源自动化管理脚本编写（结合gcloud命令与Node.js逻辑）
• CI/CD流水线中集成云服务部署步骤（如部署Cloud Functions、App Engine应用）
• 需要同时使用Google Cloud工具和Node.js的开发环境快速搭建

使用方法

基本启动

通过以下命令启动容器并进入交互式终端：

bash
docker run -it --rm gcloud-sdk-nodejs /bin/bash

环境验证

在容器内验证环境组件是否正常工作：

bash
# 验证Google Cloud SDK版本
gcloud --version

# 验证Node.js版本
node --version

# 验证npm版本
npm --version

Google Cloud配置

交互式配置（本地开发）

首次使用需通过交互式命令配置gcloud：

bash
gcloud init

根据提示完成账号登录、项目选择及默认区域设置。

非交互式配置（CI/CD环境）

通过挂载凭据文件实现无交互登录：

bash
docker run -it --rm \
  -v /path/to/your/gcloud/credentials.json:/root/.config/gcloud/credentials.json \
  gcloud-sdk-nodejs \
  gcloud auth activate-service-account --key-file=/root/.config/gcloud/credentials.json

运行Node.js应用

在容器内创建并执行Node.js脚本：

bash
# 创建示例脚本
echo "const os = require('os'); console.log('Hostname:', os.hostname());" > app.js

# 运行脚本
node app.js

Docker Compose示例

创建docker-compose.yml配置文件：

yaml
version: '3'
services:
  gcloud-node:
    image: gcloud-sdk-nodejs
    volumes:
      - ./app:/app  # 挂载本地Node.js项目
      - ~/.config/gcloud:/root/.config/gcloud  # 共享本地gcloud配置
    working_dir: /app
    command: npm start

启动服务：

bash
docker-compose up

注意事项

• 生产环境建议使用非root用户运行容器，可通过--user参数指定用户
• 敏感凭据（如服务账号密钥）应通过环境变量或挂载文件传递，避免提交到代码仓库
• 根据项目需求选择包含特定版本的镜像标签（如指定Node.js版本或Google Cloud SDK版本）