Gérer les environnements d'exécution

Cette page explique comment gérer un environnement d'exécution Colab Enterprise, y compris les tâches suivantes :

  • Démarrez un environnement d'exécution.
  • Arrêtez un environnement d'exécution.
  • Déconnectez-vous d'un environnement d'exécution.
  • Reconnectez-vous à un environnement d'exécution.
  • Modifiez l'environnement d'exécution auquel vous êtes connecté.
  • Supprimer un environnement d'exécution

Rôles requis

Pour obtenir les autorisations nécessaires pour gérer un environnement d'exécution Colab Enterprise, demandez à votre administrateur de vous accorder le rôle IAM Utilisateur Colab Enterprise (roles/aiplatform.colabEnterpriseUser) sur le projet. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Démarrer un environnement d'exécution

Pour démarrer un environnement d'exécution, vous pouvez utiliser la console Google Cloud , la gcloud CLI ou l'API REST.

Console

Pour démarrer un environnement d'exécution :

  1. Dans la console Google Cloud , accédez à la page Environnements d'exécution de Colab Enterprise.

    Accédez à la page "Environnements d'exécution".

  2. Dans le menu Région, sélectionnez la région qui contient votre environnement d'exécution.

  3. Sélectionnez le runtime que vous souhaitez démarrer.

  4. Cliquez sur Démarrer.

gcloud

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • RUNTIME_ID : ID de votre environnement d'exécution.
  • PROJECT_ID : ID de votre projet.
  • REGION : région où se trouve votre environnement d'exécution.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud colab runtimes start RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

gcloud colab runtimes start RUNTIME_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

gcloud colab runtimes start RUNTIME_ID ^
    --project=PROJECT_ID ^
    --region=REGION

Pour en savoir plus sur la commande permettant de créer un modèle d'exécution à partir de la ligne de commande, consultez la documentation de la gcloud CLI.

REST

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • REGION : région où se trouve votre environnement d'exécution.
  • PROJECT_ID : ID de votre projet.
  • RUNTIME_ID : ID de votre environnement d'exécution.

Méthode HTTP et URL :

POST https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Exécutez la commande suivante :

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start"

PowerShell

Exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start" | Select-Object -Expand Content
Si elle aboutit, le corps de la réponse contient une instance d'Operation.

Pour en savoir plus, reportez-vous à la. documentation de l'API REST notebookRuntimes.start.

Arrêter un environnement d'exécution

Pour arrêter un environnement d'exécution, vous pouvez utiliser la gcloud CLI ou l'API REST.

gcloud

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • RUNTIME_ID : ID de votre environnement d'exécution.
  • PROJECT_ID : ID de votre projet.
  • REGION : région où se trouve votre environnement d'exécution.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud colab runtimes stop RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

gcloud colab runtimes stop RUNTIME_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

gcloud colab runtimes stop RUNTIME_ID ^
    --project=PROJECT_ID ^
    --region=REGION

Pour en savoir plus sur la commande permettant d'arrêter un environnement d'exécution à partir de la ligne de commande, consultez la documentation de la gcloud CLI.

REST

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • REGION : région où se trouve votre environnement d'exécution.
  • PROJECT_ID : ID de votre projet.
  • RUNTIME_ID : ID de votre environnement d'exécution.

Méthode HTTP et URL :

POST https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Exécutez la commande suivante :

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d "" \
"https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start"

PowerShell

Exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method POST `
-Headers $headers `
-Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID:start" | Select-Object -Expand Content
Si elle aboutit, le corps de la réponse contient une instance d'Operation.

Pour en savoir plus, reportez-vous à la. documentation de l'API REST notebookRuntimes.stop.

Se déconnecter d'un environnement d'exécution

