Structure d'objet CloudFront

L'objet cloudfront configure la distribution CloudFront pour les fichiers stockés dans S3. Il est requis lorsque fileStrategy ou toute entrée fileStrategies utilise "cloudfront".

Exemple

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

Champs

Key	Type	Description	Example
domain	String	Domaine de distribution CloudFront ou CNAME. Requis.	domain: "https://cdn.example.com"
distributionId	String	ID de distribution CloudFront. Requis lorsque `invalidateOnDelete` est défini sur true.	distributionId: "E1234ABCD"
invalidateOnDelete	Boolean	Crée une invalidation CloudFront après la suppression de l'objet S3. Par défaut : false.	invalidateOnDelete: false
imageSigning	String	Mode de signature de média en ligne. Options : `"none"`, `"cookies"`, `"url"`. `"url"` est réservé et non implémenté pour les images.	imageSigning: "cookies"
urlExpiry	Number	Durée de vie en secondes de l'URL de téléchargement signée CloudFront. Par défaut : 3600.	urlExpiry: 3600
cookieExpiry	Number	Durée de vie du cookie signé en secondes. Par défaut : 1800. Maximum : 604800.	cookieExpiry: 1800
cookieDomain	String	Domaine parent partagé pour les cookies signés. Requis lorsque `imageSigning` est défini sur `"cookies"`. Doit commencer par un point.	cookieDomain: ".example.com"
storageRegion	String	Étiquette de région facultative utilisée dans les clés d'objet générées lorsque `includeRegionInPath` est true.	storageRegion: "us-east-2"
includeRegionInPath	Boolean	Inclut la région de stockage dans les clés d'objet nouvellement générées. Par défaut : false.	includeRegionInPath: false
requireSignedAccess	Boolean	Nécessite un accès CloudFront par cookie signé pour s'initialiser correctement au démarrage. Par défaut : false.	requireSignedAccess: true

Règles de validation

distributionId est requis lorsque invalidateOnDelete est true.
cookieDomain est requis lorsque imageSigning est défini sur "cookies".
cookieDomain doit commencer par un point, par exemple .example.com.
requireSignedAccess: true nécessite imageSigning: "cookies".

Key	Type	Description	Example
CLOUDFRONT_KEY_PAIR_ID	String	ID de paire de clés publiques CloudFront. Requis pour les cookies signés et les téléchargements signés.	# CLOUDFRONT_KEY_PAIR_ID=K1234567890ABC
CLOUDFRONT_PRIVATE_KEY	String	Clé privée PEM CloudFront. Requise pour les cookies signés et les téléchargements signés.	# CLOUDFRONT_PRIVATE_KEY="-----BEGIN RSA PRIVATE KEY-----\n...\n-----END RSA PRIVATE KEY-----"

Pour obtenir des conseils sur le déploiement, consultez CloudFront with S3.

Structure d'objet CloudFront

Exemple

Champs

Règles de validation

Variables d'environnement associées