Configure o Gemini Cloud Assist no Cloud Billing

Para configurar o Gemini Cloud Assist na Faturação do Google Cloud, execute os seguintes passos:

  1. Ative a API Gemini Cloud Assist num Google Cloud projeto. Normalmente, um administrador realiza este passo.

  2. No Google Cloud projeto, conceda funções de gestão de identidade e acesso (IAM) aos mesmos utilizadores que acedem aos dados de custos e utilização da Cloud Billing. Normalmente, um administrador realiza este passo.

  3. Para os utilizadores que precisam de acesso aos dados do Cloud Billing e ao Gemini Cloud Assist no Cloud Billing, conceda funções da IAM na conta do Cloud Billing associada ao projeto onde a API Gemini Cloud Assist está ativada. Normalmente, um administrador executa este passo.

Ative a API Gemini Cloud Assist num Google Cloud projeto

Esta secção descreve os passos necessários para ativar a API Gemini Cloud Assist num Google Cloud projeto.

Consola

  1. Para ativar a API Gemini Cloud Assist, aceda à página API Gemini Cloud Assist.

    Aceda à API Gemini Cloud Assist

  2. No seletor de projetos, selecione o projeto que quer usar como projeto "Gemini".

    Pode ativar a API Gemini Cloud Assist em mais do que um projeto. Para os utilizadores do Cloud Billing que têm autorizações ao nível da conta de faturação na conta do Cloud Billing, recomendamos que use um projeto de administração de FinOps para conter a API.

  3. Clique em Ativar.

    A página é atualizada e mostra o estado API ativada.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

  2. No menu do seletor de projetos, selecione o projeto que quer usar como projeto "Gemini".

    Pode ativar a API Gemini Cloud Assist em mais do que um projeto. Para os utilizadores do Cloud Billing que têm autorizações ao nível da conta de faturação na conta do Cloud Billing, recomendamos que use um projeto de administração de FinOps para conter a API.

  3. Ative a API Gemini Cloud Assist através do comando gcloud services enable:

    gcloud services enable geminicloudassist.googleapis.com

    Se quiser ativar a API Gemini Cloud Assist num Google Cloud projeto diferente, adicione o parâmetro --project:

    gcloud services enable geminicloudassist.googleapis.com --project PROJECT_ID

    Substitua PROJECT_ID pelo ID do seu Google Cloud projeto.

    O resultado é semelhante ao seguinte:

    Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.

Depois de ativar a API Gemini Cloud Assist noGoogle Cloud projeto especificado, o Gemini Cloud Assist fica disponível para todos os utilizadores que tenham as funções do IAM necessárias no projeto especificado.

Conceda funções de IAM num Google Cloud projeto

Esta secção descreve os passos para conceder as autorizações do projeto necessárias para usar o Gemini Cloud Assist. No Google Cloud projeto onde ativou a API Gemini Cloud Assist, conceda as seguintes funções do IAM aos utilizadores (principais) no projeto:

  • Utilizador do Gemini Cloud Assist
  • Consumidor da utilização do serviço

Consola

  1. Para conceder as funções de IAM necessárias para usar o Gemini Cloud Assist, aceda à página IAM e administração.

    Aceda a IAM e administração

  2. Na coluna Principal, encontre um principal para o qual quer ativar o acesso ao Gemini Cloud Assist e, em seguida, clique em Editar principal nessa linha.

  3. No painel Editar acesso, clique em Adicionar outra função.

  4. Em Selecionar uma função, selecione Utilizador do Gemini Cloud Assist.

  5. Clique em Adicionar outra função e selecione Consumidor de utilização de serviços.

  6. Clique em Guardar.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

  2. No menu do seletor de projetos, selecione um projeto.

  3. Conceda a função Utilizador do Gemini Cloud Assist:

    gcloud projects add-iam-policy-binding PROJECT_ID \
  --member=PRINCIPAL --role=roles/geminicloudassist.user

    Substitua o seguinte:

    • PROJECT_ID: o ID do seu projeto Google Cloud , por exemplo,1234567890.
    • PRINCIPAL: o identificador do principal, por exemplo, user:cloudysanfrancisco@gmail.com.

    A saída é uma lista de associações de políticas que inclui o seguinte:

    - members:
  - user:PRINCIPAL
  role: roles/geminicloudassist.user

  4. Repita o passo anterior para a função roles/serviceusage.serviceUsageConsumer.

    5. Para mais informações, consulte os artigos Conceda uma única função e gcloud projects add-iam-policy-binding.

Todos os utilizadores (diretores) aos quais estas funções são concedidas podem aceder às funcionalidades do Gemini Cloud Assist na consola no projeto especificado. Google Cloud Se os utilizadores do projeto também tiverem acesso para ver os dados do Cloud Billing, podem usar o Gemini Cloud Assist nos relatórios do Cloud Billing e no hub do FinOps para receber assistência de IA para criar relatórios de custos e resumir estatísticas importantes sobre os custos na nuvem e as recomendações de otimização. Para mais informações, consulte o artigo Vista geral do Gemini Cloud Assist no Cloud Billing.

Tarefas de configuração avançadas do IAM para projetos

Em vez de usar a Google Cloud consola ou a CLI gcloud para conceder funções predefinidas do IAM num projeto, pode fazer qualquer uma das seguintes ações:

  • Use APIs REST IAM ou bibliotecas cliente IAM para conceder funções.

    Se usar estas interfaces, use os nomes de funções totalmente qualificados:

    • roles/geminicloudassist.user
    • roles/serviceusage.serviceUsageConsumer

    Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

  • Crie e conceda funções personalizadas.

    Todas as funções personalizadas para autorizações ao nível do projeto que criar precisam das seguintes autorizações para aceder ao Gemini Cloud Assist:

    • geminicloudassist.companions.generateChat
    • geminicloudassist.companions.generateCode
    • serviceusage.services.use

Conceda funções do IAM numa conta do Cloud Billing

Para os utilizadores que precisam de acesso aos dados de custos do Cloud Billing, tem de conceder autorizações na conta do Cloud Billing adequadas para aceder à página Relatórios e ao hub do FinOps. Para usar o Gemini Cloud Assist no Cloud Billing, conceda aos utilizadores acesso à conta do Cloud Billing que está associada ao projeto onde a API Gemini Cloud Assist está ativada.

O que se segue?