教學課程：建立包含索引鍵值的 CloudFront 函數 - Amazon CloudFront
必要條件建立金鑰值存放區將鍵值對添加到鍵值存儲將鍵值存儲與函數相關聯測試並發佈函數程式碼

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

教學課程：建立包含索引鍵值的 CloudFront 函數

本教程將向您展示如何在 CloudFront 功能中包含鍵值。鍵值是鍵值對的一部分。您可以在函數代碼中包含名稱（來自鍵值對）。當函數運行時， CloudFront 將名稱替換為值。

鍵值對是存儲在鍵值存儲中的變量。當您在函數中使用鍵 (而不是硬式編碼值) 時，您的函數會更靈活。您可以變更鍵的值，而不需要部署程式碼變更。鍵值對也可以減少函數的大小。如需詳細資訊，請參閱 Amazon CloudFront KeyValueStore。

必要條件

如果您不熟悉 CloudFront Functions 函數和索引鍵值存放區，建議您遵循中的教學課程教學課程：使用函數建立簡單 CloudFront 函數。

完成該自學課程後，您可以依照本教學課程來擴充您所建立的函數。在本自學課程中，我們建議您先建立金鑰值存放區。

建立金鑰值存放區

首先，建立要用於函數的索引鍵值存放區。

建立金鑰值存放區的步驟

  1. 規劃您要包含在函數中的鍵值對。請記下這些鍵的名稱。您要在函數中使用的鍵值對必須位於單個索引鍵值存放區中。

  2. 決定工作的順序。有兩種方式可以繼續：

    • 創建一個鍵值存儲，並將鍵值對添加到存儲中。然後建立 (或修改) 函數並加入鍵的名稱。

    • 或者，建立 (或修改) 函數，並加入您要使用的鍵的名稱。然後創建一個鍵值存儲，並添加鍵值對。

  3. 登入 AWS Management Console 並開啟 CloudFront 主控台，位於https://console.aws.amazon.com/cloudfront/v4/home。

  4. 在導覽窗格中，選擇 [函數]，然後選擇索KeyValueStores引標籤。

  5. 選擇「建立」， KeyValueStore然後輸入下列欄位：

    • 輸入商店的名稱和（可選）說明。

    • 將 S3 URI 保留空白。在本教程中，您將手動輸入鍵值對。

  6. 選擇建立。此時會顯示新鍵值存放區的詳細資訊頁面。此頁面包含目前空白的鍵值對區段。

將鍵值對添加到鍵值存儲

接下來，手動將鍵值對清單新增至先前建立的金鑰值存放區。

若要將鍵值配對新增至索引鍵值存放區

  1. 在 [金鑰值配對] 區段中，選擇 [新增金鑰值配對]。

  2. 選擇 [新增配對]，然後輸入金鑰和值。選擇核取記號以確認變更，然後重複此步驟以新增更多內容。

  3. 完成後，選擇 [儲存變更] 以將鍵值組儲存在索引鍵值存放區中。在確認對話方塊中，選擇「完成」。

現在，您有一個包含一組鍵值對的鍵值存儲庫。

將鍵值存儲與函數相關聯

您現在已建立鍵值存放區。並且您已經建立或修改了一個函數，其中包含鍵值存放區中的鍵名稱。您現在可以建立鍵值存放區與函數的關聯。您從函數內建立該關聯。

將索引鍵值存放區與函數產生關聯

  1. 在導覽視窗中，選擇函數。依據預設，函數索引標籤會顯示在頂端。

  2. 選擇函數名稱，然後在「關聯 KeyValueStore」區段中選擇「關聯現有的」 KeyValueStore。

  3. 選取索引鍵值存放區，然後選擇「關聯」 KeyValueStore。

注意

您只能將一個索引鍵值存放區與每個函數相關聯。

測試並發佈函數程式碼

將索引鍵值存放區與函數產生關聯之後，您可以測試並發佈函數程式碼。每次修改函數程式碼時，應一律對其進行測試，包括執行以下操作時：

  • 將鍵值存放區與函數建立關聯。

  • 修改函數及其索引鍵值存放區，以包含新的索引鍵值配對。

  • 更改鍵值對的值。

若要測試和發佈函數程式碼

  1. 如需有關如何測試函數的詳細資訊，請參閱 測試功能。確定您選擇在 DEVELOPMENT 階段測試函數。

  2. 當您準備好在LIVE環境中使用函數 (搭配新的或修訂的索引鍵值組) 時，請發佈函數。

    當您發佈時，會 CloudFront 將該函數的版本從DEVELOPMENT舞台複製到即時階段。該函數具有新程式碼，並與鍵值存放區相關聯。(在即時階段無需再次執行關聯。)

    如需有關如何發佈函數的詳細資訊，請參閱 發佈函數。