Commit e caricamento

Caricare una nuova applicazione

api.applications.create(file) carica uno zip e crea un’applicazione nuova di zecca. L’argomento file è un percorso di file locale oppure un Buffer.

import { SquareCloudAPI } from "@squarecloud/api";
import { join } from "node:path";

const api = new SquareCloudAPI(process.env.SQUARE_API_KEY!);

const result = await api.applications.create(join(__dirname, "my-app.zip"));

console.log(result.id);              // newly created application ID
console.log(result.name);            // display name
console.log(result.ram);             // allocated RAM in MB
console.log(result.cpu);             // allocated CPU shares
console.log(result.language);        // { name: "javascript", version: "22" }
console.log(result.description);     // string, only when set in squarecloud.config
console.log(result.subdomain);       // string, only when set in squarecloud.config

Possibili errori includono UPLOAD_FAILED (l’upload non è stato elaborato), STORAGE_UPLOAD_FAILED (il backend di storage ha rifiutato il file), INSUFFICIENT_MEMORY (il piano non ha RAM sufficiente disponibile) e FILE_TOO_LARGE (413, zip oltre il limite di dimensione). Lo zip deve contenere almeno:

File principale — punto di ingresso della tua applicazione
File delle dipendenze — package.json, requirements.txt, ecc.
squarecloud.app — file di configurazione con nome, descrizione, file principale, versione, ecc. Consulta la guida al file di configurazione

Effettuare il commit di file su un’applicazione esistente

app.commit(file, fileName?) carica file in un’applicazione già in deploy. Passa uno zip per sostituire più file contemporaneamente, oppure un singolo file per aggiornare solo quello.

Parametro	Tipo	Descrizione
`file`	`string \| Buffer`	Percorso del file locale o contenuto `Buffer`
`fileName`	`string?`	Nome allegato al caricamento. `.zip` viene estratto sul server; qualsiasi altra estensione viene scritta come singolo file.

Sotto il cofano, l’API accetta un parametro di query path per controllare dove viene scritto il commit; l’SDK lo invia automaticamente.

Commit di un singolo file (Buffer)
Commit di uno zip dal disco
Commit di un file tramite percorso

const content = Buffer.from("console.log('hello')\n");
await app.commit(content, "index.js");

import { readFile } from "node:fs/promises";

const zip = await readFile("./dist.zip");
await app.commit(zip, "dist.zip");

import { join } from "node:path";

const filePath = join(__dirname, "index.js");
await app.commit(filePath, "index.js");

In v3 commit() accettava un terzo argomento restart. In v4 il terzo parametro è stato rimosso — usa app.restart() dopo il commit se hai bisogno di un riavvio.

await app.commit(zip, "dist.zip");
await app.restart();

Possibili errori includono UPLOAD_FAILED, STORAGE_UPLOAD_FAILED, INSUFFICIENT_MEMORY, FILE_TOO_LARGE (413), UPLOAD_ABORTED (il client ha interrotto l’upload) e COMMIT_FAILED.

Servizi

Runtimes

Piattaforma

Risoluzione dei problemi

CLI

SDKs

Changelog

Caricare una nuova applicazione

Effettuare il commit di file su un’applicazione esistente

​Caricare una nuova applicazione

​Effettuare il commit di file su un’applicazione esistente

Caricare una nuova applicazione

Effettuare il commit di file su un’applicazione esistente