【Python】如何在samconfig.yml中以List (array)格式編寫CommaDelimitedList

📅 發布日: 2025/02/09, 更新日: 2025/02/09 ⏱️ 預計閱讀時間約2分鐘 (924字)

在SAM CLI中使用samconfig.yml部署時，如果以CommaDelimitedList Type編寫引數，則必須將其寫為字串。
如果有許多元素，將其寫為字串將使其更長且更難讀取。
由於CommaDelimitedList以陣列格式編寫在samconfig.yml中，因此轉換過程已在Python中實現，因此我們將解釋如何執行此操作。

編碼標準和先決條件
使用 samconfig.yml 將 CommadelimitedList 轉換為列表格式的過程
（額外）部署 CloudFormation 時從 YAML 檔案生成 –cli-input-json 的 JSON 檔案

編碼標準和先決條件

本文引用的Python指令碼符合PEP8。
他們使用 flake8 進行語法檢查，使用 black 進行自動格式化。
由於處理原因必須忽略檢查的程式碼包括“#noqa”。
最大行長度（ max-line-length ）設定為 200 個字元。
Python執行時版本為3.12.1，相容性已測試。

使用 samconfig.yml 將 CommadelimitedList 轉換為列表格式的過程

所需的模組是：
argparse 是標準庫的一部分，因此不需要額外安裝。

pyyaml

以下 Python 指令碼將 samconfig.yml 中的 parameter_overrides 值從陣列格式轉換為 CommadelimitedList 格式。使用適當的 Python 檔名儲存它（例如“transform_parameter_overrides.py”）。
由於無法在 SAM CLI 選項之間切換，因此請將此指令碼合併到您的執行過程或 CI/CD 管道中。

import yaml
import argparse

def is_already_transformed(overrides):
    return all(isinstance(item, str) and "=" in item for item in overrides)

def transform_parameter_overrides(data):
    for key, value in data.items():
        if isinstance(value, dict) and "global" in value and "parameters" in value["global"]:
            parameters = value["global"]["parameters"]
            if "parameter_overrides" in parameters:
                if not is_already_transformed(parameters["parameter_overrides"]):
                    new_overrides = []
                    for override in parameters["parameter_overrides"]:
                        if isinstance(override, dict):
                            for k, v in override.items():
                                if isinstance(v, list):
                                    v = ",".join(v)
                                new_overrides.append(f"{k}={v}")
                    parameters["parameter_overrides"] = new_overrides
    return data

def main(input_file, output_file):
    with open(input_file, "r") as f:
        data = yaml.safe_load(f)

    transformed_data = transform_parameter_overrides(data)

    with open(output_file, "w") as f:
        yaml.dump(transformed_data, f, default_flow_style=False, sort_keys=False)

if __name__ == "__main__":
    parser = argparse.ArgumentParser(description="Transform parameter overrides in a YAML file.")
    parser.add_argument("--input-file", help="Path to the input YAML file.", default="samconfig.original.yml")
    parser.add_argument("--output-file", help="Path to the output YAML file.", default="samconfig.yml")
    args = parser.parse_args()

    main(args.input_file, args.output_file)

這是如何執行指令碼的示例。例如，將以 List 格式編寫的 samconfig.original.yml 檔案轉換為 samconfig.yml ：
該指令碼使用這些作為預設值，因此您可以在不指定任何引數的情況下執行它。
如果需要，請在執行指令碼時指定檔案路徑作為引數。

python transform_parameter_overrides.py

下面是 samconfig.original.yml 的示例。轉換此檔案將生成“samconfig.yml”。

version: 0.1
dev:
  global:
    parameters:
      parameter_overrides:
        - Environment: dev
        - Whitelist:
            # Windows Update
            # reference: https://learn.microsoft.com/en-us/windows-server/administration/windows-server-update-services/deploy/2-configure-wsus#211-configure-your-firewall-to-allow-your-first-wsus-server-to-connect-to-microsoft-domains-on-the-internet
            - .windowsupdate.microsoft.com
            - .update.microsoft.com
            - .windowsupdate.com
            - download.microsoft.com
            - .download.windowsupdate.com
            - wustat.windows.com
            - ntservicepack.microsoft.com
            - go.microsoft.com
            - dl.delivery.mp.microsoft.com
            - .delivery.mp.microsoft.com
            - .microsoft.com

