Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Integration von Device Farm mit einem Jenkins CI-Server
Das Jenkins CI-Plugin bietet AWS Device Farm Farm-Funktionalität von Ihrem eigenen Jenkins Continuous Integration (CI) -Server aus. Weitere Informationen finden Sie unter [Jenkins (Software)](https://en.wikipedia.org/wiki/Jenkins_%28software%29).
**Anmerkung**
Um das Jenkins-Plugin herunterzuladen, gehen Sie zu [GitHub](https://github.com/awslabs/aws-device-farm-jenkins-plugin)und folgen Sie den Anweisungen unter. [Schritt 1: Installation des Jenkins CI-Plug-ins für AWS Device FarmInstallation des Jenkins CI-Plug-ins](#jenkins-ci-installing-the-plugin)
Dieser Abschnitt enthält eine Reihe von Verfahren zur Einrichtung und Verwendung des Jenkins CI-Plug-ins mit AWS Device Farm.
Die folgenden Bilder zeigen die Funktionen des Jenkins CI-Plug-ins.
![\[Integration in die Jenkins CI-„Hello World“-Anwendung\]](http://docs.aws.amazon.com/de_de/devicefarm/latest/developerguide/images/aws-device-farm-jenkins-plugin-continuous-integration-project-hello-world-app.png)
![\[Integration in Jenkins CI-Postbuild-Aktionen\]](http://docs.aws.amazon.com/de_de/devicefarm/latest/developerguide/images/aws-device-farm-jenkins-plugin-continuous-integration-post-build-actions.png)
Das Plug-in kann auch alle Testartefakte (Protokolle, Screenshots usw.) lokal abrufen:
![\[Integration in Jenkins CI-Testartefakte\]](http://docs.aws.amazon.com/de_de/devicefarm/latest/developerguide/images/aws-device-farm-jenkins-plugin-continuous-integration-test-artifacts.png)
**Topics**
+ [Abhängigkeiten](#jenkins-plugin-dependencies)
+ [Schritt 1: Installation des Jenkins CI-Plug-ins für AWS Device Farm](#jenkins-ci-installing-the-plugin)
+ [Schritt 2: Einen AWS Identity and Access Management Benutzer für Ihr Jenkins CI Plugin für AWS Device Farm erstellen](#jenkins-ci-set-up-iam-user)
+ [Schritt 3: Erstmaliges Konfigurieren des Jenkins CI-Plug-ins in AWS Device Farm](#jenkins-ci-first-time-configuration-instructions)
+ [Schritt 4: Verwenden des Plugins in einem Jenkins-Job](#jenkins-ci-using-plugin-jenkins-job)
## Abhängigkeiten
Das Jenkins CI-Plugin erfordert das AWS Mobile SDK 1.10.5 oder höher. Weitere Informationen und eine Anleitung zur Installation des SDK finden Sie unter [AWS Mobile-SDK](https://aws.amazon.com/mobile/sdk/).
## Schritt 1: Installation des Jenkins CI-Plug-ins für AWS Device Farm
Es gibt zwei Optionen für die Installation des Jenkins-Plug-ins Continuous Integration (CI) für AWS Device Farm. Sie können im Dialogfeld **Available Plugins (Verfügbare Plug-ins)** in der Web-Benutzeroberfläche von Jenkins nach dem Plug-in suchen oder die Datei `hpi` herunterladen und direkt aus Jenkins heraus installieren.
### Installieren über die Jenkins-Benutzeroberfläche
1. Suchen Sie das Plug-ins über die Jenkins-Benutzeroberfläche, indem Sie nacheinander die Optionen **Manage Jenkins (Jenkins verwalten)**, **Manage Plugins (Plug-ins verwalten)** und **Available (Verfügbar)** wählen.
1. Suchen Sie nach **aws-device-farm**.
1. Installieren Sie das AWS Device Farm Farm-Plug-In.
1. Stellen Sie sicher, dass der Besitzer der Datei der Benutzer `Jenkins` ist.
1. Starten Sie Jenkins neu.
### Laden Sie das Plugin herunter
1. Laden Sie die `hpi` Datei direkt von [http://updates.jenkins-ci herunter. org/latest/aws-device-farm.hpi](http://updates.jenkins-ci.org/latest/aws-device-farm.hpi).
1. Stellen Sie sicher, dass der Besitzer der Datei der Benutzer `Jenkins` ist.
1. Installieren Sie das Plug-in mithilfe einer der folgenden Verfahren:
+ Laden Sie das Plug-in hoch, indem Sie nacheinander die Optionen **Manage Jenkins (Jenkins verwalten)**, **Manage Plugins (Plug-ins verwalten)**, **Advanced (Erweitert)** und dann **Upload plugin (Plug-in hochladen)** wählen.
+ Verschieben Sie die Datei `hpi` in das Jenkins-Plug-in-Verzeichnis (in der Regel `/var/lib/jenkins/plugins`).
1. Starten Sie Jenkins neu.
## Schritt 2: Einen AWS Identity and Access Management Benutzer für Ihr Jenkins CI Plugin für AWS Device Farm erstellen
Wir empfehlen, dass Sie Ihr AWS Root-Konto nicht für den Zugriff auf Device Farm verwenden. Erstellen Sie stattdessen einen neuen AWS Identity and Access Management (IAM-) Benutzer (oder verwenden Sie einen vorhandenen IAM-Benutzer) in Ihrem AWS Konto und greifen Sie dann mit diesem IAM-Benutzer auf Device Farm zu.
Informationen zum Erstellen eines neuen IAM-Benutzers finden Sie unter [Einen IAM-Benutzer erstellen](https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_SettingUpUser.html#Using_CreateUser_console) ().AWS-Managementkonsole Achten Sie darauf, dass Sie für jeden Benutzer einen Zugriffsschlüssel erstellen, und laden Sie die Sicherheitsanmeldeinformationen für jeden Benutzer herunter oder speichern Sie diese. Sie benötigen die Anmeldeinformationen zu einem späteren Zeitpunkt.
### Erteilen Sie dem IAM-Benutzer die Erlaubnis, auf Device Farm zuzugreifen
Um dem IAM-Benutzer Zugriff auf Device Farm zu gewähren, erstellen Sie eine neue Zugriffsrichtlinie in IAM und weisen Sie die Zugriffsrichtlinie dann dem IAM-Benutzer wie folgt zu.
**Anmerkung**
Das AWS Root-Konto oder der IAM-Benutzer, mit dem Sie die folgenden Schritte ausführen, muss berechtigt sein, die folgende IAM-Richtlinie zu erstellen und sie an den IAM-Benutzer anzuhängen. Weitere Informationen finden Sie unter [Arbeiten mit Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/policies_manage.html)
**Um die Zugriffsrichtlinie in IAM zu erstellen**
1. Öffnen Sie unter [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) die IAM-Konsole.
1. Wählen Sie **Policies (Richtlinien)**.
1. Wählen Sie **Richtlinie erstellen** aus. (Wenn die Schaltfläche **Get Started (Erste Schritte)** angezeigt wird, klicken Sie darauf und wählen Sie anschließend **Create Policy (Richtlinie erstellen)** aus.)
1. Klicken Sie neben **Create Your Own Policy** auf **Select**.
1. Geben Sie unter **Policy Name (Richtlinienname)** einen Namen für die Richtlinie ein (z. B. **AWSDeviceFarmAccessPolicy**).
1. Geben Sie **unter Beschreibung** eine Beschreibung ein, anhand derer Sie diesen IAM-Benutzer Ihrem Jenkins-Projekt zuordnen können.
1. Geben Sie unter **Policy Document (Richtliniendokument)** die folgende Anweisung ein:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "DeviceFarmAll",
"Effect": "Allow",
"Action": [ "devicefarm:*" ],
"Resource": [ "*" ]
}
]
}
```
------
1. Wählen Sie **Richtlinie erstellen** aus.
**Um die Zugriffsrichtlinie dem IAM-Benutzer zuzuweisen**
1. Öffnen Sie unter [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) die IAM-Konsole.
1. Wählen Sie **Users** (Benutzer) aus.
1. Wählen Sie den IAM-Benutzer aus, dem Sie die Zugriffsrichtlinie zuweisen möchten.
1. Wählen Sie im Bereich **Permissions (Berechtigungen)** unter **Managed Policies (Verwaltete Richtlinien)** die Option **Attach Policy (Richtlinie anfügen)**.
1. Wählen Sie die gerade erstellte Richtlinie aus (z. B. **AWSDeviceFarmAccessPolicy**).
1. Wählen Sie **Richtlinie anfügen** aus.
## Schritt 3: Erstmaliges Konfigurieren des Jenkins CI-Plug-ins in AWS Device Farm
Wenn Sie Ihrer Jenkins-Server zum ersten Mal ausführen möchten, müssen Sie das System wie folgt konfigurieren.
**Anmerkung**
Wenn Sie [Geräteplätze](how-to-purchase-device-slots.md) verwenden, beachten Sie, dass das Geräteplatz-Feature standardmäßig deaktiviert ist.
1. Melden Sie sich an Ihrer Jenkins-Webbenutzeroberfläche an.
1. Wählen Sie auf der linken Seite des Bildschirms die Option **Manage Jenkins (Jenkins verwalten)** aus.
1. Wählen Sie **Configure System (System konfigurieren)** aus.
1. Scrollen Sie nach unten zum **AWS Device Farm Farm-Header**.
1. Kopieren Sie Ihre Anmeldeinformationen unter [Einen IAM-Benutzer für Ihr Jenkins CI-Plugin erstellen](#jenkins-ci-set-up-iam-user) und fügen Sie Ihre Zugriffsschlüssel-ID und den geheimen Zugriffsschlüssel in die jeweiligen Felder ein.
1. Wählen Sie **Speichern**.
## Schritt 4: Verwenden des Plugins in einem Jenkins-Job
Verfahren Sie nach der Installation der Jenkins-Plug-ins wie folgt, um es in einem Jenkins-Auftrag zu verwenden.
1. Melden Sie sich bei Ihrer Jenkins-Webbenutzeroberfläche an.
1. Klicken Sie auf den Auftrag, den Sie bearbeiten möchten.
1. Wählen Sie auf der linken Seite des Bildschirms die Option **Configure (Konfigurieren)** aus.
1. Führen Sie einen Bildlauf nach unten zur Überschrift **Post-build Actions (Postbuild-Aktionen)** durch.
1. Klicken Sie auf **Post-Build-Aktion hinzufügen** und wählen Sie **Tests auf AWS Device Farm ausführen** aus.
1. Willen Sie das Projekt aus, das verwendet werden soll.
1. Wählen Sie den Gerätepool aus, der verwendet werden soll.
1. Legen Sie fest, ob die Testartefakte (z. B. Protokolle und Screenshots) lokal archiviert werden sollen.
1. Geben Sie im Feld **Application (Anwendung)** den Pfad zu Ihrer kompilierten Anwendung an.
1. Wählen Sie den Test aus, den Sie ausführen möchten, und füllen Sie alle Pflichtfelder aus.
1. Wählen Sie **Speichern**.