Recomendador geral sobre alterações interruptivas e descontinuações do Cloud

Visualização

Esse recurso está sujeito aos "Termos de ofertas pré-GA" na seção "Termos de Serviço gerais" dos Termos específicos de serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

O recomendador geral sobre alterações interruptivas e descontinuações do Cloud fornece recomendações sobre alterações interruptivas e descontinuações do Cloud. Ele identifica os recursos do Cloud que serão afetados por descontinuações e alterações interruptivas futuras, além de fornecer diretrizes sobre como gerenciá-los. As recomendações podem ser consultadas na CLI do Google Cloud, na API e no BigQuery Export.

Antes de começar

1. 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.

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

   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

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Recommender API.

   Enable the API

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

   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

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Recommender API.

   Enable the API

Observação: você só precisa ativar a API em um único projeto de faturamento. Esse projeto de faturamento pode ser usado para recuperar recomendações e insights de outros projetos, de toda a organização ou da conta de faturamento com a flag --billing-project.

4. Verifique se você tem os seguintes papéis:

Descrição	Papéis
Ver recomendações	recommender.cloudDeprecationRecommendationViewer
Ver e atualizar recomendações	recommender.cloudDeprecationRecommendationAdmin

Funções exigidas

Nesta seção, descrevemos os papéis e as permissões necessárias para usar o recomendador geral sobre alterações interruptivas e descontinuações do Cloud.

Papel	Permissões incluídas
roles/recommender.cloudDeprecationRecommendationViewer	recommender.cloudDeprecationGeneralInsights.get recommender.cloudDeprecationGeneralInsights.list recommender.cloudDeprecationGeneralRecommendations.get recommender.cloudDeprecationGeneralRecommendations.list
roles/recommender.cloudDeprecationRecommendationAdmin	recommender.cloudDeprecationGeneralInsights.update recommender.cloudDeprecationGeneralRecommendations.update

Para mais informações sobre papéis e concessão de acesso, consulte:

• Como entender os papéis
• Gerenciar o acesso a projetos, pastas e organizações

Preços

O recomendador geral sobre alterações interruptivas e descontinuações do Cloud é oferecido sem custo financeiro. Para informações sobre outros níveis de preço, consulte Preços do recomendador.

Consultar as recomendações de descontinuação do Cloud

É possível listar recomendações usando o console, a Google Cloud CLI, a API Recommender ou o BigQuery Export.

Console

1. Acesse o Hub de recomendações.

   Acesse o Hub de recomendações

2. Defina o Campo de filtro como Recommender:google.cloud.deprecation.GeneralRecommender.

   Observação: você precisa ter as permissões de IAM corretas (listadas acima) para ver as recomendações. Se você tiver as permissões corretas e a página não mostrar recomendações, isso significa que o projeto não terá descontinuações ou alterações interruptivas que atendam aos critérios de uma recomendação.
   .

Google Cloud CLI

Esta guia mostra os comandos para listar recomendações e insights com a CLI do Google Cloud.

• Listar recomendações

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

• Listar insights

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

Substitua:

• BILLING_PROJECT_ID pelo ID do projeto que você ativou com a API Recommender.
• PROJECT_ID pelo identificador do projeto do Google Cloud.
• LOCATION pelo local do Google Cloud em que os recursos associados às recomendações estão (por exemplo, global ou us-central1-a).

API

Esta guia mostra os comandos para listar recomendações e insights com a API Recommender.

• Listar recomendações

  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"
  

• Listar insights

  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"
  

Substitua:

• BILLING_PROJECT_ID pelo ID do projeto que você ativou com a API Recommender.
• PROJECT_ID pelo identificador do projeto do Google Cloud.
• LOCATION pelo local do Google Cloud em que os recursos associados às recomendações estão (por exemplo, global ou us-central1-a).

Exportação para o BigQuery

Esta guia mostra os comandos para listar recomendações com o BigQuery Export.

As recomendações de descontinuação do Cloud também estão incluídas no BigQuery Export. Com a exportação do BigQuery, é possível ver snapshots diários de recomendações para sua organização.

1. Siga a documentação do BigQuery Export para exportar recomendações para o BigQuery.

2. Consulte todas as recomendações de descontinuação:

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

Subtipos de recomendação disponíveis

Na tabela a seguir, descrevemos os subtipos de recomendação disponíveis e que podem ser divulgados.

Subtipo	Descontinuação ou alteração interruptiva?
GCE_METADATA_SERVER_HEADER_WHITESPACE	O Compute Engine aplicará verificações de formatação de solicitações HTTP no serviço de metadados do Compute Engine para alinhamento com a Seção 3.2 da RFC 7230, uma vez que aceitar solicitações formatadas incorretamente pode causar vulnerabilidades de segurança.

Aviso: as recomendações dispensadas não são geradas novamente e ocultam a recomendação de descontinuação da instância em todas as plataformas. Em vez de fazer isso, marque a recomendação como "bem-sucedida" depois de aplicá-la.

Esta tabela não é abrangente e pode omitir intencionalmente descontinuações ou alterações interruptivas que exigem segurança.