Distributor でパッケージを作成する

AWS Systems Manager コンソール (https://console.aws.amazon.com/systems-manager/) を開きます。

ナビゲーションペインで、[Distributor] を選択します。

Distributor ホームページで [Create package (パッケージの作成)]、[Simple] の順に選択します。

[Create package (パッケージの作成)] ページに、パッケージの名前を入力します。パッケージ名には、文字、数字、ピリオド、ダッシュ、アンダースコアを含めることができます。この名前は、パッケージの添付ファイルのすべてのバージョンに適用できるほど一般的である必要がありますが、パッケージの目的を識別できるよう具体的な名前である必要があります。

（オプション） [バージョン名] にバージョン名を入力します。バージョン名は最大 512 文字で、特殊文字を含めることはできません。

[Location (ロケーション)] で、バケット名とプレフィックス、またはバケット URL を使用してバケットを選択します。

[Upload software] (ソフトウェアのアップロード) で、[Add software] (ソフトウェアの追加) を選択し、.rpm、.msi、または .deb 拡張子が付いたインストール可能なソフトウェアファイルにナビゲートします。ファイル名にスペースが含まれていると、アップロードは失敗します。1 回のアクションで複数のソフトウェアファイルをアップロードできます。

[Target platform (ターゲットプラットフォーム)] で、インストール可能な各ファイルに表示されるターゲットオペレーティングシステムプラットフォームが正しいことを確認します。表示されているオペレーティングシステムが正しくない場合は、ドロップダウンリストから正しいオペレーティングシステムを選択します。

[Simple] パッケージ作成ワークフローでは、各インストール可能ファイルを 1 回だけアップロードするため、Distributor に複数のオペレーティングシステムの単一ファイルをターゲットにするよう指示するための追加のステップが必要です。たとえば、Logtool_v1.1.1.rpm という名前のインストール可能なソフトウェアファイルをアップロードする場合、サポートされているバージョンの Amazon Linux と Ubuntu Server オペレーティングシステムの両方で同じソフトウェアがターゲットになるため、[Simple] ワークフローのデフォルト設定をいくつか変更する必要があります。複数のプラットフォームをターゲットにする場合は、次のいずれかの操作を行います。

[プラットフォームのバージョン] で、表示されているオペレーティングシステムのプラットフォームのバージョンが _any、後にワイルドカード (7.*) が続くメジャーリリースバージョン、またはソフトウェアを適用する特定のオペレーティングシステムのリリースバージョンに一致していることを確認します。オペレーティングシステムのプラットフォームのバージョンの指定の詳細については、ステップ 2: JSON パッケージマニフェストを作成する のステップ 4 を参照してください。

[Architecture] のドロップダウンリストから、インストール可能なファイルごとに正しいプロセッサアーキテクチャを選択します。サポートされるプロセッサアーキテクチャの詳細については、「サポートされているパッケージのプラットフォームとアーキテクチャ」を参照してください。

（オプション） [Scripts (スクリプト)] を展開し、インストール可能なソフトウェア用に Distributor によって生成されるスクリプトを確認します。

（オプション）インプレース更新で使用する更新スクリプトを提供するには、[Scripts (スクリプト)] を展開し、[Update script (スクリプトの更新)] タブを選択して、更新スクリプトコマンドを入力します。

Systems Manager は、ユーザーに代わって更新スクリプトを生成しません。

インストール可能なソフトウェアファイルを追加するには、[Add software (ソフトウェアの追加)] を選択します。それ以外の場合は、次のステップに進みます。

(オプション) [Manifest (マニフェスト)] を展開し、インストール可能なソフトウェアに対して Distributor が生成する JSON パッケージのマニフェストを確認します。プラットフォームのバージョンやターゲットのプラットフォームなど、この手順を開始してからソフトウェアに関する情報を変更した場合は、[Generate manifest (マニフェストの生成)] を選択して、更新されたパッケージマニフェストを表示します。

ステップ 8 で説明されているように、複数のオペレーティングシステムでインストール可能なソフトウェアをターゲットにする場合は、マニフェストを手動で編集できます。マニフェストの編集の詳細については、「ステップ 2: JSON パッケージマニフェストを作成する」を参照してください。

[Create package (パッケージの作成)] を選択します。

スキーマバージョンをマニフェストに追加します。このリリースでは、スキーマバージョンは常に 2.0 です。

{ "schemaVersion": "2.0",

ユーザー定義のパッケージのバージョンをマニフェストに追加します。これは、パッケージを Distributor に追加するときに指定する [Version name (バージョン名)] の値でもあります。これは、パッケージを追加するときに Distributor が作成する AWS Systems Manager ドキュメントの一部になります。また、この値を AWS-ConfigureAWSPackage ドキュメントの入力として提供して、最新バージョン以外のバージョンのパッケージをインストールします。version 値には、文字、数字、アンダースコア、ハイフン、およびピリオドを含み、長さは最大 128 文字までです。人間が読み取れるパッケージバージョンを使用して、デプロイ時にユーザーと他の管理者が正確なパッケージバージョンを簡単に指定できるようにすることをお勧めします。以下はその例です。

"version": "1.0.1",

(オプション) 発行者名を追加します。以下はその例です。

"publisher": "MyOrganization",

パッケージを追加します。この "packages" セクションでは、パッケージ内の .zip ファイルでサポートされているプラットフォーム、リリースバージョン、アーキテクチャについて説明します。詳細については、「サポートされているパッケージのプラットフォームとアーキテクチャ」を参照してください。

platform-version はワイルドカード値 _any にすることができます。このファイルを使用して、.zip ファイルがプラットフォームのリリースをサポートしていることを示します。また、メジャーリリースバージョンの後にワイルドカードを指定して、すべてのマイナーバージョンをサポートすることもできます (たとえば 7.*)。特定のオペレーティングシステムバージョンに対して platform-version 値を指定する場合は、ターゲットとするオペレーティングシステム AMI のリリースバージョンと正確に一致していることを確認してください。以下は、オペレーティングシステムの正しい値を得るために推奨されるリソースです。

"packages": {
    "platform": {
      "platform-version": {
        "architecture": {
          "file": ".zip-file-name-1.zip"
        }
      }
    },
    "another-platform": {
      "platform-version": {
        "architecture": {
          "file": ".zip-file-name-2.zip"
        }
      }
    },
    "another-platform": {
      "platform-version": {
        "architecture": {
          "file": ".zip-file-name-3.zip"
        }
      }
    }
  }

以下に例を示します。この例では、オペレーティングシステムプラットフォームは amazon、サポートされているリリースバージョンは 2016.09、アーキテクチャは x86_64、このプラットフォームをサポートする .zip ファイルは test.zip です。

{
    "amazon": {
        "2016.09": {
            "x86_64": {
                "file": "test.zip"
            }
        }
    }
},

ワイルドカード値 _any を追加して、パッケージが親要素のすべてのバージョンをサポートしていることを示すことができます。例えば、パッケージが Amazon Linux のリリース版でサポートされていることを示すには、パッケージステートメントは以下のようになります。バージョンまたはアーキテクチャレベルで _any ワイルドカードを使用すると、プラットフォームのすべてのバージョン、またはバージョンのすべてのアーキテクチャ、またはプラットフォームのすべてのバージョンとすべてのアーキテクチャをサポートできます。

{
    "amazon": {
        "_any": {
            "x86_64": {
                "file": "test.zip"
            }
        }
    }
},

次の例では、_any を追加して、最初のパッケージ data1.zip が Amazon Linux 2016.09 のすべてのアーキテクチャでサポートされていることを示します。2 番目のパッケージ data2.zip は、Amazon Linux のすべてのリリースでサポートされていますが、x86_64 アーキテクチャのマネージドノードでのみサポートされています。2023.8 および _any バージョンは両方とも amazon 下にあるエントリです。1 つのプラットフォーム (Amazon Linux) がありますが、サポートされているバージョン、アーキテクチャ、および関連する .zip ファイルは異なります。

{
    "amazon": {
        "2023.8": {
            "_any": {
                "file": "data1.zip"
            }
        },
        "_any": {
            "x86_64": {
                "file": "data2.zip"
            }
        }
    }
}

.zip ファイルが複数のプラットフォームをサポートしている場合は、マニフェストの "packages" セクションで複数回 .zip ファイルを参照できます。例えば、Red Hat Enterprise Linux 8.x バージョンと Amazon Linux の両方をサポートする .zip ファイルがある場合、次の例に示すように、同じ .zip ファイルを指す 2 つのエントリが "packages" セクションにあります。

{
    "amazon": {
        "2023.8.20250715 ": {
            "x86_64": {
                "file": "test.zip"
            }
        }
    },
    "redhat": {
        "8.*": {
            "x86_64": {
                "file": "test.zip"
            }
        }
    }
},

ステップ 4。からこのパッケージの一部である .zip ファイルのリストを追加します。各ファイルエントリには、ファイル名と sha256 ハッシュ値チェックサムが必要です。マニフェストのチェックサム値は、パッケージのインストールが失敗しないように、圧縮されたアセットの sha256 ハッシュ値と一致する必要があります。

インストール可能ファイルから正確なチェックサムを取得するには、次のコマンドを実行します。Linux では、shasum -a 256 file-name.zip または openssl dgst -sha256 file-name.zip を実行します。Windows では、PowerShell で Get-FileHash -Path path-to-.zip-file コマンドレットを実行します。

マニフェストの "files" セクションには、パッケージ内の各 .zip ファイルへのリファレンスが 1 つ含まれています。

"files": {
        "test-agent-x86.deb.zip": {
            "checksums": {
                "sha256": "EXAMPLE2706223c7616ca9fb28863a233b38e5a23a8c326bb4ae241dcEXAMPLE"
            }
        },
        "test-agent-x86_64.deb.zip": {
            "checksums": {
                "sha256": "EXAMPLE572a745844618c491045f25ee6aae8a66307ea9bff0e9d1052EXAMPLE"
            }
        },
        "test-agent-x86_64.nano.zip": {
            "checksums": {
                "sha256": "EXAMPLE63ccb86e830b63dfef46995af6b32b3c52ce72241b5e80c995EXAMPLE"
            }
        },
        "test-agent-rhel8-x86.nano.zip": {
            "checksums": {
                "sha256": "EXAMPLE13df60aa3219bf117638167e5bae0a55467e947a363fff0a51EXAMPLE"
            }
        },
        "test-agent-x86.msi.zip": {
            "checksums": {
                "sha256": "EXAMPLE12a4abb10315aa6b8a7384cc9b5ca8ad8e9ced8ef1bf0e5478EXAMPLE"
            }
        },
        "test-agent-x86_64.msi.zip": {
            "checksums": {
                "sha256": "EXAMPLE63ccb86e830b63dfef46995af6b32b3c52ce72241b5e80c995EXAMPLE"
            }
        },
        "test-agent-rhel8-x86.rpm.zip": {
            "checksums": {
                "sha256": "EXAMPLE13df60aa3219bf117638167e5bae0a55467e947a363fff0a51EXAMPLE"
            }
        }
    }

パッケージ情報を追加したら、マニフェストファイルを保存して閉じます。

マニフェストで指定したすべての .zip アーカイブファイルを、フォルダまたはディレクトリにコピーまたは移動します。.zip アーカイブファイルとマニフェストファイルの移動先のフォルダやディレクトリは圧縮しないでください。

バケットを作成するか、既存のバケットを選択します。詳細については、Amazon Simple Storage Service 入門ガイドの「バケットの作成」を参照してください。AWS CLI コマンドを実行してバケットを作成する方法の詳細については、AWS CLI コマンドリファレンスの「mb」を参照してください。

フォルダかディレクトリをバケットにアップロードします。詳細については、Amazon Simple Storage Service 入門ガイドの「バケットへのオブジェクトの追加」を参照してください。JSON マニフェストを AWS Systems Manager コンソールに貼り付ける場合は、マニフェストをアップロードしないでください。AWS CLI コマンドを実行してバケットにファイルをアップロードする方法の詳細については、AWS CLI コマンドリファレンスの「mv」を参照してください。

バケットのホームページでアップロードしたフォルダかディレクトリを選択します。バケット内のサブフォルダにファイルをアップロードした場合は、サブフォルダ ([prefix] とも呼ばれる) を書き留めます。パッケージを Distributor に追加するには、プレフィックスが必要です。

AWS Systems Manager コンソール (https://console.aws.amazon.com/systems-manager/) を開きます。

ナビゲーションペインで、[Distributor] を選択します。

Distributor ホームページで [Create package (パッケージの作成)]、[Advanced] の順に選択します。

[Create package (パッケージの作成)] ページに、パッケージの名前を入力します。パッケージ名には、文字、数字、ピリオド、ダッシュ、アンダースコアを含めることができます。この名前は、パッケージの添付ファイルのすべてのバージョンに適用できるほど一般的である必要がありますが、パッケージの目的を識別できるよう具体的な名前である必要があります。

[Version name (バージョン名)] で、マニフェストファイルの version エントリの正確な値を入力します。

[S3 バケット名] で、ステップ 3: Amazon S3 バケットにパッケージとマニフェストをアップロードする で .zip ファイルとマニフェストをアップロードしたバケットの名前を選択します。

[S3 キープレフィックス] に、.zip ファイルとマニフェストが保存されているバケットのサブフォルダを入力します。

[マニフェスト] で、[パッケージから抽出] を選択して、.zip ファイルとともに Amazon S3 バケットにアップロードしたマニフェストを使用します。

（オプション） .zip ファイルを保存した S3 バケットに JSON マニフェストをアップロードしなかった場合は、[新しいマニフェスト] を選択します。JSON エディタフィールドで、マニフェスト全体を作成または貼り付けることができます。JSON マニフェストの作成方法の詳細については、「ステップ 2: JSON パッケージマニフェストを作成する」を参照してください。

マニフェストの作成または貼り付けが完了したら、[パッケージの作成] を選択します。

Distributor で .zip ファイルとマニフェストからパッケージが作成されるまで待ちます。追加するパッケージの数とサイズによっては、数分かかる場合があります。 Distributor では、新しいパッケージの [Package details] ページに自動的にリダイレクトされますが、ソフトウェアのアップロード後にこのページを自分で開くことを選択することもできます。Distributor でパッケージの作成プロセスが完了するまで、[パッケージの詳細] ページにはパッケージに関する情報は表示されません。アップロードプロセスとパッケージ作成プロセスを停止するには、[Cancel] を選択します。

AWS CLI を使用してパッケージを作成するには、次のコマンドを実行します。コマンドの package-name はパッケージ名に、path-to-manifest-file は JSON マニフェストファイルのファイルパスに置き換えてください。amzn-s3-demo-bucket は、パッケージ全体が保存されている Amazon S3 バケットの URL です。Distributor で create-document コマンドを実行する場合は、--document-type の Package 値を指定します。

マニフェストファイルを Amazon S3 バケットに追加しなかった場合、--content パラメータ値は JSON マニフェストファイルへのファイルパスです。

aws ssm create-document \
    --name "package-name" \
    --content file://path-to-manifest-file \
    --attachments Key="SourceUrl",Values="amzn-s3-demo-bucket" \
    --version-name version-value-from-manifest \
    --document-type Package

以下はその例です。

aws ssm create-document \
    --name "ExamplePackage" \
    --content file://path-to-manifest-file \
    --attachments Key="SourceUrl",Values="https://s3.amazonaws.com/amzn-s3-demo-bucket/ExamplePackage" \
    --version-name 1.0.1 \
    --document-type Package

パッケージが追加されたことを確認し、package-name をパッケージ名で置き換えて次のコマンドを実行して、パッケージマニフェストを表示します。ドキュメントの特定のバージョンを取得するには (パッケージのバージョンと同じではありません)、--document-version パラメータを追加します。

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