OmniLab Android Test Station

O OmniLab ATS é uma ferramenta de teste que desenvolvedores Android e engenheiros de teste podem usar para empregar uma interface do usuário para executar pacotes de testes padrão do Android, como o conjunto de teste de compatibilidade (CTS) do Android. Essa ferramenta atua como uma interface da Web para vários frameworks de teste, como o Trade Federation (TF) e o Google Mobly, permitindo que você execute o CTS e testes multidispositivo em um conjunto de dispositivos de teste com configuração mínima, além de estabelecer uma programação para executar testes continuamente.

Introdução ao OmniLab ATS 2.0

O OmniLab ATS 2.0 migra a infraestrutura de execução do teste subjacente do Trade Federation para o OmniLab. Essa mudança traz um back-end mais robusto e eficiente, preservando a interface do usuário e os fluxos de trabalho do OmniLab ATS 1.0.

Principais benefícios do OmniLab ATS 2.0:

• Infraestrutura modernizada:aproveita a plataforma OmniLab para melhorar a estabilidade e o desempenho.
• Transição perfeita:sem mudanças na interface da Web ou nos fluxos de trabalho principais de execução de testes.
• Preparado para o futuro:alinha-se à infraestrutura de testes unificada do Google, permitindo uma adoção mais rápida de novos recursos.

O OmniLab ATS 2.0 inclui novos recursos, como atualizações em massa do plano de teste, alocação avançada de dispositivos e muito mais. Confira as notas da versão para ver as atualizações.

Fazer upgrade para o OmniLab ATS 2.0:

Para usar o OmniLab ATS 2.0, faça upgrade da sua estação para o build R52 ou mais recente. Use a flag --force_ats_version 2 para mudar para o novo Omnilab ATS 2.0 e a flag --force_update com o comando mtt start para fazer upgrade para o build mais recente:

mtt start --force_ats_version 2 --force_update

Durante o período de migração, recomendamos usar a tag dogfood para acessar o build estável mais recente com os recursos do OmniLab ATS 2.0:

mtt start --force_ats_version 2 --tag dogfood --force_update

Planejamos tornar o OmniLab ATS 2.0 a versão padrão no terceiro trimestre de 2026. Planejamos desativar o OmniLab ATS 1.0 até o final de 2026.

Para mais detalhes sobre atualizações específicas, diferenças conhecidas e orientações de upgrade, consulte o Guia de upgrade do OmniLab ATS 2.0.

Configurar o ATS do OmniLab

Nesta seção, explicamos como instalar e configurar o OmniLab ATS.

O OmniLab ATS usa o código-fonte destes locais:

• Código-fonte do OmniLab ATS
• Código-fonte do cluster do TradeFed

Instalar o ATS do OmniLab

Siga todos os requisitos de hardware e software para os pacotes de testes que você executar.

Os requisitos do CTS estão disponíveis em source.android.com.

Não há outros requisitos de hardware para o ATS do OmniLab, mas recomendamos usar o requisito de host do CTS como ponto de partida.

Há duas maneiras de instalar o OmniLab ATS:

• Execute o programa de instalação.
• Instale-o manualmente, o que requer a instalação de vários programas e recursos.

Instalar com o programa de instalação

O programa de instalação é compatível com o Ubuntu 22.04 e versões mais recentes. O instalador instala e configura todos os programas e recursos necessários para executar o OmniLab ATS.

Para usar o programa de instalação:

1. Execute o programa de instalação:

   curl https://storage.googleapis.com/android-mtt.appspot.com/prod/install.sh | bash
   

2. Execute mtt version para verificar a versão instalada da CLI do OmniLab ATS.

Instalar manualmente

Instalar o Docker

1. Siga as instruções para instalar o Docker Community Edition (CE) na máquina Linux.

2. Siga as etapas pós-instalação para gerenciar o Docker como um usuário raiz não.

3. Talvez seja necessário reiniciar a janela do terminal ou sair e fazer login novamente para que as mudanças de permissão entrem em vigor.

