Void Platformダウンロードガイド:セルフホスト型チームプラットフォームのインストール

Void Platformのダウンロードに必要なすべて:前提条件、コアサービスとオプションサービス、そして初回デプロイまでのステップバイステップのインストール手順。

「Void Platformダウンロード」の本当の意味

Void Platformのダウンロードを検索するほとんどの人は、単一のインストーラーファイルと「次へ次へ完了」のウィザードを期待しています。現実は異なります。Voidはチームが共有のCloudflareアカウントにデプロイするセルフホスト型プラットフォームであり、「ダウンロード」ステップは実際にはプラットフォームのツール一式を整えてセットアップフローを実行することです。この違いを最初に理解しておけば数時間を節約できます。なぜなら、そもそもプラットフォームが必要かどうかを決めることになるからです。自分自身のためだけにアプリをリリースするなら、Cloudflareに直接デプロイしてプラットフォームを完全に省略できます。

Voidプラットフォームは、開発者とCloudflareの間にある共有レイヤーです。管理者として、あなたがそれをインストールし、稼働させ続けます。その後、開発者はVoid CLIをプラットフォームのURLに向け、有効化されたログイン方法のいずれかでサインインし、その共有アカウントにアプリをデプロイします。Void Platformのダウンロードプロセスのあらゆる部分は、その引き継ぎを確実で再現可能にするために存在します。

プラットフォームはノートPC上ではなくあなたのCloudflareアカウント内に存在するため、ダウンロードはファイルというよりもインフラストラクチャに関するものです。Cloudflareの認証情報、プラン要件、文書化された一連のサービスを扱うことになります。以下の表で期待値を正しく整理しましょう。

Void Platformのダウンロードに期待されること実際に起こること
単一の.exeまたは.dmgインストーラープラットフォームはあなた自身のCloudflareアカウントにビルドおよびデプロイされる
ノートPC上で動作するクラウド上で動作し、チーム全体で共有される
即座に、アカウント設定不要Cloudflareの認証情報、Workers Paidプラン、文書化されたインフラストラクチャが必要
すべてのプロジェクトに必須ソロ開発者は代わりにCloudflareに直接デプロイできる
すべてが箱から出して揃っているコアインストールは意図的に最小限。アドオンは別途

前提条件と認証情報のチェックリスト

Void Platformのダウンロードを始める前に、必要なアカウントとアクセス権を集めましょう。実際には、失敗するインストールのほとんどは権限の欠如やプランのプロビジョニング不足が原因で、プラットフォーム自体の問題ではありません。まずこのリストを確認することで、イライラする午後がスムーズなセットアップに変わります。

要件必要な理由備考
Cloudflareアカウントプラットフォームとデプロイされたすべてのアプリをホストするチーム全体で共有
Workers PaidプランマネージドSandboxesに必要プラットフォームアカウントに適用
Workers for Platformsチームプラットフォームに必要文書化されたインフラストラクチャと組み合わせる
プラットフォームの認証情報インストールとAPIアクセスを認証する公式インストールガイドで説明されている
共有メールドメインとゾーンメールゲートウェイを有効にするオプション — 設定するまでメールはオフのまま
Void CLI開発者が接続してデプロイする方法各開発者のマシンにインストール

このうち2つは特に注意が必要です。第一に、Workers Paidプランは個々の開発者のアカウントではなく、プラットフォームアカウントで有効になっている必要があります。そうでなければSandboxesは動作しません。第二に、認証情報は初日から本番のシークレットとして扱うべきです。なぜなら、インストールゲートウェイとプロキシは、プラットフォーム上のすべてのアプリのWorkers AIおよびプロバイダーへのリクエストの前に位置するからです。

組織がAPIを保護するためにCloudflare Accessを使用している場合は、Webhookのパスを早めに計画しましょう。オプションのGitHubサービスを追加するソースからビルドされたプラットフォームでは、受信WebhookがAccessによってブロックされないよう、分離されたWebhookイングレスが必要です。後からそれを追加するのは、最初から設計するよりもはるかに苦労します。

コアインストールとオプションサービス

Void Platformのダウンロード後に最大の驚きの一つは、標準インストールに何が含まれ、何が意図的に除外されているかを発見することです。コアは設計上最小限です。マネージドSandboxesとメールゲートウェイで、メールは共有メールドメインとゾーンを設定して初めて有効になります。

コアインストールに含まれるものコアインストールに含まれないもの
マネージドSandboxesユーザーダッシュボード
メールゲートウェイ(ドメインとゾーンの設定後)GitHubビルドとWebhook
チームの共有アクセスBuild Containers
保持されたデプロイ履歴カスタムプロジェクトドメイン
AIリクエスト用のインストールゲートウェイとプロキシあらゆる種類のマネージドGitHub連携

この区分はロールアウトを計画する際に重要です。初日から洗練されたダッシュボードを期待するチームは、誰かがそれを構築または追加しない限り失望するでしょう。同様に、GitHub駆動のビルドに依存するチームはオプションサービスレイヤーが必要であり、ブランド化されたプロジェクトドメインを望むチームはその作業を別途計画する必要があります。

実用的なアプローチは、まずコアをインストールし、Sandboxesとデプロイが動作することを確認してから、追加機能を重ねることです。各アドオンはメンテナンスする領域を増やし、壊れたオプションサービスはコアが正常であることがわかっていればはるかに診断が容易です。

