將版本新增至 Distributor package

在 開啟 AWS Systems Manager 主控台https://console.aws.amazon.com/systems-manager/。

在導覽窗格中，選擇 Distributor.

在 上 Distributor 首頁，選擇您要新增其他版本的套件。

在 Add version (新增版本) 頁面上，選擇 Simple (簡單)。

對於 Version name (版本名稱)，輸入版本名稱。新版本的版本名稱必須與舊版本名稱不同。版本名稱最多可包含 512 個字元，而且不得包含特殊字元。

對於 S3 bucket name (S3 儲存貯體名稱)，從清單中選擇現有的 S3 儲存貯體。這可以與您存放舊版安裝型檔案使用的儲存貯體相同，但安裝型檔案名稱必須不同，來避免在儲存貯體中覆寫現有的安裝型檔案。

對於 S3 key prefix (S3 金鑰前綴)，輸入安裝型資產存放所在的儲存貯體子資料夾。

對於 Upload software (上傳軟體) 中，瀏覽您想要連接到新版本的安裝型軟體檔案。系統不會將現有版本中的安裝型檔案自動複製到新版本，如果您希望任何相同的安裝型檔案成為新版本的一部分，您必須從舊版套件上傳任何安裝型檔案。您可以在單一動作中上傳多個軟體檔案。

對於 Target platform (目標平台)，確認為每個安裝型檔案顯示的目標作業系統平台是否正確。如果顯示的作業系統不正確，請從下拉式清單中選擇正確的作業系統。

在 Simple (簡單) 版本控制工作流程中，因為您每個安裝型檔案僅上傳一次，需要額外的步驟來以多個作業系統的單一檔案為目標。例如，如果您上傳名為 的可安裝軟體檔案Logtool_v1.1.1.rpm，則必須變更簡單工作流程中的一些預設值，以指示 Distributor 以 Amazon Linux 和 Ubuntu 作業系統的相同軟體為目標。您可以執行以下其中一項操作來解決這個限制。

對於 Platform version (平台版本)，請確認顯示的作業系統平台版本是 _any (後接萬用字元的主要發行版本 (7.*))，或正是您希望軟體套用的確切作業系統發行版本。如需指定平台版本的詳細資訊，請參閱 步驟 2：建立JSON套件資訊清單中的步驟 4。

對於 Architecture (架構)，從下拉式清單中為每個安裝型檔案選擇正確的處理器架構。如需支援架構的詳細資訊，請參閱 支援的套件平台和架構。

（選用） 展開指令碼 ，並檢閱安裝和解除安裝指令碼 Distributor 會針對可安裝的軟體產生 。

若要將更多安裝型軟體檔案新增至新版本，選擇 Add software (新增軟體)。否則，請進行下一個步驟。

（選用） 展開清單清單 ，並檢閱JSON套件清單 Distributor 會針對可安裝的軟體產生 。如果在您開始此程序後變更了與安裝型軟體相關的任何資訊，例如平台版本或目標平台，請選擇 Generate manifest (產生資訊清單) 以顯示更新的套件資訊清單。

如果您想要以多個作業系統的軟體安裝型檔案為目標，您可以手動編輯資訊清單，如步驟 9 所述。如需編輯資訊清單的相關資訊，請參閱 步驟 2：建立JSON套件資訊清單。

當您完成軟體的新增和目標平台、版本和架構資料的檢閱後，請選擇 Add version (新增版本)。

等待 Distributor 完成上傳您的軟體並建立新的套件版本。Distributor 顯示每個可安裝檔案的上傳狀態。根據您新增的包裹數量和大小，這可能需要幾分鐘的時間。Distributor 會自動將您重新導向至套件的套件詳細資訊頁面，但您可以選擇在軟體上傳後自行開啟此頁面。在 之前，套件詳細資訊頁面不會顯示您套件的所有資訊 Distributor 完成建立新的套件版本。若要停止上傳和套件版本建立，請選擇 Stop upload (停止上傳)。

