Passer au contenu principal
  • upload crée une nouvelle application, avec un nouvel ID.
  • commit envoie des fichiers vers une application qui existe déjà et conserve son ID, son domaine et ses paramètres.
  • zip construit le même zip en local, sans l’envoyer, pour que vous puissiez vérifier ce qu’il contient.
  • init écrit le fichier de configuration pour vous, si vous préférez ne pas l’écrire à la main.
upload et commit existent aussi sous squarecloud app (squarecloud app upload, squarecloud app commit). Vous débutez ? Commencez par le Démarrage rapide.

Ce qui entre dans le zip

upload, commit et zip compressent le dossier courant et laissent de côté ce que liste le fichier squarecloud.ignore à la racine du projet. Il utilise la syntaxe de .gitignore et c’est le même fichier que lit l’extension VS Code.
  • Toujours exclus en premier : node_modules, .git, .github, .vscode, package-lock.json, pnpm-lock.yaml et yarn.lock. Les dépendances sont installées sur la plateforme à partir de votre manifeste. Pour envoyer un fichier de verrouillage parce que vous avez besoin de versions figées, ajoutez une règle !, comme !package-lock.json.
  • Liens : un lien symbolique vers un fichier est compressé comme ce fichier ; les liens vers des dossiers et les liens cassés sont ignorés, avec une note sur stderr.
  • Anciens noms de fichier (.squareignore, .squarecloudignore, square.ignore) : ils sont encore lus lorsque squarecloud.ignore est absent, avec un avertissement invitant à renommer le fichier.

squarecloud upload

Utilisation
Compresse le dossier courant et crée une nouvelle application à partir de celui-ci. Le dossier doit contenir un fichier squarecloud.app ou squarecloud.config, que vous pouvez écrire à la main ou avec squarecloud init.
Sortie
Après un téléversement réussi, la CLI écrit ID=<appID> dans le fichier de configuration du dossier courant, pour que les commandes suivantes sachent de quelle app il s’agit. Consultez où l’ID est enregistré. Avec --json, stdout ne contient que l’application créée (ID, nom, description, domaine, cluster, mémoire, CPU et langage) au format JSON ; les messages de progression vont vers stderr.

squarecloud commit

Utilisation
Alias : squarecloud push, squarecloud app commit, squarecloud app push Compresse le dossier courant et l’envoie vers une application existante. L’ID provient de l’argument ou de la ligne ID= de votre fichier de configuration. Contrairement aux autres commandes, commit n’ouvre jamais de sélecteur : sans l’un ni l’autre, elle s’arrête avec le code de sortie 1.
Sortie
Les commits volumineux ne sont pas interrompus par un délai d’expiration. commit n’a pas de sortie JSON.

squarecloud zip

Utilisation
Compresse le dossier courant de la même manière que upload et commit et l’enregistre sous <folder name>.zip dans ce dossier, en remplaçant un fichier existant du même nom. Aucune connexion n’est nécessaire.
Sortie
Si le zip ne peut pas être écrit, la CLI affiche Couldn't zip your application. avec la raison ; si un ancien <folder name>.zip ne peut pas être supprimé, elle l’indique. Dans les deux cas, la commande se termine avec le code 1.

squarecloud init

Utilisation
Écrit le fichier de configuration du projet dans le dossier courant : squarecloud.app, ou squarecloud.config sous macOS. Aucune connexion n’est nécessaire. Dans un terminal, la commande demande chaque valeur, avec la valeur détectée par défaut :
  • MAIN : le main de package.json, ou un fichier d’entrée courant comme index.js, main.py, main.go ou index.html.
  • DISPLAY_NAME : le nom du dossier.
  • MEMORY : le minimum, 256 Mo, ou 512 Mo pour un site web ou une API. Un site web ou une API reçoit aussi un SUBDOMAIN, basé sur le nom du dossier.
  • VERSION : toujours recommended.
  • START et AUTORESTART : facultatifs, vide et désactivé par défaut.
Lorsque le dossier n’a pas de squarecloud.ignore, la commande peut aussi en créer un de départ.
Sortie
Sans terminal, exécutez-la avec --yes. Si aucun fichier principal n’est trouvé, --yes s’arrête avec le code de sortie 1 : exécutez squarecloud init sans cette option pour choisir le fichier.

Voir aussi

Pour déployer à chaque push, consultez plutôt Déploiements GitHub.