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 へのプログラムによるアクセスが必要です。

• ユーザープロビジョニング、アカウントのリンク、およびシングル サインオン

  Vercel UI で Open in MongoDB Atlas を使用して、Vercel マネージド リソースに関連付けられた Atlas 組織、プロジェクト、クラスターにアクセスします。Atlas アカウントをまだお持ちでない場合は、Vercel から Atlas を開くと、Atlas は新しい Atlas アカウントをプロビジョニングします。Vercel マネージド Atlas リソースにアクセスするために、別の Atlas 認証情報を作成する必要はありません。

  ユーザー名とパスワードを使用する Atlas アカウントを既にお持ちの場合、Atlas は初回に Atlas アカウントを Vercel にリンクするように求めます。アカウントをリンクした後は、既存の Atlas 認証情報を使用して Atlas に直接ログインを続行するか、Open in MongoDB Atlas を使用して Vercel から Atlas に戻ることができます。ほとんどの場合、ユーザーは Vercel 認証情報 (SSO) を使用して Atlas にログインできます。ただし、Google または Github でログインする既存の Atlas ユーザー、および組織がエンタープライズ SSO を構成しているユーザーは、Atlas アカウントログインページを通じて既存の Atlas ログイン方法で Atlas にアクセスし続ける必要があります。

  Vercelチームの Atlas ネイティブ統合を最初にインストールしたユーザーは、Atlas Organization Owner になります。

• Vercel から Atlas へのアクセス

  VercelからOpen in MongoDB Atlasボタンを使用してAtlas UIに移動できます。

  • 既存の Atlas アカウントを持つユーザー。Vercel から Atlas にアクセスすると、Vercel は既存の Atlas アカウントを持つユーザーに、Atlas アカウントを Vercel インストールにリンクするように促します。確認後、ユーザーは Vercel 認証情報 (SSO) を使用して Atlas にサインインするか、Atlas 認証情報を使用して続行することができます。

    Google、GitHub、またはエンタープライズ SSO を使用して Atlas にサインインする既存の Atlas ユーザーは、Vercel の認証情報を使用してサインインすることはできません。

  • 新規ユーザー。新規ユーザーが Open in Atlas をクリックすると、Atlas はアカウントをプロビジョニングし、Vercel 認証情報を使用してログインさせます。Atlas はユーザーの Atlas アカウントを Vercel インストールにリンクし、Atlas でこのユーザーに Organization Owner ロールを付与します。Atlas は組織の許可を Vercel の許可と一致させます。Vercel の "Admin" ロールと "User" ロールは、それぞれ 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 クラスターに接続されている他のプロジェクトやアプリケーションを共有していないことを確認してください。