Seleção de dispositivos privados em um pool de dispositivos

Para usar dispositivos privados em sua execução de teste, você pode criar um pool de dispositivos que seleciona seus dispositivos privados. Os pools de dispositivos permitem que você selecione dispositivos privados principalmente por meio de três tipos de regras de pool de dispositivos:

1. Regras com base no ARN do dispositivo

2. Regras com base no rótulo da instância do dispositivo

3. Regras com base no ARN da instância do dispositivo

Nas seções a seguir, cada tipo de regra e seus casos de uso são descritos detalhadamente. Você pode usar o console Device Farm, a Interface de Linha de AWS Comando (AWSCLI) ou a API Device Farm para criar ou modificar um pool de dispositivos com dispositivos privados usando essas regras.

ARN do dispositivo

O ARN de um dispositivo é um identificador que representa um tipo de dispositivo em vez de qualquer instância específica de dispositivo físico. Um tipo de dispositivo é definido pelos seguintes atributos:

• O ID da frota do dispositivo

• O OEM do dispositivo

• O número do modelo do dispositivo

• A versão do sistema operacional do dispositivo.

• O estado do dispositivo que indica se ele está enraizado ou não

Muitas instâncias de dispositivos físicos podem ser representadas por um único tipo de dispositivo, em que cada instância desse tipo tem os mesmos valores para esses atributos. Por exemplo, se você tivesse três dispositivos Apple iPhone 13 no iOS versão 16.1.0 em sua frota particular, cada dispositivo compartilharia o mesmo ARN do dispositivo. Se algum dispositivo fosse adicionado ou removido da sua frota com esses mesmos atributos, o ARN do dispositivo continuaria a representar quaisquer dispositivos disponíveis que você tivesse em sua frota para esse tipo de dispositivo.

O ARN do dispositivo é a maneira mais robusta de selecionar dispositivos privados para um pool de dispositivos, pois permite que o pool de dispositivos continue selecionando dispositivos, independentemente das instâncias de dispositivos específicas que você implantou a qualquer momento. Instâncias individuais de dispositivos privados podem apresentar falhas de hardware, fazendo com que o Device Farm as substitua automaticamente por novas instâncias funcionais do mesmo tipo de dispositivo. Nesses cenários, a regra de ARN do dispositivo garante que seu pool de dispositivos possa continuar selecionando dispositivos no caso de uma falha de hardware.

Quando você usa uma regra de ARN de dispositivo para dispositivos privados em seu pool de dispositivos e agenda uma execução de teste com esse pool, o Device Farm verifica automaticamente quais instâncias de dispositivos privados são representadas pelo ARN desse dispositivo. Das instâncias que estão disponíveis atualmente, uma delas será designada para executar seu teste. Se nenhuma instância estiver disponível no momento, o Device Farm aguardará até que a primeira instância disponível do ARN desse dispositivo fique disponível e a atribuirá para executar seu teste.

Rótulos de instância do dispositivo

Um rótulo de instância de dispositivo é um identificador textual que você pode anexar como metadados para uma instância de dispositivo. Você pode anexar vários rótulos a cada instância do dispositivo e o mesmo rótulo a várias instâncias do dispositivo. Para obter mais informações sobre como adicionar, modificar ou remover rótulos de dispositivos de instâncias de dispositivos, consulte Gerenciamento de dispositivos privados.

O rótulo da instância do dispositivo pode ser uma forma robusta de selecionar dispositivos privados para um pool de dispositivos porque, se você tiver várias instâncias de dispositivos com o mesmo rótulo, ele permitirá que o pool de dispositivos selecione qualquer uma delas para seu teste. Se o ARN do dispositivo não for uma boa regra para seu caso de uso (por exemplo, se você quiser selecionar entre dispositivos de vários tipos de dispositivos ou se quiser selecionar entre um subconjunto de todos os dispositivos de um tipo de dispositivo), os rótulos de instância do dispositivo poderão permitir que você selecione entre vários dispositivos para seu pool de dispositivos com maior granularidade. Instâncias individuais de dispositivos privados podem apresentar falhas de hardware, fazendo com que o Device Farm as substitua automaticamente por novas instâncias funcionais do mesmo tipo de dispositivo. Nesses cenários, a instância do dispositivo substituto não reterá nenhum metadado do rótulo da instância do dispositivo substituído. Portanto, se você aplicar o mesmo rótulo de instância de dispositivo a várias instâncias de dispositivos, a regra de rótulo de instância de dispositivo garantirá que seu pool de dispositivos possa continuar selecionando instâncias de dispositivos no caso de uma falha de hardware.

Quando você usa uma regra de rótulo de instância de dispositivo para dispositivos privados em seu pool de dispositivos e agenda uma execução de teste com esse pool, o Device Farm verifica automaticamente quais instâncias de dispositivos particulares são representadas por esse rótulo de instância de dispositivo e, dessas instâncias, seleciona aleatoriamente uma que esteja disponível para executar seu teste. Se nenhuma estiver disponível, o Device Farm selecionará aleatoriamente qualquer instância de dispositivo com o rótulo de instância do dispositivo para executar seu teste e colocará o teste em fila para execução no dispositivo quando estiver disponível.