下面是轉換後的 samconfig.yml 的示例。您可以看到 Whitelist 的值已轉換為 CommadelimitedList 格式。

version: 0.1
dev:
  global:
    parameters:
      parameter_overrides:
      - Environment=dev
      - Whitelist=.windowsupdate.microsoft.com,.update.microsoft.com,.windowsupdate.com,download.microsoft.com,.download.windowsupdate.com,wustat.windows.com,ntservicepack.microsoft.com,go.microsoft.com,dl.delivery.mp.microsoft.com,.delivery.mp.microsoft.com,.microsoft.com

（額外）部署 CloudFormation 時從 YAML 檔案生成 –cli-input-json 的 JSON 檔案

部署CloudFormation時，您可以提供引數作為外部檔案，並使用“–cli-input-json”選項指定JSON檔案。從 YAML 檔案生成此 JSON 檔案的過程如下。
所需的模組是：
argparse 是標準庫的一部分，因此不需要額外安裝。

pyyaml
json

以下 Python 指令碼將 parameter.original.yml 中的 Parameters 值轉換為 JSON 檔案，以便與 --cli-input-json 一起使用。使用適當的 Python 檔名儲存它（例如“transform_parameters.py”）。

import yaml
import json
import argparse

def transform_parameters(data):
    if "Parameters" in data:
        new_parameters = []
        for param in data["Parameters"]:
            for key, value in param.items():
                if isinstance(value, list):
                    value = ",".join(value)
                new_parameters.append({"ParameterKey": key, "ParameterValue": value})
        data["Parameters"] = new_parameters
    return data

def main(input_file, output_file):
    with open(input_file, "r") as f:
        data = yaml.safe_load(f)

    transformed_data = transform_parameters(data)

    with open(output_file, "w") as f:
        json.dump(transformed_data, f, indent=4)

if __name__ == "__main__":
    parser = argparse.ArgumentParser(description="Transform parameters in a YAML file.")
    parser.add_argument("--input-file", help="Path to the input YAML file.", default="parameter.original.yml")
    parser.add_argument("--output-file", help="Path to the output JSON file.", default="parameter.json")
    args = parser.parse_args()

    main(args.input_file, args.output_file)

這是如何執行指令碼的示例。例如，要將 YAML 格式的 parameter.original.yml 轉換為 parameter.json ：
該指令碼使用這些作為預設值，因此您可以在不指定任何引數的情況下執行它。
如果需要，請在執行指令碼時指定檔案路徑作為引數。

python transform_parameters.py

下面是 parameter.original.yml 的示例。轉換此檔案將生成“parameter.json”。

Parameters:
  Environment:
    - dev
  Whitelist:
    - .windowsupdate.microsoft.com
    - .update.microsoft.com
    - .windowsupdate.com
    - download.microsoft.com
    - .download.windowsupdate.com
    - wustat.windows.com
    - ntservicepack.microsoft.com
    - go.microsoft.com
    - dl.delivery.mp.microsoft.com
    - .delivery.mp.microsoft.com
    - .microsoft.com

下面是轉換後的“parameter.json”示例。可以看到 Parameters 的值已經轉換為 --cli-input-json 需要的JSON檔案格式。

{
    "Parameters": [
        {
            "ParameterKey": "Environment",
            "ParameterValue": "dev"
        },
        {
            "ParameterKey": "Whitelist",
            "ParameterValue": ".windowsupdate.microsoft.com,.update.microsoft.com,.windowsupdate.com,download.microsoft.com,.download.windowsupdate.com,wustat.windows.com,ntservicepack.microsoft.com,go.microsoft.com,dl.delivery.mp.microsoft.com,.delivery.mp.microsoft.com,.microsoft.com"
        }
    ]
}