Instalar o Python 3

A CLI do OmniLab ATS requer o Ubuntu 22.04 ou mais recente. A CLI é verificada com as versões 3.10 a 3.13 do Python.

Para instalar o Python 3, execute estes comandos:

sudo apt-get update
sudo apt install python3 python3-distutils

Se você precisar de uma versão do Python 3 que não esteja incluída na distribuição padrão, primeiro adicione o repositório do Python 3 seguindo um destes procedimentos:

• Execute este comando:

  sudo add-apt-repository ppa:deadsnakes/ppa
  

• Crie e instale o repositório da origem.

Para instalar uma versão específica do Python 3 (por exemplo, 3.10), execute estes comandos:

sudo apt-get update
sudo apt install python3.10 python3.10-distutils

Acessar a CLI do OmniLab ATS

Baixe o pacote da interface de linha de comando (CLI) aqui.

Iniciar o ATS do OmniLab

Inicie o ATS do OmniLab com o seguinte comando:

mtt start

Na primeira vez que a interface for iniciada, pode levar alguns minutos para que ela apareça. A CLI mostra um URL da Web para acessar a interface em um navegador. Por padrão, o URL da Web é localhost:8000. Se necessário, é possível mudar a porta padrão na inicialização com a flag --port.

Se uma versão mais recente estiver disponível, você poderá atualizar para a versão atual. Confira as Notas da versão para saber mais sobre as versões mais recentes.

Para atualizar para a versão atual, execute:

mtt start --force_update

Para interromper o app, execute:

mtt stop

Para ver uma lista de outros comandos, use:

mtt --help

Fazer backup e restaurar o banco de dados

Para fazer backup do banco de dados do OmniLab ATS, interrompa o app e execute o seguinte comando, que faz backup do banco de dados atual em um arquivo TAR chamado mtt-backup.tar no diretório principal:

docker run --rm --mount source=mtt-data,target=/data -v ~:/out ubuntu bash -c "cd /data && tar cvf /out/mtt-backup.tar ."

Para restaurar, execute o seguinte comando antes de iniciar o app:

docker run --rm --mount source=mtt-data,target=/data -v ~:/out ubuntu bash -c "cd /data && tar xvf /out/mtt-backup.tar"

Assistente de configuração

Depois de instalar e executar o OmniLab ATS pela primeira vez, o assistente de configuração vai guiar você por algumas etapas para personalizar a ferramenta para seu ambiente. Todas as mudanças feitas aqui podem ser reconfiguradas mais tarde na página "Configurações".

Restaurar um backup de configuração

Se você tiver um arquivo de configuração salvo em backup de outro host do OmniLab ATS, clique no botão Fazer upload de arquivo para fazer upload do arquivo e copiar as configurações modificadas desse host.

Figura 1. Como restaurar um backup de configuração.

Definir a conta de serviço padrão

É possível definir uma conta de serviço que o OmniLab ATS usa por padrão ao acessar seus recursos (por exemplo, Google Cloud Storage, Google Drive). Para autenticar sua conta de serviço, clique em Fazer upload da chave da conta de serviço e selecione o arquivo de chave JSON da conta de serviço.

Figura 2. Configurando a conta de serviço.

Quando a conta de serviço é autenticada, o endereço de e-mail dela aparece no canto superior direito da página. Para mudar a conta de serviço, clique no nome da conta, remova a conta padrão atual e faça upload de uma nova chave de conta de serviço.

Figura 3. Alterar a conta de serviço.

Importar conjuntos de configuração

Um conjunto de configurações é um pacote de configurações para executar pacotes de testes, incluindo ações de dispositivo relacionadas e canais de build. Os conjuntos de configuração são hospedados em um bucket específico do Google Cloud Storage (GCS). Depois de autenticar o canal de build do GCS com sua Conta do Google, você verá uma lista de todos os conjuntos de configuração disponíveis.

