翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon OpenSearch Ingestion パイプラインの更新
Amazon OpenSearch Ingestion パイプラインは AWS マネジメントコンソール、、 AWS CLI、または OpenSearch Ingestion API を使用して更新できます。パイプライン設定を更新すると、OpenSearch Ingestion がブルー/グリーンデプロイを開始します。詳細については、「[パイプライン更新用のブルー/グリーンデプロイ](#pipeline-bg)」を参照してください。
**Topics**
+ [考慮事項](#update-pipeline-considerations)
+ [必要なアクセス許可](#update-pipeline-permissions)
+ [パイプラインの更新](#update-pipeline-steps)
+ [パイプライン更新用のブルー/グリーンデプロイ](#pipeline-bg)
## 考慮事項
パイプラインを更新するときは、次の点を考慮します。
+ パイプラインの名前またはネットワーク設定を更新することはできません。
+ パイプラインが VPC ドメインシンクに書き込みを行う場合、パイプラインを作成した後に、前に戻ってシンクを別の VPC ドメインに変更することはできません。そのパイプラインを削除し、新しいシンクを使って改めて作成する必要があります。シンクを VPC ドメインからパブリックドメイン、パブリックドメインから VPC ドメイン、パブリックドメインから別のパブリックドメインに、それぞれ切り替えることはできます。
+ パイプラインシンクは、パブリック OpenSearch Service ドメインと OpenSearch Serverless コレクションの間で、随時切り替えることができます。
+ パイプラインのソース、プロセッサー、またはシンクの設定を更新すると、OpenSearch Ingestion がブルー/グリーンデプロイを開始します。詳細については、「[パイプライン更新用のブルー/グリーンデプロイ](#pipeline-bg)」を参照してください。
+ パイプラインのソース、プロセッサー、またはシンクの設定を更新すると、OpenSearch Ingestion は、パイプラインが実行している Data Prepper のメジャーバージョンでサポートされている最新のマイナーバージョンに、パイプラインを自動でアップグレードします。このプロセスにより、パイプラインは、最新のバグ修正とパフォーマンスの改善が施されて最新状態に保たれます。
+ パイプラインは、停止した場合でも更新することができます。
## 必要なアクセス許可
OpenSearch Ingestion は、パイプラインの更新に次の IAM アクセス許可を使用します。
+ `osis:UpdatePipeline` - パイプラインを更新します。
+ `osis:ValidatePipeline` — パイプライン設定が有効かどうかを確認します。
+ `iam:PassRole` — パイプラインロールを OpenSearch Ingestion に渡し、ドメインにデータを書き込めるようにします。このアクセス許可は、パイプラインの設定を更新するときのみ必要で、ログの公開や容量制限など、他の設定を変更する場合は必要ありません。
例えば、次のポリシーではパイプラインを更新するためのアクセス許可を付与しています。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Resource": "*",
"Action": [
"osis:UpdatePipeline",
"osis:ValidatePipeline"
]
},
{
"Resource": [
"arn:aws:iam::{{111122223333}}:role/{{pipeline-role}}"
],
"Effect": "Allow",
"Action": [
"iam:PassRole"
]
}
]
}
```
------
## パイプラインの更新
Amazon OpenSearch Ingestion パイプラインは AWS マネジメントコンソール、、 AWS CLI、または OpenSearch Ingestion API を使用して更新できます。
### コンソール
**パイプラインを更新するには**
1. [https://console.aws.amazon.com/aos/osis/home](https://console.aws.amazon.com/aos/osis/home#osis/ingestion-pipelines) で Amazon OpenSearch Service コンソールにサインインします。Pipelines ページが表示されます。
1. パイプラインを選択し、設定を開きます。次に、**[編集]** オプションのいずれかを選択します。
1. 変更が完了したら、**[保存]** を選択します。
### CLI
を使用してパイプラインを更新するには AWS CLI、[update-pipeline](https://docs.aws.amazon.com/cli/latest/reference/osis/update-pipeline.html) リクエストを送信します。次のリクエスト例では、新しい設定ファイルをアップロードし、最小容量と最大容量値を更新しています。
```
aws osis update-pipeline \
--pipeline-name "{{my-pipeline}}" \
--pipline-configuration-body "file://{{new-pipeline-config.yaml}}" \
--min-units {{11}} \
--max-units {{18}}
```
### OpenSearch Ingestion API
OpenSearch Ingestion API を使用して OpenSearch Ingestion パイプラインを更新するには、[UpdatePipeline](https://docs.aws.amazon.com/opensearch-service/latest/APIReference/API_osis_UpdatePipeline.html) オペレーションを呼び出します。
## パイプライン更新用のブルー/グリーンデプロイ
パイプライン設定を更新すると、OpenSearch Ingestion が*ブルー/グリーン*デプロイプロセスを開始します。
ブルー/グリーンとは、パイプライン更新用の新しい環境を作成し、これらの更新が完了した後に新しい環境にトラフィックをルーティングする方法のことを指します。この方法では、新しい環境へのデプロイに失敗しても、ダウンタイムを最小限に抑えることができ、元の環境を維持することができます。ブルー/グリーンデプロイ自体はパフォーマンスに影響しませんが、パイプラインの設定が、パフォーマンスを変えるような形で変更されると、パフォーマンスが変わる可能性があります。
OpenSearch Ingestion は、ブルー/グリーンデプロイの間は自動スケーリングをブロックします。新しいパイプラインにリダイレクトされるまで、古いパイプラインへのトラフィックに対してのみ、引き続き料金が請求されます。トラフィックがリダイレクトされると、新しいパイプラインに対してのみ料金が請求されます。2 つのパイプラインの料金が同時に請求されることはありません。
パイプラインのソース、プロセッサー、またはシンクの設定を更新すると、OpenSearch Ingestion により、パイプラインが実行している Data Prepper のメジャーバージョンでサポートされている最新のマイナーバージョンに、パイプラインを自動でアップグレードできます。例えば、パイプラインの設定に `version: "2"` があり、OpenSearch Ingestion がまず、バージョン 2.1.0 のパイプラインをプロビジョニングしたとします。バージョン 2.1.1 のサポートが追加され、パイプライン設定に変更を加えると、OpenSearch Ingestion はパイプラインをバージョン 2.1.1 にアップグレードします。
このプロセスにより、パイプラインは、最新のバグ修正とパフォーマンスの改善が施されて最新状態に保たれます。OpenSearch Ingestion は、パイプライン設定内の `version` オプションを手動で変更しない限り、パイプラインのメジャーバージョンを更新することはできません。