Utilizzo di un'istanza di blocchi note gestiti dall'utente all'interno di un perimetro di servizio
In questa pagina viene descritto come utilizzare i Controlli di servizio VPC per configurare per un'istanza di blocchi note gestiti dall'utente all'interno di un perimetro di servizio.
Prima di iniziare
Leggi la Panoramica di Controlli di servizio VPC.
Creazione di blocchi note gestiti dall'utente in esecuzione. Questa istanza non è ancora all'interno di un perimetro del servizio.
Crea un perimetro di servizio utilizzando i Controlli di servizio VPC. Questo perimetro di servizio protegge le risorse gestite da Google dei servizi che specifichi. Durante la creazione del perimetro di servizio, segui questi passaggi:
Quando è il momento di aggiungere progetti al perimetro di servizio, aggiungi contenente l'istanza di blocchi note gestiti dall'utente.
Quando è il momento di aggiungere servizi al perimetro di servizio, aggiungi API Notebooks.
Se hai creato il perimetro di servizio senza aggiungere i progetti e i servizi di cui hai bisogno, consulta Gestire i perimetri di servizio per scoprire come aggiornarlo.
Configura le voci DNS utilizzando Cloud DNS
Le istanze di notebook gestite dall'utente di Vertex AI Workbench utilizzano diversi domini che una rete Virtual Private Cloud non gestisce per impostazione predefinita. Per assicurarti che la tua rete VPC gestisca correttamente le richieste inviate a questi domini, usa Cloud DNS per aggiungere i record DNS. Per maggiori informazioni per informazioni sulle route VPC, consulta Route.
Per creare una zona gestita per un dominio, aggiungi una voce DNS che indirizzi la richiesta ed esegui la transazione.
Ripeti questi passaggi per
domini per cui devi gestire le richieste, iniziando
con *.notebooks.googleapis.com
.
In Cloud Shell o in qualsiasi ambiente in cui è installato Google Cloud CLI, inserisci i seguenti comandi Google Cloud CLI.
-
Per creare una zona gestita privata per uno dei domini La rete VPC deve gestire:
gcloud dns managed-zones create ZONE_NAME \ --visibility=private \ --networks=https://www.googleapis.com/compute/v1/projects/PROJECT_ID/global/networks/NETWORK_NAME \ --dns-name=DNS_NAME \ --description="Description of your managed zone"
Sostituisci quanto segue:
-
ZONE_NAME
: un nome per la zona da creare. Devi utilizzare una zona separata per ciascun dominio. Questo nome zona viene utilizzato in ciascuno dei passaggi che seguono. -
PROJECT_ID
: l'ID del progetto che ospita il tuo Rete VPC -
NETWORK_NAME
: il nome della rete VPC creata in precedenza -
DNS_NAME
: la parte del nome di dominio che comprende dopo il giorno*.
, con un punto alla fine. Ad esempio,*.notebooks.googleapis.com
ha un valoreDNS_NAME
dinotebooks.googleapis.com.
-
-
Avvia una transazione.
gcloud dns record-sets transaction start --zone=ZONE_NAME
-
Aggiungi il seguente record A DNS. Questo reindirizza il traffico a Indirizzi IP limitati di Google.
gcloud dns record-sets transaction add \ --name=DNS_NAME. \ --type=A 199.36.153.4 199.36.153.5 199.36.153.6 199.36.153.7 \ --zone=ZONE_NAME \ --ttl=300
-
Aggiungi il seguente record DNS CNAME in modo che punti al record A che hai appena aggiunto. Questa operazione reindirizza tutto il traffico corrispondente dominio agli indirizzi IP elencati nel passaggio precedente.
gcloud dns record-sets transaction add \ --name=\*.DNS_NAME. \ --type=CNAME DNS_NAME. \ --zone=ZONE_NAME \ --ttl=300
-
Esegui la transazione.
gcloud dns record-sets transaction execute --zone=ZONE_NAME
-
Ripeti questi passaggi per ciascuno dei seguenti domini. Per ogni ripetizione, modifica ZONE_NAME e DNS_NAME ai valori appropriati dominio. Mantieni PROJECT_ID e NETWORK_NAME sempre lo stesso. Hai già completato questi passaggi per
*.notebooks.googleapis.com
.*.notebooks.googleapis.com
*.notebooks.cloud.google.com
*.notebooks.googleusercontent.com
*.googleapis.com
per eseguire codice che interagisce con altre API di Google e servizi
Configura il perimetro di servizio
Dopo aver configurato i record DNS, crea un servizio perimetro o aggiorna un modello esistente perimetro per aggiungere il tuo progetto al perimetro di servizio.
Nella rete VPC, aggiungi una route per l'intervallo 199.36.153.4/30
con un
hop successivo di Default internet gateway
.
Utilizza Artifact Registry all'interno del tuo perimetro di servizio
Se vuoi utilizzare Artifact Registry nel perimetro del servizio, consulta Configurare l'accesso limitato per i cluster privati GKE.
Usa VPC condiviso
Se utilizzi VPC condiviso,
devi aggiungere i progetti host e di servizio al perimetro del servizio. Nel progetto host, devi anche concedere il
ruolo Utente di rete Compute
(roles/compute.networkUser
) all'agente di servizio Notebooks
dal progetto di servizio. Per saperne di più, consulta Gestire i perimetri di servizio.
Accedi all'istanza di blocchi note gestiti dall'utente
Segui la procedura per aprire un un blocco note personalizzato.
Limitazioni
Tipo di identità per i criteri per il traffico in entrata e in uscita
Quando specifichi un criterio di ingresso o di uscita per un perimetro di servizio,
non puoi utilizzare ANY_SERVICE_ACCOUNT
o ANY_USER_ACCOUNT
come tipo di identità per tutte le operazioni di Vertex AI Workbench.
Utilizza invece ANY_IDENTITY
come tipo di identità.
Accesso al proxy dei blocchi note gestiti dall'utente da una workstation senza connessione a internet
Per accedere alle istanze di blocchi note gestiti dall'utente da una workstation con accesso limitato a internet, verifica con il tuo amministratore IT che puoi accedere ai seguenti domini:
*.accounts.google.com
*.accounts.youtube.com
*.googleusercontent.com
*.kernels.googleusercontent.com
*.gstatic.com
*.notebooks.cloud.google.com
*.notebooks.googleapis.com
Devi avere accesso a questi domini per l'autenticazione su Google Cloud. Per ulteriori informazioni sulla configurazione, consulta la sezione precedente Configurare le voci DNS utilizzando Cloud DNS.
Passaggi successivi
- Installa le dipendenze sul tuo nuovo di blocchi note gestiti dall'utente.