翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Software Package Catalog の開始方法
AWS IoT Device Management Software Package Catalog は AWS マネジメントコンソール、、 AWS IoT Core API オペレーション、および AWS Command Line Interface () を使用して構築および保守できますAWS CLI。
**注記**
AWS IoT フリートインデックス作成を有効にすることは、 Software Package Catalog を使用するための要件です。でソフトウェアパッケージバージョンを作成し、 `CreatePackage` API コマンド AWS マネジメントコンソール を使用するなどの基本的な操作は、 AWS IoT フリートインデックス作成を有効にしないと失敗します。
Software Package Catalog での AWS IoT フリートインデックス作成の使用の詳細については、「」を参照してください[フリートインデックス作成の準備](preparing-fleet-indexing.md)。
**コンソールの使用**
を使用するには AWS マネジメントコンソール、 AWS アカウントにサインインし、 に移動します[AWS IoT Core](https://console.aws.amazon.com/iot/home)。ナビゲーションペインで、**[ソフトウェアパッケージ]** を選択します。その後で、このセクションからパッケージとそのバージョンを作成および管理できます。
**API または CLI オペレーションの使用**
AWS IoT Core API オペレーションを使用して、 Software Package Catalog 機能を作成および管理できます。詳細については、「[AWS IoT API リファレンス](https://docs.aws.amazon.com/iot/latest/apireference/)」および「[AWS SDK とツールキット](https://aws.amazon.com/developer/tools/)」を参照してください。 AWS CLI コマンドはカタログも管理します。詳細については、「[AWS IoT CLI コマンドリファレンス](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/index.html)」を参照してください。
**Topics**
+ [ソフトウェアパッケージとパッケージバージョンの作成](creating-package-and-version.md)
+ [AWS IoT ジョブによるパッケージバージョンのデプロイ](deploying-package-version.md)
+ [AWS IoT モノへのパッケージバージョンの関連付け](associating-package-version.md)
# ソフトウェアパッケージとパッケージバージョンの作成
次の手順を使用して、 AWS マネジメントコンソールからパッケージと初期バージョンのモノを作成できます。
**ソフトウェアパッケージを作成するには**
1. AWS アカウントにサインインし、 [AWS IoT コンソール](https://console.aws.amazon.com/iot/home)に移動します。
1. ナビゲーションペインで、**[ソフトウェアパッケージ]** を選択します。
1. **[AWS IoT ソフトウェアパッケージ]** ページで、**[パッケージの作成]** を選択します。**[パッケージ管理の依存関係を有効にする]** ダイアログボックスが表示されます。
1. **[フリートインデックス作成]** で、**[デバイスソフトウェアパッケージとバージョンの追加]** を選択します。これは、Software Package Catalog に必須で、フリートインデックス作成とフリートに関するメトリクスを提供します。
1. [オプション] AWS IoT ジョブが正常に完了したときに予約された名前付きシャドウをジョブで更新する場合は、**ジョブからシャドウの自動更新**を選択します。 AWS IoT ジョブでこの更新を行わない場合は、このチェックボックスはオフのままにします。
1. [オプション] 予約済み名前付きシャドウを更新する権限を AWS IoT ジョブに付与するには、**「ロールの選択**」で**「ロールの作成**」を選択します。 AWS IoT ジョブでこの更新を行わない場合は、このロールは必要ありません。
1. ロールを作成または選択します。
1. この目的の**ロールがない**場合: **[ロールを作成]** ダイアログボックスが表示されたら、**[ロール名]** を入力して **[作成]** を選択します。
1. この目的の**ロールがある場合**: **[ロールを選択]** でロールを選択し、**[IAM ロールにポリシーをアタッチ]** チェックボックスがオンになっていることを確認します。
1. **[確認]** を選択します。**[新しいパッケージを作成]** ページが表示されます。
1. **[パッケージの詳細]** に、**パッケージ名**を入力します。
1. **[パッケージの説明]** に、このパッケージの識別と管理に役立つ情報を入力します。
1. [オプション] タグを使用すると、このパッケージを分類および管理しやすくなります。タグを追加するには、**[タグ]** を展開して **[タグを追加]** を選択し、キーと値のペアを入力します。最大 50 個のタグを入力できます。詳細については、「 [AWS IoT リソースのタグ付け](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html)」を参照してください。
**新しいパッケージの作成時にパッケージバージョンを追加するには**
1. **[初期バージョン]** に、**[バージョン名]** を入力します。
パッケージのバージョンを一意に識別するには、[SemVer 形式](https://semver.org/) (例: `1.0.0.0`) を使用することをお勧めします。また、ユースケースに適した別のフォーマット戦略を使用することもできます。詳細については、「[パッケージバージョンライフサイクル](preparing-to-use-software-package-catalog.md#package-version-lifecycle)」を参照してください。
1. **[バージョンの説明]** に、このパッケージバージョンの識別と管理に役立つ情報を入力します。
**注記**
パッケージバージョンは `draft` 状態で作成されるため、**[デフォルトバージョン]** チェックボックスはオフになっています。パッケージバージョンの作成後、および状態を `published` に変更したときに、デフォルトバージョンに名前を付けることができます。詳細については、「[パッケージバージョンライフサイクル](preparing-to-use-software-package-catalog.md#package-version-lifecycle)」を参照してください。
1. [オプション] このバージョンを管理したり、デバイスに情報を伝えたりするには、**[バージョン属性]** に名前と値のペアを 1 つ以上入力します。入力する名前と値のペアごとに **[属性の追加]** を選択します。詳細については、「[バージョン属性](preparing-to-use-software-package-catalog.md#version-attributes)」を参照してください。
1. [オプション] タグを使用すると、このパッケージを分類および管理しやすくなります。タグを追加するには、**[タグ]** を展開して **[タグを追加]** を選択し、キーと値のペアを入力します。最大 50 個のタグを入力できます。詳細については、「 [AWS IoT リソースのタグ付け](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html)」を参照してください。
1. [**次へ**] を選択します。
**ソフトウェア部品表をパッケージバージョンに関連付ける (オプション）**
1. **[SBOM 設定]** ウィンドウの **[ステップ 3: バージョン SBOM (オプション)]** で、パッケージバージョンに関連付ける前に、ソフトウェア部品表の検証に使用されるデフォルトの SBOM ファイル形式と検証モードを選択します。
1. **[SBOM ファイルを追加]** ウィンドウで、バージョニングされた Amazon S3 バケットを表す Amazon リソースネーム (ARN) と、デフォルトのタイプが機能しない場合は任意の SBOM ファイル形式を入力します。
**注記**
パッケージバージョンに複数のソフトウェア部品表がある場合は、1 つの SBOM ファイルまたは複数の SBOM を含む 1 つの zip ファイルを追加できます。
1. **[追加された SBOM ファイル]** ウィンドウで、パッケージバージョンに追加した SBOM ファイルを表示できます。
1. **[パッケージとバージョンの作成]** を選択します。パッケージバージョンページが表示され、**[追加された SBOM ファイル]** ウィンドウで SBOM ファイルの検証ステータスを確認できます。SBOM ファイルが検証されるときに初期ステータスは `In progress` になります。
**注記**
SBOM ファイルの検証ステータスは、`Invalid file`、`Not started`、`In progress`、`Validated (SPDX)`、`Validated (CycloneDX)` および検証失敗の理由です。
# AWS IoT ジョブによるパッケージバージョンのデプロイ
次の手順を使用して、 AWS マネジメントコンソールからパッケージバージョンをデプロイできます。
**前提条件**:
開始する前に、以下を実行します。
+ AWS IoT モノを に登録します AWS IoT Core。デバイスを追加する手順については AWS IoT Core、「モノ[のオブジェクトを作成する](https://docs.aws.amazon.com/iot/latest/developerguide/create-iot-resources.html#create-aws-thing)」を参照してください。
+ [オプション] AWS IoT モノのグループまたはモノの動的グループを作成して、パッケージバージョンをデプロイするデバイスをターゲットにします。モノのグループの作成方法については、「[モノの静的グループの作成](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html#create-thing-group)」を参照してください。モノの動的グループの作成方法については、「[モノの動的グループを作成する](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html#create-dynamic-thing-group)」を参照してください。
+ ソフトウェアパッケージとパッケージバージョンを作成します。詳細については、「[ソフトウェアパッケージとパッケージバージョンの作成](creating-package-and-version.md)」を参照してください。
+ ジョブドキュメントを作成します。詳細については、「[デプロイ用のジョブドキュメントとパッケージバージョンの準備](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-jobs-for-service-package-catalog.html#preparing-to-deploy)」を参照してください。
**AWS IoT ジョブをデプロイするには**
1. [AWS IoT コンソール](https://console.aws.amazon.com/iot/home)で、**[ソフトウェアパッケージ]** を選択します。
1. デプロイするソフトウェアパッケージを選択します。**[ソフトウェアパッケージ詳細]** ページが表示されます。
1. **[バージョン]** でデプロイするパッケージバージョンを選択し、**[ジョブバージョンのデプロイ]** を選択します。
1. このポータルから初めてジョブをデプロイする場合は、要件を説明するダイアログボックスが表示されます。情報を確認してから、[**確認**] を選択します。
1. デプロイの名前を入力するか、自動生成された名前を **[名前]** フィールドに残します。
1. [オプション] **[説明]** フィールドに、デプロイの目的や内容を特定する説明を入力するか、自動生成された情報をそのまま残します。
**注意:** ジョブ名および説明のフィールドに個人を特定できる情報を使用しないことをお勧めします。
1. [オプション] このジョブに関連付けるタグをすべて追加します。
1. [**次へ**] を選択します。
1. **[ジョブターゲット]** で、ジョブを受け取るモノまたはモノのグループを選択します。
1. **[ジョブファイル]** フィールドで、ジョブドキュメントの JSON ファイルを指定します。
1. **[Package Catalog サービスとのジョブの統合]** を開きます。
1. ジョブドキュメント内で指定されているパッケージとバージョンを選択します。
**注記**
ジョブドキュメント内で指定されているのと同じパッケージとパッケージバージョンを選択する必要があります。さらに多くを含めることもできますが、ジョブから発行される指示は、ジョブドキュメントに含まれるパッケージとバージョンについてのみです。詳細については、「[デプロイ時のパッケージとバージョンの命名](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-jobs-for-service-package-catalog.html#naming-package-versions)」を参照してください。
1. [**次へ**] を選択します。
1. [ジョブ設定] ダイアログボックスの [ジョブ設定] ページで、次のいずれかのジョブタイプを選択します。
+ **スナップショットジョブ**: スナップショットジョブは、ターゲットデバイスおよびグループでの実行が終了すると完了します。
+ **連続ジョブ**: 連続ジョブはモノのグループに適用され、指定したターゲットグループに後に追加するあらゆるデバイス上で実行されます。
1. **[その他の設定 - オプション]** ダイアログボックスで、以下のオプションのジョブ設定を確認し、それに応じて選択してください。詳細については、「[ジョブのロールアウト、スケジュール、中止の設定](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-configurations-details.html#job-rollout-abort-scheduling)」および「[ジョブ実行タイムアウトと再試行の設定](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-configurations-details.html#job-timeout-retry)」を参照してください。
+ ロールアウト設定
+ スケジューリング設定
+ ジョブ実行タイムアウトの設定
+ ジョブ実行再試行設定
+ 中止設定
1. 選択したジョブを確認して、**[送信]** を選択します。
ジョブを作成した後、コンソールにより JSON 署名が生成され、ジョブドキュメントに入力されます。 AWS IoT コンソールを使用して、ジョブのステータスを表示したり、ジョブをキャンセルまたは削除したりできます。ジョブを管理するには、[コンソールの [Job hub]](https://console.aws.amazon.com/iot/home#/jobhub) (ジョブハブ) に移動します。
# AWS IoT モノへのパッケージバージョンの関連付け
デバイスにソフトウェアをインストールしたら、パッケージバージョンを AWS IoT モノの予約済みの名前付きシャドウに関連付けることができます。 AWS IoT ジョブがデプロイされて正常に完了した後に、モノの予約済み名前付きシャドウを更新するようにジョブが設定されている場合は、この手順を完了する必要はありません。詳細については、「[予約済みの名前付きシャドウ](preparing-to-use-software-package-catalog.md#reserved-named-shadow)」を参照してください。
**前提条件**:
開始する前に、以下を実行します。
+ AWS IoT モノを作成し、テレメトリを確立します AWS IoT Core。詳細については、[「 の開始方法 AWS IoT Core](https://docs.aws.amazon.com/iot/latest/developerguide/iot-gs.html)」を参照してください。
+ ソフトウェアパッケージとパッケージバージョンを作成します。詳細については、「[ソフトウェアパッケージとパッケージバージョンの作成](creating-package-and-version.md)」を参照してください。
+ パッケージバージョンソフトウェアをデバイスにインストールします。
**注記**
パッケージバージョンを AWS IoT モノに関連付けても、物理デバイスにソフトウェアは更新またはインストールされません。パッケージバージョンはデバイスにデプロイする必要があります。
**パッケージバージョンを AWS IoT モノに関連付けるには**
1. [AWS IoT コンソール](https://console.aws.amazon.com/iot/home)のナビゲーションペインで、**[すべてのデバイス]** メニューを展開して **[モノ]** を選択します。
1. リストから更新する AWS IoT モノを特定し、モノの名前を選択して詳細ページを表示します。
1. **[詳細]** セクションで、**[パッケージとバージョン]** を選択します。
1. **[パッケージとバージョンに追加]** を選択します。
1. **[デバイスパッケージの選択]** で、必要なソフトウェアパッケージを選択します。
1. **[バージョンを選択]** で、必要なソフトウェアバージョンを選択します。
1. **[デバイスパッケージの追加]** を選択します。
パッケージとバージョンが **[選択したパッケージとバージョン]** リストに表示されます。
1. このモノに関連付けるパッケージとバージョンごとに上記の手順を繰り返します。
1. 完了したら、**[パッケージとバージョンの詳細を追加]** を選択します。**[モノの詳細]** ページが開き、新しいパッケージとバージョンがリストに表示されます。