S3 Uploader
Verwende diesen Skill, wenn ein Automatisierungslauf dauerhafte Artefaktspeicherung benötigt: CSV-Berichte, PDFs, JSON-Checkpoints, Screenshots, Modellausgaben oder Logs, die außerhalb der lokalen Maschine überleben sollen. Der Helfer zielt auf generische S3-kompatible Speicher und liest Bucket, Endpunkt und Anmeldedaten ausschließlich aus Umgebungsvariablen.
Wann aufrufen
- Der Benutzer sagt: „Lade diesen Bericht zu S3 hoch“, „Speichere Artefakte im Objektspeicher“, „Lade die letzte Datei herunter“, „Verwende MinIO/R2/Spaces“.
- Code im Gespräch schreibt Dateien lokal, benötigt aber eine portable Übergabe oder Archivierungsmöglichkeit.
Wann NICHT aufrufen
- Das Artefakt wird nur innerhalb desselben Prozesses benötigt; behalte es auf der Festplatte.
- Der Benutzer benötigt einen öffentlichen Website-CDN-Workflow mit Cache-Invalidierung und signierten URLs.
Konkretes Beispiel
Benutzereingabe:
Lade die generierte CSV nach Abschluss des Scrapers in meinen S3-kompatiblen Bucket hoch.
Ausgabe:
# Kopiere assets/s3.py in dein Projekt, dann:
from s3 import upload_file
key = upload_file("out/daily_report.csv", key="reports/daily_report.csv")
print("uploaded:", key)
Der Helfer liest S3_BUCKET, S3_ACCESS_KEY_ID, S3_SECRET_ACCESS_KEY, optional S3_ENDPOINT_URL und optional S3_REGION aus der Umgebung. Nichts Ziel- oder Spezifisches oder Geheimes wird eingecheckt.
Anzuwendendes Muster
- Halte Bucket-Name, Endpunkt, Zugriffsschlüssel und geheimen Schlüssel nur in Umgebungsvariablen.
- Verwende deterministische Objekt-Schlüssel wie
reports/YYYY-MM-DD/name.csv, damit Neuausführungen leicht zu finden sind. - Lade erst hoch, nachdem die lokale Datei vollständig ist; streame niemals ein halb geschriebenes Artefakt.
- Unterstütze S3-kompatible Endpunkte durch Übergabe von
endpoint_urlanstelle von hartcodiertem AWS. - Scheitere mit einem klaren Konfigurationsfehler, wenn Umgebungsvariablen oder Client-Bibliotheken fehlen.
Referenz: assets/s3.py.
Quelle
Abgeleitet aus der Produktionsnutzung in den Automatisierungsprojekten des Autors. v1.0.0. Siehe auch: [[csv-report-writer]], [[playwright-pdf-snapshot]], [[pipeline-orchestrator]].
→ Baue den vollständig ausführbaren Bot mit Trawlkit.