Skip to main content
このガイドでは、小さな Node.js の Web サーバーをデプロイして、3 つのファイル、1 つの zip、1 回のアップロードという一連の流れを最初から最後まで確認します。ボットや他の言語でも手順は同じです。

始める前に

Square Cloud は有料プラットフォームです。デプロイには有効なプランが必要で、初日からプロジェクトが本番グレードのインフラ上で稼働します。まずはアカウントを作成し、その後あなたに最適なプランを選択してください(各プランに含まれる内容はこちら)。

サインアップ

Square を初めてご利用の場合は、サインアップして始めましょう。

ログイン

すでにアカウントをお持ちの場合は、ログインして始めましょう。

プロジェクトを作成する

フォルダを作成し、次の 3 つのファイルを置きます。
1

アプリを書く

index.js は、すべてのリクエストに短いメッセージで応答します。ポートとホストは、Square Cloud が 80 と 0.0.0.0 に設定する環境変数 PORT と HOST から読み取ります。
index.js
2

依存関係を記載する

Node.js のプロジェクトには必ず package.json が必要です。Square Cloud は、アプリを起動する前にこのファイルに記載されたパッケージをインストールします。この例では依存関係はありませんが、ファイル自体は必要で、空にはできません。
package.json
3

設定ファイルを追加する

squarecloud.app は、実行するファイル、確保するメモリ量、使用するランタイムのバージョンを Square Cloud に伝えます。SUBDOMAIN を指定すると、アプリは https://<subdomain>.squareweb.app で Web サイトとして公開されます。まだ誰も使っていない名前を選んでください。
squarecloud.app
各フィールドの説明は設定ファイルのリファレンスにあります。VS Code 拡張機能を使うと、入力中にこのファイルの補完とチェックが行われます。
Web サイトはポート 80、ホスト 0.0.0.0 で待ち受ける必要があります。localhost、127.0.0.1、または別のポート(3000 や 8080 など)にバインドしたサーバーには到達できず、サイトにはタイムアウトのページが表示されます。index.js のように PORT と HOST を読み取れば、Square Cloud では正しく動作し、手元のマシンではポート 3000 で動かせます。
ボットをデプロイする場合は、SUBDOMAIN を省いて AUTORESTART=true を追加し、トークンはコードではなく環境変数に保存してください。Discord ボットのチュートリアルで、ボット全体の作り方を説明しています。

プロジェクトを zip にする

CLI でデプロイする場合、このセクションは不要です。squarecloud upload がフォルダを zip にまとめます。
1

フォルダではなくファイルを選択する

プロジェクトのフォルダを開き、中身をすべて選択します。squarecloud.app は zip の最上位に置く必要があります。フォルダ自体を圧縮すると、ファイルがサブフォルダに入ってしまい、デプロイが MISSING_CONFIG で失敗します。
2

zip を作成する

選択したファイルを右クリックし、ZIP ファイルに圧縮する(Windows 11)、または 送る → 圧縮 (zip 形式) フォルダー を選びます。
3

サイズを確認する

zip のサイズは最大 100 MB です。node_modules、仮想環境、ビルドキャッシュは含めないでください。依存関係はサーバー上でインストールされ、これらのフォルダはいずれにしてもデプロイ時に削除されます。

デプロイ

ダッシュボードで zip をアップロードするか、CLI から 1 コマンドでデプロイします。

ダッシュボード経由

1

アップロードページにアクセス

アップロードページにアクセスし、プロジェクトの zip ファイルをアップロードします。
2

環境を設定

zip をアップロードした後、プロジェクトの名前、メインファイルまたはランタイム環境、その他の設定を構成する必要があります。
ウェブプロジェクトをアップロードする場合は、必ず「Web Publication」を選択し、プロジェクトにサブドメインを設定してください。
3

プロジェクトをデプロイ

最後に「Deploy」ボタンをクリックして、プロジェクトを Square Cloud にホストします。
デプロイ後、ダッシュボードからプロジェクトのステータスとログを監視できます。
Square Cloud へのアプリケーションのアップロード
4

アプリが稼働していることを確認

最初のデプロイは、通常 1 分もかからずに完了します。ダッシュボードでアプリケーションのステータスが running になるのを待ち、起動時のエラーがないかログを確認してください。
ウェブサイトや API をデプロイした場合は、ブラウザで https://<your-subdomain>.squareweb.app を開き、アプリケーションが応答することを確認してください。ボットをデプロイした場合は、コマンドを送信してオンラインになっていることを確認してください。
アプリが起動しませんか?よくある原因と修正方法はトラブルシューティングガイドを参照してください。

CLI 経由

この方法を使用するには、プロジェクトのルートに squarecloud.app という名前の設定ファイルが必要です。このファイルは、アプリケーションの実行方法を Square Cloud に伝えます。

設定ファイルガイド

アプリケーションの環境を定義する squarecloud.app 設定ファイルの作成方法を学びます。
1

CLI をインストール

Square Cloud CLI をインストールします。すでにお持ちの場合は、同じコマンドを実行すると更新されます:
2

ログイン

次のコマンドを実行します。ブラウザが開くので、そこでログインを承認すれば CLI の準備は完了です。API キーをコピーする必要はありません。スクリプトや CI については、CLI の認証を参照してください。
3

プロジェクトをアップロード

プロジェクトのフォルダで次のコマンドを実行します。CLI は squarecloud.ignore に記載されたものを除いて現在のフォルダを zip にし、アップロードします:
自分で作成した zip をアップロードするには、--file で指定します:
4

アプリが稼働していることを確認

最初のデプロイは、通常 1 分もかからずに完了します。ターミナルから直接、アプリケーションのステータスとログを確認してください。
ウェブサイトや API をデプロイした場合は、ブラウザで https://<your-subdomain>.squareweb.app を開き、アプリケーションが応答することを確認してください。ボットをデプロイした場合は、コマンドを送信してオンラインになっていることを確認してください。
アプリが起動しませんか?よくある原因と修正方法はトラブルシューティングガイドを参照してください。
アプリが起動すると、https://hello-square-yourname.squareweb.app(あなたのサブドメイン)が Hello from Square Cloud! と応答します。
push のたびにデプロイしたい場合は、GitHub リポジトリを接続するか、GitHub Actions のワークフローを使ってください。

次のステップ

設定ファイル

メモリ、起動コマンド、サブドメイン、自動再起動など、squarecloud.app のすべてのフィールド。

環境変数

トークンや接続文字列をコードの外に保存します。

トラブルシューティング

アップロードのエラー、表示されないサイト、起動しないアプリを解決します。

VS Code 拡張機能

エディターを離れずに、アップロード、コミット、ログの確認ができます。

言語別のガイド

各ガイドでは、そのランタイムの依存関係ファイル、起動コマンド、よくある落とし穴を説明しています。

JavaScript

Bun

Deno

Python

Java

Rust

Elixir

PHP

Go

C#

Ruby

HTML/CSS