Void Platform: Void への到達方法、サインイン、最初のアプリのデプロイ

「Void に到達する」とは実際に何を意味するのか

Void Platform は、チーム全体が単一の Cloudflare アカウントにアプリをデプロイできるようにする共有レイヤーであり、Void に到達する方法を知っているかどうかが、最初のデプロイが5分で終わるか、午後を丸ごと無駄にするかの差になります。これまでにプラットフォームの URL と CLI を渡されて「つなぐだけ」と言われたことがあるなら、足りないのはコンテキストだということがすでにお分かりでしょう。このガイドでは Void Platform を扱います。インストールする管理者として、またサインインして CLI をリンクし、アプリを出荷する開発者として、Void に到達する方法を説明します。

「Void に到達する」という表現は曖昧に使われるため、3つの異なるレイヤーに分けると役立ちます。失敗のほとんどは、あるレイヤーを解決して、残り2つも処理済みだと思い込んだことが原因です。

どれか1つでも欠けていると、プラットフォームは存在していても実質的に到達不可能なままです。順番に解決してください。

始める前に: 前提条件とアクセス要件

Void プラットフォームは、単にログインするだけのホスト型サービスではありません。管理者がインストールして維持するものです。つまり、前提条件は、プラットフォームアカウントに必要なインフラストラクチャと、クライアント側に必要な認証情報にきれいに分かれます。

始める前の実用的なヒント:

• ターミナルを触る前に、公式の Void インストールドキュメント にある前提条件と認証情報のガイドを読んでください。短く、ほとんどの手戻りを防げます。
• 単独のターゲットを構築するのか、チームプラットフォームを構築するのかを最初に決めてください。チームプラットフォームには Workers for Platforms と文書化されたインフラストラクチャが必要で、かなり大規模な構築になります。
• メールがワークフローにとって重要なら、DNS ゾーンを用意してください。後からメールドメインを追加するには、インストールを見直すことになります。
• プラットフォーム URL は常に確認できる場所に保管してください。共有デプロイプラットフォームを運用する管理者からのコミュニティ報告では、「CLI が間違った URL を指していた」ことが初日の最も一般的な問題として一貫して挙げられています。

Void Platform: Void への到達方法、ステップバイステップ

以下の順序は意図された順番です。最初にインストールし、次に共有サービスを設定し、その後に開発者を迎え入れます。CLI のステップに先走ることが、プラットフォームが壊れていると結論づける最も一般的な理由です。

ステップ 1 — コアプラットフォームをインストールする

管理者がプラットフォームをインストールして維持します。開発者はサーバー側に何もインストールしません。コアインストールにはマネージド Sandboxes とメールゲートウェイが含まれますが、多くの人が期待するいくつかの機能 — ユーザーダッシュボード、マネージド GitHub ビルドと webhook、ビルド Containers、カスタムプロジェクトドメイン — は意図的に含まれていません。コアは軽量だと想定してください。

ステップ 2 — 共有メールドメインとゾーンを設定する

メールゲートウェイはコアインストールに含まれますが、共有メールドメインとゾーンを設定するまで機能しません。これを省略しても、大きなエラーは出ません。単にメールの動作が得られないだけです。オプションの追加機能ではなく、インストールの一部として扱ってください。

ステップ 3 — ログイン方法を有効にする

サインインは「有効なログイン方法を通じて」行われます。つまり、プラットフォームは管理者が有効にしたものだけを提供します。開発者を招待する前に、少なくとも1つの方法がエンドツーエンドで機能することを確認してください。できれば、プライベートブラウザウィンドウで自分自身でサインインして確認します。

ステップ 4 — Void CLI をプラットフォーム URL に接続する

各開発者は Void CLI をプラットフォーム URL に向けます。これが日常的な意味での「Void に到達する」瞬間です。CLI がプラットフォームを見つけられるか、見つけられないかのどちらかです。API が Access 保護の背後にある場合、オプションの GitHub サービスを追加するソースビルドのプラットフォームは、保護された API に穴を開けるのではなく、分離された webhook ingress のセットアップに従う必要があることに注意してください。

ステップ 5 — サインインしてデプロイする

有効な方法でサインインしてからデプロイします。直接 Cloudflare と共有プラットフォームという両方のデプロイ先は同じアプリケーション API を使用するため、直接デプロイで学んだことはそのまま当てはまります。

直接 Cloudflare か、共有プラットフォームか？ 適切な経路を選ぶ

誰もがプラットフォームを必要とするわけではありません。純粋に自分のためにアプリをデプロイする場合、指針は明確です。Cloudflare に直接デプロイし、プラットフォームのインストールは完全に省略してください。プラットフォームは、チーム全体で共有アクセスと保持された履歴を求める場合に価値を発揮します。

パターンは明確です。直接デプロイは即時性をもたらし、プラットフォームは保持と共有アクセスをもたらします。「誰が何を、いつデプロイしたか」に6週間後も答えが必要かどうかで選んでください。

すぐには手に入らないオプション機能

新しい管理者が繰り返し驚くのは、インストールしたプラットフォームが想像していたプラットフォームではないことです。ここでは正直に分けて説明します。

ソースビルドを通じて GitHub サービスを追加し、API が Access で保護されている場合は、分離された webhook ingress のガイダンスに従ってください。これは、API 保護を弱めることなく webhook を受け取れるようにするためにまさに存在します。

トラブルシューティング: Void に到達できないとき

「到達できない」という報告のほとんどは、いくつかの原因に集約されます。設定を変更し始める前に、症状を照合してください。

2つの習慣でこれらのほとんどを防げます。CLI を触る前に URL を確認すること、そしてチームをオンボーディングする前にログイン方法が機能することを確認することです。それ以外は、プラットフォームが壊れているというより、設定の詳細であることがほとんどです。

FAQ

自分のアプリをデプロイするために Void プラットフォームをインストールする必要はありますか？ いいえ。自分のためにアプリをデプロイする場合は、Cloudflare に直接デプロイしてください。プラットフォームはチーム共有のための構成要素であり、前提条件ではありません。

プラットフォームのインストール後、開発者はどうやって Void に到達しますか？ Void CLI をプラットフォーム URL に接続し、有効なログイン方法でサインインします。管理者の役割は、開発者が試す前に両方が存在することを確認することです。

私は管理者ではなく開発者です。Void Platform で、自分の側で Void に到達するには実際に何が必要ですか？ 3つです。プラットフォーム URL、有効なログイン方法に紐づいたアカウント、ローカルにインストールされた CLI です。どれかが欠けている場合は、CLI をデバッグするのではなく管理者に尋ねてください。

なぜ私のプラットフォームはドキュメントが示すより機能が少なく見えるのですか？ 標準インストールは意図的に軽量だからです。ユーザーダッシュボード、マネージド GitHub ビルドと webhook、ビルド Containers、カスタムプロジェクトドメインはオプションの追加機能であり、デフォルトではありません。何かが壊れていると決めつける前に、インストールに実際に何が含まれているかを確認してください。