Selecione os conjuntos de configuração que você quer adicionar ao host da Test Station e clique em Import Selected.

Figura 4. Importar um conjunto de configurações.

Incluir configurações de Wi-Fi

Alguns testes do CTS exigem que o dispositivo se conecte a um ponto de acesso Wi-Fi. Para selecionar sua rede Wi-Fi, insira o SSID do Wi-Fi e a PSK do Wi-Fi (opcional).

Figura 5. Configurações do ponto de acesso Wi-Fi.

Depois de concluir o assistente de configuração, a página é recarregada com as novas configurações aplicadas.

Conectar um dispositivo

A depuração USB precisa estar ativada para usar um dispositivo para testes. Para ativar a depuração:

1. Siga as instruções em Ativar as opções do desenvolvedor e a depuração.

2. Se você planeja usar builds de teste do Android pré-carregados com chaves ADB personalizadas, coloque os arquivos .adb_key personalizados no diretório ~/.android/.

   Os arquivos são carregados automaticamente e transmitidos ao ADB para ativar a depuração USB depois que o dispositivo é atualizado para dispositivos que executam essas versões.

3. Conecte o dispositivo à máquina host usando USB.

   O dispositivo aparece na guia "Dispositivos" do OmniLab ATS em até um minuto após a atualização da interface da Web. Também é possível ver o estado dos dispositivos nessa guia.

   

   Figura 6. Conectar um dispositivo.

Os diferentes estados do dispositivo são:

• Disponível: o dispositivo está conectado e pronto para executar um teste.
• Alocado: o dispositivo está conectado e executando um teste. Cada dispositivo pode executar apenas um teste por vez. Portanto, ele precisa concluir o teste atual antes de executar um novo.

Executar um teste

Selecione um teste

O OmniLab ATS vem com um conjunto de configurações pré-empacotadas do CTS. Para executar um desses testes, acesse a guia "Pacotes de testes" e clique em Executar teste para o teste selecionado.

Figura 7. Selecionar um teste.

Para editar ou adicionar novos testes, consulte Como adicionar testes.

Configurar execução do teste

Edite os parâmetros que serão usados para essa execução de teste específica. A maioria dos parâmetros é preenchida com valores definidos na configuração de teste selecionada.

Essa etapa pode ser concluída usando os valores padrão, mas é possível mudar qualquer um dos parâmetros, como Máximo de novas tentativas e Comando, para atender às suas necessidades.

Figura 8. Como configurar uma execução de teste.

Os parâmetros de execução do teste são:

• Nome: nome do pacote de testes que você quer executar.
• Contagem de execuções: número de vezes que essa execução de teste deve ser realizada quando programada. As execuções de teste são programadas usando a Trade Federation, que executa até 20 testes em paralelo, se houver capacidade para isso.
• Máximo de novas tentativas: número máximo de vezes que uma execução de teste será repetida se pelo menos um teste falhar. Normalmente, isso é definido como 4 a 6 novas tentativas para uma execução completa do CTS para lidar com testes instáveis.
• Tempo limite da fila: se uma execução de teste permanecer no estado Na fila por muito tempo, ela será cancelada automaticamente. Especifique o tempo de espera antes do cancelamento aqui. O padrão é 24 horas.

• Comando: o comando para executar o pacote de testes. Você pode inserir outros argumentos de linha de comando aqui. Por exemplo, execute um módulo específico no CTS 8.1 com:

  cts-suite -m ShortModuleName
  

• Comando de nova tentativa: o comando para tentar novamente um pacote de testes. É possível adicionar outros argumentos de linha de comando aqui. Por exemplo, para repetir apenas um módulo específico no CTS 8.1, use:

  cts --retry 0 -m ShortModuleName
  

  Os argumentos de nova tentativa podem ser diferentes daqueles disponíveis com o comando inicial. Portanto, verifique os parâmetros compatíveis no site oficial do pacote de testes selecionado.

