CloudFront-Objektstruktur

Das cloudfront-Objekt konfiguriert die CloudFront-Bereitstellung für Dateien, die in S3 gespeichert sind. Es ist erforderlich, wenn fileStrategy oder ein fileStrategies-Eintrag "cloudfront" verwendet.

Beispiel

fileStrategies:
  avatar: 'cloudfront'
  image: 'cloudfront'
  document: 's3'
 
cloudfront:
  domain: 'https://cdn.example.com'
  distributionId: 'E1234ABCD'
  invalidateOnDelete: false
  imageSigning: 'cookies'
  cookieDomain: '.example.com'
  cookieExpiry: 1800
  urlExpiry: 3600
  storageRegion: 'us-east-2'
  includeRegionInPath: false
  requireSignedAccess: true

Felder

Key	Type	Description	Example
domain	String	CloudFront-Distributionsdomain oder CNAME. Erforderlich.	domain: "https://cdn.example.com"
distributionId	String	CloudFront-Verteilungs-ID. Erforderlich, wenn `invalidateOnDelete` auf true gesetzt ist.	distributionId: "E1234ABCD"
invalidateOnDelete	Boolean	Erstellt eine CloudFront-Invalidierung nach dem Löschen des S3-Objekts. Standard: false.	invalidateOnDelete: false
imageSigning	String	Inline-Mediensignaturmodus. Optionen: `"none"`, `"cookies"`, `"url"`. `"url"` ist reserviert und für Bilder nicht implementiert.	imageSigning: "cookies"
urlExpiry	Number	Lebensdauer der signierten CloudFront-Download-URL in Sekunden. Standard: 3600.	urlExpiry: 3600
cookieExpiry	Number	Lebensdauer des signierten Cookies in Sekunden. Standard: 1800. Maximum: 604800.	cookieExpiry: 1800
cookieDomain	String	Gemeinsame übergeordnete Domain für signierte Cookies. Erforderlich, wenn `imageSigning` auf `"cookies"` gesetzt ist. Muss mit einem Punkt beginnen.	cookieDomain: ".example.com"
storageRegion	String	Optionales Regions-Label, das in generierten Objektschlüsseln verwendet wird, wenn `includeRegionInPath` auf true gesetzt ist.	storageRegion: "us-east-2"
includeRegionInPath	Boolean	Beinhaltet die Speicherregion in neu generierten Objektschlüsseln. Standard: false.	includeRegionInPath: false
requireSignedAccess	Boolean	Erfordert für eine erfolgreiche Initialisierung beim Start den Zugriff über signierte CloudFront-Cookies. Standard: false.	requireSignedAccess: true

Validierungsregeln

distributionId ist erforderlich, wenn invalidateOnDelete auf true gesetzt ist.
cookieDomain ist erforderlich, wenn imageSigning auf "cookies" gesetzt ist.
cookieDomain muss mit einem Punkt beginnen, zum Beispiel .example.com.
requireSignedAccess: true erfordert imageSigning: "cookies".

Key	Type	Description	Example
CLOUDFRONT_KEY_PAIR_ID	String	CloudFront Public-Key-Paar-ID. Erforderlich für signierte Cookies und signierte Downloads.	# CLOUDFRONT_KEY_PAIR_ID=K1234567890ABC
CLOUDFRONT_PRIVATE_KEY	String	CloudFront privater Schlüssel PEM. Erforderlich für signierte Cookies und signierte Downloads.	# CLOUDFRONT_PRIVATE_KEY="-----BEGIN RSA PRIVATE KEY-----\n...\n-----END RSA PRIVATE KEY-----"

Für Anleitungen zur Bereitstellung siehe CloudFront with S3.

CloudFront-Objektstruktur

Beispiel

Felder

Validierungsregeln

Zugehörige Umgebungsvariablen