Google Cloud Functions 中默认项目凭据的变更及应对方案

本文旨在探讨 Google Cloud Functions 中默认项目凭据不再隐式生效的问题。我们将分析这一变化可能的原因，并根据实际情况提供相应的解决方案，帮助开发者了解何时需要显式指定项目 ID，以及如何平滑过渡，避免影响现有生产环境中的 Cloud Functions。

背景：隐式项目 ID 的消失

在 Google Cloud Functions 的早期版本中，如果在使用诸如 google-cloud-storage 等 GCP 客户端库时未显式提供项目 ID，函数会自动使用部署时所在的项目 ID 作为默认值。这简化了开发流程，尤其是在多个函数部署在同一项目下时。然而，这种隐式行为现在似乎已经发生了改变。

问题分析：为何需要显式指定项目 ID？

根据观察和经验，可能的原因如下：

1. ADC (Application Default Credentials) 的变化： 官方文档中可能已经不再强调或支持这种隐式的项目 ID 默认行为。
2. 客户端库的更新： 虽然 google-cloud-storage 的更新日志中没有明确提及此项变更，但内部实现可能已经调整，不再依赖隐式项目 ID。
3. 安全性和权限控制： 显式指定项目 ID 可以增强安全性和权限控制，避免潜在的跨项目资源访问问题。

解决方案：评估与调整

是否需要更新所有 Cloud Functions 取决于函数内部的具体操作。以下是一些需要考虑的关键点：

• 资源操作类型：

  • 读取和写入 Bucket： 对于简单的读取和写入 Bucket 操作，通常不需要指定项目 ID，因为 Bucket 是全局资源。
  • 创建 Bucket： 如果函数需要创建新的 Bucket，则必须指定项目 ID，因为创建 Bucket 需要指定 Bucket 所在的宿主项目。
  • 其他 GCP 资源操作： 对于其他需要项目 ID 的 GCP 资源操作（例如，Cloud SQL 实例操作、BigQuery 数据集操作等），也需要显式指定项目 ID。

• 代码示例：

  如果你的代码类似以下示例，则可能需要更新：

  

  AI Surge Cloud

  低代码数据分析平台，帮助企业快速交付深度数据

  57

  查看详情

  from google.cloud import storage
  
  # 原始代码 (可能不再有效)
  storage_client = storage.Client()
  bucket = storage_client.bucket("your-bucket-name")
  
  # 修改后的代码 (显式指定项目 ID)
  storage_client = storage.Client(project="your-project-id")
  bucket = storage_client.bucket("your-bucket-name")

  登录后复制

• 逐步更新：

  建议采用逐步更新的策略，先对部分函数进行测试，确认修改后的代码能够正常工作，再逐步推广到所有函数。

如何获取项目 ID

在 Cloud Functions 中，可以通过多种方式获取项目 ID：

1. 环境变量： Cloud Functions 默认提供环境变量 GCP_PROJECT，其中包含当前函数的项目 ID。

   import os
   
   project_id = os.environ.get("GCP_PROJECT")
   storage_client = storage.Client(project=project_id)

   登录后复制

2. Metadata Server： 可以通过 Metadata Server 获取项目 ID。

   import google.auth
   
   credentials, project_id = google.auth.default()
   storage_client = storage.Client(project=project_id)

   登录后复制

最佳实践

• 使用环境变量： 优先使用环境变量 GCP_PROJECT 获取项目 ID，避免硬编码。
• 集中管理项目 ID： 如果多个函数使用相同的项目 ID，可以考虑将项目 ID 存储在统一的配置管理系统中，方便统一管理和更新。
• 服务账号： 为每个 Cloud Function 分配独立的 Service Account，并授予最小权限，提高安全性。
• 测试与监控： 在更新 Cloud Functions 后，进行充分的测试，并监控函数的运行状态，确保一切正常。

总结

虽然 Google Cloud Functions 中默认项目凭据的变更可能需要一些额外的调整，但通过理解其背后的原因，并采取相应的解决方案，可以平滑过渡，避免影响现有生产环境。 重要的是评估每个函数的操作类型，并根据需要显式指定项目 ID，以确保函数的正常运行。

以上就是Google Cloud Functions 中默认项目凭据的变更及应对方案的详细内容，更多请关注php中文网其它相关文章！