• Execução de teste anterior: se você quiser repetir uma execução de teste anterior:

  • Local: se a execução foi iniciada no host atual, insira o ID do teste mostrado ao visualizar os detalhes do teste.

    

    Figura 9. Execução de teste anterior local.

  • Remoto: se a execução tiver sido iniciada em um host diferente, faça upload do arquivo de resultados do teste selecionando Remoto, clicando em Fazer upload do arquivo de resultados do teste e selecionando um arquivo do armazenamento local.

    

    Figura 10. Remova a execução de teste anterior.

Dispositivos selecionados

Clique nas caixas de seleção para selecionar os dispositivos que serão alocados para executar o pacote de testes. A contagem de fragmentos deve mudar automaticamente para corresponder ao número de dispositivos selecionados.

Figura 11. Selecionar dispositivos.

Para selecionar dispositivos por atributos que não sejam números de série, insira manualmente as "Especificações do dispositivo". Por exemplo, para selecionar três dispositivos com o nome do produto "bramble", digite o seguinte:

product:bramble;product:bramble;product:bramble

Os atributos aceitos são:

• build_id
• device_serial
• device_type
• nome do host
• produto
• product_variant
• sim_state

Todos os dispositivos selecionados precisam estar no estado Disponível para executar o teste, e todos eles mudam para o estado Alocado quando o teste é executado. Uma execução de teste fica no estado Em fila enquanto aguarda os dispositivos ficarem disponíveis.

Adicionar ações do dispositivo

As ações do dispositivo são scripts que podem ser executados antes de cada execução de teste. Algumas ações do dispositivo já vêm configuradas, como atualização e reinicialização. Para criar novas ações de dispositivo, consulte Criar uma nova ação de dispositivo.

Figura 12. Ações do dispositivo.

Para adicionar uma ação de dispositivo a uma execução de teste, clique em Add new action, marque as caixas de seleção das ações que você quer adicionar e clique em Add Action(s). As ações do dispositivo são realizadas sequencialmente. Para reordenar as ações, arraste-as.

Figura 13. Reordenando ações.

Definir recursos de teste

Os recursos de teste são arquivos necessários para executar um teste. Por exemplo, para executar o CTS, é necessário um arquivo android-cts*.zip, e para atualizar um dispositivo, é preciso fornecer a imagem do build.

O URL de download do arquivo ZIP do pacote de testes deve ser, por padrão, os links do Google Drive fornecidos aos parceiros. Para selecionar outro arquivo, clique em Procurar. Na janela pop-up, é possível inserir um link de download de arquivo, usar um arquivo de um canal de build autenticado ou fazer upload de um arquivo para usar do armazenamento local.

Figura 14. Recursos de teste.

Confira abaixo a janela pop-up para selecionar um recurso de teste por um URL da Web. Insira o link do URL de download e clique no botão Selecionar para confirmar a seleção.

Figura 15. Seletor de recursos de teste: URL da Web.

Se você tiver feito upload de recursos para o Google Drive, o Google Cloud Storage (GCS) ou outros canais, também poderá acessar a guia do canal específico e selecionar os recursos nela. Veja um exemplo de como selecionar um recurso do Google Drive.

Figura 16. Testar o seletor de recursos: Google Drive.

Além de selecionar arquivos, caracteres curinga também são aceitos no campo Nome do arquivo. A documentação está disponível neste link.

Figura 17. Seletor de recursos de teste: suporte a padrões de caracteres curinga.

Também é possível selecionar um arquivo do armazenamento local do OmniLab ATS. É possível fazer upload de arquivos para esse armazenamento ou usar diretamente arquivos e diretórios locais.

Figura 18. Seletor de recursos de teste: armazenamento de arquivos local.

Adicionar configurações de nova execução

É possível programar novas execuções que começam após a conclusão da execução principal e carregam os resultados, mas podem usar dispositivos, ações ou recursos diferentes.

Figura 19. Adicionando configurações de nova execução.

Iniciar um teste

