Vercel との統合
Atlas App Services Data API は非推奨です。 この機能は終了し、 30 、 2025に削除されます。 詳細については、App Services ドキュメントの非推奨ページを参照してください。
Atlas クラスターは、 Vercel を使用して配置したアプリケーションに接続できます。 。
このページを使用して、次のタスクを実行します。
Vercel ユーザーとチームを Atlas 内の組織に接続します。
これらのユーザーとチームの Vercel プロジェクトから Atlas クラスターへのリンクを作成します。
Atlas Data API を有効にします。
Vercel に配置したサーバーレス関数を Atlas クラスターに接続するには、 MongoDB Node.js ドライバー または Mongoose ODM ライブラリを使用することもできます。
Considerations
Vercel のアカウント（個人またはチーム）
Vercel との統合には、次のことが必要です。
新しい個人アカウントを作成 または Vercel で新しいチームを作成します。
Vercel で既存の個人アカウントまたはチーム アカウントを使用します。
注意
個人アカウント ユーザーとして Vercel 統合を追加し、その後チーム ユーザーとして別の Vercel 統合を追加できます。Vercel では、既存の統合の範囲を個人アカウントからチーム レベル アカウントに変更することはできません。
個人の Vercel アカウントの MongoDB 統合から、同じ Atlas 組織内のチーム スコープの統合に切り替えるには、Atlas で 既存の統合のための接続を切断し、チームの範囲との新しい統合を追加します。
Vercel のプロジェクト
Vercel では、1 つの Atlas クラスターを複数のプロジェクトにリンクできます。
統合を構成するには、個人またはチームの Vercel アカウントに 1 つ以上のプロジェクトが必要です。
統合に選択できる Vercel プロジェクトのリストは、ユーザーまたはチームの範囲によって異なります。
Atlas の IP アクセス リストと Vercel の IP 許可リスト
Vercel 配置では、動的 IP アドレスを使用します。
Atlas クラスターに接続するには、Atlas クラスターの IP アクセス リストですべての IP アドレス（0.0.0.0/0）を許可する必要があります。Atlas が Atlas プロジェクトの IP アクセス リストで 0.0.0.0/0 のエントリを見つけられない場合、Atlas は統合ワークフローの一部として、ユーザーに代わってそれを追加します。
統合をセットアップすると、AtlasはクラスタへのVercel接続を保護するために以下のアクションを実行します:
このクラスターをリンクするすべての Vercel プロジェクトの MongoDB Atlas クラスターの接続文字列として機能する
MONGODB_URI環境変数を作成します。アプリケーションでデータベースが指定されていない場合、
MONGODB_URI変数はデフォルトのデータベース名として/myFirstDatabaseを使用します。この名前をデータベース名に置き換えるか、ライブラリを使用して MongoDB とインターフェイスする場合は、アプリケーションのコードでデータベース名が指定されていることを確認してください。管理データベースにデータベース ユーザー
vercel-admin-userを作成し、クラスター内の他のすべての非システム データベースに組み込みの readWriteAnyDatabase MongoDB データベース ロールを付与します。
Vercel 統合を追加する
この手順により、組織、プロジェクト、およびユーザー ロールを持つ Atlas に新しいアカウントを作成してから、新しいクラスターを作成するか、既存の Atlas アカウント、組織、プロジェクト、および Atlas クラスターを使用して Vercel と統合することができます。
Vercel アプリケーションを Atlas クラスターと統合するには、まず Vercel UI から始めます。
MongoDB Atlas の統合に移動します。
Vercel の MongoDB Atlas 統合 に進み、Add integration をクリックします。
統合の範囲（ユーザーまたはチーム）を選択します。
ドロップダウン メニューから Vercel の範囲を 1 つ選択します。
Personal Account
Team
一度統合の範囲を設定すると、それを変更することはできません。選択したスコープとは異なるスコープに切り替えるには、1 つの統合の接続を切断 し、この手順を使用して別の統合を作成します。
[Continue] をクリックします。
MongoDB アカウントをまだお持ちでない場合は作成してください。
次のいずれかのオプションを選択します。
Google アカウントを使用している場合は、手順に従ってログインするか、新しい Google アカウントを作成してください。
ご自身のメールアドレスを使用している場合は、すでに入力されていてグレー表示されます。
会社で フェデレーティッド認証 を使用している場合は、会社のメール アドレスを使用します。フェデレーティッド ユーザー アクセスに必要な検証手順に進みます。
すでに Atlas アカウントをお持ちの場合は、 Log in now をクリックしてください。「Atlas アカウントにログインする」を参照してください。
氏名を入力し、パスワードを選択します。パスワードは 8 文字以上で、固有の文字、数字、または記号を含無必要があります。電子メールアドレスを含めることはできません。「新しい Atlas アカウントの登録」を参照してください。
I accept the Privacy Policy and the Terms of Service のチェックボックスをオンにします。
「利用規約」と「プライバシー ポリシー」を参照してください。
Vercel と統合する Atlas 組織を選択します。
ドロップダウンから Atlas 組織を選択するか、新しい Atlas 組織を作成します。
[Continue] をクリックします。
Atlas 組織へのアクセスを確認します。
Atlas が組織を作成します。I Acknowledge をクリックして、Atlas 組織への Vercel アクセスを許可することを確認します。
この Vercel 統合から MongoDB Atlas 組織へのアクセスを削除するには、この統合の接続を切断する必要があります。
ドロップダウンから Vercel と統合する Atlas プロジェクトを選択するか、新しいプロジェクトを作成します。
（任意）。Enable the Atlas Data APIスイッチを切り替えます。Atlas Data API を有効にすると、HTTPS を使用してこの組織内の Atlas データベースに接続できるようになります。
新しい無料階層クラスターを作成するか、既存のクラスターを 1 つ以上の Vercel プロジェクトにリンクします。
すでに Atlas アカウントをお持ちの場合は、既存の組織とプロジェクトを選択してから、既存のクラスターを選択できます。
Atlas Project Owner ロールが付与されていることを確認してください。
マップの左側に表示されたドロップダウンから、Atlas クラスターを選択してください。
右側のドロップダウンから、1 つ以上の Vercel プロジェクトを選択します。1 つの Atlas クラスターを 1 つ以上の Vercel プロジェクトにマッピングできます。ドロップダウン メニューには、この統合手順の前段階で選択した内容に応じて、1 つのプロジェクトまたはすべてのプロジェクトが表示されます。この統合では、後でさらに多くの Vercel プロジェクトを同じ Atlas クラスターにリンクできます。
Atlas アクセス リストで選択したプロジェクトに 0.0.0.0./0 エントリがない場合、Atlas はasks you to acknowledge that you are creating an Atlas cluster with full access due ton Vercel
Atlas クラスターがない場合は、新しいクラスターを作成します。作成したクラスターは後で変更できます。
Atlas
Project Ownerロールが付与されていることを確認してください。Atlas は無料階層クラスターを新規作成し、選択した Vercel プロジェクトにリンクします。この統合では、同じ Atlas クラスターに、後からその他の Vercel プロジェクトへのリンクを追加できます。
これらの声明に同意するには、 をクリックします。
IP アクセス リストには 0.0.0.0/0 が含まれており、これにより、選択した Atlas プロジェクト内の Atlas クラスターへの受信アクセスがすべての IP アドレスに対して開かれます。
Vercel 配置では、このアクセスが必要になります。これは、Atlas への接続に動的 IP アドレスを使用するためです。
Atlas UI での Vercel 統合を管理する
Vercel との統合を管理するには :
Atlas で、Organization Settings ページに移動します。
まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーション バーのOrganizationsメニュー
[Organizations] メニューの横にある [Organization Settings] アイコンをクリックします。
[ Organization Settings ]ページが表示されます。
Organization Integrations ページに移動します。
サイドバーの Integrations をクリックします。
[組織統合 ]ページが表示されます。
追加の Atlas クラスターのリンク
組織内の追加のクラスターを Vercel のプロジェクトにリンクするには :
注意
すでに構成されている統合には、この手順を使用します。初期統合を構成するには、「Vercel 統合を追加する」を参照してください。
Atlas で、Organization Settings ページに移動します。
まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーション バーのOrganizationsメニュー
[Organizations] メニューの横にある [Organization Settings] アイコンをクリックします。
[ Organization Settings ]ページが表示されます。
Organization Integrations ページに移動します。
サイドバーの Integrations をクリックします。
[組織統合 ]ページが表示されます。
別の Atlas クラスターを 1 つ以上の Vercel プロジェクトにリンクします。
[Link Clusters] をクリックします。
Add Another Cluster Link with Vercel ウィンドウが開き、Atlas 組織が表示されます。
Atlas プロジェクトを選択します。
左側のドロップダウン リストで、Vercel にリンクされていないクラスターを選択します。プロジェクトに別の Atlas クラスターがない場合は、作成できます。
右側のドロップダウン リストで、1 つ以上の Vercel プロジェクトを選択します。
（任意）。Enable the Atlas Data APIスイッチを切り替えます。Atlas Data API を有効にすると、 HTTPS を使用してこの組織内の Atlas データベースに接続できるようになります。
[Save] をクリックします。
統合の詳細が記載された確認メールが Atlas から届きます。
新しいリンクされた Atlas クラスターがリンクされたクラスターの一覧に表示されます。
組織内の別の Atlas プロジェクトのクラスターを Vercel にリンクするには、そのプロジェクトに対してこの手順を繰り返します。
Atlas クラスターへのリンクを編集または削除する
Atlas クラスターにリンクした Vercel プロジェクトを追加または削除できます。
Atlas で、Organization Settings ページに移動します。
まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーション バーのOrganizationsメニュー
[Organizations] メニューの横にある [Organization Settings] アイコンをクリックします。
[ Organization Settings ]ページが表示されます。
Organization Integrations ページに移動します。
サイドバーの Integrations をクリックします。
[組織統合 ]ページが表示されます。
Vercel プロジェクトを追加または削除するには、 リンクされた Atlas プロジェクトの横にある Edit をクリックします。
Atlas は、リンクされた既存の Vercel プロジェクトを表示します。
右側のリストで、ドロップダウンからプロジェクトを選択して、既存のリンクを編集します。ここでは、次の作業が可能です。
リスト内の Vercel プロジェクトの横にある をクリックして、このクラスターの統合に追加すること。
をクリックして、この統合からいくつかの Vercel プロジェクトを削除すること。
（任意）。Enable the Atlas Data APIスイッチを切り替えます。Atlas Data API を有効にすると、 HTTPS を使用してこの組織内の Atlas データベースに接続できるようになります。
Vercel プロジェクトへのすべてのリンクを削除するには、 リンクされた Atlas プロジェクトの横にある Unlink をクリックします。
Atlasは、プロジェクトからクラスターのリンクを解除することを確認するよう求めます。確認するには、[ Unlink] をクリックします。Atlas は、プロジェクトを Atlas クラスターにリンクしたときに作成した Vercel プロジェクトの環境変数を削除します。
すべてのプロジェクトのリンクを解除すると、Atlas は次のように動作します。以下の点に留意してください。
この統合用に作成したデータ、データベース ユーザー、または IP アクセス リストは削除されません。
Atlas UI に統合内にリンクされたクラスターがないと表示されても、クラスターまたは統合は削除されません。統合を無効にするには、Vercel の接続を切断する必要があります。
Vercel 統合の接続の切断
Vercel プロジェクトを Atlas クラスターから切断する前に、同じ Atlas クラスターに接続されているアプリケーションのダウンタイムを回避するために、クラスターのユーザーとネットワーク アクセス ルールが、この Atlas クラスターに接続されている他のプロジェクトやアプリケーションを共有していないことを確認してください。
Atlas で、Organization Settings ページに移動します。
まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーション バーのOrganizationsメニュー
[Organizations] メニューの横にある [Organization Settings] アイコンをクリックします。
[ Organization Settings ]ページが表示されます。
Organization Integrations ページに移動します。
サイドバーの Integrations をクリックします。
[組織統合 ]ページが表示されます。
この Vercel 統合の接続を切断することを確認します。
Atlas は、Atlas 組織を Vercel から接続を切断するかどうかを確認するメッセージを表示します。
統合の接続を切断すると、Vercel アプリケーションおよび Vercel にリンクした Atlas クラスターに接続しているその他のアプリケーションでダウンタイムが発生する可能性があります。
確認するには、大文字で「 Disconnect Vercel」と入力し、Disconnect Vercel をクリックします。
Atlas は、プロジェクトを Atlas クラスターにリンクしたときに作成された Vercel プロジェクトの環境変数を削除することで、統合を削除します。
Vercel も統合を削除し、Vercel UI に表示されなくなります。
Vercel 統合の接続を切断した後、ユーザー、アクセス リスト、または Atlas Data API キーを削除していない場合は、次の操作を実行できます。
注意
Vercel UI で統合を削除すると、Atlas でも統合が削除されるため、Atlas UI で統合の接続を切断する必要はありません。