Vercel は、アプリケーションの配置を簡素化する開発プラットフォームです。Vercel には、開発者がソフトウェア パッケージを検索し、アプリケーションをプロビジョニングするためのマーケットプレイスがあります。
このページの手順を使用して、次の操作を行います。
Vercel とMongoDB Atlasから開始し、 MongoDB Atlasで次のプロジェクトを構築します。
すべてのユースケースに対応したオプションを持つ、 無料、専用、およびフレキシブルなMongoDBクラスターから選択します。
ネイティブ統合と接続可能なアカウント
Vercel との統合には次の方法があります。
ネイティブ統合
このモードでは、Vercel Marketplace でMongoDB Atlasを見つけ、Vercel を通じて実行される請求を持つ新しいMongoDB Atlasアカウントを作成します。Vercel でMongoDB Atlasをネイティブ統合すると、次のことが可能になります。
Vercel ダッシュボードから Atlas リソースを直接プロビジョニングし、請求は Vercel アカウントを通じて管理されます。また、プロビジョニングされたリンクされたアカウントを使用して、Atlas のリソースに直接アクセスすることもできます。
新規および既存の Vercel アプリケーション用にMongoDB Atlasクラスターを配置します。
MongoDB Atlasクラスターを作成すると、Vercel は Atlas クラスターの認証情報とその他の設定を Vercel 環境に追加します。ネイティブ統合の詳細については、Vercel ネイティブ統合を参照してください。
接続可能なアカウントの統合
このモードでは、既存の Vercel プロジェクトに接続するために Atlas でアカウントを設定する方法についてガイドします。
接続可能なアカウント統合モードを使用すると、既存の Atlas アカウントを Vercel アカウントにリンクできますが、Atlas アカウント、請求、リソースの作成は Vercel UIの外部で管理する必要があります。対照的に、ネイティブ統合モードでは、 Vercel UIから Atlas リソースを直接作成および管理し、請求は Vercel アカウントを通じて管理されます。
重要
接続可能なアカウント統合は引き続きサポートされますが、既存の Atlas リソースを Vercel に接続する目的でのみ使用することをお勧めします。Vercel とMongoDB Atlasを併用して新しい Atlas リソースを作成し、最高の開発者エクスペリエンスを実現するには、Vercel ネイティブ統合 を使用します。
Vercel で Atlas を見つける
任意のロールを持つ Vercel ユーザーであれば、次の方法で Atlas を検出できます。
Vercel UIにログインします。
OverviewAdd new[0]タブで、右上隅の [] ボタンを見つけ、ドロップダウンからIntegration [] ボタンから [] を選択します。
Considerations
Vercel のアカウント（個人またはチーム）
Vercel との統合には、次のことが必要です。
新しい個人アカウントを作成 または Vercel で新しいチームを作成します。
Vercel で既存の個人アカウントまたはチーム アカウントを使用します。
Vercel のプロジェクト
Vercel では、1 つの Atlas クラスターを複数のプロジェクトにリンクできます。
Vercel で Atlas のネイティブ統合を作成すると、Atlas は Atlas に新しい Vercel 管理の組織とプロジェクトを作成します。
Atlas と Vercel の 接続可能なアカウント統合 を使用する場合、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 は統合ワークフローの一部として、ユーザーに代わってそれを追加します。
注意
プロジェクトアクセス リストに 0.0.0.0/0 CIDR を追加すると、Atlas はプロジェクトにロールが直接付与されている ユーザー、またはチームメンバーシップを通じて間接的にメールが付与されている （チームがプロジェクトにロールを付与されている場合）にアラート メールを送信します。 。
Atlas と Vercel のネイティブ統合を使用する場合、Atlas は管理データベースデータベースに次の形式:
Vercel-Admin-[name of resource]のデータベースユーザーを作成し、Atlas クラスター内の他のすべての非システムデータベースに組み込みの readWriteAnyDatabase MongoDBデータベースロールを付与します。例、Vercelリソースの名前がmy-first-atlas-clusterの場合、Atlas が作成するデータベースユーザーはVercel-Admin-my-first-atlas-clusterになります。Atlas と Vercel の接続可能なアカウント統合を設定すると、Atlas は次のようにクラスターへの Vercel 接続を保護します。Atlas は、このクラスターを にリンクするすべての Vercel プロジェクトに対して、Atlas クラスターの接続文字列として機能する
MONGODB_URI環境変数を作成します。 。アプリケーションでデータベースが指定されていない場合、
MONGODB_URI変数はデフォルトのデータベース名として/myFirstDatabaseを使用します。この名前をデータベース名に置き換えるか、ライブラリを使用して MongoDB とインターフェイスする場合は、アプリケーションのコードでデータベース名が指定されていることを確認してください。Atlas は、管理データベースにデータベースユーザー
vercel-admin-userを作成し、Atlas クラスター内の他のすべての非システムデータベースに組み込みの readWriteAnyDatabase MongoDBデータベースロールを付与します。
Vercel ネイティブ統合
Vercel Marketplace で Atlas のネイティブ統合を作成し、Vercel ダッシュボードから Atlas リソースを直接プロビジョニングできます。請求は Vercel アカウントを通じて管理されます。また、プロビジョニングされたリンクされたアカウントを使用して、Atlas のリソースに直接アクセスすることもできます。
アカウントをお持ちでない場合は、Atlas がそのアカウントをプロビジョニングします。Atlas アカウントは Vercel インストールにリンクされています。Atlas にログインするための個別の認証情報があります。
考慮事項: ネイティブ統合
Vercel での Atlas のネイティブ統合には次の考慮事項が適用されます。さらに、両方の統合モードに適用される考慮事項を参照してください。
リソース マッピング
Vercel の「チームインストール」は、Atlas の組織にマップされます。Vercel にインストールされた製品（リソース）は、Atlas のプロジェクトとクラスターにマップされます。
API アクセス
Vercel では、ユーザーに代わってリソースを作成および管理し、環境の変化を伝達するために、Atlas API へのプログラムによるアクセスが必要です。
ユーザープロビジョニングとアカウントのリンク
Atlas は、Vercel ユーザーに新しい Atlas ユーザー アカウントをプロビジョニングし、既存のアカウントをリンクして、Atlas 認証情報を構成しない場合はパスワード リセットメールを送信します。 ユーザー認証には、Atlas にアクセスするために Atlas の認証情報が必要です。
Vercelチームの Atlas ネイティブ統合を最初にインストールしたユーザーは、Atlas
Organization Ownerになります。|service| へのアクセスVercel からの
Open in Atlas ボタンを使用して Vercel から Atlas UIに移動できます。Atlas 認証情報を使用してログインすると、Atlas は対応する Atlasリソースにリダイレクトします。
既存の Atlas アカウントを持つユーザー。Vercel から Atlas にアクセスする際、Vercel は既存の Atlas アカウントを持つユーザーに、Atlas アカウントを Vercel インストールにリンクすることを確認するように要求します。ユーザーがリンクを確認し、Atlas 認証情報でログして ID を証明すると、Atlas はユーザーの Atlas アカウントを Vercel インストールにリンクします。
新規ユーザー。Atlas は、新規ユーザーにアカウントをプロビジョニングし、パスワード リセットメールを送信して、ユーザーがパスワードを設定して ID を証明できるようにします。Atlas がユーザーの認証情報を取得すると、Atlas はユーザーの Atlas アカウントを Vercel
Organization Ownerインストールにリンクし、Atlas でこのユーザーに ロールを付与します。Atlas は組織の権限を Vercel の権限と並行して保持します。Vercel の「管理者」ロールと「ユーザー」ロールは、それぞれ Atlas のOrganization OwnerロールとOrganization Read Onlyロールにマップされます。
Vercelチームのいずれかのユーザーが、ネイティブ統合を使用して追加の Atlas クラスターをインストールした場合、Atlas は Vercelチーム用に作成された Atlas組織にこれらのユーザーを自動的に追加しません。Atlas組織の所有者は、Atlas組織へのアクセスを必要とするすべての Vercelチームユーザーがこの組織を持つようにする必要があります。これは、ネイティブ統合の初期インストール後に Vercelチームに参加する新しい Vercelチームユーザーにも適用されます。
次のいずれかの方法を使用して、Atlas が Atlas 組織に Vercel チームのユーザーを追加するようにします。
Vercelチームユーザーは、 Vercel UIを通じて Atlas UIの Atlas組織にアクセスできます。まだ Atlas ユーザーでない場合、Atlas はそのユーザーのアカウントをプロビジョニングし、ネイティブ統合用に Atlas組織に割り当てます。
Atlas 組織の所有者は、Atlas ユーザーを Atlas 組織に招待できます。
環境変数
ネイティブ統合により、安全なデータベース接続のために
MONGODB_URI環境変数が自動的に構成されます。環境変数の完全なリストについては、 Atlas のネイティブ統合の Vercel UI を参照してください。請求
Vercel ネイティブ統合により、Vercel UIから新しい Atlas 組織が作成されます。これは、Atlas 組織のアクティブな支払い方法として Vercel Marketplace 請求プランに自動的に接続されます。請求は 1 つの Atlas組織ごとに行われ、組織内のすべてのMongoDB Atlasクラスターとサービスに対する合計請求額が含まれます。Vercel および Atlas では、Atlas 組織の Vercel Marketplace の請求と日次使用コストの確認を確認できます。
セキュリティ
Atlas は、Vercel のネイティブ統合を通じて作成した Atlas クラスターのIP許可リストを使用した SCRAM認証経由で安全な接続を確保します。
ネイティブ統合の削除またはアンインストール
Vercel 統合をアンインストールした後、Atlas 組織の所有者は、アクセス割り当てと請求方法が最新であることを確認し、古いアクセス権または不要なアクセス権を削除して、超過請求の支払いに関するMongoDBからの自動通知を防ぐことをお勧めします。Atlas は Atlas の最終的な Vercel 請求書を Vercel に送信し、Atlas 組織から Vercel Marketplace 支払い方法を削除します。
この請求書は確定的な Atlas 請求書ではありません。ただし、まだ請求されていない最新の使用量に対して、インストールを解除した後も組織によって追加料金が発生する可能性があります。組織に新しい支払い方法を追加して、未処理の使用量を確実に支払いできるようにする必要があります。
Atlas ではいつでもリソースを削除できますが、 Atlas UIからネイティブ統合をアンインストールしたり、リンクを解除したりすることはできません。Vercelに連結クラスターを削除すると、これは Vercel UIに反映されます。
Next.js の Vercel UIを使い始める
ネイティブ統合用の Vercel UI には、Next.js と Atlas を使い始めるための手順が含まれています。
配置テンプレート
ネイティブ統合の Vercel UIには配置テンプレートが含まれています。これらのテンプレートには、Vercel で Atlas プロジェクトを開始するために役立つ例コードと構成ファイルが含まれています。
ネイティブ統合を追加する
MongoDB Atlas のネイティブ統合を Vercel に追加するには、次の手順に従います。
クラスター リージョンを選択します。
Vercel リージョン のリストが表示されます。これらのリージョンは、ほとんどの場合、 MongoDB Atlasリージョンにマップされます。対応する Atlas リージョンがない Vercel リージョンを選択した場合、Atlas は、選択した Vercel リージョンに最も近いリージョンを選択します。
インストール プランの選択 [ 無料] または [有料] を選択します。
無料プラン $0
クレジットカードは必要ありません。このプランでは、 無料のMongoDB Atlasクラスターのみを作成できます。
有料プラン
クレジット カードが必要です。このプランでは、無料、フレキシブル、専用クラスターを作成できます。フレキシブルなクラスターと専用クラスターに対してのみ料金が発生します。
Flex または Atlas クラスターを選択した場合、無料プランはグレー表示されます。Vercelチームのいずれかのメンバーが、無料プランでこのネイティブ統合を使用し、Flex または専用クラスターの作成を選択した場合、プランは有料プランに変更されます。無料ではないMongoDB Atlasクラスターをアンインストールしても、プランは有料プランとして残ります。プランを無料プランに変更するには、ネイティブ統合をアンインストールし、無料クラスターと 無料プランを選択して再度インストールします。ネイティブ統合をアンインストールする方法については、Vercel のドキュメントを参照してください。
Vercel で Atlas のネイティブ統合を使用して、次のことが可能になります。
Vercelプロジェクトに接続します。
最新の環境変数を取得します。
このMongoDB Atlasクラスターが不要になった場合は、ネイティブ統合をアンインストールし、 MongoDB Atlasデータベースを削除 できます。手順については、 Vercel のドキュメント を参照してください。
統合全体をアンインストールせずに、データベース（リソース）を削除することもできます。これは、将来的に他のリソースを作成するために統合を維持したい場合や、同じ統合内に他のリソースがある場合に役立ちます。
Vercel にリンクされた Atlas クラスターを削除すると、Vercel でこのクラスターにリンクしたプロジェクトはすべて、このデータベースクラスターにアクセスできなくなります。Atlas クラスターのアンインストールと削除を続行する前に、この Atlas クラスターがどのプロジェクトまたはアプリケーションでも使用されていないことを確認してください。
サポートお問い合わせ
MongoDB Atlasと Vercel ネイティブ統合 を使用中に問題が発生した場合は、 MongoDB Vercel-integer-support@mongodb.com の Vercel 統合サポート にお問い合わせください。
接続可能なアカウント統合を追加する
注意
このセクションのすべての手順は非推奨です。既存の接続可能なアカウント統合は引き続き機能します。新しい統合には、代わりに Vercel とのネイティブ統合 を使用してください。
この手順により、既存の Atlas アカウント、組織、プロジェクト、および Atlas クラスターを使用して Vercel と統合できます。
Vercel に配置したサーバーレス関数を Atlas クラスターに接続するには、MongoDB Node.jsドライバーまたはMongoose ODM ライブラリを使用することもできます。
Vercel アプリケーションを Atlas クラスターと統合するには、まず Vercel UI から始めます。
注意
個人アカウント ユーザーとして Vercel 統合を追加し、その後チーム ユーザーとして別の Vercel 統合を追加できます。Vercel では、既存の統合の範囲を個人アカウントからチーム レベル アカウントに変更することはできません。
個人の Vercel アカウントのMongoDB接続可能アカウント統合から、同じ Atlas組織内のチームスコープの統合に切り替えるには、Atlas で 既存の統合のための接続を切断し、チームの範囲との新しい統合を追加します。
MongoDB Atlas の統合に移動します。
MongoDB Atlas Integration in Vercel にGo、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 プロジェクトを選択するか、新しいプロジェクトを作成します。
新しい無料階層クラスターを作成するか、既存のクラスターを 1 つ以上の Vercel プロジェクトにリンクします。
すでに Atlas アカウントをお持ちの場合は、既存の組織とプロジェクトを選択してから、既存のクラスターを選択できます。
Atlas Project Owner ロールが付与されていることを確認してください。
マップの左側に表示されたドロップダウンから、Atlas クラスターを選択してください。
右側のドロップダウンから、1 つ以上の Vercel プロジェクトを選択します。1 つの Atlas クラスターを 1 つ以上の Vercel プロジェクトにマッピングできます。ドロップダウン メニューには、この統合手順の前段階で選択した内容に応じて、1 つのプロジェクトまたはすべてのプロジェクトが表示されます。この統合では、後でさらに多くの Vercel プロジェクトを同じ Atlas クラスターにリンクできます。
選択したプロジェクトに 0.0.0.0./0 がない場合、エントリがない場合、Atlas はasks you to acknowledge that you are creating an Atlas cluster with full access due ton Vercel にある 動的IPアドレス i により、フルアクセス権のある Atlas クラスターを作成していることを確認するよう求めています。Atlas からこの情報が記載されたメールが送信されます。
Atlas クラスターがない場合は、新しいクラスターを作成します。作成したクラスターは後で変更できます。
Atlas
Project Ownerロールが付与されていることを確認してください。Atlas は無料階層クラスターを新規作成し、選択した Vercel プロジェクトにリンクします。この統合では、同じ Atlas クラスターに、後からその他の Vercel プロジェクトへのリンクを追加できます。
これらの声明に同意するには、 をクリックします。
IP アクセス リストには 0.0.0.0/0 が含まれており、これにより、選択した Atlas プロジェクト内の Atlas クラスターへの受信アクセスがすべての IP アドレスに対して開かれます。
プロジェクトアクセス リストに
0.0.0.0/0CIDR を追加すると、Atlas はプロジェクトにロールが直接付与されている ユーザー、またはチームメンバーシップを通じて間接的にメールが付与されている （チームがプロジェクトにロールを付与されている場合）にアラート メールを送信します。 。Vercel 配置では、このアクセスが必要になります。これは、Atlas への接続に 動的IPアドレス を使用するためです。
接続可能なアカウント統合の管理
注意
このセクションのすべての手順は非推奨です。既存の接続可能なアカウント統合は引き続き機能します。新しい統合には、代わりに Vercel とのネイティブ統合 を使用してください。
Vercel との Connectable Accounts 統合を管理するには、次の手順に従います。
Atlas で、Organization Settings ページに移動します。
まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーション バーのOrganizationsメニュー
サイドバーで、Organization Settings をクリックします。
[ Organization Settings ]ページが表示されます。
Atlas で、Organization Integrations ページに移動します。
[Integrations] タブをクリックします。
[組織統合 ]ページが表示されます。
別の Atlas クラスターを接続可能なアカウント統合にリンク
注意
このセクションのすべての手順は非推奨です。既存の接続可能なアカウント統合は引き続き機能します。新しい統合には、代わりに Vercel とのネイティブ統合 を使用してください。
組織内の追加のクラスターを Vercel のプロジェクトにリンクするには、次の手順に従います。
注意
すでに構成されている接続可能なアカウントの統合には、この手順を使用します。
Atlas で、Organization Settings ページに移動します。
まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーション バーのOrganizationsメニュー
サイドバーで、Organization Settings をクリックします。
[ Organization Settings ]ページが表示されます。
Atlas で、Organization Integrations ページに移動します。
[Integrations] タブをクリックします。
[組織統合 ]ページが表示されます。
別の Atlas クラスターを 1 つ以上の Vercel プロジェクトにリンクします。
[Link Clusters] をクリックします。
Add Another Cluster Link with Vercel ウィンドウが開き、Atlas 組織が表示されます。
Atlas プロジェクトを選択します。
左側のドロップダウン リストで、Vercel にリンクされていないクラスターを選択します。プロジェクトに別の Atlas クラスターがない場合は、作成できます。
右側のドロップダウン リストで、1 つ以上の Vercel プロジェクトを選択します。
[Save] をクリックします。
統合の詳細が記載された確認メールが Atlas から届きます。
新しいリンクされた Atlas クラスターがリンクされたクラスターの一覧に表示されます。
組織内の別の Atlas プロジェクトのクラスターを Vercel にリンクするには、そのプロジェクトに対してこの手順を繰り返します。
Atlas クラスターへのリンクを編集または削除する
注意
このセクションのすべての手順は非推奨です。既存の接続可能なアカウント統合は引き続き機能します。新しい統合には、代わりに Vercel とのネイティブ統合 を使用してください。
Atlas クラスターにリンクした Vercel プロジェクトを追加または削除できます。
Atlas で、Organization Settings ページに移動します。
まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーション バーのOrganizationsメニュー
サイドバーで、Organization Settings をクリックします。
[ Organization Settings ]ページが表示されます。
Atlas で、Organization Integrations ページに移動します。
[Integrations] タブをクリックします。
[組織統合 ]ページが表示されます。
Vercel プロジェクトへのすべてのリンクを削除するには、 リンクされた Atlas プロジェクトの横にある Unlink をクリックします。
Atlasは、プロジェクトからクラスターのリンクを解除することを確認するよう求めます。確認するには、[ Unlink] をクリックします。Atlas は、プロジェクトを Atlas クラスターにリンクしたときに作成した Vercel プロジェクトの環境変数を削除します。
すべてのプロジェクトのリンクを解除すると、Atlas は次のように動作します。以下の点に留意してください。
この統合用に作成したデータ、データベース ユーザー、または IP アクセス リストは削除されません。
Atlas UI に統合内にリンクされたクラスターがないと表示されても、クラスターまたは統合は削除されません。統合を無効にするには、Vercel の接続を切断する必要があります。
Vercel 統合の接続の切断
注意
このセクションのすべての手順は非推奨です。既存の接続可能なアカウント統合は引き続き機能します。新しい統合には、代わりに Vercel とのネイティブ統合 を使用してください。
Vercel プロジェクトを Atlas クラスターから切断する前に、同じ Atlas クラスターに接続されているアプリケーションのダウンタイムを回避するために、クラスターのユーザーとネットワーク アクセス ルールが、この Atlas クラスターに接続されている他のプロジェクトやアプリケーションを共有していないことを確認してください。
Atlas で、Organization Settings ページに移動します。
まだ表示されていない場合は、以下から目的の組織を選択しますナビゲーション バーのOrganizationsメニュー
サイドバーで、Organization Settings をクリックします。
[ Organization Settings ]ページが表示されます。
Atlas で、Organization Integrations ページに移動します。
[Integrations] タブをクリックします。
[組織統合 ]ページが表示されます。
この Vercel 統合の接続を切断することを確認します。
Atlas は、Atlas 組織を Vercel から接続を切断するかどうかを確認するメッセージを表示します。
統合の接続を切断すると、Vercel アプリケーションおよび Vercel にリンクした Atlas クラスターに接続しているその他のアプリケーションでダウンタイムが発生する可能性があります。
確認するには、大文字で「 Disconnect Vercel」と入力し、Disconnect Vercel をクリックします。
Atlas は、プロジェクトを Atlas クラスターにリンクしたときに作成された Vercel プロジェクトの環境変数を削除することで、統合を削除します。
Vercel も統合を削除し、Vercel UI に表示されなくなります。
Vercel の統合を切断した後、ユーザーやアクセスリストを削除していない場合は、次の操作を実行できます。
注意
Vercel UI で統合を削除すると、Atlas でも統合が削除されるため、Atlas UI で統合の接続を切断する必要はありません。