Depois de inserir as informações necessárias para a execução de teste, clique em Iniciar execução de teste. Se todas as informações forem válidas, a execução do teste será iniciada e você será redirecionado para uma página com os detalhes e o progresso da execução.

Figura 20. Iniciar um teste.

Criar um plano de teste

Os planos de teste são usados para criar execuções de teste em uma programação periódica. Por exemplo, executar o CTS 9.0 todos os dias às 17h. Para criar um novo plano de teste, clique em Criar um novo plano de teste.

Figura 21. Criar um plano de teste.

Configurar plano de teste

Insira o nome do plano de teste e os rótulos que você quer adicionar. Em seguida, selecione uma programação para usar.

• Manual: o plano de teste cria execuções de teste somente quando um usuário clica em Executar plano de teste na página da lista de planos de teste.
• Periódico: o plano de teste programa automaticamente as execuções de teste na programação periódica selecionada. Por exemplo, programar uma execução de teste todos os dias às 17h.
• Personalizado: o plano de teste programa automaticamente as execuções de teste com base na expressão cron inserida. Por exemplo, para programar uma execução de teste todos os dias às 17h, a expressão cron é 0 17 * * *.

Figura 22. Configurar um plano de teste.

Adicionar pacotes de testes

Adicione os pacotes de testes que você quer programar pelo plano de teste clicando em + Adicionar configuração de execução de teste. Selecione um pacote de testes no menu suspenso Nome e clique em Próxima etapa. Em seguida, selecione os dispositivos em que você quer executar o teste e clique em Add Configuration. É possível adicionar várias configurações para cada plano de teste.

Figura 23. Como configurar uma execução de teste.

Adicionar ações do dispositivo

Adicione as ações do dispositivo que você quer executar antes de cada teste. Consulte Como adicionar ações do dispositivo para mais detalhes.

Figura 24. Adicionar ações do dispositivo.

Definir recursos de teste

Adicionar recursos de teste a planos de teste é o mesmo que adicioná-los a execuções de teste individuais. Consulte Como definir recursos de teste para mais detalhes.

Figura 25. Como definir recursos de teste.

Ver execuções de teste

Lista de execuções de teste

Confira a lista de execuções de teste programadas na página "Execuções de teste". Clique em Visualizar para ver mais detalhes sobre uma execução de teste.

Também é possível filtrar a lista inserindo uma string na barra de filtro e pressionando a tecla Enter. É possível usar vários filtros separando-os com uma vírgula. O filtro retorna todas as linhas que contêm o texto exato (sem correspondência de substring) em qualquer coluna, exceto Status e Criado.

Um filtro vazio retorna todas as linhas. No momento, não é possível filtrar linhas com valores vazios.

Figura 26. Lista de execuções de teste.

Detalhes da execução de teste

É possível ver os detalhes de uma execução de teste aqui, como status, registros e resultados.

Figura 27. Detalhes da execução do teste.

Status da execução de teste

O progresso de uma execução de teste é mostrado na seção "Status". Se houver uma mensagem relacionada, como progresso do download, motivo do cancelamento ou mensagem de erro, ela também será mostrada aqui.

Figura 28. Status da execução do teste.

Os estados de execução do teste são:

• Pendente: os recursos necessários estão sendo baixados.
• Na fila: o teste está pronto para ser executado quando um dispositivo estiver disponível.
• Em execução: o teste está sendo executado em um dispositivo alocado.
• Concluído: o teste foi concluído e os resultados foram informados.
• Cancelado: o teste foi cancelado pelo usuário ou expirou ao tentar encontrar dispositivos disponíveis.
• Erro: ocorreu um erro que impediu a execução do teste.

Cancelar um teste

Se a execução de teste não tiver sido concluída, clique em Cancelar e em Sim na caixa de diálogo de confirmação. As execuções de teste também serão canceladas automaticamente se permanecerem no estado Em fila por mais tempo do que o campo queue_timeout_seconds. O cancelamento de uma execução de teste no estado Em execução pode levar alguns minutos para entrar em vigor.

