使用 Application Manager 管理 AWS CloudFormation 範本 - AWS Systems Manager

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

使用 Application Manager 管理 AWS CloudFormation 範本

Application Manager是 的功能 AWS Systems Manager,包含範本程式庫和其他工具,可協助您管理 AWS CloudFormation 範本。此區段包含下列資訊:

使用範本程式庫

所以此 Application Manager 範本程式庫提供工具,可協助您檢視、建立、編輯、刪除和複製範本。您也可以直接從範本程式庫佈建堆疊。範本會儲存為類型 的 Systems Manager (SSM) 文件CloudFormation。透過將範本儲存為SSM文件,您可以使用版本控制來使用不同版本的範本。您也可以設定許可及共享範本。成功佈建堆疊後,堆疊和範本可在 中使用 Application Manager 和 CloudFormation。

開始之前

建議您先閱讀下列主題,以進一步了解SSM文件,再開始在 中使用 CloudFormation 範本 Application Manager.

若要在 中檢視範本程式庫 Application Manager
  1. 在 開啟 AWS Systems Manager 主控台https://console.aws.amazon.com/systems-manager/

  2. 在導覽窗格中,選擇 Application Manager.

  3. 應用程式區段中,選擇CloudFormation 堆疊

  4. 選擇 Template library (範本程式庫)。

建立範本

下列程序說明如何在 中建立 CloudFormation 範本 Application Manager。 建立範本時,您可以在 JSON或 中輸入範本的堆疊詳細資訊YAML。如果您不熟悉 JSON或 YAML,您可以使用 AWS CloudFormation 設計工具,以視覺化方式建立和修改範本。如需更多詳細資訊,請參閱 AWS CloudFormation 使用者指南 中的 什麼是 AWS CloudFormation 設計器?。如需範本結構與語法的資訊,請參閱範本剖析

您也可以從多個範本程式碼片段建構範本。範本程式碼片段是可向您示範如何撰寫特定資源範本的範例。例如,您可以檢視 Amazon Elastic Compute Cloud (AmazonEC2) 執行個體、Amazon Simple Storage Service (Amazon S3) 網域、 AWS CloudFormation 映射等程式碼片段。程式碼片段會依資源分組。您可以在《AWS CloudFormation 使用者指南》中的一般範本程式碼片段區段中尋找一般用途 AWS CloudFormation 程式碼片段。

在 中建立 CloudFormation 範本 Application Manager (主控台)

使用下列程序在 中建立 CloudFormation 範本 Application Manager 使用 AWS Management Console。

若要在 中建立 CloudFormation 範本 Application Manager
  1. 在 開啟 AWS Systems Manager 主控台https://console.aws.amazon.com/systems-manager/

  2. 在導覽窗格中,選擇 Application Manager.

  3. 應用程式區段中,選擇CloudFormation 堆疊

  4. 選擇 Template library (範本程式庫),然後選擇 Create template (建立範本) 或選擇現有範本,接著依次選擇 Actions (動作)、Clone (複製)。

  5. 對於 Name (名稱),輸入範本的名稱,以協助您識別其建立的資源或堆疊的用途。

  6. (選用) 對於 Version name (版本名稱),輸入名稱或編號以識別範本版本。

  7. (選用) 對於 Description (說明),輸入此範本的資訊。

  8. 程式碼編輯器區段中,選擇 YAML或 ,JSON然後輸入或複製並貼上範本程式碼。

  9. (選用) 在 Tags (標籤) 區段中,將一個或多個標籤索引鍵名稱/值對套用到範本。

  10. (選用) 在許可區段中,輸入 AWS 帳戶 ID 並選擇新增帳戶 。此動作會提供範本的讀取許可。帳戶擁有者可以佈建和複製範本,但無法編輯或刪除範本。

  11. 選擇 Create (建立)。範本會儲存在 Systems Manager (SSM) 文件服務中。

在 中建立 CloudFormation 範本 Application Manager (命令列)

在 JSON或 中建立 CloudFormation 範本的內容之後YAML,您可以使用 AWS Command Line Interface (AWS CLI) AWS Tools for PowerShell 或 將範本儲存為SSM文件。取代每個 example resource placeholder 使用您自己的資訊。

開始之前

AWS Tools for PowerShell如果您尚未安裝和設定 AWS CLI 或 。如需相關資訊,請參閱安裝或更新 AWS CLI的最新版本安裝 AWS Tools for PowerShell

Linux & macOS
aws ssm create-document \ --content file://path/to/template_in_json_or_yaml \ --name "a_name_for_the_template" \ --document-type "CloudFormation" \ --document-format "JSON_or_YAML" \ --tags "Key=tag-key,Value=tag-value"
Windows
aws ssm create-document ^ --content file://C:\path\to\template_in_json_or_yaml ^ --name "a_name_for_the_template" ^ --document-type "CloudFormation" ^ --document-format "JSON_or_YAML" ^ --tags "Key=tag-key,Value=tag-value"
PowerShell
$json = Get-Content -Path "C:\path\to\template_in_json_or_yaml | Out-String New-SSMDocument ` -Content $json ` -Name "a_name_for_the_template" ` -DocumentType "CloudFormation" ` -DocumentFormat "JSON_or_YAML" ` -Tags "Key=tag-key,Value=tag-value"

如果成功,此命令會傳回類似如下的回應。

{
    "DocumentDescription": {
        "Hash": "c1d9640f15fbdba6deb41af6471d6ace0acc22f213bdd1449f03980358c2d4fb",
        "HashType": "Sha256",
        "Name": "MyTestCFTemplate",
        "Owner": "428427166869",
        "CreatedDate": "2021-06-04T09:44:18.931000-07:00",
        "Status": "Creating",
        "DocumentVersion": "1",
        "Description": "My test template",
        "PlatformTypes": [],
        "DocumentType": "CloudFormation",
        "SchemaVersion": "1.0",
        "LatestVersion": "1",
        "DefaultVersion": "1",
        "DocumentFormat": "YAML",
        "Tags": [
            {
                "Key": "Templates",
                "Value": "Test"
            }
        ]
    }

編輯範本

使用下列程序在 中編輯 CloudFormation 範本 Application Manager。 在您佈建使用更新範本的堆疊 CloudFormation 之後,即可在 中使用範本變更。

在 中編輯 CloudFormation 範本 Application Manager
  1. 在 開啟 AWS Systems Manager 主控台https://console.aws.amazon.com/systems-manager/

  2. 在導覽窗格中,選擇 Application Manager.

  3. 應用程式區段中,選擇CloudFormation 堆疊

  4. 選擇 Template library (範本程式庫)。

  5. 選擇一個範本,然後選擇 Actions (動作)、Edit (編輯)。您無法變更範本的名稱,但您可以變更所有其他詳細資訊。

  6. 選擇 Save (儲存)。範本會存放在 Systems Manager 文件服務中。