配置のロールバック
Overview
アプリの構成を以前に配置されたバージョンにロールバックできます。 App Services は、アプリの最新の 25 件の配置を自動的に再配置できます。 古い配置の場合、構成ファイル(例:ソース管理から)を手動で取得して配置する必要があります。
再配置により、アプリケーションの構成が以前のバージョンと一致するようにロールバックされます。
始める前に
Atlas UI でアプリをロールバックするには、次のものが必要です。
プロジェクト所有者の権限を持つ MongoDB Atlas アカウント。 無料アカウントの登録方法については、「 Atlasを使い始める 」を参照してください。
Admin API を使用してアプリをロールバックするには、次のものが必要です。
プロジェクト所有者の権限を持つ MongoDB Atlas アカウント。 無料アカウントのサインアップ方法については、「 Atlas の使用 」を参照してください。
MongoDB Atlas Admin APIの公開キーと秘密キーのペア。 App Services Admin API を操作するには、API キーにプロジェクト オーナーの権限が必要です。
アプリの内部 ObjectId 16x string と、アプリを含む Atlas プロジェクトのプロジェクト ID。 これらを見つける方法については、 「 アプリのメタデータを取得する 」を参照してください。
手順
MongoDB Atlas ユーザーの認証
MongoDB Atlas API キー ペアを使用して、管理ユーザー認証エンドポイントを呼び出します。
curl -X POST \ https://services.cloud.mongodb.com/api/admin/v3.0/auth/providers/mongodb-cloud/login \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -d '{ "username": "<Public API Key>", "apiKey": "<Private API Key>" }'
認証に成功すると、レスポンス本文にはaccess_token
値を持つ JSON オブジェクトが含まれます。
{ "access_token": "<access_token>", "refresh_token": "<refresh_token>", "user_id": "<user_id>", "device_id": "<device_id>" }
access_token
は App Services Admin API へのアクセスを許可します。 すべての管理 API リクエストのAuthorization
ヘッダーに Bearer トークンとして含める必要があります。
配置 ID の検索
再配置する配置の_id
が必要です。 これを見つけるには、 List Deploymentsエンドポイントを呼び出します。このエンドポイントは、アプリの25最新の配置のリストを返します。
リストで再デプロイする配置を見つけ、その_id
をコピーします。
curl -X GET \ https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/deployments \ -H 'Authorization: Bearer <access_token>'
[ { "_id": "638662e881ad88c37dcb7656", "app_id": "63844243ec3f52ed48923213", "draft_id": "638662d6cc4b58e348927a7a", "user_id": "59231005d323af2275135258", "deployed_at": 1669751529, "origin": "UI", "commit": "", "status": "successful", "status_error_message": "", "diff_url": "", "name": "638662e881ad88c37dcb7656", "remote_location": "US-VA" }, { "_id": "638662b2fd660afffb39df01", "app_id": "63844243ec3f52ed48923213", "draft_id": "638662928d19776b743d3b30", "user_id": "593f1105d383ad2275165258", "deployed_at": 1669751475, "origin": "UI", "commit": "", "status": "successful", "status_error_message": "", "diff_url": "", "name": "638662b2fd660afffb39df01", "remote_location": "US-VA" } ]
アプリを再配置する
配置の再配置エンドポイントを呼び出すことで、以前の配置にロールバックできます。 再配置する配置の_id
をdeploymentId
パラメータとして渡します。
curl -X GET \ https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps/{appId}/deployments/{deploymentId}/redeploy \ -H 'Authorization: Bearer <access_token>'