Cloud 弃用和破坏性更改常规 Recommender

预览

此功能须遵守服务专用条款的“通用服务条款”部分中的“非正式版产品条款”。 非正式版功能“按原样”提供，可能只能获得有限的支持。 如需了解详情，请参阅发布阶段说明。

Cloud 弃用和重大更改 Recommender 提供了有关 Cloud 弃用和重大更改的建议。它确定了将受到即将弃用和重大更改影响的 Cloud 资源，同时提供了有关如何管理这些资源的准则。您可以通过 Google Cloud CLI、API 和 BigQuery 导出功能查看建议。

须知事项

1. 登录您的 Google Cloud 账号。如果您是 Google Cloud 新手，请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

2. 在 Google Cloud Console 中的项目选择器页面上，选择或创建一个 Google Cloud 项目。

   注意：如果您不打算保留在此过程中创建的资源，请创建新的项目，而不要选择现有的项目。完成本教程介绍的步骤后，您可以删除所创建的项目，并移除与该项目关联的所有资源。

   转到“项目选择器”

3. 确保您的 Google Cloud 项目已启用结算功能。

4. 启用 Recommender API。

   启用 API

5. 在 Google Cloud Console 中的项目选择器页面上，选择或创建一个 Google Cloud 项目。

   注意：如果您不打算保留在此过程中创建的资源，请创建新的项目，而不要选择现有的项目。完成本教程介绍的步骤后，您可以删除所创建的项目，并移除与该项目关联的所有资源。

   转到“项目选择器”

6. 确保您的 Google Cloud 项目已启用结算功能。

7. 启用 Recommender API。

   启用 API

注意：您只需在单个结算项目上启用该 API。然后，您可以使用此结算项目和 --billing-project 标志检索其他项目、整个组织或结算账号的建议和数据分析。

4. 确保您拥有以下角色：

说明	角色
查看建议	recommender.cloudDeprecationRecommendationViewer
查看和更新建议	recommender.cloudDeprecationRecommendationAdmin

所需的角色

本部分介绍使用 Cloud 弃用和破坏性更改常规 Recommender 的角色和必要权限。

角色	包含的权限
roles/recommender.cloudDeprecationRecommendationViewer	recommender.cloudDeprecationGeneralInsights.get recommender.cloudDeprecationGeneralInsights.list recommender.cloudDeprecationGeneralRecommendations.get recommender.cloudDeprecationGeneralRecommendations.list
roles/recommender.cloudDeprecationRecommendationAdmin	recommender.cloudDeprecationGeneralInsights.update recommender.cloudDeprecationGeneralRecommendations.update

如需详细了解角色以及如何授予访问权限，请参阅以下内容：

• 了解角色
• 管理对项目、文件夹和组织的访问权限

价格

云弃用和重大更改 Recommender 可免费使用。如需了解其他价格层级，请参阅 Recommender 价格。

查看云弃用建议

您可以使用控制台、Google Cloud CLI、Recommender API 或通过 BigQuery Export 列出建议。

控制台

1. 转到 Recommendation Hub。

   前往 Recommendation Hub

2. 将过滤条件字段设置为 Recommender:google.cloud.deprecation.GeneralRecommender。

   注意：您必须拥有正确的 IAM 权限（上文列出）才能查看建议。如果您拥有正确的权限，并且页面未显示任何建议，则表示项目没有任何满足建议的条件的弃用或破坏性更改。

Google Cloud CLI

此标签页显示了使用 Google Cloud CLI 列出建议和数据分析的命令。

• 列出建议

  gcloud recommender recommendations list \
    --billing-project=BILLING_PROJECT_ID  \
    --project=PROJECT_ID  \
    --location=LOCATION  \
    --recommender=google.cloud.deprecation.GeneralRecommender \
    --format=yaml
  

• 列出数据分析

  gcloud recommender insights list \
    --billing-project=BILLING_PROJECT_ID  \
    --project=PROJECT_ID  \
    --location=LOCATION  \
    --insight-type=google.cloud.deprecation.GeneralInsight \
    --format=yaml
  

替换以下内容：

• 将 BILLING_PROJECT_ID 替换为已启用 Recommender API 的项目的 ID。
• 将 PROJECT_ID 替换为您的 Google Cloud 项目的标识符。
• 将 LOCATION 替换为与建议关联的资源所在的 Google Cloud 位置（例如，global 或 us-central1-a）。

API

此标签页会显示您使用 Recommender API 列出建议和数据分析的命令。

• 列出建议

  curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "x-goog-user-project: BILLING_PROJECT_ID " \
  "https://recommender.googleapis.com/v1/projects/PROJECT_ID /locations/LOCATION /recommenders/google.cloud.deprecation.GeneralRecommender/recommendations"
  

• 列出数据分析

  curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "x-goog-user-project: BILLING_PROJECT_ID " \
  "https://recommender.googleapis.com/v1/projects/PROJECT_ID /locations/LOCATION /insightTypes/google.cloud.deprecation.GeneralInsight/insights"
  

替换以下内容：

• 将 BILLING_PROJECT_ID 替换为已启用 Recommender API 的项目的 ID。
• 将 PROJECT_ID 替换为您的 Google Cloud 项目的标识符。
• 将 LOCATION 替换为与建议关联的资源所在的 Google Cloud 位置（例如，global 或 us-central1-a）。

BigQuery 导出

此标签页显示了使用 BigQuery Export 来列出建议的命令。

BigQuery 导出中也包含云弃用建议。借助 BigQuery Export，您可以查看组织的建议的每日快照。

1. 按照 BigQuery 导出文档将建议导出到 BigQuery。

2. 查询所有弃用建议：

   SELECT *
   FROM `<project>.<dataset>.recommendations_export`
   WHERE DATE(_PARTITIONTIME) = "<date>"
   and recommender = "google.cloud.deprecation.GeneralRecommender"
   

可用的建议子类型

下表介绍了可用和可调度的建议子类型。

子类型	弃用还是重大更改？
GCE_METADATA_SERVER_HEADER_WHITESPACE	Compute Engine 将在 Compute Engine 元数据服务中强制执行 HTTP 请求格式检查，以符合 RFC 7230 第 3.2 节，因为接受格式错误的请求可能会导致安全性漏洞。

警告：已忽略的建议不会重新生成，并且会在所有界面上隐藏实例的弃用建议。相反，请在应用建议后将其标记为成功。

请注意，此表并不全面，并可能会有意省略对安全性敏感的弃用或重大更改。