配置の MongoDB バージョンの更新

項目一覧

検討事項

MongoDB のバージョンを更新するための API リソースの変数
前提条件
手順

Cloud Manager は、 2024年8月30日でMongoDB 3.6と4.0のオートメーション、バックアップおよびモニタリングのサポートを終了します。 MongoDB の配置をアップグレードするか、Atlas に移行してください。

Cloud Managerへのプログラムによるアクセスのための OAuth 2.0認証はプレビュー機能として利用できます。: 機能および関連するドキュメントは、プレビュー期間中にいつでも変更される可能性があります。 OAuth2.0 認証を使用するには、 Cloud Manager Public APIへのリクエストで使用するサービスアカウントを作成します。

このチュートリアルでは、 APIを使用して MongoDB 配置を MongoDB の新しいバージョンに移行する方法について説明します。これらの手順では、チュートリアルのを使用して API 経由でクラスターを配置した場合など、MongoDB の 4.0.6バージョンを使用する既存の配置があることを前提としています。

注意

グループとプロジェクトは同義語です。あなたの{PROJECT-ID}は、プロジェクト ID と同じです。既存のグループの場合、グループ/プロジェクト ID は同じままです。このページでは、説明を参照するときに、より一般的な用語のグループを使用します。エンドポイントはドキュメントに記載されているままです。

検討事項

APIは、MongoDB バージョン 2.6 以降のほとんどの MongoDB 設定とパラメータをサポートしています。詳しくは、「 MongoDB 設定とオートメーションサポート」を参照してください。

MongoDB のバージョンを更新するための API リソースの変数

API リソースは、これらの変数の 1 つ以上を使用します。これらの API リソースを呼び出す前に、これらの変数を目的の値に置き換えます。

名前	タイプ	説明
`PUBLIC-KEY`	string	API認証情報の公開 API キー。
`PRIVATE-KEY`	string	API 認証情報のプライベート API キー。
`cloud.mongodb.com`	string	Cloud Manager インスタンスのURL 。
`GROUP-ID`	string	プロジェクト設定からのプロジェクトの一意の識別子。
`CLUSTER-ID`	string	クラスターの一意の識別子です。

前提条件

配置が存在する Cloud Manager プロジェクトのProject Ownerロールを持つユーザーとして Cloud Manager にアクセスするには、認証情報が必要です。

手順

Cloud Manager から自動化構成を取得します。

構成を取得するには、 automationConfigリソースを使用します。次のコマンドを発行して、プレースホルダーを MongoDB バージョンを更新するための API リソースの変数に置き換えます。

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --request GET "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/automationConfig?pretty=true" \
     --output currentAutomationConfig.json

ダウンロードしたオートメーション構成ファイルを検証します。
versionのcurrentAutomationConfig.json フィールドと Automation Configuration バックアップファイルのmms-cluster-config-backup.json フィールドを比較します。version値は両方のJSONドキュメントの最後の要素です。このファイルは、MongoDB Agent を実行しているホスト上の次の場所にあります。
- Linux と macOS: /var/lib/mongodb-mms-automation/mms-cluster-config-backup.json
- Windows: %SystemDrive%\MMSAutomation\versions\mms-cluster-config-backup.json
version値が一致する場合は、現在のバージョンの Automation 構成ファイルを操作します。

編集する構成ドキュメントを開きます。

次の手順で構成ドキュメントを編集する際には、設定の詳細な説明については、オートメーション構成の説明を参照してください。

配列のMongoDBのバージョンを更新します。`processes`

すべてのprocesses.version フィールドを更新して4.2.1 を指定します。

"version": "4.2.1"

更新された自動化構成を送信します。

更新されたオートメーション構成を送信するには、 automationConfigリソースを使用します。

更新された構成ドキュメントへのパスを指定して次のコマンドを発行し、プレースホルダーを MongoDB バージョンを更新するための API リソースの変数に置き換えます。

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --header "Content-Type: application/json"
     --request PUT "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/automationConfig?pretty=true" \
     --data @currentAutomationConfig.json

構成の更新に成功すると、API はリクエストが成功したことを示す HTTP 200 OKステータスコードを返します。

オートメーション構成の更新が成功したことを確認します。

Cloud Manager からオートメーション構成を取得し、変更が含まれていることを確認します。構成を取得するには、次のコマンドを実行して、プレースホルダーを「MongoDB バージョンを更新するための API リソースの変数」に置き換えます。

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --request GET "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/automationConfig?pretty=true"

配置ステータスをチェックし、目的の状態に達していることを確認します。

配置ステータスを取得するには、 automationStatusリソースを使用します。次のコマンドを発行して、プレースホルダーを MongoDB バージョンを更新するための API リソースの変数に置き換えます。

curl --user "{PUBLIC-KEY}:{PRIVATE-KEY}" --digest \
     --request GET "https://cloud.mongodb.com/api/public/v1.0/groups/{PROJECT-ID}/automationStatus?pretty=true"

processes配列内のすべてのlastGoalVersionAchievedフィールドの値がgoalVersionフィールドと一致していることを確認します。配置ステータスの詳細については、「最新プランのオートメーションステータスを取得する」を参照してください。

戻る

API によるオートメーションパスワードのローテーション

API によるバックアップ復元の自動化

注意