Figura 29. Como cancelar uma execução de teste.

Resultados da execução de teste

Depois que uma execução de teste é concluída, os resultados são coletados e exibidos. Para ver mais detalhes, clique na seta de cada execução. Clique em View Output Files para conferir os artefatos de teste coletados, como test_result.xml e test_result_failures.html.

Figura 30. Resultados da execução do teste.

É possível conferir os registros do host e do Tradefed na guia "Registros".

Figura 31. Guia "Registros".

Os resultados de módulos individuais estão na guia "Resultados do teste".

Figura 32. Guia "Resultados do teste".

Para baixar os arquivos usados como recursos de teste, clique em Abrir na guia Recursos de Teste.

Figura 33. Guia "Recursos de teste".

Para ver os detalhes da execução do teste, como create_time, acesse a guia "Configuração".

Figura 34. Guia "Configuração".

Recursos avançados

Gerenciar arquivos de configuração

O OmniLab ATS usa arquivos de configuração escritos em YAML para carregar opções predefinidas, como testes, canais de build e ações do dispositivo. Confira um exemplo de arquivo de configuração:

// example_file.yaml
tests:
- id : android.cts.9_0.arm
  name: CTS 9.0 (ARM)
  test_resource_defs:
  - name: android-cts.zip
    default_download_url: https://dl.google.com/dl/android/cts/android-cts-9.0_r7-linux_x86-arm.zip
    test_resource_type: TEST_PACKAGE
  command: cts
  env_vars:
  - name: TF_PATH
    value: ${TF_WORK_DIR}/android-cts/tools:${TF_WORK_DIR}/android-cts/testcases
  - name: LD_LIBRARY_PATH
    value: ${TF_WORK_DIR}/android-cts/lib:${TF_WORK_DIR}/android-cts/lib64
  setup_scripts:
  output_file_patterns:
  - android-cts/logs/latest/.*
  - android-cts/results/latest/.*\.html
  - android-cts/results/latest/compatibility_result\..*
  - android-cts/results/latest/logo.png
  - android-cts/results/latest/test_result.xml
  result_file: test_result.xml
  java_properties:
  - name: CTS_ROOT
    value: ${TF_WORK_DIR}
  context_file_dir: android-cts/results/
  context_file_pattern: '[\d_\.]+\.zip'
  retry_command_line: retry --retry 0
  runner_sharding_args: --shard-count ${TF_SHARD_COUNT}

build_channels:
- id: google_drive
  name: Google Drive
  provider_name: Google Drive

device_actions:
- id: flash
  name: Flash
  test_resource_defs:
  - name: bootloader.img
    test_resource_type: DEVICE_IMAGE
  - name: radio.img
    test_resource_type: DEVICE_IMAGE
  - name: img.zip
    test_resource_type: DEVICE_IMAGE
  tradefed_target_preparers:
  - class_name: com.android.tradefed.targetprep.RunHostCommandTargetPreparer
    option_values:
    - name: work-dir
      values:
      - ${TF_WORK_DIR}
    - name: host-setup-command
      values:
      - adb -s $SERIAL reboot-bootloader
      - fastboot -s $SERIAL flash bootloader bootloader.img
      - fastboot -s $SERIAL flash radio radio.img
      - fastboot -s $SERIAL reboot-bootloader
      - fastboot -s $SERIAL -w update img.zip
      - adb -s $SERIAL wait-for-device
    - name: host-cmd-timeout
      values:
      - 10m

Ao configurar sua instância do OmniLab ATS, é possível compartilhar sua configuração com outros usuários exportando-a como um arquivo. Para fazer isso, acesse a página "Configurações" e clique em Exportar no canto superior direito.

Figura 35. Gerenciamento de arquivos de configuração.

Depois que o arquivo de configuração for baixado, compartilhe-o com outros usuários. Para adicionar o arquivo de configuração à instância do OmniLab ATS, clique em Importar e selecione o arquivo de configuração.

