Criando uma Sessão de Notebook

Crie uma sessão de notebook do Data Science para acessar uma interface JupyterLab que use uma configuração de computação, armazenamento e rede personalizável.

Antes de Começar

Para usar uma configuração de runtime, identifique as variáveis de ambiente personalizadas e quaisquer URLs do repositório Git que você deseja usar.

Observação

A configuração de rede de uma sessão de notebook não pode ser alterada quando a sessão de notebook é reativada. Se uma sessão de notebook tiver sido configurada para usar uma rede padrão, você não poderá desativar a sessão de notebook e, em seguida, selecionar a rede personalizada quando a reativar.

Configuração de Rede para Usar Recursos Gerenciados da Oracle

Para usar qualquer um dos recursos gerenciados pela Oracle dentro do Notebook, dos Scripts do Ciclo de Vida do Notebook, das Ações Rápidas de IA, do Explorador de Ambientes e dos Notebooks de Exemplo, a sub-rede do Notebook deve ter permissões para acessar o OCI Object Storage.

Se você selecionar Rede Padrão para seu Notebook, a sub-rede do Notebook terá acesso ao Object Storage. Se você selecionar Rede Personalizada, será necessário configurar o acesso ao Object Storage com o Gateway de Serviço ou o Gateway Nat. Você pode configurar o Service Gateway para acessar todos os serviços ou o Object Storage específico da região. Para obter mais informações, consulte Criando um Gateway de Serviço e Visão Geral dos Gateways de Serviço na documentação do serviço Networking. Ou você pode configurar o Nat Gateway para permitir acesso público à Internet. Para obter mais informações, consulte Gateway NAT na documentação de Rede.

Se você usar o Gateway de Internet, não poderá se conectar à internet pública com seu Notebook. Isso ocorre porque o Gateway de Internet espera que os recursos por trás dele sejam uma sub-rede pública com IPs públicos que os Notebooks do Data Science não usam. O Notebook também não funcionará com a conexão com recursos gerenciados pela Oracle.

Configurando Montagens de Armazenamento

Para usar montagens de armazenamento, você deve ter um bucket do Object Storage ou um ponto de acesso NFS (FSS) do OCI File Storage Service e um caminho de exportação.

Para usar o FSS, é necessário primeiro criar o sistema de arquivos e o ponto de montagem. Use a opção de rede personalizada e certifique-se de que o ponto de acesso NFS e o notebook estejam configurados com a mesma sub-rede. Configure regras de lista de segurança para a sub-rede com as portas e protocolos específicos.

Verifique se os limites de serviço estão alocados para file-system-count e mount-target-count.

Configure políticas para usar o Object Storage ou o File Storage Service (FSS) para montagens de armazenamento no notebook.

Usando o OCI File Storage

Configurar Montagens de Armazenamento ao usar o OCI File Storage.

Configurando Montagens de Armazenamento

  1. Navegue até o compartimento de sua escolha.
  2. Crie um sistema de arquivos no serviço OCI File Storage com uma exportação.
  3. Selecione um ponto de acesso NFS existente ou crie um novo.
    Você tem um sistema de arquivos, uma exportação e um ponto de acesso NFS criados.
  4. Configurar rede personalizada.
    Você pode criar uma nova sub-rede ou usar uma existente. Certifique-se de que o ponto de acesso NFS e o notebook estejam configurados com a mesma sub-rede.
  5. Configure as regras de lista de segurança da sub-rede usada conforme especificado em Configurando Regras de Segurança da VCN para o Serviço File Storage.
    Observação

    Antes de montar um sistema de arquivos, configure regras de segurança na Sub-rede da VCN para permitir tráfego de rede de/para o ponto de acesso NFS. Você pode configurar regras de segurança em listas de segurança de sub-rede, grupos de segurança de rede ou usando uma combinação de ambos. Para obter mais informações, consulte Configurando Regras de Segurança da VCN para o Serviço File Storage.
    • entrada com monitoramento de estado para portas TCP 111, 2048, 2049 e 2050, e portas UDP 111 e 2048.
    • saída com monitoramento de estado para portas de origem TCP 111, 2048, 2049 e 2050, e porta de origem UDP 111.

Usando o OCI Object Storage

Configurar Montagens de Armazenamento ao usar o OCI Object Storage.

As montagens de armazenamento do serviço Object Storage usam autorização baseada em controladores de recursos para se comunicar entre o notebook e o bucket necessário.

Para usar a opção de rede padrão para um notebook, a saída gerenciada funciona sem a necessidade de configurar regras de rede extras.

Para usar a opção de rede personalizada para um notebook, é necessária mais uma configuração de rede.

