Zugriff auf eine Laufzeitvorlage verwalten

Zugriff auf eine Laufzeitvorlage verwalten

Auf dieser Seite wird beschrieben, wie Sie den Zugriff auf eine Laufzeitvorlage in Colab Enterprise gewähren und entziehen können.

Hinweise

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 Vertex AI, Dataform, and Compute Engine APIs.

   Enable the APIs

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 Vertex AI, Dataform, and Compute Engine APIs.

   Enable the APIs

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle „Colab Enterprise Admin“ (roles/aiplatform.colabEnterpriseAdmin) für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Verwalten des Zugriffs auf eine Laufzeitvorlage benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Mindestens eine der erforderlichen Rollen enthält die Berechtigung dataform.repositories.list. Nutzer, denen die Berechtigung dataform.repositories.list oder die Rolle Code-Ersteller (roles/dataform.codeCreator) in einem Projekt gewährt wurde, können die Namen von Code-Assets in diesem Projekt mit der Dataform API oder der Dataform-Befehlszeile verwenden. Nicht-Administratoren, die BigQuery Studio verwenden, sehen nur Code-Assets, die sie erstellt haben oder für sie freigegeben wurden.

Zugriff auf eine Laufzeitvorlage gewähren

Sie können der Google Cloud Console, der Google Cloud CLI oder Terraform verwenden, um einem Nutzer Zugriff auf eine Runtime-Vorlage zu gewähren.

Console

1. Rufen Sie in der Google Cloud Console die Colab Enterprise-Seite Laufzeitvorlagen auf.

   Laufzeitvorlagen aufrufen

2. Wählen Sie im Menü Region die Region aus, in der sich Ihre Laufzeitvorlage befindet.

3. Wählen Sie im Menü Laufzeitvorlage eine Laufzeitvorlage aus. Wenn keine Laufzeitvorlagen aufgeführt sind, erstellen Sie eine Laufzeitvorlage.

4. Klicke auf  Berechtigungen.

5. Klicken Sie im Fenster Berechtigungen auf  Hauptkonto hinzufügen.

6. Geben Sie im Dialogfeld Zugriff gewähren im Feld Neue Hauptkonten ein oder mehrere durch Kommas getrennte Hauptkonten ein.

7. Schließen Sie im Menü Rolle auswählen den Dialog zum Zuweisen einer Rolle ab.

8. Optional: Klicken Sie auf  Weitere Rolle hinzufügen und wiederholen Sie den letzten Schritt.

9. Klicken Sie auf Speichern.

gcloud

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

