Avant que vous puissiez utiliser Gemini Cloud Assist, votre administrateur doit suivre la procédure de configuration décrite dans ce document. Gemini Cloud Assist peut être configuré pour un projet ou un dossier.
Configurer Gemini Cloud Assist pour un projet
Les étapes suivantes expliquent comment configurer Gemini Cloud Assist pour un projet dans la console Google Cloud ou à l'aide de la CLI Google Cloud.
Console
Accédez à la page Administration pour Gemini.
Dans le sélecteur de projets situé en haut de la page, sélectionnez la ressource de votre projet.
Sélectionnez Obtenir Gemini Cloud Assist.
Dans la boîte de dialogue Obtenir l'assistance Gemini Cloud, procédez comme suit:
Sélectionnez la flèche d'expansion
dans la section API requises et recommandées.Assurez-vous que les API requises suivantes sont activées: l'API Gemini Cloud Assist et l'API Gemini pour Google Cloud.
Dans la liste API recommandées, sélectionnez les API que vous souhaitez activer.
Facultatif: sélectionnez Aidez Google à améliorer Cloud Assist en partageant vos requêtes et réponses.
Sélectionnez Activer Gemini Cloud Assist sans frais.
Cliquez sur Enregistrer.
Attribuez les rôles IAM requis pour utiliser Gemini Cloud Assist.
Accédez à la page IAM et administration.
Dans la colonne Compte principal, recherchez un compte principal auquel vous souhaitez accorder l'accès à Gemini Cloud Assist, puis cliquez sur Modifier le compte principal sur cette ligne.
Dans le volet Modifier les accès, cliquez sur
Ajouter un autre rôle.Dans Sélectionner un rôle, sélectionnez Utilisateur de Gemini Cloud Assist.
Cliquez sur Ajouter un autre rôle, puis sélectionnez Lecteur du recommender.
Si le principal souhaite obtenir de l'aide concernant des produits auxquels il n'a pas encore accès, vous devrez peut-être lui accorder des rôles IAM supplémentaires. Consultez les Exigences IAM pour utiliser Gemini Cloud Assist pour obtenir un tableau des rôles IAM qui permettent une expérience optimale de Gemini Cloud Assist pour différents produits.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
Activez l'API Gemini Cloud Assist à l'aide de la commande
gcloud services enable
:gcloud services enable geminicloudassist.googleapis.com
Cette étape active également l'API Gemini pour Google Cloud, qui est également requise pour utiliser Gemini Cloud Assist.
Si vous souhaitez activer l'API Gemini Cloud Assist dans un autre projet Google Cloud, ajoutez le paramètre
--project
:gcloud services enable geminicloudassist.googleapis.com --project PROJECT_ID
Le résultat ressemble à ce qui suit :
Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete... Operation finished successfully.
Attribuez des rôles IAM dans un projet Google Cloud. Pour en savoir plus, consultez les sections Attribuer un seul rôle et
gcloud projects add-iam-policy-binding
.Attribuez le rôle
roles/geminicloudassist.user
:gcloud projects add-iam-policy-binding PROJECT_ID \ --member=PRINCIPAL --role=roles/geminicloudassist.user
Remplacez
PRINCIPAL
par l'identifiant du compte principal. L'identifiant se présente sous la formeuser|group|serviceAccount:email
oudomain:domain
(par exemple,user:cloudysanfrancisco@gmail.com
,group:admins@example.com
,serviceAccount:test123@example.domain.com
oudomain:example.domain.com
.Le résultat est une liste de liaisons de stratégie qui incluent les éléments suivants :
- members: - user:PRINCIPAL role: roles/geminicloudassist.user
Répétez l'étape précédente pour le rôle
roles/recommender.viewer
.
Si le principal souhaite obtenir de l'aide concernant des produits auxquels il n'a pas encore accès, vous devrez peut-être lui accorder des rôles IAM supplémentaires. Consultez les Exigences IAM pour utiliser Gemini Cloud Assist pour obtenir un tableau des rôles IAM qui permettent une expérience optimale de Gemini Cloud Assist pour différents produits.
Configurer Gemini Cloud Assist pour un dossier
Les étapes suivantes expliquent comment configurer Gemini Cloud Assist pour un dossier dans la console Google Cloud. Vous ne pouvez pas utiliser Google Cloud CLI pour configurer Gemini Cloud Assist.
Activez les API requises et recommandées.
Accédez à la page Administration pour Gemini.
Dans le sélecteur de projets situé en haut de la page, sélectionnez votre ressource de dossier.
Sélectionnez Obtenir des assistances Gemini Cloud.
La boîte de dialogue Enable API for existing projects within folder (Activer l'API pour les projets existants dans le dossier) s'affiche.
Dans la boîte de dialogue Activer l'API pour les projets existants dans un dossier,sélectionnez la flèche d'expansion
dans la section API requises et recommandées.Assurez-vous que les API requises suivantes sont activées: l'API Gemini Cloud Assist et l'API Gemini pour Google Cloud.
Dans la liste API recommandées, sélectionnez les API que vous souhaitez activer.
Facultatif: sélectionnez Aidez Google à améliorer Cloud Assist en partageant vos requêtes et réponses.
Sélectionnez Activer Gemini Cloud Assist sans frais.
Cette étape active les API requises et recommandées sélectionnées pour tous les projets du dossier. Si vous souhaitez des exceptions pour certains projets du dossier, vous pouvez bloquer l'activation des API en définissant une contrainte de règle d'administration Restreindre l'utilisation des services de ressources sur ces projets. Pour en savoir plus, consultez la section Limiter l'utilisation des ressources.
Accordez les rôles IAM suivants ou créez des rôles personnalisés avec des autorisations équivalentes sur le dossier:
- Utilisateur Gemini pour Google Cloud
- Lecteur d'éléments Cloud
- Visionneuse de l'outil de recommandation
Si le principal souhaite obtenir de l'aide concernant des produits auxquels il n'a pas encore accès, vous devrez peut-être lui accorder des rôles IAM supplémentaires. Consultez les Exigences IAM pour utiliser Gemini Cloud Assist pour obtenir un tableau des rôles IAM qui permettent une expérience optimale de Gemini Cloud Assist pour différents produits.
Si vous utilisez Gemini Cloud Assist avec des applications, vous devez également activer la gestion des applications. Cette étape crée un projet de gestion auquel vous devez associer un compte de facturation.
Revenez à la page Administration pour Gemini.
Sélectionnez Activer la gestion des applications.
La page des paramètres IAM et administration s'affiche.
Sélectionnez Activer dans la section Activation de l'application de la page.
La boîte de dialogue Activer les API d'applications pour ce dossier s'affiche.
Sélectionnez Activer.
Une barre d'état indique la progression de l'activation de l'API. La page des paramètres IAM et administration s'actualise une fois l'activation de l'API terminée.
Sélectionnez Gérer la facturation.
La page Compte associé s'affiche.
Sélectionnez un compte de facturation dans la liste, puis sélectionnez Définir le compte.
Accordez les rôles IAM que vous avez accordés au dossier à l'étape 2, ou créez des rôles personnalisés avec des autorisations équivalentes à celles du projet de gestion créé à l'étape précédente.
Recherchez le projet de gestion du dossier:
Revenez à la page Administration pour Gemini.
Dans le sélecteur de projets situé en haut de la page, sélectionnez votre ressource de dossier.
Sélectionnez Gérer les paramètres de Gemini Cloud Assist.
La boîte de dialogue Gérer Gemini Cloud Assist s'affiche.
Notez le projet de gestion.
(Facultatif) Configurez les paramètres des projets du dossier.
Étape suivante
- Découvrez comment analyser et optimiser vos ressources cloud avec l'aide de Gemini.