As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Integrar o Device Farm a um servidor Jenkins CI
O plug-in do Jenkins CI oferece a funcionalidade do AWS Device Farm por meio do seu próprio servidor de integração contínua (CI) Jenkins. Para obter mais informações, consulte [Jenkins (software)](https://en.wikipedia.org/wiki/Jenkins_%28software%29).
**nota**
Para baixar o plug-in Jenkins, acesse [GitHub](https://github.com/awslabs/aws-device-farm-jenkins-plugin)e siga as instruções em[Etapa 1: Instalar o plug-in do Jenkins CI para o AWS Device FarmInstalar o plug-in do Jenkins CI](#jenkins-ci-installing-the-plugin).
Esta seção contém uma série de procedimentos para configurar e usar o plug-in Jenkins CI com o AWS Device Farm.
As imagens a seguir mostram os recursos do plug-in Jenkins CI.
![\[Integração com o aplicativo Jenkins CI Hello World\]](http://docs.aws.amazon.com/pt_br/devicefarm/latest/developerguide/images/aws-device-farm-jenkins-plugin-continuous-integration-project-hello-world-app.png)
![\[Integração com ações pós-compilação do Jenkins CI\]](http://docs.aws.amazon.com/pt_br/devicefarm/latest/developerguide/images/aws-device-farm-jenkins-plugin-continuous-integration-post-build-actions.png)
Esse plug-in também pode abrir todos os artefatos de teste (logs, capturas de tela etc.) localmente:
![\[Integração com artefatos de teste do Jenkins CI\]](http://docs.aws.amazon.com/pt_br/devicefarm/latest/developerguide/images/aws-device-farm-jenkins-plugin-continuous-integration-test-artifacts.png)
**Topics**
+ [Dependências](#jenkins-plugin-dependencies)
+ [Etapa 1: Instalar o plug-in do Jenkins CI para o AWS Device Farm](#jenkins-ci-installing-the-plugin)
+ [Etapa 2: Criar um AWS Identity and Access Management usuário para seu plug-in Jenkins CI para AWS Device Farm](#jenkins-ci-set-up-iam-user)
+ [Etapa 3: configurar o plug-in Jenkins CI pela primeira vez no AWS Device Farm](#jenkins-ci-first-time-configuration-instructions)
+ [Etapa 4: usar o plug-in em um trabalho do Jenkins](#jenkins-ci-using-plugin-jenkins-job)
## Dependências
O plug-in Jenkins CI requer o AWS Mobile SDK 1.10.5 ou posterior. Para obter mais informações e instalar o SDK, consulte [AWS Mobile SDK](https://aws.amazon.com/mobile/sdk/).
## Etapa 1: Instalar o plug-in do Jenkins CI para o AWS Device Farm
Há duas opções para instalar o plug-in de integração contínua (CI) do Jenkins para o AWS Device Farm. Você pode procurar o plug-in na caixa de diálogo **Available Plugins (Plug-ins disponíveis)** na interface do usuário da web do Jenkins ou você pode fazer download do arquivo `hpi` e instalá-lo por meio do Jenkins.
### Instalação por meio da interface de usuário do Jenkins
1. Encontre o plug-in na interface do usuário do Jenkins, escolha **Manage Jenkins (Gerenciar Jenkins)**, **Manage Plugins (Gerenciar plug-ins)** e **Available (Disponível)**.
1. Pesquise por **aws-device-farm**.
1. Instale o plug-in AWS Device Farm.
1. Verifique se o plug-in pertence ao usuário `Jenkins`.
1. Reinicie o Jenkins.
### Faça download do plug-in.
1. Baixe o `hpi` arquivo diretamente de [http://updates.jenkins-ci. org/latest/aws-device-farm.hpi](http://updates.jenkins-ci.org/latest/aws-device-farm.hpi).
1. Verifique se o plug-in pertence ao usuário `Jenkins`.
1. Instale o plug-in usando uma das seguintes opções:
+ Faça upload do plug-in escolhendo **Manage Jenkins (Gerenciar Jenkins)**, **Manage Plugins (Gerenciar plug-ins)**, **Advanced (Avançado)** e **Upload plugin (Fazer upload do plug-in)**.
+ Coloque o arquivo `hpi` no diretório do plug-in Jenkins (normalmente `/var/lib/jenkins/plugins`).
1. Reinicie o Jenkins.
## Etapa 2: Criar um AWS Identity and Access Management usuário para seu plug-in Jenkins CI para AWS Device Farm
Recomendamos que você não use sua conta AWS root para acessar o Device Farm. Em vez disso, crie um novo usuário AWS Identity and Access Management (IAM) (ou use um usuário do IAM existente) em sua AWS conta e, em seguida, acesse o Device Farm com esse usuário do IAM.
Para criar um usuário do IAM, consulte [Creating an IAM User (Console de gerenciamento da AWS)](https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_SettingUpUser.html#Using_CreateUser_console). Lembre-se de gerar uma chave de acesso para cada usuário e fazer download ou salvar as credenciais de segurança do usuário. Você precisará das credenciais posteriormente.
### Dê ao usuário do IAM permissão para acessar o Device Farm
Para dar permissão ao usuário do IAM para acessar o Device Farm, crie uma nova política de acesso no IAM e atribua a política de acesso ao usuário do IAM da seguinte forma.
**nota**
A conta AWS raiz ou o usuário do IAM que você usa para concluir as etapas a seguir deve ter permissão para criar a seguinte política do IAM e anexá-la ao usuário do IAM. Para obter mais informações, consulte [Trabalhar com políticas](https://docs.aws.amazon.com/IAM/latest/UserGuide/policies_manage.html).
**Para criar a política de acesso no IAM**
1. Abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Selecione **Políticas**.
1. Escolha **Create Policy**. (Se aparecer um botão **Get Started**, selecione-o e, em seguida, **Create Policy**.)
1. Próximo a **Create Your Own Policy**, escolha **Select**.
1. Em **Policy Name (Nome da política)**, digite um nome para política (por exemplo, **AWSDeviceFarmAccessPolicy**).
1. Em **Descrição**, digite uma descrição que ajude a associar esse usuário do IAM ao projeto do Jenkins.
1. Em **Policy Document (Documento da política)**, digite a seguinte declaração:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "DeviceFarmAll",
"Effect": "Allow",
"Action": [ "devicefarm:*" ],
"Resource": [ "*" ]
}
]
}
```
------
1. Escolha **Create Policy**.
**Para atribuir a política de acesso ao usuário do IAM**
1. Abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Selecione **Usuários**.
1. Escolha o usuário do IAM ao qual você atribuirá a política de acesso.
1. Na área **Permissions (Permissões)**, em **Managed Policies (Políticas gerenciadas)**, escolha **Attach Policy (Anexar política)**.
1. Selecione a política que você acabou de criar (por exemplo, **AWSDeviceFarmAccessPolicy**).
1. Escolha **Attach Policy**.
## Etapa 3: configurar o plug-in Jenkins CI pela primeira vez no AWS Device Farm
A primeira vez em que você executar o servidor Jenkins, precisará configurar o sistema conforme a seguir.
**nota**
Se estiver usando [slots de dispositivos](how-to-purchase-device-slots.md), o recurso de slots para dispositivo estará desativado por padrão.
1. Faça login na interface de usuário web do Jenkins.
1. No lado esquerdo da tela, escolha **Manage Jenkins (Gerenciar Jenkins)**.
1. Escolha **Configure System (Configurar sistema)**.
1. Role para baixo até o cabeçalho **AWS Device Farm**.
1. Copie suas credenciais de segurança de [Criar um usuário do IAM para o plug-in do Jenkins CI](#jenkins-ci-set-up-iam-user) e cole o ID da chave de acesso e a chave de acesso secreta nas respectivas caixas.
1. Escolha **Salvar**.
## Etapa 4: usar o plug-in em um trabalho do Jenkins
Assim que você tiver instalado o plug-in Jenkins, siga estas instruções para usar o plug-in em um trabalho do Jenkins.
1. Faça login na interface de usuário web do Jenkins.
1. Clique no trabalho que você deseja editar.
1. No lado esquerdo da tela, escolha **Configurar**.
1. Role para baixo até o cabeçalho **Ações pós-compilação**.
1. Clique em **Adicionar ação pós-compilação** e selecione **Executar testes no AWS Device Farm**.
1. Selecione o projeto que você deseja usar.
1. Selecione o grupo de dispositivos que você deseja usar.
1. Selecione se você gostaria de ter os artefatos de teste (como logs e capturas de tela) arquivados localmente.
1. Em **Aplicativo**, preencha o caminho do aplicativo compilado.
1. Selecione o teste que deseja executar e preencha todos os campos obrigatórios.
1. Escolha **Salvar**.