Cloudflare直接とセルフホスト型プラットフォーム

Void Platformのダウンロードを決める前に、プラットフォームが正しいターゲットであることを確認しましょう。どちらのパスも同じアプリケーションAPIを使用するため、どちらにもロックインされません。違いは共有アクセスと保持された履歴です。

機能Cloudflare直接コアセルフホスト型プラットフォーム
Workers AIとプロバイダーリクエストあなたのアカウントとあなたのゲートウェイインストールゲートウェイとプロキシ
ランタイムログライブCloudflare tail保持されたプラットフォームログ
アプリケーションのロールバックWorkerバージョン保持されたプラットフォームデプロイ
SandboxesWorkers PaidとDockerが必要プラットフォームアカウントでWorkers Paidが必要
ユーザーダッシュボードとマネージドGitHubビルド不要標準インストールには含まれない

簡単に言えば、自分用のアプリをデプロイして本番への最短経路を望むなら直接を選びましょう。チームが共有のデプロイターゲット、保持されたログ、生のWorkerバージョンではなく特定の保持されたデプロイへのロールバック機能を必要とするならプラットフォームを選びましょう。Sandboxesの違いにも注意してください。直接デプロイはローカルにDockerが必要ですが、プラットフォームはその要件をプラットフォームアカウントに押し付けます。

ステップバイステップ:Void Platformのダウンロードから初回デプロイまで

前提条件が確認できたら、インストール自体は予測可能な順序に従います。各ステップをゲートとして扱いましょう。前のステップが検証されるまで次に進まないでください。

ステップやること「完了」の状態
1ターゲットを確認:Cloudflare直接かセルフホスト型プラットフォームか明確な決定をチームのために文書化
2Cloudflareアカウント、プラン、認証情報を準備するWorkers Paidが有効。チームセットアップ用にWorkers for Platformsを準備
3公式インストールガイドを使ってプラットフォームをビルドおよびデプロイするプラットフォームがそのURLで到達可能
4共有メールドメインとゾーンを設定する(オプション)メールゲートウェイが有効で送信中
5GitHubビルドやBuild Containersなどのオプションサービスを追加する各アドオンを個別に検証
6Void CLIを通じて開発者を接続する開発者がサインインしてテストアプリをリリース

ステップ1と2:決定とプロビジョニング。 何かに触れる前に、直接実行するのかセルフホスト型を実行するのかを書き留めましょう。次にCloudflareアカウントをプロビジョニングし、Workers Paidプランを確認し、プラットフォームがチーム用であればWorkers for Platformsをセットアップします。認証情報はチャットでやり取りするのではなく、共有のシークレットストアに保管しましょう。

ステップ3と4:インストールとメール設定。 文書化されたインフラストラクチャが重要なので、場当たり的に進めるのではなく、公式のVoidセルフホスト型プラットフォームインストールガイドに従いましょう。プラットフォームに到達できたら、メールゲートウェイが必要なら共有メールドメインとゾーンを設定します。そのステップがなければ、メールは単に無効のままです。

ステップ5と6:拡張とオンボーディング。 オプションサービスを一度に一つずつ追加し、それぞれの後にテストします。次に開発者にプラットフォームのURLとCLIの指示を渡し、チーム全体にプラットフォームを告知する前に、一人が完全なサインインとデプロイをスモークテストとして完了するようにします。

症状考えられる原因修正方法
Sandboxesが起動しないプラットフォームアカウントでWorkers Paidが有効でないそのアカウントのプランを確認またはアップグレード
開発者がサインインできないログイン方法が有効化されていないプラットフォーム設定でサポートされているログイン方法を有効化
メールが送信されない共有メールドメインまたはゾーンが欠けているドメインとゾーンを設定してから再テスト
Access背後のGitHub Webhookが失敗するWebhookイングレスが分離されていない分離されたWebhookイングレスのセットアップに従う
チーム機能が利用できないWorkers for Platformsが設定されていない文書化されたインフラストラクチャを完了する

よくある質問

WindowsやmacOS用のVoid Platformダウンロードはありますか? いいえ、コンシューマー向けのデスクトップインストーラーはありません。Void Platformのダウンロードとは、プラットフォームをあなた自身のCloudflareアカウントにビルドしてデプロイすることを意味します。ローカルマシンには、開発者がプラットフォームのURLに接続してデプロイできるよう、Void CLIだけが必要です。

ソロ開発者ならVoid Platformのダウンロードは必要ですか? 通常は不要です。自分用のアプリをデプロイするなら、Cloudflareに直接デプロイしてプラットフォームを省略しましょう。プラットフォームは、チームが共有のデプロイターゲット、保持されたログ、ロールバック用の保持されたデプロイ履歴を必要とするときにその価値を発揮します。

標準インストールから欠けているものは何ですか? ユーザーダッシュボード、GitHubビルドとWebhook、Build Containers、カスタムプロジェクトドメインはすべてコアインストールの対象外です。マネージドSandboxesとメールゲートウェイは含まれますが、メールは共有メールドメインとゾーンが設定されて初めて機能します。

チームプラットフォームにはどのプランが必要ですか? チームプラットフォームにはWorkers for Platformsと文書化されたインフラストラクチャが必要で、マネージドSandboxesにはプラットフォームアカウントでのWorkers Paidプランが必要です。正確な機能はインストールの設定方法によって異なるため、開始前に公式ガイドを確認してください。