Déployer une app ou un bot Bun

​

Avant de commencer

• Bun sur votre machine, via l’installeur officiel de Bun ou le paquet npm (npm install bun).
• Un compte Square Cloud : inscrivez-vous avec votre e-mail ou GitHub.
• Un plan actif. Consultez les plans et choisissez celui qui convient à votre projet.

​

Configurer Square Cloud

npm install bun

RUNTIME=nodejs
START=npx bun index.ts
MEMORY=256
VERSION=recommended
DISPLAY_NAME=My bot

RUNTIME=nodejs
START=npx bun index.ts
MEMORY=512
VERSION=recommended
DISPLAY_NAME=My website
SUBDOMAIN=mywebsite

​

Ce que Square Cloud exécute

• START est exécuté directement. Pour plus d’informations sur les paramètres du fichier de configuration, consultez les paramètres de configuration.
• Si l’application n’a pas de dossier node_modules, Square Cloud exécute npm install --no-audit --no-fund avant de la démarrer, ce qui installe aussi bun. Les paquets de devDependencies ne sont pas installés, car le runtime définit NODE_ENV=production. Lorsque node_modules existe déjà, l’étape d’installation est ignorée.

​

Port et hôte pour les sites web et les API

Bun.serve({
  fetch() {
    return new Response("Hello, World!");
  },
});

​

Préparer le projet

​

Fichiers requis

• squarecloud.app, à la racine du ZIP.
• Votre fichier d’entrée, par exemple index.ts.
• package.json, qui liste bun dans dependencies. Un envoi sans ce fichier échoue avec INVALID_DEPENDENCY.

​

Ce qu’il faut exclure

• node_modules : Square Cloud retire ce dossier de votre envoi et installe les dépendances à partir de package.json au premier démarrage.
• Les fichiers de verrouillage : les dépendances sont installées avec npm, donc bun.lock n’est pas utilisé. La CLI et l’extension VS Code excluent aussi par défaut package-lock.json, yarn.lock et pnpm-lock.yaml ; lorsque vous avez besoin des versions exactes de votre package-lock.json, réincluez-le avec !package-lock.json dans votre squarecloud.ignore.

​

Dépannage

​

Déployer

​

Via le tableau de bord

1

Accéder à la page d'upload

Accédez à la page d’upload et téléversez le fichier zip de votre projet.

2

Configurer votre environnement

Après avoir téléversé votre zip, vous devrez configurer le nom, le fichier principal ou l’environnement d’exécution ainsi que d’autres paramètres de votre projet.
Si vous téléversez un projet web, veillez à sélectionner « Publication Web » et à définir un sous-domaine pour votre projet.

3

Déployer votre projet

Enfin, cliquez sur le bouton « Deploy » pour héberger votre projet sur Square Cloud.
Une fois le déploiement effectué, vous pouvez suivre l’état et les logs de votre projet depuis le tableau de bord.

4

Confirmez que votre application est en ligne

Votre premier déploiement prend généralement moins d’une minute. Dans le tableau de bord, attendez que le statut de votre application affiche « en cours d’exécution » et vérifiez les logs pour détecter d’éventuelles erreurs de démarrage.
Si vous avez déployé un site web ou une API, ouvrez https://<votre-sous-domaine>.squareweb.app dans votre navigateur, vous devriez voir votre application répondre. Si vous avez déployé un bot, envoyez-lui une commande pour confirmer qu’il est en ligne.

Votre application ne démarre pas ? Consultez le guide de dépannage pour les causes les plus courantes et leurs solutions.

​

Via la CLI

curl -fsSL https://cli.squarecloud.app/install | bash

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

squarecloud upload --file <path/to/zip>

squarecloud app status
squarecloud app logs

​

Prochaines étapes

​

Contactez-nous