ステップ 1。 AWS IoT Greengrass Core ソフトウェア v2.x をインストールステップ 2: Greengrass V2 コンポーネントをコアデバイスにデプロイ

Greengrass V1 コアデバイスを Greengrass V2 にアップグレードします。

アプリケーションとコンポーネントが AWS IoT Greengrass V2 コアデバイスで作動することを確認したら、本番デバイスなど、現在 v1.x を実行しているデバイスに AWS IoT Greengrass Core ソフトウェア v2.x をインストールできます。次に、Greengrass V2 コンポーネントをデプロイして、Greengrass アプリケーションをデバイスで実行します。

デバイスのフリートを V1 から V2 にアップグレードするには、アップグレードするデバイスごとに次の手順を実行します。モノグループを使用して、V2 コンポーネントをコアデバイスのフリートにデプロイできます。

ヒント

デバイスのフリートに対するアップグレードプロセスを自動化するスクリプトを作成することをお勧めします。AWS Systems Manager を使用してフリートを管理する場合、システムマネージャーを使用し、各デバイスにそのスクリプトを実行してフリートを V1 から V2 にアップグレードできます。

AWS エンタープライズサポートの担当に連絡して、アップグレードプロセスを最適に自動化する方法についてお問い合わせいただけます。

ステップ 1。 AWS IoT Greengrass Core ソフトウェア v2.x をインストール

AWS IoT Greengrass Core ソフトウェア v2.x を V1 コアデバイスにインストールする次のオプションから選択します:

より少ないステップでアップグレード

より少ない手順でアップグレードするには、v2.x ソフトウェアをインストールする前に v1.x ソフトウェアをアンインストールできます。
最小限のダウンタイムでアップグレード

最小限のダウンタイムでアップグレードするには、AWS IoT Greengrass Core ソフトウェアの両バージョンを同時にインストールできます。AWS IoT Greengrass Core ソフトウェア v2.x をインストールして V2 アプリケーションが正しく動作することを確認したら、AWS IoT Greengrass Core ソフトウェア v1.x をアンインストールします。このオプションを選択する前に、AWS IoT Greengrass Core ソフトウェアの両バージョンを同時に実行するために必要な追加 RAM を検討してください。

v2.x をインストールする前に、AWS IoT Greengrass Core v1.x をアンインストール

順次アップグレードする場合、デバイスに v2.x をインストールする前に、AWS IoT Greengrass Core ソフトウェア v1.x をアンインストールします。

AWS IoT Greengrass Core ソフトウェア v1.x をアンインストールするには

AWS IoT Greengrass Core ソフトウェア v1.x がサービスとして実行されている場合、サービスを停止、無効化、削除する必要があります。
1. 実行中の AWS IoT Greengrass Core ソフトウェア v1.x サービスを停止します。
```
sudo systemctl stop greengrass 
```
2. サービスが停止するまで待ちます。list コマンドを使用してサービスの状況を確認できます。
```
sudo systemctl list-units --type=service | grep greengrass
```
3. サービスを無効にします。
```
sudo systemctl disable greengrass
```
4. サービスを削除します。
```
sudo rm /etc/systemd/system/greengrass.service
```
AWS IoT Greengrass Core ソフトウェア v1.x がサービスとして実行されていない場合、次のコマンドを実行してデーモンを停止します。greengrass-root を Greengrass ルートフォルダの名前に置き換えます。デフォルトの場所は /greengrass です。
```
cd /greengrass-root/ggc/core/
sudo ./greengrassd stop
```
(オプション) Greengrass ルートフォルダをバックアップし、該当する場合、カスタム書き込みフォルダをデバイスの別のフォルダにバックアップします。
1. 次のコマンドを使用し、現在の Greengrass ルートフォルダを別のフォルダにコピーして、ルートフォルダを削除します。
```
sudo cp -r /greengrass-root /path/to/greengrass-backup
rm -rf /greengrass-root
```
2. 次のコマンドを使用し、書き込みフォルダを別のフォルダに移動して、書き込みフォルダを削除します。
```
sudo cp -r /write-directory /path/to/write-directory-backup
rm -rf /write-directory
```

次に、AWS IoT Greengrass V2 のインストール手順を使用して、デバイスにソフトウェアをインストールします。

ヒント

コアデバイスを V1 から V2 に移行する際にコアデバイスの ID を再利用するには、手動プロビジョニングで AWS IoT Greengrass Core ソフトウェアをインストールする指示に従ってください。最初にデバイスから V1 コアソフトウェアを削除してから、V1 コアデバイスの AWS IoT モノと証明書を再利用し、証明書の AWS IoT ポリシーを更新して、v2.x ソフトウェアが必要とする許可を付与します。

