Gestire l'accesso a un modello di runtime

Questa pagina descrive come concedere e revocare l'accesso a un modello di runtime in Colab Enterprise.

Prima di iniziare

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.

   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.

   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

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per gestire l'accesso a un modello di runtime, chiedi all'amministratore di concederti il ruolo IAM Amministratore Colab Enterprise (roles/aiplatform.colabEnterpriseAdmin) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Concedere l'accesso a un modello di runtime

Per concedere a un principal l'accesso a un modello di runtime, puoi utilizzare la console Google Cloud , Google Cloud CLI o Terraform.

Console

1. Nella console Google Cloud , vai alla pagina Modelli di runtime di Colab Enterprise.

   Vai a Modelli di runtime

2. Nel menu Regione, seleziona la regione che contiene il modello di runtime.

3. Nel menu Modello di runtime, seleziona un modello di runtime. Se non sono elencati modelli di runtime, creane uno.

4. Fai clic su  Autorizzazioni.

5. Nella finestra Autorizzazioni, fai clic su  Aggiungi entità.

6. Nella finestra di dialogo Concedi l'accesso, nel campo Nuove entità, inserisci una o un elenco di entità separate da virgole.

7. Nel menu Seleziona un ruolo, completa la finestra di dialogo per assegnare un ruolo.

8. (Facoltativo) Fai clic su add Aggiungi un altro ruolo e ripeti l'ultimo passaggio.

9. Fai clic su Salva.

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, apporta le seguenti sostituzioni:

• RUNTIME_TEMPLATE_ID: l'ID del modello di runtime.
• PRINCIPAL: l'entità per cui aggiungere l'associazione.
• ROLE: il nome del ruolo da assegnare all'entità.
• PROJECT_ID: il tuo ID progetto.
• REGION: la regione in cui si trova il modello di runtime.

Esegui questo comando:

Linux, macOS o Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

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

Per saperne di più sulla gestione delle policy IAM per i modelli di runtime dalla riga di comando, consulta la documentazione della CLI gcloud.

Terraform

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base. Per saperne di più, consulta la documentazione di riferimento del fornitore Terraform.

L'esempio seguente utilizza la risorsa Terraform google_colab_runtime_template_iam_policy per concedere l'accesso a un modello di runtime di Colab Enterprise.

data "google_iam_policy" "admin" {
  binding {
    role = "roles/viewer"
    members = [
      "user:jane@example.com",
    ]
  }
}

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
}

Le entità di Colab Enterprise sono utenti, gruppi o domini

Puoi concedere l'accesso a utenti, gruppi o domini. Consulta la seguente tabella:

Entità	Account utente di esempio
Utente singolo	user@gmail.com
Gruppo Google	admins@googlegroups.com
Dominio Google Workspace	example.com

Revoca dell'accesso a un modello di runtime

Per revocare l'accesso a un modello di runtime, puoi utilizzare la console Google Cloud o gcloud CLI.

Console

1. Nella console Google Cloud vai alla pagina IAM.

   Vai a IAM

2. Seleziona un progetto, una cartella o un'organizzazione.

3. Individua la riga contenente l'entità di cui vuoi revocare l'accesso. Quindi, fai clic su edit Modifica entità in quella riga.

4. Fai clic sul pulsante Elimina delete per il ruolo che vuoi revocare, quindi fai clic su Salva.

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, apporta le seguenti sostituzioni:

• RUNTIME_TEMPLATE_ID: l'ID del modello di runtime.
• PRINCIPAL: l'entità di cui vuoi revocare l'accesso.
• ROLE: il ruolo da rimuovere dall'entità.
• PROJECT_ID: il tuo ID progetto.
• REGION: la regione in cui si trova il modello di runtime.

Esegui questo comando:

Linux, macOS o Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

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

Per saperne di più sulla gestione delle policy IAM per i modelli di runtime dalla riga di comando, consulta la documentazione della CLI gcloud.

Passaggi successivi

• Per scoprire come concedere l'accesso a un notebook, consulta Gestire l'accesso a un notebook.