LightFile NextLightFile Next

環境変数一覧

Lambda関数の環境変数リファレンス

Lambda関数の設定はLambda関数ごとの環境変数によって行います。

環境変数の種類

以下の環境変数を指定できます。詳細は各ページを参照ください。

グループ環境変数詳細設定例
全般LICENSE_TOKENライセンストークン
全般LOG_LEVELログレベルinfo
全般LANGUAGE言語ja
軽量化QUALITY画質medium
軽量化JPEG_QUALITYJPEG向けの画質low
軽量化PNG_QUALITYPNG向けの画質high
権限ACLオブジェクト上書き時のACLpublic-read
サイズMIN_SIZE対象の最小サイズ2kb
サイズMAX_SIZE対象の最大サイズ3mb
バックアップBACKUP_BUCKETバックアップ先バケットmy-backup-bucket
バックアップBACKUP_PREFIXバックアップ時のプレフィックス${bucket}
バックアップBACKUP_ACLバックアップ時のACLprivate

環境変数の変更

AWSコンソール経由

Lambda関数の設定画面で設定タブ - 環境変数メニュー - 編集ボタンを押すと、環境変数を変更できます。

環境変数の編集

環境変数の名称はすべて大文字で指定します。

AWS CLI経由

aws lambda update-function-configuration \
  --function-name my-company-lightfile \
  --environment Variables="{
    LICENSE_TOKEN=mytoken,
    QUALITY=high,
    MIN_SIZE=10kb,
    MAX_SIZE=5mb,
    LANGUAGE=ja,
    LOG_LEVEL=info
  }"

主要な環境変数

LICENSE_TOKEN

型: 文字列 必須: はい 設定者: CloudFormation (MyTokenパラメータから)

ライセンストークン。通常、これを直接変更する必要はありません。

形式:

username!base64_signature

または有効期限付き:

username~YYYYMMDD!base64_signature

QUALITY

型: 文字列 デフォルト: medium オプション: low, medium, high

JPEGとPNGの両方の最適化の品質プリセット。

品質JPEGPNG用途
low高圧縮積極的な削減ファイルサイズの最大削減、重要度の低い画像
mediumバランスバランス汎用(推奨)
high最小圧縮保守的高品質要件、最小限の品質低下

詳細は画質設定を参照してください。

JPEG_QUALITY / PNG_QUALITY

型: 文字列 デフォルト: (空 - QUALITY設定を使用) オプション: low, medium, high

JPEG画像またはPNG画像専用の品質設定を上書き。

使用例:

  • QUALITY=mediumおよびJPEG_QUALITY=highを設定
  • PNGは中品質、JPEGは高品質を使用

ACL

型: 文字列 デフォルト: public-read オプション: private, public-read, public-read-write, authenticated-read, aws-exec-read, bucket-owner-read, bucket-owner-full-control, _keep

最適化された画像に適用するACL(アクセス制御リスト)。

詳細はACL設定を参照してください。

BACKUP_BUCKET

型: 文字列 デフォルト: {prefix}-lightfile-backup 設定者: CloudFormation

オリジナル画像がバックアップされるS3バケット名。

詳細はバックアップ設定を参照してください。

MIN_SIZE / MAX_SIZE

型: 文字列 デフォルト: MIN_SIZE=5kb, MAX_SIZE=3mb

処理する最小・最大ファイルサイズ。範囲外のファイルはスキップされます。

詳細はサイズ制限を参照してください。

LANGUAGE

型: 文字列 デフォルト: en オプション: en, ja

ログメッセージの言語。

詳細は言語設定を参照してください。

LOG_LEVEL

型: 文字列 デフォルト: info オプション: debug, info, warn, error, fatal

出力する最小ログレベル。

詳細はログレベル設定を参照してください。

設定のベストプラクティス

デフォルトから始める

最初はQUALITY=mediumを使用し、結果に基づいて調整します。

品質設定をテスト

  • 異なる品質設定でテスト画像をアップロード
  • 視覚的品質とファイルサイズを比較
  • 基準を満たす最も低い品質を選択

最初はバックアップを有効化

  • 最初のデプロイ時はバックアップを有効にしておく
  • 結果が満足できることを確認した後、無効化を検討
  • バックアップストレージのコストを考慮

CloudWatchログを監視

  • 本番環境ではLOG_LEVEL=infoを維持
  • トラブルシューティング時のみdebugを使用
  • エラーを定期的にログで確認

適切なサイズ制限を設定

  • 非常に小さい画像(サムネイル、アイコン)をスキップ
  • 典型的な画像サイズに基づいてMAX_SIZEを設定
  • Lambdaのタイムアウトとメモリ制限を考慮