Documentação do Oracle Cloud Infrastructure

Iniciando uma Execução de Job

Use execuções de jobs do serviço Data Science para aplicar vários casos de uso a jobs criados.

A criação de job define a infraestrutura e o artefato real do caso do uso, mas a execução do job executa o job com os parâmetros especificados. As execuções de jobs provisionam a infraestrutura especificada, executam o artefato do job e, em seguida, desprovisionam e destroem os recursos usados quando a execução do job é encerrada.

  • Usando a Console para Iniciar Execuções de Job de Nó Único

    Usando a Console para Iniciar Execuções de Job de Nó Único

    1. Na página da lista de jobs, selecione o nome do job com o qual trabalhar. Se precisar de ajuda para encontrar a lista de jobs, consulte Listando Jobs.
    2. Selecione Iniciar uma execução de job.
    3. (Opcional) Selecione outro compartimento para a execução do job.
    4. (Opcional) Informe um nome para a execução do job (limite de 255 caracteres). Caso você não forneça um nome, um nome é gerado automaticamente.

      Por exemplo, jobrun20210808222435.

    5. (Opcional) Substitua a configuração de job padrão que foi definida quando o job foi criado usando estas opções:
      Informe ou selecione um dos valores a seguir:
      Chave de variável de ambiente personalizada

      As variáveis de ambiente que controlam o job.

      Valor

      O valor da chave de variável de ambiente personalizada.

      Você pode selecionar Chave de ambiente personalizada adicional para especificar mais variáveis.

      Argumentos de linha de comando

      Os argumentos de linha de comando que deseja usar para executar o job.

      Runtime máximo (em minutos)

      O tempo máximo em minutos que a execução do job pode durar. O serviço cancelará a execução do job se o runtime exceder o valor especificado. O runtime máximo é de 30 dias (43.200 minutos). Recomendamos que você configure um runtime máximo em todas as execuções de jobs para evitar fuga de execuções.

    6. (Opcional) Informe um valor para a substituição máxima de runtime (em minutos).
    7. Substitua a configuração do recurso de rede, que foi definida quando o job foi criado.
      O tipo de rede não pode ser alterado.
      • Se a Rede Padrão estiver configurada, nada poderá ser substituído.
      • Se o serviço Custom Networking estiver configurado, você terá a opção de alterar a VCN e a sub-rede selecionadas.
    8. (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.
    9. (Opcional) Substituir a configuração de Armazenamento.
      Informe o volume de 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.
    10. Substitua a configuração do ambiente, que foi definida quando o job foi criado, usando estas opções:
      1. Em Configuração de ambiente, selecione Selecionar. O painel Definir seu ambiente BYOC é exibido.
      2. Em Repositório, selecione um repositório na lista. Se o repositório estiver em outro compartimento, selecione Alterar compartimento.
      3. Em Imagem, selecione uma imagem na lista.
      4. (Opcional) Em Ponto de entrada, informe um ponto de entrada. Para adicionar outro, selecione o parâmetro +Add.
      5. (Opcional) Em CMD, informe um CMD. Para adicionar outro, selecione o parâmetro +Add.
        Observação

        use CMD como argumentos para o ENTRYPOINT ou o único comando a ser executado na ausência de um ENTRYPOINT.
      6. (Opcional) Em Compilação de imagem, informe uma compilação de imagem.
      7. (Opcional) Em ID da Assinatura, se estiver usando a verificação de assinatura, digite o OCID da assinatura da imagem. Por exemplo, ocid1.containerimagesignature.oc1.iad.aaaaaaaaab....
      8. Selecione Selecionar.
    11. (Opcional) Substitua a configuração de Registro em Log.
      1. Selecione um grupo de logs na lista. Você pode mudar para outro compartimento para especificar um grupo de logs em outro compartimento do job.
      2. Selecione uma das seguintes opções para armazenar todas as mensagens stdout e stderr:
        Ativar criação automática de log

        O Data Science cria automaticamente um log quando o job é iniciado.

        Selecionar um log

        Selecione um log a ser usado.

    12. (Opcional) Substitua a sondagem de inicialização.
      1. Insira um comando.
      2. (Opcional) Para adicionar outro comando, selecione comando +Add e repita a etapa a.
      3. (Opcional) Informe um valor para o atraso inicial (em segundos).
      4. (Opcional) Informe um valor do período.
      5. (Opcional) Informe um valor para o limite de falha.
      6. Selecione Salvar.
    13. (Opcional) Selecione Mostrar opções avançadas para adicionar tags à execução do job.
    14. (Opcional) Na seção Tags, adicione uma ou mais tags à execução do job. Se você tiver permissões para criar uma execução de job, também terá permissões para aplicar tags de formato livre a essa execução de job. 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.
    15. Selecione Iniciar.
    Usando a Console para Iniciar Execuções de Jobs de Vários Nós

    Usando a Console para Iniciar Execuções de Jobs de Vários Nós

    1. Na página da lista de jobs, selecione o nome do job com o qual trabalhar. Se precisar de ajuda para localizar a lista de jobs, consulte Listando Jobs.
    2. Selecione Iniciar uma execução de job.
    3. (Opcional) Selecione outro compartimento para a execução do job.
    4. (Opcional) Informe um nome para a execução do job (limite de 255 caracteres). Caso você não forneça um nome, um nome é gerado automaticamente.

      Por exemplo, jobrun20210808222435.

    5. (Opcional) Informe um valor para a substituição máxima de runtime (em minutos).
    6. Substitua a configuração do recurso de rede, que foi definida quando o job foi criado.
      O tipo de rede não pode ser alterado.
      • Se a Rede Padrão estiver configurada, nada poderá ser substituído.
      • Se o serviço Custom Networking estiver configurado, você terá a opção de alterar a VCN e a sub-rede selecionadas.
    7. (Opcional) Substitua a configuração do grupo de nós, que foi definida quando o job foi criado.

      As configurações de cada grupo de nós podem ser substituídas individualmente clicando no menu Ações (três pontos) do grupo de nós e selecionando Editar.

      1. (Opcional) Substitua o número de réplicas.
      2. (Opcional) Substitua o número mínimo de réplicas que devem ter êxito.
      3. (Opcional) Substitua o Armazenamento. Informe o volume de 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.

      4. (Opcional) Substitua a configuração de job padrão usando estas opções:

        Informe ou selecione qualquer um dos seguintes valores:
        Chave de variável de ambiente personalizada

        As variáveis de meio ambiente que controlam o job.

        Valor

        O valor da chave da variável de ambiente personalizada.

        Você pode selecionar Chave de ambiente personalizada adicional para especificar mais variáveis.

        Argumentos de linha de comando

        Os argumentos de linha de comando que deseja usar para executar o job.

      5. 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.
      6. (Opcional) Substitua a configuração de Sondas:
        1. Insira um comando.
        2. (Opcional) Para adicionar outro comando, selecione comando +Add e repita a etapa a.
        3. (Opcional) Informe um valor para o atraso inicial (em segundos).
        4. (Opcional) Informe um valor do período.
        5. (Opcional) Informe um valor para o limite de falha.
        6. Selecione Salvar.
    8. (Opcional) Substitua a configuração de Registro em Log.
      1. Selecione um grupo de logs na lista. Você pode mudar para outro compartimento para especificar um grupo de logs em outro compartimento do job.
      2. Selecione uma das seguintes opções para armazenar todas as mensagens stdout e stderr:
        Ativar criação automática de log

        O serviço Data Science cria automaticamente um log quando o job é iniciado.

        Selecionar um log

        Selecione um log a ser usado.

    9. (Opcional) Selecione Mostrar opções avançadas para adicionar tags à execução do job.
    10. (Opcional) Na seção Tags, adicione uma ou mais tags à execução do job. Se você tiver permissões para criar uma execução de job, também terá permissões para aplicar tags de formato livre a essa execução de job. 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.
    11. Selecione Iniciar.

  • Essas variáveis de ambiente controlam o job.

    Use a CLI do Serviço Data Science para iniciar execuções de job como neste exemplo:

    1. Inicie uma execução de job com: 
      oci data-science job-run create \
--display-name <job_run_name> \
--compartment-id <compartment_ocid> \
--project-id <project_ocid> \
--job-id <job_ocid> \
--configuration-override-details file://<optional_job_run_configuration_override_json_file> \
--log-configuration-override-details file://<optional_job_run_logging_configuration_override_json_file>
    2. (Opcional) Use este arquivo JSON de substituição de configuração da execução de job para substituir as configurações definidas no job principal: 
      jobEnvironmentConfigurationDetails: {
  jobEnvironmentType: "OCIR_CONTAINER",
    image: "iad.ocir.io/axoxdievda5j/odsc-byod-hello-wrld:0.1.3",
    imageDigest: "sha256",
  cmd: ["ls", "-h"],
  entrypoint: ["-l"],
    imageSignatureId: "ocid1.containerimagesignature.oc1.iad.0.ociodscdev.aaaaaaaaccutw5qdz6twjzkpgmbojdck3qotqqsbn7ph6xcumu4s32o6v5gq",
},
    jobConfigurationDetails: {
        jobType: "DEFAULT",
        environmentVariables: <envar-list-object>},
    ...
}
    3. (Opcional) Use este arquivo JSON de substituição de configuração do registro em log da execução de job para substituir a configuração de registro em log definida no job principal: 
      {
  "enableLogging": true,
  "enableAutoLogCreation": true,
  "logGroupId": "<log_group_ocid>"
}

  • O ADS SDK também é uma biblioteca Python disponível publicamente que você pode instalar com este comando:

    pip install oracle-ads

    Ele fornece o wrapper que torna o trabalho inicial executado a partir de notebooks ou na sua máquina cliente fácil.

    Use o ADS SDK para iniciar execuções de jobs.