Utilizzo di SSH per accedere a JupyterLab

Se non disponi dell'accesso HTTPS alla tua istanza JupyterLab, devi utilizzare SSH per stabilire una connessione.

Per configurare il port forwarding SSH, completa i passaggi che seguono, quindi accedi alla sessione JupyterLab tramite un browser locale:

  1. Esegui questo comando utilizzando Google Cloud CLI in sul tuo terminale preferito o Cloud Shell

    gcloud compute ssh \
    --project PROJECT_ID \
    --zone ZONE \
    INSTANCE_NAME \
    -- -L 8080:localhost:8080

    Sostituisci quanto segue:

  1. Accedi alla sessione JupyterLab tramite un browser locale:

    • Se hai eseguito il comando sulla tua macchina locale, visita https://localhost:8080 per accedere a JupyterLab.

    • Se hai eseguito il comando utilizzando Cloud Shell accedere a JupyterLab tramite Web Anteprima sulla porta 8080.

Motivi per cui potresti non avere accesso HTTPS

Per ottenere l'accesso HTTPS a JupyterLab, l'istanza di JupyterLab gestita dall'utente deve avere accesso a un servizio proxy Google Cloud. Quando l'istanza viene avviata, tenta di registrarsi con il servizio proxy. Se non riesce ad accedere al proxy, la tua istanza di blocchi note gestita dall'utente ti chiede di accedere a JupyterLab tramite SSH.

Di seguito sono riportati alcuni dei motivi più comuni per cui potresti non avere accesso HTTPS a JupyterLab:

  • Impostazione dei metadati in modalità proxy della tua istanza JupyterLab non è corretto.

  • La tua rete è configurata in modo da bloccare l'accesso a Internet per macchine virtuali (VM) che eseguono blocchi note JupyterLab.

  • La tua istanza di blocchi note gestiti dall'utente non ha un indirizzo IP esterno.

  • Le impostazioni dei Controlli di servizio VPC bloccano l'accesso a Artifact Registry.

Le sezioni seguenti mostrano come risolvere questi problemi.

Affinché le modifiche abbiano effetto, potrebbe essere necessario riavviare la VM del blocco note quando cercando di risolvere questi problemi.

L'impostazione dei metadati in modalità proxy dell'istanza JupyterLab non è corretta

Per impostazione predefinita, quando utilizzi i notebook gestiti dall'utente per creare un'istanza JupyterLab, Vertex AI Workbench aggiunge l'impostazione dei metadati in modalità proxy. Se modifichi o rimuovi l'impostazione dei metadati in modalità proxy, l'istanza dei notebook gestita dall'utente non può connettersi al servizio proxy.

Per assicurarti che l'impostazione dei metadati in modalità proxy sia valida, completa i seguenti passaggi:

  1. Nella console Google Cloud, vai alla pagina Notebook gestiti dall'utente.

    Vai a Blocchi note gestiti dall'utente

  2. Seleziona l'istanza da modificare.

  3. Accanto a Visualizza dettagli VM, fai clic su Visualizza in Compute Engine.

  4. Nella pagina dei dettagli della VM, fai clic su Modifica.

  5. Nella sezione Metadati, aggiungi o modifica i metadati per assicurare che esista un proxy-mode entryset to the correct value, for example:project_editors".

    Scopri di più sui possibili valori dei metadati proxy-mode utente.

  6. Fai clic su Salva.

La rete blocca l'accesso a internet

La tua istanza JupyterLab accede al servizio di proxy tramite un URL pubblico. Se le impostazioni di rete 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 dei notebook gestiti dall'utente. Se possibile, potresti voler lavorare con gli amministratori della rete e del firewall per consentire l'accesso di blocchi note gestiti dall'utente tramite la rete internet pubblica.

L'istanza di JupyterLab gestita dall'utente non ha un indirizzo IP esterno

Potresti aver creato l'istanza di notebook gestiti dall'utente senza un indirizzo IP esterno. Se devi modificarlo, completa i seguenti passaggi.

  1. Nella console Google Cloud, vai alla pagina Notebook gestiti dall'utente.

    Vai a Blocchi note gestiti dall'utente

  2. Fai clic sul nome dell'istanza da modificare.

  3. Fai clic su Visualizza dettagli VM.

  4. Fai clic su Modifica.

  5. Nella sezione Interfacce di rete, espandi la rete vuoi avere un indirizzo IP esterno.

  6. Fai clic sul menu a discesa Indirizzo IP esterno. e seleziona l'opzione che preferisci. Per risolvere il problema, non devi scegliere Nessuna.

  7. Nella sezione Interfacce di rete, fai clic su Fine.

  8. Fai clic su Salva.

Le impostazioni di Controlli di servizio VPC bloccano l'accesso ad Artifact Registry

Per connetterti al servizio di proxy, l'istanza di blocchi note gestiti dall'utente esegue che scarica da Artifact Registry. Senza questo agente l'istanza non riesce a connettersi al servizio di proxy.

Se le impostazioni di VPC Service Controls bloccano l'accesso a Artifact Registry, devi aggiungere il servizio Artifact Registry al perimetro di servizio di VPC Service Controls. Scopri di più su come i perimetri di servizio e quali servizi i Controlli di servizio VPC possono essere utilizzati proteggere.

Ulteriori misure di risoluzione dei problemi

Se i problemi di connessione persistono, prova a esaminare la console per la tua macchina virtuale. Questi log potrebbero aiutarti a scoprire perché l'istanza dei notebook gestiti dall'utente non riesce a registrarsi al servizio proxy.

Per accedere a questi log, segui questi passaggi:

  1. Nella console Google Cloud, vai alla pagina Blocchi note gestiti dall'utente.

    Vai a Blocchi note gestiti dall'utente

  2. Seleziona l'istanza di cui vuoi risolvere i problemi.

  3. In Log, fai clic su Porta seriale 1 (console).

Passaggi successivi

Per suggerimenti sulla risoluzione di altri problemi, consulta la sezione sulla risoluzione dei problemi relativi alla blocchi note.