Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Integración de Device Farm con un servidor Jenkins CI
El complemento Jenkins CI proporciona funcionalidad de AWS Device Farm desde su propio servidor Jenkins de integración continua (CI). Para obtener más información, consulte [Jenkins (software)](https://en.wikipedia.org/wiki/Jenkins_%28software%29).
**nota**
Para descargar el complemento de Jenkins, vaya a [GitHub](https://github.com/awslabs/aws-device-farm-jenkins-plugin)y siga las instrucciones que aparecen en[Paso 1: instalación del complemento Jenkins CI para AWS Device FarmInstalación del complemento Jenkins CI](#jenkins-ci-installing-the-plugin).
Esta sección contiene una serie de procedimientos para configurar y utilizar el complemento Jenkins CI con AWS Device Farm.
Las siguientes imágenes muestran las características del complemento Jenkins CI.
![\[Integración con la aplicación Hello World de Jenkins CI\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/aws-device-farm-jenkins-plugin-continuous-integration-project-hello-world-app.png)
![\[Integración con acciones posteriores a la compilación de Jenkins CI\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/aws-device-farm-jenkins-plugin-continuous-integration-post-build-actions.png)
El complemento también puede extraer todos los artefactos de las pruebas (registros, capturas de pantalla, etc.) localmente:
![\[Integración con artefactos de pruebas de Jenkins CI\]](http://docs.aws.amazon.com/es_es/devicefarm/latest/developerguide/images/aws-device-farm-jenkins-plugin-continuous-integration-test-artifacts.png)
**Topics**
+ [Dependencias](#jenkins-plugin-dependencies)
+ [Paso 1: instalación del complemento Jenkins CI para AWS Device Farm](#jenkins-ci-installing-the-plugin)
+ [Paso 2: Crear un AWS Identity and Access Management usuario para el complemento CI de Jenkins para AWS Device Farm](#jenkins-ci-set-up-iam-user)
+ [Paso 3: configuración del complemento Jenkins CI por primera vez en AWS Device Farm](#jenkins-ci-first-time-configuration-instructions)
+ [Paso 4: uso del complemento en un trabajo de Jenkins](#jenkins-ci-using-plugin-jenkins-job)
## Dependencias
El complemento Jenkins CI requiere la AWS versión 1.10.5 o posterior del SDK para dispositivos móviles. Para obtener más información y para instalar el SDK, consulte [AWS Mobile SDK](https://aws.amazon.com/mobile/sdk/).
## Paso 1: instalación del complemento Jenkins CI para AWS Device Farm
Existen dos opciones para instalar el complemento de integración continua (CI) de Jenkins para AWS Device Farm. Puede buscar el complemento desde el cuadro de diálogo **Complementos disponibles** en la interfaz de usuario web de Jenkins, o bien puede descargar el archivo `hpi` e instalarlo desde Jenkins.
### Instalación desde la interfaz de usuario de Jenkins
1. Para encontrar el complemento en la interfaz de usuario de Jenkins, seleccione **Administrar Jenkins**, **Administrar dispositivos** y, a continuación, seleccione **Disponibles**.
1. Busque la opción **aws-device-farm**.
1. Instale el complemento AWS Device Farm.
1. Asegúrese de que el complemento es propiedad del usuario de `Jenkins`.
1. Reinicie Jenkins.
### Descarga del complemento
1. [Descargue el `hpi` archivo directamente desde http://updates.jenkins-ci. org/latest/aws-device-farm.hpi](http://updates.jenkins-ci.org/latest/aws-device-farm.hpi).
1. Asegúrese de que el complemento es propiedad del usuario de `Jenkins`.
1. Instale el complemento mediante una de las siguientes opciones:
+ Para cargar el complemento, seleccione **Administrar Jenkins**, **Administrar complementos**, **Avanzados** y, a continuación, seleccione **Cargar complemento**.
+ Coloque el archivo `hpi` en el directorio del complemento de Jenkins (normalmente `/var/lib/jenkins/plugins`).
1. Reinicie Jenkins.
## Paso 2: Crear un AWS Identity and Access Management usuario para el complemento CI de Jenkins para AWS Device Farm
Le recomendamos que no utilice su cuenta AWS root para acceder a Device Farm. En su lugar, cree un usuario nuevo AWS Identity and Access Management (de IAM) (o utilice un usuario de IAM existente) en su AWS cuenta y, a continuación, acceda a Device Farm con ese usuario de IAM.
Para crear un nuevo usuario de IAM, consulte [Crear un usuario de IAM (Consola de administración de AWS)](https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_SettingUpUser.html#Using_CreateUser_console). Asegúrese de generar una clave de acceso para cada usuario y de descargar o guardar las credenciales de seguridad de los usuarios. Necesitará estas credenciales más tarde.
### Conceda permiso al usuario de IAM para obtener acceso a Device Farm.
Para conceder permiso al usuario de IAM para obtener acceso a Device Farm, cree una nueva política de acceso en IAM. Después, asigne la política de acceso al usuario de IAM como se indica a continuación.
**nota**
La cuenta AWS raíz o el usuario de IAM que utilice para completar los siguientes pasos debe tener permiso para crear la siguiente política de IAM y asociarla al usuario de IAM. Para obtener más información, consulte [Administración de políticas de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/policies_manage.html)
**Para crear la política de acceso en IAM**
1. Abra la consola de IAM en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Seleccione **Políticas**.
1. Seleccione **Crear política**. Si aparece el botón **Empezar**, selecciónelo y, a continuación, seleccione **Crear política**.
1. Junto a **Create Your Own Policy**, seleccione **Select**.
1. En **Nombre de política**, escriba un nombre para la política (por ejemplo, **AWSDeviceFarmAccessPolicy**).
1. Para **Descripción**, escriba una descripción que le ayude a asociar este usuario de IAM con el proyecto Jenkins.
1. En **Documento de política**, escriba la siguiente instrucción:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "DeviceFarmAll",
"Effect": "Allow",
"Action": [ "devicefarm:*" ],
"Resource": [ "*" ]
}
]
}
```
------
1. Seleccione **Crear política**.
**Para asignar la política de acceso al usuario de IAM**
1. Abra la consola de IAM en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Seleccione **Usuarios**.
1. Seleccione el usuario de IAM a quien desea asignar la política de acceso.
1. En el área **Permisos**, en **Políticas administradas**, seleccione **Asociar política**.
1. Seleccione la política que acaba de crear (por ejemplo, **AWSDeviceFarmAccessPolicy**).
1. Seleccione **Asociar política**.
## Paso 3: configuración del complemento Jenkins CI por primera vez en AWS Device Farm
La primera vez que ejecute el servidor de Jenkins, tendrá que configurar el sistema como se indica a continuación.
**nota**
Si utiliza [ranuras de dispositivos](how-to-purchase-device-slots.md), la característica de ranuras de dispositivos está deshabilitada de forma predeterminada.
1. Inicie sesión en la interfaz de usuario web de Jenkins.
1. En la parte izquierda de la pantalla, seleccione **Administrar Jenkins**.
1. Seleccione **Configurar sistema**.
1. Desplácese hacia abajo hasta el encabezado **AWS Device Farm**.
1. Copie sus credenciales de seguridad [Creación de un usuario de IAM para el complemento Jenkins CI](#jenkins-ci-set-up-iam-user) y pegue el ID de clave de acceso y la clave de acceso secreta en sus respectivas casillas.
1. Seleccione **Save**.
## Paso 4: uso del complemento en un trabajo de Jenkins
Una vez que haya instalado el complemento Jenkins, siga estas instrucciones para utilizar el complemento en un trabajo de Jenkins.
1. Inicie sesión en la interfaz de usuario web de Jenkins.
1. Haga clic en el trabajo que desea editar.
1. En la parte izquierda de la pantalla, seleccione **Configurar**.
1. Desplácese hacia abajo hasta el encabezado **Acciones posteriores a la compilación**.
1. Haga clic en **Añadir acción posterior a la compilación** y seleccione **Ejecutar pruebas en AWS Device Farm**.
1. Seleccione el proyecto que desearía usar.
1. Seleccione el grupo de dispositivos que desearía usar.
1. Seleccione si desea que los elementos de las pruebas (como los registros y las capturas de pantalla) se archiven localmente.
1. En **Aplicación**, rellene la ruta de la aplicación compilada.
1. Seleccione la prueba que desea ejecutar y rellene todos los campos obligatorios.
1. Seleccione **Save**.