教學課程:建立包含鍵值的 CloudFront 函數
本教學課程說明如何使用 CloudFront 函數納入鍵值。鍵值是鍵值對的一部分。您可以在函數程式碼中包含名稱 (來自鍵值對)。函數執行時,CloudFront 會以值取代該名稱。
鍵值對是存放在鍵值存放區中的變數。當您在函數中使用鍵 (而不是硬式編碼值) 時,您的函數會更靈活。您可以變更鍵的值,而不需要部署程式碼變更。鍵值對也可以減少函數的大小。如需更多詳細資訊,請參閱 Amazon CloudFront KeyValueStore。
必要條件
如果您是初次使用 CloudFront Functions 函數和鍵值存放區,建議您遵循 教學課程:使用 CloudFront Functions 建立簡單的函數 中的教學課程。
完成該教學課程後,您可以遵循本教學課程來延伸您建立的函數。在本教學課程中,建議您先建立鍵值存放區。
建立鍵值存放區
首先請建立用於函數的鍵值存放區。
建立鍵值存放區
-
規劃您要包含在函數中的鍵值對。請記下這些鍵的名稱。您要在函數中使用的所有鍵值對都必須位於單一鍵值存放區中。
-
決定工作的順序。有兩種方式可以繼續:
-
建立一個鍵值存放區,並將鍵值對新增到存放區中。然後建立 (或修改) 函數並加入鍵的名稱。
-
或者,建立 (或修改) 函數,並加入您要使用的鍵的名稱。然後建立一個鍵值存放區,並新增鍵值對。
-
登入 AWS 管理主控台 並開啟位於 https://console.aws.amazon.com/cloudfront/v4/home
的 CloudFront 主控台。 -
在導覽視窗中選擇函數,然後選擇 KeyValueStores 索引標籤。
-
選擇建立 KeyValueStore 並輸入下列欄位:
-
輸入存放區的名稱及 (選用) 說明。
-
將 S3 URI 保留空白。在本教學課程中,您將手動輸入鍵/值對。
-
-
選擇建立。此時會顯示新鍵值存放區的詳細資訊頁面。此頁面包含目前空白的鍵值對區段。
將鍵值對新增到存放區
接著手動將鍵值對清單新增至您先前建立的鍵值存放區。
將鍵值對新增到鍵值存放區
-
在鍵值對區段中選擇新增鍵值對。
-
選擇新增配對,然後輸入鍵和值。選擇核取記號以確認您的變更,然後重複此步驟以新增更多鍵值對。
-
完成後請選擇儲存變更,以儲存在鍵值存放區中的所有鍵值對。在確認對話上選擇完成。
您現在有一個包含一組鍵值對的鍵值存放區。
建立鍵值存放區與函數的關聯
您現在已建立鍵值存放區。並且您已經建立或修改了一個函數,其中包含鍵值存放區中的鍵名稱。您現在可以建立鍵值存放區與函數的關聯。您從函數內建立該關聯。
建立函數與鍵值存放區的關聯
-
在導覽視窗中,選擇函數。依據預設,函數索引標籤會顯示在頂端。
-
選擇函數名稱,並在關聯的 KeyValueStore 區段中選擇關聯現有 KeyValueStore。
-
選取鍵值存放區,然後選擇關聯 KeyValueStore。
注意
每個函數只能與一個鍵值存放區建立關聯。
測試並發佈函數程式碼
將鍵值存放區與函數建立關聯後,您可以測試和發佈函數程式碼。每次修改函數程式碼時,應一律對其進行測試,包括執行以下操作時:
-
將鍵值存放區與函數建立關聯。
-
修改函數及其鍵值存放區,以包含新的鍵值對。
-
變更鍵值對的值。