Pour vous déconnecter d'un environnement d'exécution :

  1. Dans la console Google Cloud , accédez à la page Mes notebooks de Colab Enterprise.

    Accéder à "Mes notebooks"

  2. Dans le menu Région, sélectionnez la région qui contient votre notebook.

  3. Ouvrez le notebook que vous souhaitez déconnecter du runtime.

  4. Dans la barre d'outils de l'en-tête, cliquez sur Exécution > Gérer les sessions. Si la barre d'outils de l'en-tête ne s'affiche pas, cliquez sur  Activer/Désactiver l'affichage de l'en-tête.

  5. Dans le volet Sessions actives, cliquez sur le bouton  Mettre fin à la session.

  6. Cliquez sur Terminer.

Se reconnecter à un environnement d'exécution

Pour vous reconnecter à un environnement d'exécution :

  1. Dans la console Google Cloud , accédez à la page Mes notebooks de Colab Enterprise.

    Accéder à "Mes notebooks"

  2. Dans le menu Région, sélectionnez la région qui contient votre notebook.

  3. Ouvrez un notebook qui a été récemment déconnecté d'un environnement d'exécution.

  4. En haut à droite du notebook, cliquez sur Reconnecter.

    Si l'environnement d'exécution auquel le notebook était précédemment connecté est toujours en cours d'exécution, Colab Enterprise s'y connecte. Si cet environnement d'exécution n'est plus en cours d'exécution, il se connecte à l'environnement d'exécution par défaut.

Modifier l'environnement d'exécution

Pour modifier l'environnement d'exécution auquel vous êtes connecté :

  1. Dans la console Google Cloud , accédez à la page Mes notebooks de Colab Enterprise.

    Accéder à "Mes notebooks"

  2. Dans le menu Région, sélectionnez la région qui contient votre notebook.

  3. Ouvrez un notebook connecté à un environnement d'exécution.

  4. En haut à droite du notebook, cliquez sur  Options de connexion supplémentaires > Modifier le type d'exécution.

  5. Remplissez la boîte de dialogue pour vous connecter à un environnement d'exécution.

Supprimer un environnement d'exécution

Pour supprimer un environnement d'exécution, vous pouvez utiliser la console Google Cloud , la gcloud CLI ou l'API REST.

Console

Pour supprimer un environnement d'exécution :

  1. Dans la console Google Cloud , accédez à la page Environnements d'exécution de Colab Enterprise.

    Accédez à la page "Environnements d'exécution".

  2. Dans le menu Région, sélectionnez la région qui contient votre environnement d'exécution.

  3. Sélectionnez le runtime que vous souhaitez supprimer.

  4. Cliquez sur  Supprimer.

  5. Cliquez sur Confirmer.

gcloud

Avant d'utiliser les données de la commande ci-dessous, effectuez les remplacements suivants :

  • RUNTIME_ID : ID de votre environnement d'exécution.
  • PROJECT_ID : ID de votre projet.
  • REGION : région où se trouve votre environnement d'exécution.

Exécutez la commande suivante :

Linux, macOS ou Cloud Shell

gcloud colab runtimes delete RUNTIME_ID \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

gcloud colab runtimes delete RUNTIME_ID `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

gcloud colab runtimes delete RUNTIME_ID ^
    --project=PROJECT_ID ^
    --region=REGION

Pour en savoir plus sur la commande permettant de créer un modèle d'exécution à partir de la ligne de commande, consultez la documentation de la gcloud CLI.

REST

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

  • REGION : région où se trouve votre environnement d'exécution.
  • PROJECT_ID : ID de votre projet.
  • RUNTIME_ID : ID de votre environnement d'exécution.

Méthode HTTP et URL :

DELETE https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Exécutez la commande suivante :

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID"

PowerShell

Exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://REGION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/notebookRuntimes/RUNTIME_ID" | Select-Object -Expand Content
Si elle aboutit, le corps de la réponse contient une instance d'Operation.

Pour en savoir plus, reportez-vous à la. documentation de l'API REST notebookRuntimes.delete.

Étapes suivantes