Déployez et contrôlez vos applications depuis le terminal

Connectez-vous avec un code dans le navigateur, déployez n’importe quel dossier en une commande et accédez aux logs, bases de données et espaces de travail depuis la même invite, avec une sortie que vos scripts savent lire.

Installer la CLILire la documentation
La CLI Square Cloud est open source et fonctionne sur macOS, Linux et Windows, sur x86 et ARM. Le code source est disponible sur GitHub.

Installez en une commande

Le script d’installation et le paquet npm téléchargent le build pour votre système depuis la dernière release et vérifient sa somme de contrôle avant de l’installer.

macOS, Linux et WSL

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

S’installe dans /usr/local/bin et peut donc vous demander votre mot de passe.

Windows

npm i -g @squarecloud/cli

Nécessite Node.js avec npm. La même commande fonctionne aussi sur macOS et Linux.

  • Vérifié avec les sommes de contrôle SHA-256 de la release
  • Builds pour x86 et ARM, Apple silicon compris
  • Pour mettre à jour, relancez la même commande
Autres méthodes d’installation

Connectez-vous sans copier de clé

La CLI affiche un code, vous l’approuvez dans le navigateur et le terminal reçoit sa propre clé, comme se connecte l’extension VS Code.

  1. 1

    Le terminal affiche un code

    Lancez la commande de connexion : le navigateur s’ouvre sur la page d’approbation, pendant que le terminal affiche un code de huit caractères et un compte à rebours.

  2. 2

    Approuvez-le dans le navigateur

    Saisissez le code sur la page Square Cloud, puis approuvez. Ne saisissez jamais un code que quelqu’un vous a envoyé.

  3. 3

    La CLI est connectée

    Le terminal confirme votre compte et enregistre une clé créée pour lui, avec uniquement les permissions dont ses commandes ont besoin.

  • Chaque clé est valable 90 jours, et auth whoami indique jusqu’à quand
  • Demande avant de remplacer un autre compte sur cette machine
  • En SSH, --no-browser affiche le lien à ouvrir où vous voulez
  • Vous avez déjà une clé ? Utilisez --token ou --with-token

Déployez depuis n’importe quel dossier

Téléversez le dossier où vous êtes comme nouvelle application, envoyez des modifications à une application existante, ou liez un dépôt GitHub pour que chaque push la déploie.

  • Nouvelle application

    La CLI compresse le dossier courant selon vos règles d’exclusion, crée l’application et affiche le lien vers sa page dans le tableau de bord.

    uploadupload --file

    • Ou envoyez un zip que vous avez déjà
    • Écrit le nouvel ID dans squarecloud.app, si le projet en a un

  • Commit des modifications

    Envoyez le dossier, ou un zip, à une application existante. Elle conserve son ID, son domaine et ses paramètres.

    commitcommit -rcommit --path

    • Redémarre ensuite l’application, si vous le demandez
    • Peut placer les fichiers dans un dossier de l’application

  • Déployer à chaque push

    Liez un dépôt et une branche via la GitHub App Square Cloud, ou créez un webhook avec un token GitHub, sans quitter le terminal.

    app deploy github linkapp deploy webhookapp deploy list

Un seul fichier d’exclusion pour la CLI et VS Code

upload, commit et zip laissent de côté ce que squarecloud.ignore liste à la racine de votre projet. L’extension VS Code lit le même fichier, avec les mêmes règles.

  • La syntaxe de .gitignore

    # pour les commentaires, ! pour réintégrer un chemin, dir/ pour les dossiers seulement, /build pour la racine seulement, ainsi que *, ?, [abc] et **. La dernière ligne qui correspond l’emporte, sans distinction de casse.

  • Des exclusions par défaut

    node_modules, .git, .github, .vscode et les lockfiles de npm, pnpm et Yarn sont exclus avant vos règles. Une ligne comme !yarn.lock en réintègre un.

  • Vérifiez avant d’envoyer

    squarecloud zip crée la même archive dans votre dossier : ouvrez-la pour voir exactement ce qui serait envoyé.

Les variables arrivent telles que vous les avez saisies

Votre application charge ses variables via un shell. Depuis la version 3.1.1, la CLI envoie entre guillemets les valeurs contenant des espaces ou des caractères comme $, & ou ;, pour que le shell ne puisse ni les couper ni les développer.

  • Depuis le terminal

    Passez autant de paires KEY=VALUE que vous voulez. La CLI prend l’application dans squarecloud.app ou vous laisse la choisir dans une liste.

    app env setapp env list

    • Guillemets simples, ou doubles si la valeur en contient un
    • Une valeur déjà entre guillemets est envoyée telle quelle

  • Depuis un fichier .env

    Lit les lignes KEY=VALUE d’un fichier en ignorant les commentaires et les lignes vides. Les lignes qui commencent par export et les valeurs entre guillemets fonctionnent aussi.

    --from-file .env

    • Fonctionne pour définir ou remplacer des variables
    • La liste les affiche au format KEY=VALUE

  • Changements en masse

    Remplacez toutes les variables d’un coup, ou supprimez-les toutes. Les deux demandent confirmation avant tout changement, et un remplacement exige au moins une nouvelle variable.

    app env replaceapp env remove --all-y

    • Un flag confirme pour vous dans les scripts
    • Répondez non et rien ne change

