Créer une instance et y accéder

Créer une instance et y accéder

Créez une instance Secure Source Manager et accédez à son interface Web pour préparer la création de dépôts et l'octroi d'accès aux utilisateurs.

Remarque : Secure Source Manager n'est pas compatible avec les projets à portée de domaine. Si l'ID de votre projet contient un signe deux-points (:), vous devez créer un projet avant d'utiliser Secure Source Manager.

Avant de commencer

Connectez-vous à votre Google Cloud compte. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits sans frais pour exécuter, tester et déployer des charges de travail.

Installez Google Cloud CLI.

Remarque : Si vous avez déjà installé gcloud CLI, assurez-vous que vous disposez de la dernière version en exécutant gcloud components update.

Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à gcloud CLI avec votre identité fédérée.

Pour initialiser gcloud CLI, exécutez la commande suivante :

gcloud init

Créez ou sélectionnez un Google Cloud projet.

Rôles requis pour sélectionner ou créer un projet

• Sélectionner un projet : la sélection d'un projet ne nécessite pas de rôle IAM spécifique Vous pouvez sélectionner n'importe quel projet pour lequel un rôle vous a été attribué.
• Créer un projet : pour créer un projet, vous avez besoin du rôle Créateur de projet (roles/resourcemanager.projectCreator), qui contient l'autorisation resourcemanager.projects.create. Découvrez comment attribuer des rôles.

Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu d'en sélectionner un existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

• Créez un Google Cloud projet :

  gcloud projects create PROJECT_ID

  Remplacez PROJECT_ID par un nom pour le Google Cloud projet que vous créez.

• Sélectionnez le Google Cloud projet que vous avez créé :

  gcloud config set project PROJECT_ID

  Remplacez PROJECT_ID par le nom de votre Google Cloud projet.

Vérifiez que la facturation est activée pour votre Google Cloud projet.

Si ce n'est pas déjà fait, activez l'API Secure Source Manager :

Rôles requis pour activer les API

Pour activer les API, vous avez besoin de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation via le rôle Propriétaire (roles/owner). Sinon, vous pouvez obtenir cette autorisation via le rôle Administrateur d'utilisation du service (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles.

gcloud services enable securesourcemanager.googleapis.com

Installez Google Cloud CLI.

Remarque : Si vous avez déjà installé gcloud CLI, assurez-vous que vous disposez de la dernière version en exécutant gcloud components update.

Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à gcloud CLI avec votre identité fédérée.

Pour initialiser gcloud CLI, exécutez la commande suivante :

gcloud init

Créez ou sélectionnez un Google Cloud projet.

Rôles requis pour sélectionner ou créer un projet

• Sélectionner un projet : la sélection d'un projet ne nécessite pas de rôle IAM spécifique Vous pouvez sélectionner n'importe quel projet pour lequel un rôle vous a été attribué.
• Créer un projet : pour créer un projet, vous avez besoin du rôle Créateur de projet (roles/resourcemanager.projectCreator), qui contient l'autorisation resourcemanager.projects.create. Découvrez comment attribuer des rôles.

Remarque : Si vous ne comptez pas conserver les ressources créées dans cette procédure, créez un projet au lieu d'en sélectionner un existant. Après avoir suivi ces étapes, vous pouvez supprimer le projet. Cela entraîne la suppression de toutes les ressources qui lui sont associées.

• Créez un Google Cloud projet :

  gcloud projects create PROJECT_ID

  Remplacez PROJECT_ID par un nom pour le Google Cloud projet que vous créez.

• Sélectionnez le Google Cloud projet que vous avez créé :

  gcloud config set project PROJECT_ID

  Remplacez PROJECT_ID par le nom de votre Google Cloud projet.

Vérifiez que la facturation est activée pour votre Google Cloud projet.

Si ce n'est pas déjà fait, activez l'API Secure Source Manager :

Rôles requis pour activer les API

