クラウドの非推奨と破壊的変更に関する一般的な推奨事項

プレビュー版

この機能は、 サービス固有の規約の対象となります。 一般提供前（pre-GA）の機能は「現状のまま」で提供されるものであり、サポートが制限されることがあります。 詳細については、リリース ステージの説明をご覧ください。

クラウドの非推奨と破壊的変更に関する一般的な推奨事項では、クラウドの非推奨と破壊的変更に関する推奨事項が提示されます。今後の非推奨と破壊的変更の影響を受ける Cloud リソースが特定され、それらを管理するためのガイドラインが示されます。推奨事項は、Google Cloud CLI、API、BigQuery へのエクスポートを通じて確認できます。

始める前に

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Recommender API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Enable the Recommender API.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the API

注: API は、1 つの課金プロジェクトで有効にするだけで済みます。この課金プロジェクトと --billing-project フラグを使用することによって、組織全体または請求先アカウント全体の他のプロジェクトの推奨事項と分析情報を取得できます。
4. 以下のロールがあることを確認してください。

説明	ロール
レコメンデーションを表示	recommender.cloudDeprecationRecommendationViewer
推奨事項の表示と更新	recommender.cloudDeprecationRecommendationAdmin

必要なロール

このセクションでは、クラウドの非推奨と破壊的変更に関する全般的な推奨事項を使用するためのロールと必要な権限について説明します。

ロール	含まれる権限
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 の料金をご覧ください。

クラウドの非推奨に関する推奨事項を確認する

コンソール、Google Cloud CLI、Recommender API、または BigQuery エクスポートを使用して、推奨事項のリストを取得できます。

コンソール

1. Active Assist に移動します。

   Active Assist に移動する

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 プロジェクトの ID に置き換えます。
• 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 プロジェクトの ID に置き換えます。
• LOCATION は、推奨事項に関連付けられているリソースがある Google Cloud ロケーション（global、us-central1-a など）に置き換えます。

BigQuery Export

このタブでは、BigQuery へのエクスポートを使用して推奨事項と分析情報のリストを取得するコマンドを示します。

BigQuery へのエクスポートには、クラウドの非推奨に関する推奨事項も含まれています。BigQuery へのエクスポートでは、組織に対する推奨事項の日次スナップショットを表示できます。

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 メタデータ サービスで RFC 7230 のセクション 3.2 に沿って HTTP リクエスト フォーマット チェックを適用します。フォーマットが正しくないリクエストを受け入れると、セキュリティの脆弱性につながる可能性があります。

警告: 推奨事項を拒否すると、その推奨事項は再生成されなくなり、すべての場所のインスタンスでその非推奨の推奨事項は表示されなくなります。したがって、推奨事項を適用したら成功とマークしてください。

この表は包括的なものではなく、セキュリティ関連の非推奨や破壊的変更は意図的に省略されている場合があります。