• RUNTIME_TEMPLATE_ID: die ID Ihrer Laufzeitvorlage.
• PRINCIPAL ist das Mitglied, für das die Bindung eingefügt werden soll.
• ROLE: der Rollenname, der dem Hauptkonto zugewiesen werden soll.
• PROJECT_ID: Ihre Projekt-ID.
• REGION: die Region, in der sich die Laufzeitvorlage befindet.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud colab runtime-templates add-iam-policy-binding RUNTIME_TEMPLATE_ID \
    --member=PRINCIPAL \
    --role=ROLE \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud colab runtime-templates add-iam-policy-binding RUNTIME_TEMPLATE_ID `
    --member=PRINCIPAL `
    --role=ROLE `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud colab runtime-templates add-iam-policy-binding RUNTIME_TEMPLATE_ID ^
    --member=PRINCIPAL ^
    --role=ROLE ^
    --project=PROJECT_ID ^
    --region=REGION

Weitere Informationen zum Verwalten von IAM-Richtlinien für Laufzeitvorlagen über die Befehlszeile finden Sie in der gcloud-Befehlszeilendokumentation.

Terraform

Informationen zum Anwenden oder Entfernen einer Terraform-Konfiguration finden Sie unter Grundlegende Terraform-Befehle. Weitere Informationen finden Sie in der Anbieterreferenzdokumentation zu Terraform.

Im folgenden Beispiel wird die Terraform-Ressource google_colab_runtime_template_iam_policy verwendet, um Zugriff auf eine Colab Enterprise-Laufzeitvorlage zu gewähren.

data "google_iam_policy" "admin" {
  binding {
    role = "roles/viewer"
    members = [
      "user:[e-mail]",
    ]
  }
}

resource "google_colab_runtime_template_iam_policy" "policy" {
  project = google_colab_runtime_template.runtime-template.project
  location = google_colab_runtime_template.runtime-template.location
  runtime_template = google_colab_runtime_template.runtime-template.name
  policy_data = data.google_iam_policy.admin.policy_data
}

Colab Enterprise-Hauptkonten sind Nutzer, Gruppen oder Domains.

Sie können Nutzern, Gruppen oder Domains Zugriff gewähren. Weitere Informationen finden Sie in der folgenden Tabelle:

Hauptkonto	Beispielnutzerkonto
Einzelner Nutzer	[e-mail]
Google-Gruppe	[e-mail]
Google Workspace-Domain	example.com

Zugriff auf eine Laufzeitvorlage widerrufen

Sie können den Zugriff auf eine Runtime-Vorlage über die Google Cloud Console oder die gcloud CLI widerrufen.

Console

1. Öffnen Sie in der Google Cloud Console die Seite IAM.

   IAM aufrufen

2. Wählen Sie ein Projekt, einen Ordner oder eine Organisation aus.

3. Suchen Sie die Zeile mit dem Hauptkonto, dessen Zugriff Sie widerrufen möchten. Klicken Sie dann auf Hauptkonto bearbeiten in dieser Zeile.

   Hinweis: Übernommene Rollen können beim Bearbeiten des Zugriffs auf eine Ressource nicht bearbeitet werden. Zur Bearbeitung übernommener Rollen rufen Sie die Ressource auf, der die Rolle zugewiesen wurde.

4. Klicken Sie für die Rolle, die Sie entziehen möchten, auf die Schaltfläche Löschen und dann auf Speichern.

gcloud

Ersetzen Sie folgende Werte, bevor sie einen der Befehlsdaten verwenden:

• RUNTIME_TEMPLATE_ID: die ID Ihrer Laufzeitvorlage.
• PRINCIPAL: Das Hauptkonto, dessen Zugriff Sie widerrufen möchten.
• ROLE: die Rolle, die aus dem Hauptkonto entfernt werden soll.
• PROJECT_ID: Ihre Projekt-ID.
• REGION: die Region, in der sich die Laufzeitvorlage befindet.

Führen Sie folgenden Befehl aus:

Linux, macOS oder Cloud Shell

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud colab runtime-templates remove-iam-policy-binding RUNTIME_TEMPLATE_ID \
    --member=PRINCIPAL \
    --role=ROLE \
    --project=PROJECT_ID \
    --region=REGION

Windows (PowerShell)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud colab runtime-templates remove-iam-policy-binding RUNTIME_TEMPLATE_ID `
    --member=PRINCIPAL `
    --role=ROLE `
    --project=PROJECT_ID `
    --region=REGION

Windows (cmd.exe)

Hinweis: Prüfen Sie, ob die Google Cloud CLI mit Authentifizierung und einem Projekt initialisiert wurde. Führen Sie dazu gcloud init oder gcloud auth login und gcloud config set project aus.

gcloud colab runtime-templates remove-iam-policy-binding RUNTIME_TEMPLATE_ID ^
    --member=PRINCIPAL ^
    --role=ROLE ^
    --project=PROJECT_ID ^
    --region=REGION

Weitere Informationen zum Verwalten von IAM-Richtlinien für Laufzeitvorlagen über die Befehlszeile finden Sie in der gcloud-Befehlszeilendokumentation.

Nächste Schritte

• Informationen zum Gewähren des Zugriffs auf ein Notebook finden Sie unter Zugriff auf ein Notebook verwalten.