Integrazione di Device Farm con un server CI Jenkins - AWS Device Farm

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).

Nota

Per scaricare il plugin Jenkins, vai a GitHube segui le istruzioni in. Passaggio 1: installazione del plug-in Jenkins CI per AWS Device Farm

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
Integrazione con le operazioni post-compilazione Jenkins CI

Il plugin può anche aprire tutti gli artefatti del test (log, screenshot, ecc.) in locale:

Integrazione con gli artefatti del test Jenkins CI

Dipendenze

Il Jenkins CI Plugin richiede AWS Mobile SDK 1.10.5 o versione successiva. Per ulteriori informazioni e per installare ilSDK, consulta Mobile. AWS SDK

Passaggio 1: installazione del plug-in 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).

  2. Cercare aws-device-farm.

  3. Installa il plugin AWS Device Farm.

  4. Assicurati che il plugin sia di proprietà dell'utente Jenkins.

  5. Riavvia Jenkins.

Scarica il plugin

  1. Scarica il hpi file direttamente da http://updates.jenkins-ci.org/latest/ aws-device-farm .hpi.

  2. Assicurati che il plugin sia di proprietà dell'utente Jenkins.

  3. 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).

  4. Riavvia Jenkins.

Passaggio 2: creazione di un AWS Identity and Access Management utente per il plug-in Jenkins CI per AWS Device Farm

Si consiglia di non utilizzare l'account AWS root per accedere a Device Farm. Invece, crea un nuovo AWS Identity and Access Management (IAM) utente (o utilizza un IAM utente esistente) nel tuo AWS account, quindi accedi a Device Farm con quell'IAMutente.

Per creare un nuovo IAM utente, vedi Creazione di un IAM utente (AWS Management 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.

Autorizzare l'IAMutente ad accedere a Device Farm

Per concedere IAM all'utente l'autorizzazione ad accedere a Device Farm, crea una nuova politica di accesso inIAM, quindi assegna la politica di accesso all'IAMutente come segue.

Nota

L'account o IAM l'utente AWS root che utilizzate per completare i seguenti passaggi deve disporre dell'autorizzazione per creare la seguente IAM politica e allegarla all'IAMutente. Per ulteriori informazioni, consulta l'articolo relativo all'utilizzo delle policy.

Per creare la politica di accesso in IAM
  1. Apri la IAM console all'indirizzo https://console.aws.amazon.com/iam/.

  2. Seleziona Policy.

  3. Scegliere Create Policy (Crea policy). (Se viene visualizzato il pulsante Get Started (Inizia), sceglierlo, quindi scegliere Create Policy (Crea policy)).

  4. Accanto a Create Your Own Policy (Crea la tua policy) scegli Select (Seleziona).

  5. In Policy Name (Nome policy) digitare un nome per la policy, ad esempio AWSDeviceFarmAccessPolicy.

  6. Per Descrizione, digita una descrizione che ti aiuti ad associare questo IAM utente al tuo progetto Jenkins.

  7. Per Policy Document (Documento della policy), digita la seguente istruzione:

    { "Version": "2012-10-17", "Statement": [ { "Sid": "DeviceFarmAll", "Effect": "Allow", "Action": [ "devicefarm:*" ], "Resource": [ "*" ] } ] }
  8. Scegliere Create Policy (Crea policy).

Per assegnare la politica di accesso all'utente IAM
  1. Aprire la IAM console all'indirizzo https://console.aws.amazon.com/iam/.

  2. Scegliere Users (Utenti).

  3. Scegli l'IAMutente a cui assegnare la politica di accesso.

  4. Nell'area Permissions (Autorizzazioni), in Managed Policies (Policy gestite), seleziona Attach Policy (Collega policy).

  5. Seleziona la politica che hai appena creato (ad esempio, AWSDeviceFarmAccessPolicy).

  6. Scegli Attach Policy (Collega policy).

Passaggio 3: Configurazione del plug-in 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, la loro funzionalità sarà disabilitata per impostazione predefinita.

  1. Accedi all'interfaccia utente Web di Jenkins.

  2. Sul lato sinistro dello schermo, scegli Manage Jenkins (Gestisci Jenkins).

  3. Scegli Configure System (Configura sistema).

  4. Scorri verso il basso fino all'intestazione di AWSDevice Farm.

  5. Copia le tue credenziali di sicurezza da Creazione di un IAM utente per il tuo Jenkins CI Plugin e incolla il tuo ID chiave di accesso e la tua chiave di accesso segreta nelle rispettive caselle.

  6. Seleziona Salva.

Fase 4: Utilizzo del 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.

  2. Clicca sull'attività che desideri modificare.

  3. Sul lato sinistro dello schermo, scegli Configure (Configura).

  4. Scorri verso il basso fino all'intestazione Post-build Actions (Operazioni post-compilazione).

  5. Fai clic su Aggiungi azione post-compilazione e seleziona Esegui test su AWS Device Farm.

  6. Seleziona il progetto che desideri utilizzare.

  7. Seleziona il pool di dispositivi che desideri utilizzare.

  8. Seleziona se archiviare in locale gli artefatti dei test (ad esempio, i log e gli screenshot).

  9. In Application (Applicazione), inserisci il percorso dell'applicazione compilata.

  10. Seleziona il test che desideri eseguire e compila tutti i campi obbligatori.

  11. Seleziona Salva.