Conçue pour les scripts et la CI

Des résultats lisibles par un programme, des codes de sortie qui disent vrai et une clé qui fonctionne sans navigateur.

  • Du JSON à la demande

    Les commandes qui affichent des données peuvent répondre en JSON, avec uniquement le résultat sur stdout. Les autres refusent le flag avec une erreur plutôt que d’afficher un texte qui ferait trébucher un parser.

    --json

  • Codes de sortie fiables

    Chaque échec se termine par 1. Quand une confirmation ne peut pas être demandée, sans terminal ni flag pour y répondre, la commande échoue et ne change rien.

    -y

  • Un stdout propre

    Les erreurs, les questions et les avis vont sur stderr, tout comme la progression quand vous demandez du JSON : un pipe ne transporte que le résultat.

    stdoutstderr

  • Une clé pour la CI

    Définissez une clé de votre compte comme variable d’environnement et chaque commande l’utilise, sans connexion. Avec CI à true, la connexion par navigateur ne démarre pas.

    SQUARECLOUD_API_KEYCI=true

  • Traces sans secrets

    Une variable affiche sur stderr la méthode, le chemin, le statut et la durée de chaque appel à l’API, jamais les en-têtes, les query strings ni les corps.

    SQUARECLOUD_DEBUG=1

  • GitHub Actions

    L’Action Square Cloud installe la CLI sur le runner, la vérifie avec les sommes de contrôle de la release et lance n’importe quelle commande avec votre clé.

    squarecloudofc/github-action@v2

Le reste de la plateforme, aussi

Logs, métriques, fichiers, snapshots, domaines, bases de données et espaces de travail, chacun à une commande près.

  • Logs et flux en direct

    Affichez les dernières lignes, ou suivez la sortie en direct avec chaque changement de statut. Ce que votre application écrit sur stderr reste sur stderr.

    app logsapp realtime

  • Statut et métriques

    CPU, mémoire, disque et uptime pour une application ou une ligne pour chacune, plus les métriques des dernières 24 heures.

    app status --allapp metrics

  • Fichiers distants

    Listez, lisez, écrivez, déplacez et supprimez les fichiers de l’application. Écrire depuis un fichier préserve les binaires, et lire vers un fichier demande avant de l’écraser.

    app file readapp file write

  • Snapshots

    Créez un snapshot et téléchargez-le, listez ses versions et restaurez-en une, pour les applications comme pour les bases de données.

    app snapshot createdb snapshot restore

  • Domaines et trafic

    Configurez un domaine personnalisé, obtenez les enregistrements DNS à créer, lisez les analytics, erreurs et performances edge, et videz le cache.

    app network domainapp network analytics

  • Bases de données

    Créez des bases MongoDB, MySQL, PostgreSQL et Redis, démarrez-les ou arrêtez-les, téléchargez le certificat TLS et changez le mot de passe.

    db createdb credentials reset

Toutes les commandes dans la documentation

Prudente, ouverte et dans votre langue

  • En huit langues

    Messages, aide et tableaux suivent la langue d’affichage de votre système à chaque lancement. LC_ALL en choisit une autre pour une seule commande.

  • Aucun ID à retenir

    La plupart des commandes prennent l’application dans squarecloud.app, ou listent les vôtres pour que vous en choisissiez une.

  • Confirmation d’abord

    Supprimer, remplacer toutes les variables, restaurer un snapshot ou vider le cache demande d’abord, et les scripts peuvent confirmer avec un flag.

  • Open source

    Le code est sur GitHub, et chaque release publie ses builds avec des sommes de contrôle SHA-256.

Un plan pour chaque étape de votre projet

Commencez petit et évoluez quand vous en avez besoin, sans contrat d’engagement.

Comparer tous les plans

4,9 sur 5 · 402 avis sur Google + TrustpilotTrustpilot

Hébergé dans un datacenter partenaire disposant des certifications
Tier 3ISO 27001SOC 2 Type IIProtection DDoS permanente
Découvrez notre infrastructure

Prêt à faire évoluer votre projet ?

Rejoignez les plus de 500 000 développeurs qui ont utilisé Square Cloud pour héberger leurs projets.

Commencez dès maintenant sur Square CloudVoir les plans et les tarifs
  • Tarifs prévisibles
  • Aucune surprise de facturation
  • Déployez en quelques secondes
  • Haute disponibilité
  • Évoluez en toute stabilité
  • Redémarrage automatique
  • SSL et sécurité inclus
  • Conteneurs isolés