Pour activer les API, vous avez besoin de l'autorisation serviceusage.services.enable. Si vous avez créé le projet, vous disposez probablement déjà de cette autorisation via le rôle Propriétaire (roles/owner). Sinon, vous pouvez obtenir cette autorisation via le rôle Administrateur d'utilisation du service (roles/serviceusage.serviceUsageAdmin). Découvrez comment attribuer des rôles.

gcloud services enable securesourcemanager.googleapis.com

Rôles requis

Pour obtenir les autorisations nécessaires pour créer une instance Secure Source Manager, demandez à votre administrateur de vous accorder le rôle IAM Propriétaire de l'instance (roles/securesourcemanager.instanceOwner) sur le Google Cloud projet.

Remarque : Le rôle Administrateur Secure Source Manager (roles/securesourcemanager.admin) ou le rôle de base IAM Propriétaire (roles/owner) sur votre projet contient également des autorisations permettant de créer une instance. Les rôles d'administrateur ou les rôles de base ne doivent pas être attribués dans un environnement de production, mais ils peuvent l'être dans un environnement de développement ou de test.

Les rôles Secure Source Manager n'apparaissent dans la Google Cloud console que lorsqu' ils ont été attribués à un compte principal. Pour attribuer un rôle Secure Source Manager pour la première fois, consultez Attribuer et révoquer des rôles IAM.

Créer une instance

1. Exécutez la commande suivante pour créer une instance nommée my-instance dans la us-central1 région. Vous serez peut-être invité à vous authentifier auprès de gcloud CLI.

   gcloud source-manager instances create my-instance \
       --region=us-central1
   

   Où :

   • my-instance est le nom de l'instance.
   • us-central1 est la région dans laquelle vous créez l'instance.

   Une opération de longue durée de création d'instance démarre. Le résultat ressemble à ceci :

   Create request issued for [my-instance].
   done: false
   metadata:
     '@type': type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata
     apiVersion: v1
     createTime: '2023-02-27T20:57:52.315609549Z'
     requestedCancellation: false
     target: projects/PROJECT_ID/locations/us-central1/instances/my-instance
     verb: create
   name: projects/PROJECT_ID/locations/us-central1/operations/operation-1234567894561-5ec69948c0f2b-60dd727f-a9b97a2e
   

   La création de l'instance peut prendre jusqu'à 60 minutes.

2. Notez le OPERATION_NAME, qui correspond au nom complet de la ressource de l'opération reçue en réponse à votre requête. Il présente le format suivant et est requis lors de la vérification de l'état de l'opération à l'étape suivante :

   projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID

   Par exemple : projects/PROJECT_ID/locations/us-central1/operations/operation-1234567894561-5ec69948c0f2b-60dd727f-a9b97a2e où PROJECT_ID correspond à votre Google Cloud projet.

3. Vérifiez l'état de l'opération create en exécutant la commande suivante :

   gcloud source-manager operations describe OPERATION_NAME \
       --region=us-central1
   

   Remplacez OPERATION_NAME par le nom d'opération renvoyé dans la réponse de votre commande de création.

   Une fois l'instance prête, la réponse se présente comme suit :

   {
   "name": "projects/PROJECT_ID/locations/us-central1/operations/operation-123456789012-5ec69948c0f2b-60dd727f-a9b97a2e",
   "metadata": {
     "@type": "type.googleapis.com/google.cloud.securesourcemanager.v1.OperationMetadata",
     "createTime": "2022-11-01T14:31:32.420469714Z",
     "endTime": "2022-11-01T14:48:34.140378114Z",
     "target": "projects/PROJECT_ID/locations/us-central1/instances/my-instance",
     "verb": "create",
     "requestedCancellation": false,
     "apiVersion": "v1"
   },
   "done": true,
   "response": {
     "@type": "type.googleapis.com/google.cloud.securesourcemanager.v1.Instance",
     "name": "projects/PROJECT_ID/locations/us-central1/instances/my-instance",
     "createTime": "2022-11-01T14:31:32.416413630Z",
     "updateTime": "2022-11-01T14:31:32.416413630Z"
     },
     "state": "ACTIVE",
     "hostConfig": {
       "html": "my-instance-098765432109.us-central1.sourcemanager.dev",
       "api": "my-instance-098765432109-api.us-central1.sourcemanager.dev",
       "gitHttp": "my-instance-098765432109-git.us-central1.sourcemanager.dev"
     }
   }
   }
   

   Où :

   • my-instance-098765432109.us-central1.sourcemanager.dev est l'URL HTML de l'instance.
   • PROJECT_ID correspond à l'ID du projet.
   Remarque : Il est possible que la vérification de l'état indique que l'opération est terminée avant que l’ instance ne soit entièrement opérationnelle. Si vous rencontrez des erreurs lors de l'accès à l' instance après sa création, attendez 60 minutes et réessayez avant de contacter l' assistance Secure Source Manager à l' [e-mail].

