教學課程：建立包含索引鍵值的 CloudFront 函數 - Amazon CloudFront
先決條件建立鍵值存放區將鍵值對新增至鍵值存放區將鍵值存放區與函數建立關聯測試和發佈函數程式碼

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

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

本教學課程說明如何使用 CloudFront 函數納入鍵值。鍵值是鍵值對的一部分。您可以在函數程式碼中包含名稱 （來自鍵值對）。函數執行時，CloudFront 會以值取代該名稱。

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

先決條件

如果您是初次使用 CloudFront Functions 函數和鍵值存放區，建議您遵循中的教學課程教學課程：使用 CloudFront Functions 建立簡單的 函數。

完成該教學課程後，您可以遵循此教學課程來擴展您建立的 函數。在本教學課程中，建議您先建立金鑰值存放區。

建立鍵值存放區

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

建立鍵值存放區

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

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

    • 建立鍵值存放區，並將鍵值對新增至存放區。然後建立 (或修改) 函數並加入鍵的名稱。

    • 或者，建立 (或修改) 函數，並加入您要使用的鍵的名稱。然後建立鍵值存放區，並新增鍵值對。

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

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

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

    • 輸入存放區的名稱和 （選用） 描述。

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

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

將鍵值對新增至鍵值存放區

接著，手動將鍵值對清單新增至您先前建立的鍵值存放區。

將鍵值對新增至鍵值存放區

  1. 在鍵值對區段中，選擇新增鍵值對。

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

  3. 完成後，請選擇儲存變更，將鍵值對儲存在鍵值存放區中。在確認對話方塊中，選擇完成。

您現在有一個金鑰值存放區，其中包含一組金鑰值對。

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

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

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

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

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

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

注意

您只能將一個鍵值存放區與每個函數建立關聯。

測試和發佈函數程式碼

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

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

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

  • 變更鍵值對的值。

測試和發佈函數程式碼

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

  2. 當您準備好在LIVE環境中使用函數 （搭配新的或修訂後的鍵值對） 時，請發佈函數。

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

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