既に v1.x を実行しているデバイスに AWS IoT Greengrass Core ソフトウェア v2.x をインストール

既に AWS IoT Greengrass Core ソフトウェア v1.x が実行されているデバイスに AWS IoT Greengrass Core v2.x ソフトウェアをインストールする場合、以下の点に注意してください:

V2 コアデバイスの AWS IoT モノ名は一意である必要があります。V1 コアデバイスと同じモノ名を使用しないでください。
AWS IoT Greengrass Core ソフトウェア v2.x に使用するポートは、v1.x に使用するポートとは異なる必要があります。
- 8088 以外のポートを使用するように V1 ストリームマネージャーを設定します。詳細については、「ストリームマネージャーの設定」を参照してください。
- 8883 以外のポートを使用するように V1 MQTT ブローカを設定します。詳細については、「ローカルメッセージング用に MQTT ポートの設定」を参照してください。
AWS IoT Greengrass V2は、Greengrass システムサービスの名前を変更するオプションはありません。Greengrass をシステムサービスとして実行する場合、システムサービス名の不一致を避けるため、次のいずれかの操作を行う必要があります。
- v2.x をインストールする前に、v1.x の Greengrass サービスの名前を変更します。
- システムサービスがない AWS IoT Greengrass Core ソフトウェア v2.x をインストールし、greengrass 以外の名前で手動でソフトウェアをシステムサービスとして設定します。
v1.x の Greengrass サービスの名前を変更するには
1. AWS IoT Greengrass Core ソフトウェア v1.x サービスを停止します。
```
sudo systemctl stop greengrass
```
2. サービスが停止するのを待ちます。サービスの停止に数分かかることがあります。list-units コマンドを実行して、サービスが停止したかどうか調べられます。
```
sudo systemctl list-units --type=service | grep greengrass
```
3. サービスを無効にします。
```
sudo systemctl disable greengrass
```
4. サービスの名前を変更します。
```
sudo mv /etc/systemd/system/greengrass.service /etc/systemd/system/greengrass-v1.service
```
5. サービスをリロードして起動します。
```
sudo systemctl daemon-reload
sudo systemctl reset-failed
sudo systemctl enable greengrass-v1 
sudo systemctl start greengrass-v1
```

次に、AWS IoT Greengrass V2 のインストール手順を使用して、デバイスにソフトウェアをインストールします。

ヒント

ステップ 2: コアデバイスに AWS IoT Greengrass V2 コンポーネントをデプロイ

デバイスに AWS IoT Greengrass Core ソフトウェア v2.x をインストールしたら、次のリソースを含むデプロイを作成します。コンポーネントを同様なデバイスのフリートにデプロイするには、それらのデバイスを含むモノグループのデプロイを作成します。

V1 Lambda 関数から作成した Lambda 関数のコンポーネント。詳細については、「AWS Lambda 関数を実行する」を参照してください。
V1 サブスクリプションを使用する場合、レガシーサブスクリプションルータコンポーネント。
ストリームマネージャーを使用する場合、ストリームマネージャーコンポーネント。詳細については、「Greengrass コアデバイスでのデータストリームの管理」を参照してください。
ローカルシークレットを使う場合、シークレットマネージャーコンポーネント。
V1 コネクタを使用する場合、AWS が提供するコネクタコンポーネント。
Docker コンテナを使用する場合、Docker アプリケーションマネージャーコンポーネント。詳細については、「Docker コンテナの実行」を参照してください。
機械学習の推論を使用する場合、機械学習サポート用コンポーネント。詳細については、「機械学習の推論を実行する」を参照してください。
接続されたデバイスを使用する場合、クライアントデバイスサポート用コンポーネント。クライアントデバイスのサポートを有効にして、クライアントデバイスをコアデバイスに関連付ける必要があります。詳細については、「ローカル IoT デバイスとやり取りする」を参照してください。
デバイスシャドウを使用する場合、シャドウマネージャーコンポーネント。詳細については、「デバイスシャドウとやり取り」を参照してください。
Greengrass コアデバイスから Amazon CloudWatch Logs にログをアップロードする場合、ログマネージャーコンポーネント。詳細については、「AWS IoT Greengrass ログのモニタリング」を参照してください。
AWS IoT SiteWiseと統合する場合、指示に従って V2 コアデバイスを AWS IoT SiteWise ゲートウェイとしてセットアップします。AWS IoT SiteWise は、ユーザーに代わって AWS IoT SiteWise コンポーネントをデプロイするインストールスクリプトを提供します。
カスタム機能を実装するために開発したユーザー定義のコンポーネント。

デプロイの作成と改訂の情報については、「AWS IoT Greengrass コンポーネントをデバイスにデプロイする」を参照してください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

新しい V2 コアデバイスをセットアップする

はじめに