4. Copiez l'URL HTML à partir de la commande de vérification de l'état créée. Vous aurez besoin de cette URL pour accéder à l'instance à l'aide d'un navigateur Web.

Accéder à une instance

Une fois l'instance créée, vous pouvez y accéder via son interface Web à l'aide d'un navigateur.

Remarque : Pour créer des dépôts dans l' instance, vous avez besoin du rôle Créateur de dépôt (roles/securesourcemanager.repoCreator) sur le projet d'instance et du rôle Créateur de dépôt d'instance (roles/securesourcemanager.instanceRepositoryCreator) sur l'instance Secure Source Manager.

1. Pour obtenir l'URL HTML de votre instance, exécutez à nouveau la commande suivante :

      gcloud source-manager operations describe OPERATION_NAME \
       --region=us-central1
   

2. Copiez l'URL HTML de la réponse de la commande gcloud source-manager operations describe dans la barre d'adresse de votre navigateur.

3. Un écran OAuth 2.0 s'affiche et vous demande si vous souhaitez accorder à sourcemanager.dev l'accès à votre Google Cloud compte.

4. Cliquez sur le bouton Autoriser.

5. L'interface Web Secure Source Manager s'ouvre. Vous pouvez créer et afficher des dépôts, ainsi que tous les problèmes et demandes d'extraction associés à partir de l'interface Web.

Effectuer un nettoyage

Pour éviter que les ressources utilisées dans cette démonstration soient facturées sur votre Google Cloud compte pour les ressources utilisées sur cette page, supprimez le Google Cloud projet qui les contient.

Attention : La suppression d'un projet entraîne les effets décrits ci-dessous :

• Tout le contenu du projet est supprimé. Si vous avez utilisé un projet existant pour les tâches décrites dans ce document et que vous le supprimez, vous supprimerez également tout autre travail effectué dans le projet.
• Les ID de projets personnalisés sont perdus. Lorsque vous avez créé ce projet, vous avez peut-être créé un ID de projet personnalisé que vous souhaitez utiliser à l'avenir. Pour conserver les URL qui utilisent l'ID du projet, telle qu'une appspot.com URL, supprimez les ressources sélectionnées dans le projet au lieu de supprimer l'ensemble du projet.

Si vous envisagez d'explorer plusieurs architectures, tutoriels et guides de démarrage rapide, réutiliser des projets peut vous aider à ne pas dépasser les limites de quotas des projets.

1. Dans la Google Cloud console, accédez à la page Gérer les ressources.

   Accéder à la page "Gérer les ressources"

2. Dans la liste des projets, sélectionnez le projet que vous souhaitez supprimer, puis cliquez sur Supprimer.
3. Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez Arrêter pour supprimer le projet.

Étape suivante

• Créer et cloner un dépôt
• Accorder aux utilisateurs l'accès à l'instance
• Ajouter des utilisateurs au dépôt