Criar uma ação de dispositivo

As ações do dispositivo são usadas para automatizar o processo de configuração do dispositivo. As ações são scripts executados em cada dispositivo em que o teste está sendo executado antes de cada execução de teste, inclusive antes de novas tentativas. Para ver uma lista de ações disponíveis, acesse a página de configurações e clique na guia "Ações no dispositivo". Várias ações do dispositivo já vêm configuradas, como reinicialização e atualização.

Figura 36. Guia "Ações do dispositivo".

Adicionar uma nova ação do dispositivo

1. Clique em Nova ação do dispositivo.

   

   Figura 37. Botão de ação do novo dispositivo.

2. Digite um nome e uma descrição.

   

   Figura 38. Nome da ação do dispositivo.

3. Clique em Adicionar preparador de destino.

4. Insira o nome completo da classe do preparador de destino da Trade Federation, por exemplo, com.android.tradefed.targetprep.RunHostCommandTargetPreparer.

   

   Figura 39. Adicionar um preparador de destino.

   Uma lista de preparadores de destino disponíveis pode ser encontrada na referência com.android.tradefed.targetprep.

   

   Figura 40. Lista de preparadores de destino.

5. Adicione as opções que serão usadas com o preparador de destino. Para conferir as opções disponíveis, verifique targetprep para o código-fonte de cada preparador de destino no AOSP:

   

   Figura 41. Exemplo de opção de ação.

6. Para adicionar uma opção, clique em Adicionar opção de preparador de destino e insira os valores necessários.

   

   Figura 42. Exemplo de comando de ação.

7. Defina os recursos de teste necessários para executar a ação do dispositivo, por exemplo, criar imagens para atualização. Para adicionar uma definição de recurso, clique em Add Test Resource e preencha os campos obrigatórios. Se você souber onde seus arquivos estão localizados, forneça um URL de download padrão clicando em procurar. Se os preparadores de destino aceitarem o diretório como recurso de teste, selecione Descompactar. Em seguida, especifique o diretório de Destino relativo no diretório de trabalho temporário e os Nomes de arquivos a serem descompactados. Se nenhum nome de arquivo for fornecido, todos os arquivos serão descompactados do recurso de teste.

   

   Figura 43. Recursos de teste de ação.

8. Clique em Atualizar.

   

   Figura 44. Ação para salvar as mudanças.

Gerenciar testes

Editar um teste

Para editar um teste salvo, acesse a página "Testes" e clique em Editar na linha do teste que você quer modificar. Depois de mudar a configuração do teste, clique em Atualizar.

Figura 45. Como editar um teste.

Adicionar um novo teste

Para adicionar um novo teste, acesse a página "Testes" e clique em Criar um novo teste. Insira as informações apropriadas e clique em Criar.

Figura 46. Criar um teste.

Figura 47. Como copiar um teste.

Exportar configurações do host

Depois de configurar um host, é possível exportar as configurações dele para um arquivo. É possível fazer upload desse arquivo para outros hosts para copiar as configurações salvas.

Para exportar as configurações de um host, acesse a página "Configurações" e clique em Exportar no canto superior direito.

Figura 48. Exportar uma configuração de host.

Para importar um arquivo de configuração de host, acesse a página "Configurações" e clique em Importar no canto superior direito.

Figura 49. Importar uma configuração de host.

Usar arquivos e diretórios locais

A partir da versão R11, os arquivos no diretório $HOME/.ats_storage são acessíveis automaticamente no OmniLab ATS. Copie ou mova um arquivo para esse diretório. Em seguida, selecione-o na guia Arquivo local ao programar uma execução de teste.

cp /path/to/file $HOME/.ats_storage

Figura 50. Selecionar um arquivo do diretório $HOME/.ats_storage.

É possível montar outros diretórios no armazenamento de arquivos local com a flag --mount_local_path.