Instância ARN

O ARN de uma instância de dispositivo é um identificador que representa uma instância física de dispositivo bare metal implantada em uma frota privada. Por exemplo, se você tivesse três dispositivos iPhone 13 no OS 15.0.0 em sua frota privada, enquanto cada dispositivo compartilhasse o mesmo ARN do dispositivo, cada dispositivo também teria seu próprio ARN de instância representando apenas essa instância.

O ARN da instância do dispositivo é a maneira menos eficiente de selecionar dispositivos privados para um pool de dispositivos e só é recomendado se os ARNs do dispositivo e os rótulos da instância do dispositivo não se adequarem ao seu caso de uso. Os ARNs de instância de dispositivo geralmente são usados como regras para grupos de dispositivos quando uma instância específica de dispositivo é configurada de forma única e específica como pré-requisito para seu teste e se essa configuração precisa ser conhecida e verificada antes que o teste seja executado nela. Instâncias individuais de dispositivos privados podem apresentar falhas de hardware, fazendo com que o Device Farm as substitua automaticamente por novas instâncias funcionais do mesmo tipo de dispositivo. Nesses cenários, a instância do dispositivo substituto terá um ARN de instância de dispositivo diferente do dispositivo substituído. Portanto, se você depende de ARNs de instância de dispositivos para seu pool de dispositivos, precisará alterar manualmente a definição de regra do seu pool de dispositivos de usar o ARN antigo para usar o novo ARN. Se você precisar pré-configurar manualmente o dispositivo para o teste, esse pode ser um fluxo de trabalho eficaz (comparado aos ARNs do dispositivo). Para testes em grande escala, é recomendável tentar adaptar esses casos de uso para trabalhar com rótulos de instância de dispositivos e, se possível, ter várias instâncias de dispositivos pré-configuradas para testes.

Quando você usa uma regra ARN de instância de dispositivo para dispositivos privados em seu pool de dispositivos e agenda uma execução de teste com esse pool, o Device Farm atribui automaticamente esse teste a essa instância de dispositivo. Se essa instância do dispositivo não estiver disponível, o Device Farm colocará o teste em fila no dispositivo assim que ele estiver disponível.

Criação de um pool de dispositivos privados com dispositivos privados (console)

Ao criar uma execução de teste, você pode criar um grupo de dispositivos para a execução de teste e garantir que o grupo inclua apenas os dispositivos privados.

nota

Ao criar um pool de dispositivos com dispositivos privados no console, você só pode usar qualquer uma das três regras disponíveis para selecionar dispositivos privados. Se você quiser criar um pool de dispositivos que contenha vários tipos de regras para dispositivos privados (por exemplo, pools de dispositivos que contêm regras para ARNs de dispositivos e ARNs de instâncias de dispositivos), você precisa criar o pool por meio da CLI ou da API.

1. Abra o console do Device Farm em https://console.aws.amazon.com/devicefarm/.

2. No painel de navegação do Device Farm, escolha Mobile Device Testing e, em seguida, escolha Projects.

3. Escolha um projeto existente na lista ou crie um novo. Para criar um novo projeto, selecione Novo projeto, digite um nome para o projeto e, em seguida, selecione Enviar.

4. Escolha Testes automatizados, em seguida, Criar nova execução. O assistente orienta você durante as etapas para escolher seu aplicativo e configurar o teste que você deseja executar.

5. Na etapa Selecionar dispositivos, escolha Criar um novo grupo de dispositivos e insira um nome e uma descrição opcional para o grupo de dispositivos.

   1. Para usar regras de ARN de dispositivos para seu pool de dispositivos, escolha Criar pool estático de dispositivos e selecione os tipos de dispositivos específicos da lista que você gostaria de usar no pool de dispositivos. Não selecione Instâncias de dispositivos privados somente porque essa opção faz com que o pool de dispositivos seja criado com regras de ARN de instância de dispositivo (em vez de regras de ARN de dispositivo).

      

   2. Para usar regras de rótulo de instância de dispositivo para seu pool de dispositivos, escolha Criar pool dinâmico de dispositivos. Em seguida, para cada etiqueta que você gostaria de usar no pool de dispositivos, escolha Adicionar uma regra. Para cada regra, escolha Rótulos de instância como oField, escolha Contém como Operator o. e especifique o rótulo de instância do dispositivo desejado como Value o.

      

   3. Para usar regras de ARN de instância de dispositivo para seu pool de dispositivos, escolha Create static device pool e selecione Private device instances only para limitar a lista de dispositivos somente às instâncias privadas que o Device Farm associou à sua AWS conta.

      

6. Escolha Criar.

Criação de um pool de dispositivos privados com dispositivos privados (AWS CLI)

• Execute o comando create-device-pool.

Para obter informações sobre como usar o Device Farm com o AWS CLI, consulte Referência do AWS CLI.

Criação de um pool de dispositivos privados com dispositivos privados (API)

• Chame a API CreateDevicePool.

Para obter informações sobre como usar a API do Device Farm, consulte Automatização do Device Farm .