If Distributor 無法上傳任何軟體可安裝檔案，它會顯示上傳失敗訊息。若要重試上傳，請選擇 Retry upload (重試上傳)。如需如何對套件版本建立失敗進行疑難排解的更多資訊，請參閱 AWS Systems Manager疑難排解 Distributor。

當 Distributor 完成在套件的詳細資訊頁面上的版本索引標籤上建立新的套件版本，在可用套件版本清單中檢視新版本。選擇版本來設定預設的套件版本，然後選擇 Set default version (設定預設版本)。

如果您不設定預設版本，則最新套件版本就是預設版本。

在 開啟 AWS Systems Manager 主控台https://console.aws.amazon.com/systems-manager/。

在導覽窗格中，選擇 Distributor.

在 上 Distributor 首頁，選擇您要新增其他版本的套件，然後選擇新增版本 。

對於 Version name (版本名稱)，輸入您資訊清單檔案中 version 項目的確切值。

對於 S3 bucket name (S3 儲存貯體名稱)，從清單中選擇現有的 S3 儲存貯體。這可以與您存放舊版安裝型檔案使用的儲存貯體相同，但安裝型檔案名稱必須不同，來避免在儲存貯體中覆寫現有的安裝型檔案。

對於 S3 key prefix (S3 金鑰前綴)，輸入安裝型資產存放所在的儲存貯體子資料夾。

對於 Manifest (資訊清單)，選擇 Extract from package (從套件中擷取) 來使用您透過 .zip 檔案上傳到 S3 儲存貯體的資訊清單。

（選用） 如果您未將修訂後的JSON清單上傳至存放 .zip 檔案的 Amazon S3 儲存貯體，請選擇新清單 。您可以在JSON編輯器欄位中撰寫或貼上整個資訊清單。如需如何建立JSON資訊清單的詳細資訊，請參閱 步驟 2：建立JSON套件資訊清單。

當您完成資訊清單時，請選擇 Add package version (新增套件版本)。

在套件的 Details (詳細資訊) 頁面的 Versions (版本) 標籤上，可查看可用套件版本清單的新版本。選擇版本來設定預設的套件版本，然後選擇 Set default version (設定預設版本)。

如果您不設定預設版本，則最新套件版本就是預設版本。

執行下列命令，使用新套件版本的項目編輯 AWS Systems Manager 文件。Replace (取代) document-name 您的文件名稱。Replace (取代) amzn-s3-demo-bucket 您在 中複製URL的JSON清單清單的 步驟 3：將套件和資訊清單上傳至 Amazon Simple Storage Service (Amazon S3) 儲存貯體。S3-bucket-URL-of-package 是存放整個套件URL的 Amazon S3 儲存貯體的 。Replace (取代) version-name-from-updated-manifest 清單version清單中的值為 。將 --document-version 參數設定為 $LATEST，讓與此套件版本相關聯的文件變成最新文件版本。

aws ssm update-document \
    --name "document-name" \
    --content "S3-bucket-URL-to-manifest-file" \
    --attachments Key="SourceUrl",Values="amzn-s3-demo-bucket" \
    --version-name version-name-from-updated-manifest \
    --document-version $LATEST

以下是範例。

aws ssm update-document \
    --name ExamplePackage \
    --content "https://s3.amazonaws.com/amzn-s3-demo-bucket/ExamplePackage/manifest.json" \
    --attachments Key="SourceUrl",Values="https://s3.amazonaws.com/amzn-s3-demo-bucket/ExamplePackage" \
    --version-name 1.1.1 \
    --document-version $LATEST

執行以下命令來驗證您的套件已更新，並顯示套件資訊清單。Replace (取代) package-name 包含套件的名稱，以及選用的 document-version 您更新的文件版本編號 （與套件版本不同）。若此套件版本與最新文件版本相關，您可以將選用 --document-version 參數的值指定為 $LATEST。

aws ssm get-document \
    --name "package-name" \
    --document-version "document-version"