Utilizzo di SSH per accedere a JupyterLab
Ogni volta che non hai accesso HTTPS all'istanza di JupyterLab, devi utilizzare SSH per stabilire una connessione.
Per configurare il port forwarding SSH, completa i passaggi riportati di seguito, quindi accedi alla sessione JupyterLab tramite un browser locale:
Esegui il comando seguente utilizzando Google Cloud CLI nel terminale che preferisci o in Cloud Shell:
gcloud compute ssh INSTANCE_NAME \ --project PROJECT_ID \ --zone ZONE \ -- -NL 8080:localhost:8080
Sostituisci quanto segue:
INSTANCE_NAME
: il nome dell'istanzaPROJECT_ID
: il tuo ID progetto Google CloudZONE
: la zona in cui si trova l'istanza
Accedi alla sessione JupyterLab tramite un browser locale:
Se hai eseguito il comando sulla macchina locale, visita
http://localhost:8080
per accedere a JupyterLab.Se hai eseguito il comando utilizzando Cloud Shell, accedi a JupyterLab tramite l'anteprima web sulla porta 8080.
Motivi per cui potresti non avere accesso HTTPS
Per ottenere l'accesso HTTPS a JupyterLab, l'istanza di Vertex AI Workbench deve avere accesso a un servizio proxy di Google Cloud. All'avvio, l'istanza prova a registrarsi con il servizio proxy. Se non riesce ad accedere al proxy, l'istanza ti chiede di accedere a JupyterLab tramite SSH.
Di seguito sono riportati i motivi comuni per cui potresti non avere accesso HTTPS a JupyterLab:
L'impostazione dei metadati in modalità proxy della tua istanza di JupyterLab non è corretta.
La tua rete è configurata per bloccare l'accesso a internet per le macchine virtuali (VM) che eseguono blocchi note JupyterLab.
L'istanza non ha un indirizzo IP esterno.
Le impostazioni di Controlli di servizio VPC bloccano l'accesso a Container Registry.
Le sezioni seguenti mostrano come risolvere questi problemi.
Affinché le modifiche abbiano effetto, potrebbe essere necessario riavviare la VM del blocco note quando tenti di risolvere questi problemi.
L'impostazione dei metadati in modalità proxy della tua istanza di JupyterLab non è corretta
Per impostazione predefinita, quando crei un'istanza di Vertex AI Workbench, Vertex AI Workbench aggiunge l'impostazione dei metadati in modalità proxy. Se modifichi o rimuovi l'impostazione dei metadati in modalità proxy, l'istanza non potrà connettersi al servizio proxy.
Per assicurarti che l'impostazione dei metadati della modalità proxy sia valida, completa i seguenti passaggi:
Nella console Google Cloud, vai alla pagina Istanze.
Seleziona l'istanza che devi modificare.
Accanto a Visualizza dettagli VM, fai clic su Visualizza in Compute Engine.
Nella pagina dei dettagli della VM, fai clic su Modifica.
Nella sezione Metadati, aggiungi o modifica i metadati per assicurarti che sia presente una voce in modalità proxy impostata sul valore corretto, ad esempio:
project_editors
.Fai clic su Salva.
La rete sta bloccando l'accesso a internet
L'istanza di JupyterLab accede al servizio proxy tramite un URL pubblico. Se le impostazioni di rete del Virtual Private Cloud bloccano l'accesso alla rete internet pubblica o le regole firewall bloccano il traffico in uscita, devi utilizzare SSH per accedere all'istanza di Vertex AI Workbench. Se possibile, potresti voler collaborare con gli amministratori di rete e del firewall per consentire l'accesso all'istanza tramite la rete internet pubblica.
L'istanza non ha un indirizzo IP esterno
Potresti aver creato l'istanza Vertex AI Workbench senza un indirizzo IP esterno. Se devi cambiarla, procedi nel seguente modo.
Nella console Google Cloud, vai alla pagina Istanze.
Fai clic sul nome dell'istanza da modificare.
Fai clic su Visualizza dettagli VM.
Fai clic su Modifica.
Nella sezione Interfacce di rete, espandi la rete che vuoi avere un indirizzo IP esterno.
Fai clic sul menu a discesa Indirizzo IP esterno e seleziona l'opzione che preferisci. Per risolvere il problema, non devi scegliere Nessuno.
Nella sezione Interfacce di rete, fai clic su Fine.
Fai clic su Salva.
Le impostazioni dei Controlli di servizio VPC bloccano l'accesso a Container Registry
Per connettersi al servizio proxy, l'istanza di Vertex AI Workbench esegue un agente scaricato da Container Registry. Senza questo agente, l'istanza non può connettersi al servizio proxy.
Se le impostazioni dei Controlli di servizio VPC bloccano l'accesso a Container Registry, devi aggiungere il servizio Container Registry al perimetro di servizio dei Controlli di servizio VPC. Scopri di più su come funzionano i perimetri di servizio e su quali servizi puoi proteggere i Controlli di servizio VPC.
Ulteriori misure di risoluzione dei problemi
Se i problemi di connessione persistono, prova a esaminare i log della console per la tua macchina virtuale. Questi log potrebbero aiutarti a scoprire perché l'istanza di Vertex AI Workbench non è in grado di registrarsi con il servizio proxy.
Per accedere a questi log, completa i seguenti passaggi:
Nella console Google Cloud, vai alla pagina Istanze.
Seleziona l'istanza di cui vuoi risolvere i problemi.
In Log, fai clic su Porta seriale 1 (console).
Passaggi successivi
Per suggerimenti sulla risoluzione di altri problemi, consulta la sezione relativa alla risoluzione dei problemi sulle istanze di Vertex AI Workbench.