uploadは、新しい ID を持つ新しいアプリケーションを作成します。commitは、既存のアプリケーションにファイルを送信し、その ID、ドメイン、設定を維持します。zipは、同じ zip を送信せずにローカルで作成するため、何が含まれるかを確認できます。
upload と commit は squarecloud app の下にもあります(squarecloud app upload、squarecloud app commit)。初めての方はクイックスタートから始めてください。
zip に含まれるもの
upload、commit、zip は現在のフォルダを zip にまとめ、プロジェクトのルートにある squarecloud.ignore に記載されたものを除外します。このファイルは .gitignore の構文を使い、VS Code 拡張機能が読み込むものと同じファイルです。
- 常に最初に除外されるもの:
node_modules、.git、.github、.vscode、package-lock.json、pnpm-lock.yaml、yarn.lock。依存関係はマニフェストをもとにプラットフォーム上でインストールされます。バージョンを固定する必要があってロックファイルを送信したい場合は、!package-lock.jsonのような!ルールを追加してください。 - リンク: ファイルへのシンボリックリンクはそのファイルとして zip に含まれます。フォルダへのリンクや壊れたリンクはスキップされ、stderr にその旨が表示されます。
- 古いファイル名(
.squareignore、.squarecloudignore、square.ignore)も、squarecloud.ignoreがない場合は読み込まれます。その際、ファイル名を変更するよう警告が表示されます。
squarecloud upload
使い方
squarecloud.app または squarecloud.config ファイルが必要です。
出力
ID=<appID> を書き込みます。これにより、以降のコマンドはどのアプリを指しているかを判断できます。アプリ ID の保存場所を参照してください。
--json を付けると、stdout には作成されたアプリケーション(ID、名前、説明、ドメイン、クラスター、メモリ、CPU、言語)だけが JSON で出力され、進行状況のメッセージは stderr に出力されます。
squarecloud commit
使い方
squarecloud push、squarecloud app commit、squarecloud app push
現在のフォルダを zip にまとめ、既存のアプリケーションに送信します。ID は引数、または設定ファイルの ID= 行から取得されます。ほかのコマンドと異なり、commit は選択画面を開きません。どちらもない場合は、終了コード 1 で停止します。
出力
commit には JSON 出力はありません。
squarecloud zip
使い方
upload や commit と同じ方法で現在のフォルダを zip にまとめ、そのフォルダ内に <folder name>.zip として保存します。同じ名前のファイルがある場合は置き換えます。ログインは不要です。
出力
Couldn't zip your application. と表示します。古い <folder name>.zip を削除できない場合も、その旨が表示されます。どちらも終了コード 1 で終了します。
関連項目
push のたびにデプロイしたい場合は、GitHub デプロイを参照してください。

