Vercel との統合

Vercel で Atlas を見つける

任意のロールを持つ Vercel ユーザーであれば、次の方法で Atlas を検出できます。

Vercel のアカウント（個人またはチーム）

Vercel との統合には、次のことが必要です。

• 新しい個人アカウントを作成 または Vercel で新しいチームを作成します。

• Vercel で既存の個人アカウントまたはチーム アカウントを使用します。

Vercel のプロジェクト

Vercel では、1 つの Atlas クラスターを複数のプロジェクトにリンクできます。

Vercel で Atlas のネイティブ統合を作成すると、Atlas は Atlas に新しい 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-Admin-[name of resource] のデータベースユーザーを作成し、Atlas クラスター内のすべての非システムデータベースに組み込みの readWriteAnyDatabase MongoDBデータベースロールを付与します。例、Vercelリソースの名前がmy-first-atlas-cluster の場合、Atlas が作成するデータベースユーザーは になります。Vercel-Admin-my-first-atlas-cluster

考慮事項: ネイティブ統合

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 アカウントを VercelOrganization 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 ネイティブ統合 を使用中に問題が発生した場合は、 MongoDB Vercel-integer-support@mongodb.com の Vercel 統合サポート にお問い合わせください。

Vercel 統合の接続の切断

Vercel プロジェクトを Atlas クラスターから切断する前に、同じ Atlas クラスターに接続されているアプリケーションのダウンタイムを回避するために、クラスターのユーザーとネットワーク アクセス ルールが、この Atlas クラスターに接続されている他のプロジェクトやアプリケーションを共有していないことを確認してください。