O OmniLab ATS é uma ferramenta de teste que desenvolvedores Android e engenheiros de teste podem usar empregar uma interface do usuário para executar conjuntos de testes padrão do Android, como o Conjunto de teste de compatibilidade (CTS) do Android. Esta ferramenta atua como uma interface da Web para vários frameworks de teste, como Trade Federation (TF) e O Google Mobly, o que permite executar o CTS e testes multidispositivo em um conjunto de dispositivos de teste com configuração mínima, bem como estabeleça uma programação para executar testes continuamente.
Configurar o ATS do OmniLab
Nesta seção, explicamos como instalar e configurar o ATS do OmniLab.
O OmniLab ATS usa o código-fonte destes locais:
- OmniLab ATS (em inglês) código-fonte
- Código-fonte do TradeFed Cluster
Instalar o OmniLab ATS
Siga todos os requisitos de hardware e software dos conjuntos de testes executados.
Os requisitos do CTS podem ser encontrados em source.android.com (link em inglês).
Não há requisitos de hardware adicionais para o OmniLab ATS, mas recomendamos usando o requisito de host do CTS como ponto de partida.
Há duas maneiras de instalar o OmniLab ATS:
- Execute o programa de instalação.
- Instalar manualmente, o que exige a instalação de vários programas e recursos do Google Cloud.
Instalar com o programa de instalação
No Ubuntu 20.04+, o programa de instalação instala e configura todos os programas e os recursos necessários para executar o OmniLab ATS.
Para usar o programa de instalação:
Execute o programa de instalação:
curl https://storage.googleapis.com/android-mtt.appspot.com/prod/install.sh | bash
Execute
mtt versionpara verificar a versão instalada da CLI ATS OmniLab.
Instalar manualmente
Instale o Docker
Siga o instruções para instalar o Docker Community Edition (CE) na máquina Linux.
Siga o etapas pós-instalação para gerenciar o Docker como um usuário não raiz.
Talvez seja necessário reiniciar a janela do terminal ou sair e fazer login novamente. para que as mudanças nas permissões entrem em vigor.
Instale o Python 3
A CLI ATS OmniLab é verificada nas versões 3.7 a 3.11 do Python.
Para Ubuntu 16.04 ou anterior, primeiro adicione o repositório para Python 3 fazendo um um dos seguintes:
Execute este comando:
sudo add-apt-repository ppa:deadsnakes/ppa
Criar e instalar o repositório da origem.
Para instalar o Python 3, execute estes comandos:
sudo apt-get updatesudo apt install python3 python3-distutils
Para instalar uma versão específica do Python 3 (por exemplo, 3.10), execute estes comandos: como alternativa:
sudo apt-get updatesudo apt install python3.10 python3.10-distutils
Instalar a CLI ATS OmniLab
Faça o download do pacote da interface de linha de comando (CLI) aqui.
Iniciar o OmniLab ATS
Inicie o OmniLab ATS com o seguinte comando:
mtt start
Na primeira vez que a interface for iniciada, talvez leve alguns minutos para aparecer. A CLI
exibe um URL da Web para acessar a IU em um navegador. Por padrão, o URL da Web é
localhost:8000: Se necessário, altere a porta padrão durante a inicialização com o comando
a sinalização --port.
Se uma versão mais recente estiver disponível, você poderá atualizar para a versão atual. Você pode verifique as Notas de lançamento para conhecer os lançamentos mais recentes.
Para atualizar para a versão atual, execute:
mtt start --force_update
Para interromper o app, execute:
mtt stop
Para conferir uma lista com outros comandos, use:
mtt --help
Fazer backup e restaurar o banco de dados
Para fazer backup do banco de dados ATS OmniLab, pare o app e execute o comando abaixo:
que faz backup do banco de dados atual em um arquivo TAR chamado mtt-backup.tar em
seu 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 leva algumas etapas para ajudar você a personalizar a ferramenta para seu ambiente. Qualquer um as alterações que você fizer aqui poderão ser reconfiguradas posteriormente na página "Configurações".
Restaurar um backup de configuração
Se você tiver um arquivo de configuração salvo em backup do outro host OmniLab ATS, poderá fazer upload do arquivo para copiar as configurações modificado a partir desse host clicando no botão Fazer upload do arquivo.
Figura 1. Restauração de 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 Faça upload da chave da conta de serviço e selecione o arquivo de chave JSON da sua conta de serviço.
Figura 2. Definição da conta de serviço
Quando a conta de serviço é autenticada, o e-mail da conta endereço aparecerá no canto superior direito da página. Para mudar o serviço conta, clique no nome dela, remova a conta padrão atual e faça o upload 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 do dispositivo e criar canais. Os conjuntos de configuração são hospedados em um do Cloud Storage (GCS). Depois de autenticar o canal de criação do GCS com o 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 Importar itens selecionados.
Figura 4. Como importar um conjunto de configurações
Incluir configurações de Wi-Fi
Alguns testes de CTS exigem que seu dispositivo se conecte a um ponto de acesso Wi-Fi. Para selecionar seu rede Wi-Fi, digite o SSID do Wi-Fi e o Wi-Fi PSK opcional.
Figura 5. Configurações de ponto de acesso Wi-Fi.
Depois de concluir o assistente de configuração, a página será recarregada com as novas configurações. aplicada.
Conectar dispositivo
A depuração USB deve estar ativada para usar um dispositivo em testes. Para ativar a depuração:
Siga as instruções Ative as Opções do desenvolvedor e depuração.
Se você planeja usar builds de teste do Android pré-carregados com chaves adb personalizadas, coloque os arquivos
.adb_keypersonalizados no diretório~/.android/.Os arquivos são carregados automaticamente e transmitidos ao adb para ativar o USB automaticamente. a depuração depois que o dispositivo é atualizado para dispositivos que executam esses builds.
Conecte o dispositivo à máquina host usando USB.
O dispositivo aparece na guia "Dispositivos ATS do OmniLab" um minuto após atualizando a interface da Web. Também é possível conferir o estado dos dispositivos no nesta guia.
Figura 6. Conectando um dispositivo.
Os diferentes estados são:
- Disponível: o dispositivo está conectado e pronto para executar um teste.
- Alocado: o dispositivo está conectado e está executando um teste. Cada dispositivo pode executar apenas um teste por vez, portanto, o dispositivo deve concluir sua teste atual antes de executar um novo.
Executar um teste
Selecione um teste
O OmniLab ATS vem com um conjunto de configurações de CTS pré-agrupadas. Para executar uma das esses testes, acesse a guia "Pacotes de testes" e clique em Executar teste nos teste.
Figura 7. Seleção de um teste.
Para editar ou adicionar novos testes, consulte Como adicionar testes.
Configurar a execução do teste
Edite os parâmetros que serão usados nessa execução de teste específica. A maioria dos parâmetros é pré-preenchido com valores definidos na configuração de teste selecionada.
Esta etapa pode ser concluída usando os valores padrão, mas é possível alterar qualquer um os parâmetros, como Max Retry e Command, para atender às suas necessidades.
Figura 8. 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.
- Run Count: o número de vezes que este teste deve ser executado quando programados. As execuções de teste são programadas Trade Federation, que executa até 20 o teste será executado em paralelo se houver capacidade para isso.
- Máximo de novas tentativas: o número máximo de vezes que um teste é executado novamente, se pelo menos uma vai falhar. Isso geralmente é definido como quatro a seis tentativas para uma execução completa do CTS para e lidar com testes instáveis.
- Tempo limite na 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 de o cancelamento aqui. O padrão é 24 horas.
Comando: o comando para executar o pacote de testes. É possível inserir valores argumentos de linha de comando. Por exemplo, executar um módulo específico no CTS 8.1 por:
cts-suite -m ShortModuleNameRepetir comando: o comando para repetir um pacote de testes. Você pode adicionar mais argumentos de linha de comando aqui. Por exemplo, para tentar novamente apenas um módulo específico no CTS 8.1, use:
cts --retry 0 -m ShortModuleNameOs argumentos de repetição podem ser diferentes daqueles disponíveis no comando inicial. Verifique os parâmetros suportados no site oficial para o teste selecionado Google Workspace.
Execução de teste anterior: se você quiser executar novamente um teste anterior:
Local: se a execução foi iniciada no host atual, informe a execução do teste ID visto ao visualizar os detalhes da execução do teste.
Figura 9. Execução anterior de teste local.
Remoto: se a execução tiver sido iniciada em um host diferente, faça upload do teste de resultados de pesquisa. Para isso, selecione Remoto e clique em Fazer upload dos resultados do teste Arquivo e selecione um arquivo do armazenamento local.
Figura 10. Execução remota de teste anterior.
Selecione os dispositivos
Clique nas caixas de seleção para escolher os dispositivos que serão alocados para executar o teste Google Workspace. A contagem de fragmentos deve mudar automaticamente para corresponder ao número de dispositivos selecionados.
Figura 11. Seleção de dispositivos.
Para selecionar dispositivos por atributos que não sejam números de série, faça o seguinte manualmente: digite "Especificações do dispositivo". Por exemplo, para selecionar três dispositivos cujo nome do produto é "bramble", digite o seguinte:
product:bramble;product:bramble;product:bramble
Os atributos aceitos são:
- id_da_versão
- série_dispositivo
- device_type
- nome do host
- produto
- variante_produto
- estado_sim
Todos os dispositivos selecionados precisam estar no estado Disponível para executar a execução do teste. e todos mudam para o estado Alocado quando a execução do teste é executada. Um A execução do teste fica no estado Na fila enquanto aguarda a conclusão do disponíveis.
Adicionar ações do dispositivo
As ações do dispositivo são scripts que podem ser executados antes de cada teste. Algumas as ações do dispositivo já vêm configuradas, como a atualização manual e a reinicialização. Para criar ações no dispositivo, consulte Criar uma nova ação do dispositivo.
Figura 12. Ações do dispositivo.
Para adicionar uma ação do dispositivo a uma execução de teste, clique em Add new action, selecione o caixas de seleção para as ações a serem adicionadas e clique em Adicionar ação(s). Ações do dispositivo são executadas sequencialmente. Você pode arrastar as ações para reordená-las.
Figura 13. Reordenar ações.
Definir recursos de teste
Os recursos de teste são arquivos necessários para executar uma execução de teste. Por exemplo, executar
O CTS requer um arquivo android-cts*.zip, e atualizar um dispositivo exige que você
fornecem a imagem do build.
O URL de download do arquivo ZIP do pacote de teste precisa ser o padrão do Google Drive links fornecidos aos parceiros. É possível selecionar um arquivo diferente clicando em Procurar. Na janela pop-up, você pode inserir um link de download de arquivo, usar um arquivo de canal de build autenticado ou fazer upload de um arquivo para usar do armazenamento local.
Figura 14. Testar recursos.
Confira abaixo a janela pop-up para selecionar um recurso de teste por um URL da Web. Você pode digite o link do URL de download e clique no botão Selecionar para confirmar a
Figura 15. Seletor de recursos de teste: URL da Web.
Se você fez upload de recursos no Google Grive, no Google Cloud Storage (GCS) ou outros canais, você também pode navegar até a guia do canal específico e selecionar recursos disponíveis. Este é um exemplo de seleção de um recurso do Google Drive.
Figura 16. Seletor de recursos de teste: Google Drive.
Além de apenas selecionar arquivos, os caracteres curinga também são aceitos em Campo Filename. A documentação está disponível aqui.
Figura 17. Test Resource Seletor - Suporte a padrões de caracteres curinga.
Também é possível selecionar um arquivo do armazenamento local de arquivos do OmniLab ATS. Você pode enviar no armazenamento ou usar diretamente arquivos e diretórios locais.
Figura 18. Seletor de recursos de teste: armazenamento local de arquivos.
Adicionar configurações de nova execução
É possível programar execuções que comecem após a conclusão da principal e carregam os resultados, mas podem usar dispositivos, ações ou recursos diferentes.
Figura 19. Como adicionar configurações de nova execução.
Iniciar uma execução de teste
Depois de inserir as informações necessárias para a execução do teste, clique em Iniciar teste Executar. Se todas as informações forem válidas, o teste será iniciado e você redirecionada para uma página para conferir os detalhes e o progresso da execução do teste.
Figura 20. Iniciando uma execução de teste.
Criar um plano de teste
Os planos de teste são usados para criar execuções de teste programadas. Por exemplo: executando 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. Criação de 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 usar.
- Manual: o plano de teste cria execuções de teste somente quando um usuário clica. Executar o plano de teste na página da lista de planos de teste.
- Periodic: o plano de teste programa automaticamente execuções de teste no a programação periódica selecionada. Por exemplo, programar um teste todos os dias às 17h00.
- Personalizado: o plano de teste programa automaticamente as execuções de teste com base no
expressão cron inserida. Por exemplo:
programar um teste todos os dias às 17h, a expressão cron será
0 17 * * *:
Figura 22. Configurar um plano de teste.
Adicionar pacotes de teste
Adicione conjuntos de testes que você quer que sejam agendados 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 quer executar o teste e Clique em Add Configuration. É possível adicionar várias configurações para cada teste. de transformação de dados de uma organização.
Figura 23. Configurar uma execução de teste.
Adicionar ações do dispositivo
Adicione as ações do dispositivo que você quer que sejam executadas antes de cada teste. Consulte Como adicionar ações do dispositivo para mais detalhes.
Figura 24. Adicionando ações do dispositivo.
Definir recursos de teste
Adicionar recursos de teste a planos de teste é o mesmo que adicioná-los a testes individuais é executado. Consulte Como configurar recursos de teste para mais detalhes.
Figura 25. Definição de recursos de teste.
Conferir execuções de teste
Lista de execuções de teste
Veja a lista de execuções de teste programadas na página "Execuções de teste". Clique em Visualizar para conferir mais detalhes sobre um teste.
Você também pode filtrar a lista inserindo uma string na barra de filtro e pressionando a tecla Enter. Você pode usar vários filtros separando-os com uma vírgula. O filtro retorna todas as linhas que contêm o texto exato (sem substring) correspondente) em qualquer coluna, exceto Status e Criado.
Um filtro vazio retorna todas as linhas. Não é possível filtrar linhas com valores vazios.
Figura 26. Lista de execução de teste.
Detalhes da execução do teste
É possível visualizar os detalhes de um teste aqui, como status, registros e resultados.
Figura 27. Detalhes da execução do teste.
Status da execução do teste
O progresso de uma execução de teste é mostrado na seção "Status". Se houver como andamento do download, motivo do cancelamento ou mensagem de erro, será também mostramos aqui.
Figura 28. Status da execução do teste.
Os estados de execução do teste são:
- Pendente: o download dos recursos necessários está sendo feito.
- Na fila: o teste estará pronto para ser executado quando um dispositivo ficar disponível.
- Em execução: o teste é 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.
- Error: ocorreu um erro que impediu a execução do teste.
Cancelar uma execução de teste
Se a execução do teste não tiver sido concluída, é possível cancelá-la clicando em Cancelar e e clique em Sim na caixa de diálogo de confirmação. As execuções de teste também serão cancelados automaticamente se permanecerem no estado Na fila por mais tempo que o queue_timeout_seconds. Como cancelar uma execução de teste no estado Running pode levar alguns minutos para entrar em vigor.
Figura 29. Cancelar uma execução de teste.
Resultados da execução do teste
Após a conclusão de um teste, os resultados são coletados e exibidos. Você pode
Para ver mais detalhes, clique na seta de cada execução. Clique em Ver saída.
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 visualizar os registros do host e do Tradefed em tempo real na guia "Registros".
Figura 31. Guia "Registros".
Os resultados de módulos individuais estão na guia Resultados do teste.
Figura 32. na guia "Resultados de teste".
É possível fazer o download dos arquivos usados como recursos de teste clicando em Abrir no Guia "Recursos de teste".
Figura 33. Guia "Recursos de teste".
Para conferir 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
Quando você configurar sua instância ATS OmniLab, poderá compartilhar a configuração com outros usuários exportando-o 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.
Após o download do arquivo de configuração, compartilhe-o com outros usuários. Ele pode adicionar o arquivo de configuração à instância ATS OmniLab clicando Importar e selecione o arquivo de configuração.
Criar uma ação de novo 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 é executado antes de cada execução de teste; inclusive antes de novas tentativas. Para ver uma lista de ações disponíveis no dispositivo, acesse "Configurações" e clique na guia "Ações do dispositivo". Várias ações do dispositivo ocorrem já configurado, como reinicializar e atualizar.
Figura 36. Guia "Ações do dispositivo".
Adicionar uma nova ação de dispositivo
Clique em Ação de novo dispositivo.
Figura 37. Novo botão de ação do dispositivo.
Insira um nome e uma descrição.
Figura 38. Nome da ação do dispositivo.
Clique em Adicionar preparador de destino.
Insira o alvo da Trade Federation Nome completo da classe do preparador, por exemplo,
com.android.tradefed.targetprep.RunHostCommandTargetPreparer
Figura 39. Adicionando um preparador de destino.
Uma lista de preparadores de destino disponíveis pode ser encontrada no com.android.tradefed.targetprep (link em inglês) de referência.
Figura 40. Lista de preparativos de destino.
Adicione todas as opções para usar com o preparador de destino. Para conferir as opções disponíveis, checava targetprep (link em inglês) para o código-fonte de cada preparador de destino no AOSP:
Figura 41. Exemplo de opção de ação.
Para adicionar uma opção, clique em Adicionar opção de preparador de destino e insira valores obrigatórios.
Figura 42. Exemplo de comando "Action".
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 Adicionar recurso de teste e preencha os campos obrigatórios. Se você sabe para onde seus arquivos, você pode fornecer um URL de download padrão clicando em navegar. Se os preparadores de destino aceitarem o diretório como recurso de teste, selecione Descompactar. Em seguida, especifique o diretório Destination relativo no diretório de trabalho temporário e nos File Names a serem descompactada. Se nenhum nome for dado, todos os arquivos serão descompactados o recurso de teste.
Figura 43. Recursos de teste de ação.
Clique em Atualizar.
Figura 44. Ação salvar mudanças.
Gerenciar testes
Editar um teste
Para editar um teste salvo, acesse a página "Testes" e clique em Editar na linha do que você quer modificar. Depois de alterar a configuração do teste, clique em Atualização.
Figura 45. Editar um teste.
Adicionar um novo teste
Para adicionar um novo teste, acesse a página "Testes" e clique em Criar um novo teste. Tecla Enter as informações apropriadas e clique em Criar.
Figura 46. Criação de um teste.
Figura 47. Copiando um teste.
Exportar configurações do host
Depois de configurar um host, você pode exportar as configurações dele para um arquivo. É possível fazer upload desse arquivo para outros hosts a fim de 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 do host, vá para a página Configurações e clique em Importar no canto superior direito.
Figura 49. Como 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
e acessíveis de modo automático no ATS OmniLab. Copie ou mova um arquivo para o diretório
diretório, selecione-o na aba Arquivo local ao agendar um
durante a execução do teste.
cp /path/to/file $HOME/.ats_storage
Figura 50. Selecionando um arquivo no diretório $HOME/.ats_storage.
Você pode montar diretórios adicionais no armazenamento de arquivos local com o
sinalização --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 do controlador ATS para gerenciar a dispositivos e testes em vários hosts de worker do ATS.
Figura 52. Arquitetura do modo de vários hosts.
Para iniciar o controlador ATS, use o seguinte comando:
mtt start --operation_mode=ON_PREMISEVerifique o controlador em
http://${CONTROLLER_HOSTNAME}:8000.Para iniciar os workers, use o seguinte comando:
mtt start --control_server_url=http://CONTROLLER_HOSTNAME:8000 --operation_mode=ON_PREMISE
Caso sua rede não permita que hosts se comuniquem entre si, siga as instruções de configuração mais avançadas abaixo no worker ATS.
Conecte os dois hosts usando túneis SSH. Selecione as portas para o e do servidor de arquivos, por exemplo, 9000 e 9006.
ssh -L ATS_PORT:localhost:8000 -L FS_PORT:localhost:8006 CONTROLLER_HOSTNAMEConfigure e inicie 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 a cada hora para limpar os arquivos com base nos e definidas pelo usuário. O ATS tem duas configurações padrão para arquivar testes executar resultados e excluir arquivos temporários. Este guia explica como personalizar as políticas e configurações para gerenciar seus arquivos com eficácia.
Políticas
Uma política define a operação a ser executada em arquivos ou diretórios, e a para selecionar destinos. As operações disponíveis são mostradas na tabela:
| Tipo de operação | Parâmetros |
|---|---|
ARCHIVE | remove_file: se for true, remova o arquivo após o arquivamento. |
DELETE |
Os critérios são baseados em atributos de arquivo e informações do sistema. Disponível são mostrados na tabela:
| Tipo de critério | Descrição | Parâmetros |
|---|---|---|
LAST_MODIFIED_TIME | Filtrar arquivos com base na data e hora da última modificação. | ttl: vários tipos de expressões de tempo são compatíveis, por exemplo, 10m, 2h, 7 days, 4w. Consulte pytimeparse para saber quais formatos são aceitos. |
LAST_ACCESS_TIME | Filtrar arquivos com base na data e hora do último acesso. | O mesmo que LAST_MODIFIED_TIME. |
NAME_MATCH | Filtrar arquivos com base no nome usando uma expressão regular. | pattern: expressão regular, por exemplo, [a-f0-9]{8}-([a-f0-9]{4}-){3}[a-f0-9]{12}\.zip para corresponder a CEPs de resultados. |
SYSTEM_AVAILABLE_SPACE | Acionar ações com base no espaço disponível no sistema. | threshold: aciona a ação quando o espaço disponível está abaixo do limite, por exemplo, 200(B), 200KB, 200MB, 200GB, 2TB. |
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 dentro dos diretórios especificados são processados políticas definidas pelo usuário. 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 as
config especifica o diretório de destino como logs, é interpretado como
/data/logs.
Figura 54. Edite a configuração da limpeza de arquivos.
Redefinir
Clicar em Redefinir configurações reverte a configuração do limpador de arquivos para o estado padrão. Esta ação limpa TODOS os itens personalizados.
Figura 55. Redefinir configurações da limpeza de arquivos
Suporte
Relatórios de bugs
Sua contribuição para o OmniLab ATS ajuda a melhorar o desenvolvimento da ferramenta. queremos sua opinião! Consulte a Notas da versão do OmniLab ATS para ver detalhes sobre a versão mais recente. Para informar bugs ou oferecer sugestões, envie um relatório do bug. Os parceiros devem informar bugs ou sugestões usando os próprios canais de parceiros.