Documentação do Oracle Cloud Infrastructure

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 selecionar uma rede personalizada quando reativá-la.

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, primeiro crie 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 para armazenamento de objetos 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.

Criando um Notebook

As etapas para criar um bloco de notas.

  • É recomendável que você verifique Mantendo Dados e Arquivos em um Volume em Blocos de Sessões de Notebook para ajudar a decidir o tamanho do volume em blocos.

    1. Na página de detalhes do projeto, selecione Criar sessão de notebook. Se precisar de ajuda para localizar a lista de projetos, consulte Listando Projetos.
    2. (Opcional) Digite um nome exclusivo para a sessão de notebook (limite de 255 caracteres). Se você não fornecer um nome, um nome será gerado automaticamente. Por exemplo, datasciencenotebooksession20200108222435.
    3. (Opcional) Digite uma descrição.
    4. (Opcional) Altere a forma de Computação selecionando Alterar forma. Em seguida, siga estas etapas no painel Selecionar computação.
      1. Selecione um tipo de instância.
      2. Selecione uma série de formas.
      3. Selecione uma das formas de Computação suportadas na série.
      4. Selecione a forma mais adequada à maneira como deseja usar o recurso.

        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.

      5. Se estiver usando VMs expansíveis, alterne Burstable.
        Em 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%.
      6. Selecione Selecionar forma.
    5. 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.
    6. Selecione uma das seguintes opções para configurar o tipo de rede:

      • 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 a sub-rede que deseja usar para o recurso (sessão de notebook ou job).

        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 Alterar Compartimento e, em seguida, selecione o compartimento que contém a VCN ou a sub-rede.

        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 selecionar uma rede personalizada quando reativá-la.

    7. Selecione uma das seguintes opções para configurar o tipo de ponto final:

      • 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 que você deseja usar para a sessão de notebook.

        Selecione Alterar Compartimento para selecionar o compartimento que contém a VCN, a sub-rede ou o ponto final privado.

    8. (Opcional) Para usar montagens de armazenamento, selecione +Add storage mount.
      Certifique-se de ter a autorização para usar montagens de armazenamento.
      1. Selecione um tipo de montagem de armazenamento, OCI Object Storage ou OCI File Storage.
      2. Selecione um compartimento que contenha o recurso de armazenamento que você deseja montar.
      3. Selecione uma das seguintes opções:
        Serviço Object Storage
        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.

        O bucket que você deseja usar.

        Você pode adicionar um prefixo de nome de objeto. O prefixo deve começar com um caractere alfanumérico. Os caracteres permitidos são alfanuméricos, barra ( / ), hífen ( - ) e sublinhado ( _ ).

        Serviço File Storage

        O ponto de acesso NFS e o caminho de exportação que você deseja usar. Você deve ter criado o sistema de arquivos. Especifique um ponto de acesso NFS existente ou crie um novo.

        Você deve usar uma rede personalizada para usar o armazenamento de arquivos.

        Siga as regras da lista de segurança da sub-rede.
        Observação

        Antes de montar um sistema de arquivos, configure regras de segurança na sub-rede da VCN para permitir o 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 nas portas TCP 111, 2048, 2049 e 2050, e portas UDP11 e 2048.
        • Saída com monitoramento de Estado para portas de origem TCP 111, 2048, 2049 e 2050 e porta de origem UDP 111.
      4. Informe o caminho sob o qual o armazenamento deve ser montado.

        O armazenamento é montado sob o caminho de montagem especificado. 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.

      5. Selecione Enviar.

        Repita essas etapas para adicionar até duas montagens de armazenamento para sessões de notebook.

    9. (Opcional) Expanda a seção Configuração de tempo de execução para definir variáveis de ambiente personalizadas e definições Git, da seguinte forma:
    10. (Opcional) Na seção Tags, adicione uma ou mais tags ao resourceType. 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.
    11. (Opcional) Para exibir os detalhes da sessão de notebook imediatamente após a criação, selecione Exibir página de detalhes ao clicar em criar.
    12. 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 da 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 serviço no OCI, consulte Solicitações de Serviço e a API de 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 flags e opções de variáveis para comandos da CLI, consulte a Referência de Comando da CLI.

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