Seminar DeviceFarmer STF API und Automatisierung

Seminarprofil

Die REST-Schnittstelle wird als Grundlage für wiederholbare und nachvollziehbare Geräteprozesse eingesetzt. Der Schwerpunkt liegt nicht auf einzelnen Beispielaufrufen, sondern auf belastbaren Automatisierungen mit Auswahlregeln, Zeitgrenzen, Fehlerbehandlung, Bereinigung und revisionsfähiger Protokollierung.

Inhaltsübersicht

1. API-Zugriff vorbereiten
2. Gerätebestand abfragen und filtern
3. Geräte reservieren und freigeben
4. Robuste Skriptstruktur aufbauen
5. Parallelität und Sperrkonflikte beherrschen
6. Protokollierung und Nachweisführung

Lernziele

• Zugriffstoken kontrolliert erzeugen, speichern und verwenden
• Geräteinformationen gezielt abfragen und nach technischen Merkmalen filtern
• Geräte automatisiert reservieren, prüfen und zuverlässig freigeben
• Skripte gegen typische Fehler, Zeitüberschreitungen und Parallelzugriffe absichern
• API-Abläufe in bestehende Betriebs- und Testprozesse integrieren

Seminarinhalte

API-Zugriff vorbereiten

1. Schritt 1: API-Endpunkt, Authentifizierungsverfahren und benötigte Berechtigungen der Zielumgebung feststellen.
2. Schritt 2: Ein Zugriffstoken erzeugen und außerhalb des Quellcodes in einer geschützten Variablenablage hinterlegen.
3. Schritt 3: Einen minimalen authentifizierten Aufruf ausführen und Antwortcode, Header sowie Nutzdaten prüfen.

Gerätebestand abfragen und filtern

1. Schritt 1: Die Geräteliste abrufen und relevante Felder wie Seriennummer, Bereitschaft, Nutzung und Plattform auswerten.
2. Schritt 2: Auswahlregeln für Android-Version, Modell, Provider, Gruppe und Verfügbarkeit definieren.
3. Schritt 3: Mehrdeutige oder unvollständige Treffer mit einer nachvollziehbaren Priorisierung behandeln.

Geräte reservieren und freigeben

1. Schritt 1: Ein geeignetes Gerät auswählen und die Reservierung mit einer definierten Zeitgrenze anfordern.
2. Schritt 2: Nach der Reservierung Besitz, Bereitschaft und Erreichbarkeit technisch verifizieren.
3. Schritt 3: Das Gerät nach erfolgreichem oder fehlgeschlagenem Ablauf in jedem Fall kontrolliert freigeben.

Robuste Skriptstruktur aufbauen

1. Schritt 1: Konfiguration, API-Client, Auswahl, Ausführung, Bereinigung und Protokollierung in getrennte Bausteine zerlegen.
2. Schritt 2: Wiederholungsversuche nur für geeignete Fehlerklassen mit Begrenzung und Wartezeit einsetzen.
3. Schritt 3: Abbruchsignale, Zeitüberschreitungen und unerwartete Antworten in einem zentralen Fehlerpfad behandeln.

Parallelität und Sperrkonflikte beherrschen

1. Schritt 1: Gleichzeitige Anfragen durch eindeutige Job- und Reservierungskennungen nachvollziehbar machen.
2. Schritt 2: Konkurrenz um Geräte mit erneuter Auswahl statt unkontrollierter Endlosschleifen lösen.
3. Schritt 3: Obergrenzen für parallele Reservierungen und faire Auswahlregeln pro Team oder Pipeline definieren.

Protokollierung und Nachweisführung

1. Schritt 1: Anfragezeit, Gerät, Job, Ergebnis, Dauer und Freigabestatus strukturiert protokollieren.
2. Schritt 2: Token, personenbezogene Daten und vertrauliche Geräteinformationen aus Protokollen ausschließen.
3. Schritt 3: Aus den Protokollen Kennzahlen für Auslastung, Fehlerquote und Wartezeiten ableiten.

Praxisübungen

• Aufbau eines API-Clients für Benutzer- und Geräteabfragen
• Implementierung einer regelbasierten Geräteauswahl mit Fallback
• Reservierung und sichere Freigabe mit garantiertem Bereinigungspfad
• Simulation von Zeitüberschreitung, Konflikt und nicht verfügbarem Gerät

Zielgruppe

Softwareentwicklung, Testautomatisierung, DevOps, Build Engineering und Systemadministration mit Bedarf an skriptgesteuerten Geräteprozessen.

Voraussetzungen

Grundkenntnisse in HTTP, JSON und mindestens einer Skriptsprache. Grundverständnis von STF-Geräten und Zugriffstoken ist hilfreich.