Usar SSH para acessar o JupyterLab

Sempre que você não tiver acesso HTTPS à instância do JupyterLab, será necessário usar o SSH para estabelecer uma conexão.

Para configurar o encaminhamento de portas SSH, conclua as etapas a seguir e acesse sua sessão do JupyterLab usando um navegador local:

  1. Execute o seguinte comando usando a Google Cloud CLI em seu terminal preferido ou no Cloud Shell:

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

    Substitua:

  2. Acesse a sessão do JupyterLab usando um navegador local:

    • Se você executou o comando na máquina local, visite https://localhost:8080 para acessar o JupyterLab.

    • Se você executou o comando Cloud Shell, acesse o JupyterLab por meio da visualização da Web na porta 8080.

Motivos pelos quais você talvez não tenha acesso HTTPS

Para ter acesso HTTPS ao JupyterLab, sua instância do Vertex AI Workbench precisa ter acesso a um serviço de proxy do Google Cloud. Quando a instância é iniciada, ela tenta se registrar com o serviço de proxy. Se ele não conseguir acesso ao proxy, sua instância solicitará que você acesse o JupyterLab por meio do SSH.

Veja a seguir motivos comuns pelos quais você talvez não tenha acesso HTTPS ao JupyterLab:

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

  • Sua rede está configurada para bloquear o acesso à Internet das máquinas virtuais (VMs) que executam os notebooks do JupyterLab.

  • Sua instância não tem um endereço IP externo.

  • Suas configurações de VPC Service Controls bloqueiam o acesso ao Artifact Registry.

As seções a seguir mostram como resolver esses problemas.

Para que as alterações entrem em vigor, pode ser necessário reiniciar a VM do notebook ao tentar resolver esses problemas.

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

Por padrão, quando você cria uma instância do Vertex AI Workbench, a ferramenta adiciona a configuração de metadados do modo proxy. Se você alterar ou remover a configuração de metadados do modo proxy, a instância não poderá se conectar ao serviço de proxy.

Para garantir que sua configuração de metadados do modo proxy seja válida, realize as etapas a seguir:

  1. No Console do Google Cloud, acesse a página Instâncias.

    Acesse "Instâncias"

  2. Selecione a instância que você precisa modificar.

  3. Ao lado de Visualizar detalhes da VM, clique em Visualizar no Compute Engine.

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

  5. Na seção Metadados, adicione ou modifique os metadados para garantir que haja uma entrada no modo de proxy definida com o valor correto, por exemplo: project_editors.

  6. Clique em Salvar.

A rede está bloqueando o acesso à Internet

Sua instância do JupyterLab acessa o serviço de proxy por meio de um URL público. Se as configurações de rede da nuvem privada virtual bloquearem o acesso à Internet pública ou se as regras de firewall bloquearem o tráfego de saída, use o SSH para acessar a instância de notebooks gerenciados pelo usuário. Se possível, trabalhe com os administradores de rede e firewall para permitir o acesso à sua instância por meio da Internet pública.

Sua instância não tem um endereço IP externo

Talvez você tenha criado sua instância do Vertex AI Workbench sem um endereço IP externo. Se precisar alterar isso, realize as etapas a seguir.

  1. No Console do Google Cloud, acesse a página Instâncias.

    Acesse "Instâncias"

  2. Clique no nome da instância que você quer modificar.

  3. Clique em Ver detalhes da VM.

  4. Clique em Editar.

  5. Na seção Interfaces de rede, expanda a rede em que você quer ter um endereço IP externo.

  6. Clique no menu suspenso Endereço IP externo e selecione a opção desejada. Para resolver esse problema, não escolha Nenhum.

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

  8. Clique em Salvar.

As configurações do VPC Service Controls estão bloqueando o acesso ao Artifact Registry

Para se conectar ao serviço de proxy, a instância do Vertex AI Workbench executa um agente transferido por download do Artifact Registry. Sem esse agente, sua instância não pode se conectar ao serviço de proxy.

Se as configurações do VPC Service Controls estiverem bloqueando o acesso ao Artifact Registry, adicione o serviço do Artifact Registry ao perímetro de serviço dos VPC Service Controls. Saiba mais sobre como os perímetros de serviço funcionam e quais serviços dos VPC Service Controls podem ser usados para proteger.

Mais informações para a solução de problemas

Se você ainda tiver problemas para se conectar, tente analisar os registros do console da sua máquina virtual. Esses registros podem ajudar você a descobrir por que a instância do Vertex AI Workbench não pode se registrar no serviço de proxy.

Para acessar esses registros, siga estas etapas:

  1. No Console do Google Cloud, acesse a página Instâncias.

    Acesse "Instâncias"

  2. Selecione a instância com problemas que você quer resolver.

  3. Em Registros, clique em Porta serial 1 (console).

A seguir

Para dicas sobre como resolver outros problemas, consulte a seção de solução de problemas em instâncias do Vertex AI Workbench.