Cloud

Über

Das Payload Cloud Plugin bindet eine selbst gehostete Payload-Instanz an die verwaltete Infrastruktur von Payload Cloud an. Es wird nur aktiv, wenn die Umgebungsvariable `PAYLOAD_CLOUD` auf `true` gesetzt ist und die benötigten Anmeldedaten vorliegen. Ohne diese Voraussetzungen gibt das Plugin die eingehende Konfiguration unverändert zurück, sodass die Instanz wie gewohnt läuft. Für jede Upload-Collection setzt das Plugin `disableLocalStorage` auf `true` und registriert einen eigenen Static Handler, der Dateien aus einem S3-Bucket über die Cloudflare-CDN ausliefert. `beforeChange`- und `afterDelete`-Hooks schreiben neue Uploads nach S3 und entfernen gelöschte Dateien wieder. Die AWS-Zugangsdaten für den Bucket-Zugriff werden über einen Cognito Identity Pool bezogen, der über die `PAYLOAD_CLOUD_COGNITO_*`-Umgebungsvariablen konfiguriert wird. Das Upload-Caching liegt auf der Cloudflare-CDN und nutzt standardmäßig ein `maxAge` von 86400 Sekunden (24 Stunden). Der Wert lässt sich global oder pro Collection-Slug überschreiben. Bei Aktualisierung oder Löschung eines Uploads wird der Cache automatisch gepurgt. Die E-Mail-Zustellung läuft über den SMTP-Endpunkt von Resend mit dem gebündelten `@payloadcms/email-nodemailer`-Adapter. Die Standard-Absendeadresse leitet sich aus der Deployment-Domain oder einer hinterlegten Custom-Domain ab. Ein bereits in der Payload-Konfiguration vorhandener E-Mail-Transport hat Vorrang vor der Cloud-E-Mail. Das Plugin koordiniert zudem die Jobs-Queue von Payload, sodass `config.jobs.autoRun` nur auf einer einzelnen Instanz ausgeführt wird. Die Auswahl der aktiven Instanz läuft über ein verstecktes `payload-cloud-instance`-Global. Diese Funktion lässt sich mit `enableAutoRun: false` deaktivieren. Jeder der drei Bereiche (Storage, E-Mail, Upload-Caching) kann über die Plugin-Optionen einzeln abgeschaltet werden.

Paketinformationen

Paketname

@payloadcms/plugin-cloud

Neueste Version

3.0.4

Entpackte Größe

91 kB

Lizenz

MIT

Wöchentliche Downloads

1297

Zuletzt veröffentlicht

14. März 2025