Use SSH para aceder ao JupyterLab

Sempre que não tiver acesso HTTPS à sua instância do JupyterLab, tem de usar o SSH para estabelecer uma ligação.

Para configurar o encaminhamento de portas SSH, conclua os passos seguintes e, em seguida, aceda à sua sessão do JupyterLab através de um navegador local:

  1. Execute o seguinte comando através da CLI Google Cloud no terminal da sua preferência ou na Cloud Shell:

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

    Substitua o seguinte:

  1. Aceda à sua sessão do JupyterLab através de um navegador local:

    • Se executou o comando na sua máquina local, visite https://localhost:8080 para aceder ao JupyterLab.

    • Se executou o comando através da Cloud Shell, aceda ao JupyterLab através da  Pré-visualização Web na porta 8080.

Motivos pelos quais pode não ter acesso HTTPS

Para ter acesso HTTPS ao JupyterLab, a instância de blocos de notas geridos pelo utilizador tem de ter acesso a um serviço de proxy. Google Cloud Quando a instância é iniciada, tenta registar-se no serviço de proxy. Se não conseguir obter acesso ao proxy, a instância de blocos de notas gerida pelo utilizador pede-lhe que aceda ao JupyterLab através de SSH.

Seguem-se alguns motivos comuns pelos quais pode não ter acesso HTTPS ao JupyterLab:

  • A definição de metadados do modo de proxy da instância do JupyterLab está incorreta.

  • A sua rede está configurada para bloquear o acesso à Internet para as máquinas virtuais (VMs) que executam blocos de notas do JupyterLab.

  • A instância de blocos de notas geridos pelo utilizador não tem um endereço IP externo.

  • As suas definições dos VPC Service Controls bloqueiam o acesso ao Artifact Registry.

As secções seguintes mostram como resolver estes problemas.

Para que as alterações entrem em vigor, pode ter de reiniciar a VM do bloco de notas quando tentar resolver estes problemas.

A definição de metadados do modo de proxy da sua instância do JupyterLab está incorreta

Por predefinição, quando usa blocos de notas geridos pelo utilizador para criar uma instância do JupyterLab, o Vertex AI Workbench adiciona a definição de metadados do modo de proxy. Se alterar ou remover a definição de metadados do modo proxy, a instância dos blocos de notas geridos pelo utilizador não consegue estabelecer ligação ao serviço proxy.

Para se certificar de que a definição de metadados do modo de proxy é válida, conclua os seguintes passos:

  1. Na Google Cloud consola, aceda à página Blocos de notas geridos pelo utilizador.

    Aceda aos blocos de notas geridos pelo utilizador

  2. Selecione a instância que precisa de modificar.

  3. Junto a Ver detalhes da VM, clique em Ver no Compute Engine.

  4. Na página de detalhes da VM, clique em Editar.

  5. Na secção Metadados, adicione ou modifique os metadados para garantir que existe um proxy-mode entryset to the correct value, for example:project_editors.

    Saiba mais acerca dos valores possíveis da entrada de metadados proxy-mode.

  6. Clique em Guardar.

A rede está a bloquear o acesso à Internet

A sua instância do JupyterLab acede ao serviço de proxy através de um URL público. Se as definições da sua rede de nuvem privada virtual bloquearem o acesso à Internet pública ou as regras da sua firewall bloquearem o tráfego de saída, tem de usar o SSH para aceder à instância dos blocos de notas geridos pelo utilizador. Se possível, recomendamos que trabalhe com os administradores de rede e firewall para permitir o acesso à instância de notebooks geridos pelo utilizador através da Internet pública.

A sua instância de blocos de notas geridos pelo utilizador não tem um endereço IP externo

Pode ter criado a instância de blocos de notas geridos pelo utilizador sem um endereço IP externo. Se precisar de alterar esta definição, conclua os seguintes passos.

  1. Na Google Cloud consola, aceda à página Blocos de notas geridos pelo utilizador.

    Aceda aos blocos de notas geridos pelo utilizador

  2. Clique no nome da instância que tem de modificar.

  3. Clique em Ver detalhes da VM.

  4. Clique em Edit.

  5. Na secção Interfaces de rede, expanda a rede que quer ter um endereço IP externo.

  6. Clique no menu pendente Endereço IP externo e selecione a opção pretendida. Para resolver este problema, não pode escolher Nenhum.

  7. Na secção Interfaces de rede, clique em Concluído.

  8. Clique em Guardar.

As definições dos VPC Service Controls estão a bloquear o acesso ao Artifact Registry

Para se ligar ao serviço de proxy, a instância dos blocos de notas geridos pelo utilizador executa um agente que transfere do Artifact Registry. Sem este agente, a sua instância não pode estabelecer ligação ao serviço de proxy.

Se as definições dos VPC Service Controls estiverem a bloquear o acesso ao Artifact Registry, tem de adicionar o serviço Artifact Registry ao perímetro de serviço dos VPC Service Controls. Saiba mais sobre como funcionam os perímetros de serviço e que serviços podem ser usados para proteger o VPC Service Controls.

Mais resoluções de problemas

Se continuar a ter problemas de ligação, experimente rever os registos da consola da sua máquina virtual. Estes registos podem ajudar a descobrir por que motivo a instância dos blocos de notas geridos pelo utilizador não consegue registar-se no serviço de proxy.

Para aceder a estes registos, conclua os seguintes passos:

  1. Na Google Cloud consola, aceda à página Blocos de notas geridos pelo utilizador.

    Aceda aos blocos de notas geridos pelo utilizador

  2. Selecione a instância cujos problemas quer resolver.

  3. Em Registos, clique em Porta de série 1 (consola).

O que se segue?

Para ver sugestões sobre a resolução de outros problemas, consulte a secção de resolução de problemas sobre blocos de notas geridos pelo utilizador.