デプロイ

アプリケーションをデプロイする際、Qwik にはすぐに使える統合機能が付属しており、デプロイが非常に簡単になります!

npm run qwik add

アダプターとミドルウェア

Qwik City ミドルウェアは、サーバーレンダリングフレームワーク (Cloudflare、Netlify、Vercel、Express など) と Qwik City メタフレームワークを接続するグルーコードです。

本番ビルド

新しい統合がプロジェクトに追加されると、package.json ファイルに build.server スクリプトが追加されます。このスクリプトは、本番環境用のプロジェクトをビルドするために使用されます。

必要なのは、次のコマンドを実行することだけです。

npm run build

内部的には、build スクリプトは build.server スクリプトと build.client スクリプトを実行します。

高度

上記の各ミドルウェアバンドルがリクエスト/レスポンスを Qwik City が使用する標準形式に変換するために使用するユーティリティが requestHandler() です。この関数を使用すると、特定のサーバーフレームワークのミドルウェアを提供できます。

ミドルウェアが不足していて、追加したい場合は、上記の各ミドルウェアのソースコードで requestHandler() ユーティリティがリクエストを処理するためにどのように使用されているかを確認してください。さらに良いことに、ミドルウェアの貢献をお待ちしています!PRは大歓迎です

新しいデプロイの追加

Qwik にデプロイ統合を追加することにご興味をお持ちいただきありがとうございます!始めるにあたり、喜んでお手伝いさせていただきます。始める前に、探しているものに既にデプロイがある場合は、ぜひご貢献ください。デプロイがまだ利用できない場合は、追加しましょう!

まず、既存のアダプターとミドルウェアをコピーし、ニーズに合わせて変更するのがおそらく最善です。デプロイはいくつかの異なる部分で構成されています。

アダプターの追加

アダプターとは、特別なビルド構成に必要な Vite 構成をまとめた用語です。クラウドサービスでもカスタムサーバーでも、各サーバーにはサーバーが使用する特定の出力に対して独自のビルド構成があります。たとえば、CloudflareNetlify、および Node.js サーバーにはそれぞれ独自のビルド構成があります。

アダプターは実際には、ベース構成を拡張する Vite 構成です。ベース構成はすべてのアダプターで同じであり、アダプター構成は各サーバーに固有の部分です。

ミドルウェアの追加

ミドルウェアは、サーバーレンダリングフレームワーク (Cloudflare、Netlify、Vercel、Express など) と Qwik City メタフレームワークを接続するグルーコードです。各ミドルウェアは、サーバーからのリクエストとレスポンスを処理し、Qwik City が使用する標準形式に変換する役割を担っています。

幸いなことに、Qwik City は標準化された Request および Response インターフェイスを使用しているため、ミドルウェアは通常非常に最小限です。

ミドルウェアについては、それぞれが共通の @builder.io/qwik-city/middleware/request-handler パッケージを呼び出していることに気づくでしょう。各ミドルウェアの役割は、リクエストとレスポンスを Qwik City リクエストハンドラーパッケージが使用する標準化された形式に変換することです。

スターター CLI への追加

次のステップは、新しいアダプターをスターター CLI に追加することです。このステップでは、開始するために、Discord でコアチームに連絡するのがおそらく最善でしょう。CLI は、新しいアダプターをテストし、期待どおりに動作することを確認するのに最適な方法であるため、新しいアダプターを追加するのに最適な場所です。

コントリビューター

このドキュメントの改善にご協力いただいたすべてのコントリビューターに感謝します!

  • adamdbradley
  • samijaber
  • reemardelarosa
  • mhevery
  • igorbabko
  • mrhoodz