Configurando Montagens de Armazenamento

  1. Na escolha da sua VCN, crie o gateway de serviço.
  2. Para a sub-rede privada necessária, adicione Service Gateway às configurações da tabela de roteamento.
  3. Altere as regras de saída da lista de segurança da sub-rede necessária para permitir o tráfego para todos os serviços na rede Oracle regional.

Usando a Console, a CLI ou A API

  • Recomendamos que você verifique a opção Persistindo Dados e Arquivos em um Volume em Blocos da Sessão de Notebook para ajudar a decidir o tamanho desse volume.

    1. Na página da lista Projetos, selecione o projeto no qual você deseja criar a sessão de notebook. Se precisar de ajuda para localizar a página da lista ou o projeto, consulte Listando Projetos.
    2. Na página de detalhes do projeto, selecione Sessões de notebook.
    3. Selecione Criar sessão de notebook.
      A página Criar sessão de notebook é aberta.

    1. Informações Básicas

    Opcionalmente, altere as informações de identificação.

    • Compartimento: Selecione o compartimento no qual criar a sessão de notebook.
    • Name (Opcional): Informe um nome exclusivo para a sessão do notebook (limite de 255 caracteres). Caso você não forneça um nome, um nome é gerado automaticamente. Por exemplo, datasciencenotebooksession20200108222435.
    • Tags (Opcional): Adicione tags à sessão de notebook. Se você tiver permissões para criar um recurso, também terá permissões para aplicar tags de formato livre a esse recurso. Para aplicar uma tag definida, você deve ter permissões para usar o namespace da tag. Para obter mais informações sobre tags, consulte Tags de Recursos. Se você não tiver certeza se deseja aplicar tags, ignore essa opção ou pergunte a um administrador. Você pode aplicar tags posteriormente.

    2. Configuração

    Especifique a configuração da forma de Computação e da rede.

    • Forma (Opcional): Altere a forma de Computação selecionando Alterar forma. Em seguida, siga estas etapas no painel Selecionar forma de computação.
      • Selecione um tipo de instância.
      • Selecione uma série de formas.
      • Selecione uma das formas de Computação suportadas na série. Selecione a forma que melhor se adapte à forma como deseja usar o recurso.
      • Expanda a forma selecionada para configurar OCPUs e memória.
        • Número de OCPUs
        • Quantidade de memória (GB): Para cada OCPU, selecione até 64 GB de memória e um total máximo de 512 GB. A quantidade mínima de memória permitida é 1 GB ou um valor correspondente ao número de OCPUs, o que for maior.
        • Ativar Forma Expansível: Selecione se estiver usando VMs expansíveis e, em seguida, para Utilização da linha de base por OCPU, selecione a porcentagem de OCPUs que você geralmente deseja usar. Os valores suportados são 12,5% e 50%. (Para implantações de modelo, somente o valor de 50% é suportado.)
      • Selecione Selecionar forma.
    • Tamanho do armazenamento em blocos: Informe o tamanho do armazenamento em blocos a ser usado, entre 50 GB e 10, 240 GB (10 TB). Você pode alterar o valor em incrementos de 1 GB. O valor padrão é 100 GB. de
    • Tipo de rede: Selecione a opção relevante.
      • Rede padrão - A carga de trabalho é anexada usando uma VNIC secundária a uma VCN e sub-rede gerenciadas pelo serviço pré-configuradas. Essa sub-rede fornecida permite a saída para a internet pública por meio de um gateway NAT e o acesso a outros serviços do Oracle Cloud por meio de um gateway de serviço.

        Se você precisar de acesso apenas à internet pública e aos serviços da OCI, recomendamos o uso dessa opção. Não é necessário criar recursos de rede ou gravar políticas para permissões de rede.

      • Rede personalizada — Selecione a VCN e sub-rede (no compartimento indicado) que você deseja usar para o recurso (sessão ou job de notebook).

        Para acesso de saída à Internet pública, use uma sub-rede privada com uma rota para um gateway NAT.

        Se você não vir a VCN ou a sub-rede que deseja usar, selecione outro compartimento.

        Importante

        Para usar uma montagem de armazenamento de arquivos, você deve selecionar uma rede personalizada. A VCN e a sub-rede devem ser iguais às usadas para a criação do ponto de acesso NFS.
      Observação

      A configuração de rede de uma sessão de notebook não pode ser alterada quando a sessão de notebook é reativada. Se uma sessão de notebook tiver sido configurada para usar uma rede padrão, você não poderá desativar a sessão de notebook e, em seguida, selecionar a rede personalizada quando a reativar.
    • Tipo de ponto final: Selecione a opção relevante.
      • Ponto final público — Acesso a dados em uma instância gerenciada de fora de uma VCN.
      • Ponto final privado — Selecione a VCN, a sub-rede e o ponto final privado (no compartimento indicado) que você deseja usar para a sessão de notebook.

    3. Configuração adicional

    Opcionalmente, adicione montagens de armazenamento, configuração de runtime e tags.

    Observação

    Para montagens de armazenamento, certifique-se de ter a autorização para usar montagens de armazenamento.
    • Montagens de armazenamento de arquivos (Opcional): Selecione Adicionar montagem de armazenamento de arquivos e insira as seguintes informações.
      • Compartimento: Selecione o compartimento que contém o destino que você deseja montar.
      • Ponto de acesso NFS: o ponto de acesso NFS que você deseja usar.
      • Caminho de exportação: o caminho de exportação que você deseja usar.
      • Caminho e diretório de destino: Informe o caminho a ser usado para montar o armazenamento.

        O caminho deve começar com um caractere alfanumérico. O diretório de destino deve ser exclusivo nas montagens de armazenamento fornecidas. Os caracteres permitidos são alfanuméricos, hífen ( - ) e sublinhado ( _ ).

        Você pode especificar o caminho completo, como /opc/storage-directory. Se apenas um diretório for especificado, como /storage-directory, ele será montado sob o diretório /mnt padrão. Não é possível especificar diretórios específicos do SO, como /bin ou /etc.

    • Montagens do armazenamento de objetos (Opcional): Selecione Adicionar montagem do armazenamento de objetos e especifique as seguintes informações.
      • Compartimento: Selecione o compartimento que contém o bloco que você deseja montar.
      • Bloco: Selecione o bloco que você deseja usar.
      • Prefixo do nome do objeto (Opcional): Prefixo do nome do objeto. O prefixo deve começar com um caractere alfanumérico. Os caracteres permitidos são alfanuméricos, barra ( / ), hífen ( - ) e sublinhado ( _ ).
      • Caminho e diretório de destino: Informe o caminho a ser usado para montar o armazenamento.

        O caminho deve começar com um caractere alfanumérico. O diretório de destino deve ser exclusivo nas montagens de armazenamento fornecidas. Os caracteres permitidos são alfanuméricos, hífen ( - ) e sublinhado ( _ ).

        Você pode especificar o caminho completo, como o /opc/storage-directory. Se apenas um diretório for especificado, como /storage-directory, ele será montado no diretório /mnt padrão. Não é possível especificar diretórios específicos do SO, como /bin ou /etc.

      Observação

      Se estiver usando uma rede personalizada:
      1. Crie o gateway do serviço na VCN.
      2. Para as configurações da tabela de roteamento na sub-rede privada, adicione o gateway de serviço.
      3. Altere as regras de saída da lista de segurança da sub-rede necessária para permitir o tráfego para todos os serviços na rede.
    • Configuração de runtime (Opcional): Defina variáveis de ambiente personalizadas (pares de chave/valor) e definições de Git.
      • Pares de chave/valor: Selecione Adicionar par de chave/valor e informe uma chave/valor. É possível adicionar até 30 pares de chave/valor. Para nomear chaves, consulte restrições de par de valores de chave.
      • Definições do Git: Selecione Adicionar definição do Git e informe um URL público do repositório do Git. É possível adicionar até 3 repositórios Git. Revise as restrições de repositório Git para obter o número e o tamanho dos URLs.
        Dica

        Você pode usar o exemplo de repositório do ADS para criar rapidamente um repositório Git para um notebook que pode ser usado quando você o abre no JupyterLab. Consulte https://github.com/oracle/accelerated-data-science.git.
    • Tags (Opcional): Adicione tags à sessão de notebook. Se você tiver permissões para criar um recurso, também terá permissões para aplicar tags de formato livre a esse recurso. Para aplicar uma tag definida, você deve ter permissões para usar o namespace da tag. Para obter mais informações sobre tags, consulte Tags de Recursos. Se você não tiver certeza se deseja aplicar tags, ignore essa opção ou pergunte a um administrador. Você pode aplicar as tags posteriormente.

    4. Revisar e Criar

    Verifique a configuração e selecione Criar.

    A página de sessões de notebook é aberta. Quando a sessão de notebook é criada com sucesso, o status muda para Ativo, e você pode abrir a sessão de notebook. A ação de criação de sessão de notebook é assíncrona e inicia uma solicitação de serviço. Você pode usar a solicitação de serviço para rastrear o status de uma operação.

    Para obter informações gerais sobre o uso de solicitações de trabalho na OCI, consulte Solicitações de Serviço.

  • Use os comandos oci data-science notebook-session create e os parâmetros necessários para criar uma sessão de notebook em um compartimento:

    oci data-science notebook-session create --compartment-id <compartment-id>, -c [<name>], -c [<project-id>]  ... [OPTIONS]

    Para obter uma lista completa de parâmetros e valores para comandos da CLI, consulte a Referência de Comandos da CLI.

  • Execute a operação CreateNotebookSession para criar uma sessão de notebook.