mtt start --mount_local_path=/path/to/dir1 --mount_local_path=/path/to/dir2:renamed_dir2

Figura 51. Diretórios adicionais montados no armazenamento de arquivos local.

Ativar o modo de vários hosts

Com o modo de vários hosts, os usuários podem usar um único host controlador do ATS para gerenciar os dispositivos e testes em vários hosts de worker do ATS.

Figura 52. Arquitetura do modo de vários hosts.

1. Para iniciar o controlador do ATS, use o seguinte comando:

   mtt start --operation_mode=ON_PREMISE
   

2. Verifique se o controlador está acessível em http://${CONTROLLER_HOSTNAME}:8000.

3. Para iniciar os workers, use o seguinte comando:

   mtt start --control_server_url=http://CONTROLLER_HOSTNAME:8000 --operation_mode=ON_PREMISE
   

Se a rede não permitir que os hosts se comuniquem entre si, siga as instruções de configuração mais avançadas abaixo sobre o worker do ATS.

1. Conecte os dois hosts usando túneis SSH. Selecione as portas para o servidor principal e de arquivos, por exemplo, 9000 e 9006.

   ssh -L ATS_PORT:localhost:8000 -L FS_PORT:localhost:8006 CONTROLLER_HOSTNAME
   

2. Configurar e iniciar o ATS.

   DOCKER_GATEWAY_IP_ADDRESS=$(ip -4 addr show dev docker0 | grep -Eo 'inet [.0-9]+/' | grep -Eo '[.0-9]+')
   socat tcp-listen:ATS_PORT,bind="${DOCKER_GATEWAY_IP_ADDRESS}",reuseaddr,fork tcp-connect:127.0.0.1:ATS_PORT &
   socat tcp-listen:FS_PORT,bind="${DOCKER_GATEWAY_IP_ADDRESS}",reuseaddr,fork tcp-connect:127.0.0.1:FS_PORT &
   mtt start --control_server_url=http://${DOCKER_GATEWAY_IP_ADDRESS}:ATS_PORT \
                   --control_file_server_url=http://${DOCKER_GATEWAY_IP_ADDRESS}:FS_PORT \
                   --operation_mode=ON_PREMISE
   

Limpador de arquivos

O limpador de arquivos é um cron job executado de hora em hora para limpar arquivos com base em configurações definidas pelo usuário. O ATS tem duas configurações padrão para arquivar os resultados da execução de testes e excluir arquivos temporários. Neste guia, explicamos como personalizar as políticas e configurações para gerenciar seus arquivos de maneira eficaz.

Políticas

Uma política define a operação a ser realizada em arquivos ou diretórios e os critérios para selecionar destinos. As operações disponíveis são mostradas na tabela:

Os critérios são baseados em atributos de arquivo e informações do sistema. Os critérios disponíveis são mostrados na tabela:

Figura 53. Adicione uma nova política de limpeza de arquivos.

Configurações

Uma configuração combina uma ou mais políticas com diretórios específicos. Os arquivos e diretórios dentro dos diretórios especificados são processados com base nas políticas definidas. As políticas são aplicadas na ordem em que aparecem na configuração.

Todos os diretórios de destino precisam estar localizados no diretório /data. Se a configuração especificar o diretório de destino como logs, ele será interpretado como /data/logs.

Figura 54. Edite a configuração do limpador de arquivos.

Redefinir

Clicar em Reset Settings reverte a configuração do limpador de arquivos para o estado padrão. Essa ação limpa TODOS os itens personalizados.

Figura 55. Redefinir as configurações do limpador de arquivos.

Suporte

Relatórios de bugs

Sua contribuição para o OmniLab ATS ajuda a melhorar o desenvolvimento da ferramenta, e queremos sua opinião. Consulte as notas da versão do OmniLab ATS para mais detalhes sobre a versão mais recente. Para informar bugs ou oferecer sugestões, envie um relatório de bugs. Os parceiros devem informar bugs ou sugestões usando os canais de parceiros.