Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Integrazione di Device Farm con un server CI Jenkins
Il plug-in Jenkins CI fornisce la funzionalità AWS Device Farm dal tuo server di integrazione continua (CI) Jenkins. Per ulteriori informazioni, consulta [Jenkins (software)](https://en.wikipedia.org/wiki/Jenkins_%28software%29).
**Nota**
Per scaricare il plugin Jenkins, vai a [GitHub](https://github.com/awslabs/aws-device-farm-jenkins-plugin)e segui le istruzioni in. [Fase 1: Installazione del plugin Jenkins CI per AWS Device FarmInstallazione del plugin Jenkins CI](#jenkins-ci-installing-the-plugin)
Questa sezione contiene una serie di procedure per configurare e utilizzare il plugin Jenkins CI con AWS Device Farm.
Le seguenti immagini mostrano le caratteristiche del plugin Jenkins CI.
![\[Integrazione con l'applicazione Hello World di Jenkins CI\]](http://docs.aws.amazon.com/it_it/devicefarm/latest/developerguide/images/aws-device-farm-jenkins-plugin-continuous-integration-project-hello-world-app.png)
![\[Integrazione con le operazioni post-compilazione Jenkins CI\]](http://docs.aws.amazon.com/it_it/devicefarm/latest/developerguide/images/aws-device-farm-jenkins-plugin-continuous-integration-post-build-actions.png)
Il plugin può anche aprire tutti gli artefatti del test (log, screenshot, ecc.) in locale:
![\[Integrazione con gli artefatti del test Jenkins CI\]](http://docs.aws.amazon.com/it_it/devicefarm/latest/developerguide/images/aws-device-farm-jenkins-plugin-continuous-integration-test-artifacts.png)
**Topics**
+ [Dipendenze](#jenkins-plugin-dependencies)
+ [Fase 1: Installazione del plugin Jenkins CI per AWS Device Farm](#jenkins-ci-installing-the-plugin)
+ [Fase 2: creazione di un AWS Identity and Access Management utente per il plugin Jenkins CI per AWS Device Farm](#jenkins-ci-set-up-iam-user)
+ [Fase 3: Configurazione del plugin Jenkins CI per la prima volta in AWS Device Farm](#jenkins-ci-first-time-configuration-instructions)
+ [Fase 4: Usare il plugin in un job Jenkins](#jenkins-ci-using-plugin-jenkins-job)
## Dipendenze
Il plugin Jenkins CI richiede AWS Mobile SDK 1.10.5 o versione successiva. Per ulteriori informazioni e per installare l'SDK, consulta [SDK AWS Mobile](https://aws.amazon.com/mobile/sdk/).
## Fase 1: Installazione del plugin Jenkins CI per AWS Device Farm
Esistono due opzioni per installare il plug-in Jenkins continuous integration (CI) per AWS Device Farm. Puoi cercare il plugin nella finestra di dialogo **Available Plugins (Plugin disponibili)** nell'interfaccia utente Web di Jenkins, oppure puoi scaricare il file `hpi` e installarlo in Jenkins.
### Installazione dall'interfaccia utente di Jenkins
1. Trova il plugin nell'interfaccia utente di Jenkins selezionando **Manage Jenkins (Gestisci Jenkins)**, **Manage Plugins (Gestisci Plugin)** e **Available (Disponibili)**.
1. Cercare **aws-device-farm**.
1. Installa il plug-in AWS Device Farm.
1. Assicurati che il plugin sia di proprietà dell'utente `Jenkins`.
1. Riavvia Jenkins.
### Scarica il plugin
1. Scaricate il `hpi` file direttamente da [http://updates.jenkins-ci. org/latest/aws-device-farm.hpi](http://updates.jenkins-ci.org/latest/aws-device-farm.hpi).
1. Assicurati che il plugin sia di proprietà dell'utente `Jenkins`.
1. Installa il plugin utilizzando una delle seguenti opzioni.
+ Carica il plugin selezionando **Manage Jenkins (Gestisci Jenkins)**, **Manage Plugins (Gestisci plugin)**, **Advanced (Avanzate)** e **Upload plugin (Carica plugin)**.
+ Inserisci il file `hpi` nella directory del plugin Jenkins (di solito `/var/lib/jenkins/plugins`).
1. Riavvia Jenkins.
## Fase 2: creazione di un AWS Identity and Access Management utente per il plugin Jenkins CI per AWS Device Farm
Si consiglia di non utilizzare l'account AWS root per accedere a Device Farm. Invece, crea un nuovo utente AWS Identity and Access Management (IAM) (o utilizza un utente IAM esistente) nel tuo AWS account, quindi accedi a Device Farm con quell'utente IAM.
Per creare un nuovo utente IAM, consulta [Creazione di un utente IAM (Console di gestione AWS)](https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_SettingUpUser.html#Using_CreateUser_console). Assicurati di generare una chiave di accesso per ogni utente e di scaricare o salvare le credenziali di sicurezza degli utenti. Avrai bisogno delle credenziali in un secondo momento.
### Autorizza l'utente IAM ad accedere a Device Farm
Per concedere all'utente IAM l'autorizzazione ad accedere a Device Farm, crea una nuova policy di accesso in IAM, quindi assegna la policy di accesso all'utente IAM come segue.
**Nota**
L'account AWS root o l'utente IAM che utilizzi per completare i seguenti passaggi deve disporre dell'autorizzazione per creare la seguente policy IAM e collegarla all'utente IAM. Per ulteriori informazioni, consulta l'articolo relativo all'[utilizzo delle policy](https://docs.aws.amazon.com/IAM/latest/UserGuide/policies_manage.html).
**Per creare la politica di accesso in IAM**
1. Aprire la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Seleziona **Policy**.
1. Scegli **Crea policy**. (Se viene visualizzato il pulsante **Get Started (Inizia)**, sceglierlo, quindi scegliere **Create Policy (Crea policy)**).
1. Accanto a **Create Your Own Policy** (Crea la tua policy) scegli **Select** (Seleziona).
1. In **Policy Name (Nome policy)** digitare un nome per la policy, ad esempio **AWSDeviceFarmAccessPolicy**.
1. Per **Descrizione**, digita una descrizione che ti aiuti ad associare questo utente IAM al tuo progetto Jenkins.
1. Per **Policy Document (Documento della policy)**, digita la seguente istruzione:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "DeviceFarmAll",
"Effect": "Allow",
"Action": [ "devicefarm:*" ],
"Resource": [ "*" ]
}
]
}
```
------
1. Scegli **Crea policy**.
**Per assegnare la politica di accesso all'utente IAM**
1. Aprire la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).
1. Scegliere **Users (Utenti)**.
1. Scegli l'utente IAM a cui assegnare la politica di accesso.
1. Nell'area **Permissions (Autorizzazioni)**, in **Managed Policies (Policy gestite)**, seleziona **Attach Policy (Collega policy)**.
1. Seleziona la policy che hai appena creato (ad esempio, **AWSDeviceFarmAccessPolicy**).
1. Scegli **Attach Policy (Collega policy)**.
## Fase 3: Configurazione del plugin Jenkins CI per la prima volta in AWS Device Farm
La prima volta che esegui il server Jenkins, dovrai configurare il sistema nel seguente modo.
**Nota**
Se stai utilizzando [slot per i dispositivi](how-to-purchase-device-slots.md), la loro funzionalità sarà disabilitata per impostazione predefinita.
1. Accedi all'interfaccia utente Web di Jenkins.
1. Sul lato sinistro dello schermo, scegli **Manage Jenkins (Gestisci Jenkins)**.
1. Scegli **Configure System (Configura sistema)**.
1. Scorri verso il basso fino all'intestazione di **AWS Device Farm**.
1. Copia le tue credenziali di sicurezza da [Creazione di un utente IAM per il tuo plugin Jenkins CI](#jenkins-ci-set-up-iam-user) e incolla il tuo ID chiave di accesso e la tua chiave di accesso segreta nelle rispettive caselle.
1. Scegli **Save** (Salva).
## Fase 4: Usare il plugin in un job Jenkins
Dopo aver installato il plugin Jenkins, segui queste istruzioni per utilizzare il plugin in un'attività di Jenkins.
1. Accedi all'interfaccia utente Web di Jenkins.
1. Clicca sull'attività che desideri modificare.
1. Sul lato sinistro dello schermo, scegli **Configure (Configura)**.
1. Scorri verso il basso fino all'intestazione **Post-build Actions (Operazioni post-compilazione)**.
1. Fai clic su **Aggiungi azione post-compilazione** e seleziona **Run Tests on AWS Device Farm**.
1. Seleziona il progetto che desideri utilizzare.
1. Seleziona il pool di dispositivi che desideri utilizzare.
1. Seleziona se archiviare in locale gli artefatti dei test (ad esempio, i log e gli screenshot).
1. In **Application (Applicazione)**, inserisci il percorso dell'applicazione compilata.
1. Seleziona il test che desideri eseguire e compila tutti i campi obbligatori.
1. Scegli **Save** (Salva).