Vai al contenuto principale
Panoramica del servizio Square Cloud Bots

Perché scegliere Square Cloud?

Siamo la più grande piattaforma di hosting di bot dell’America Latina, con la fiducia di 80 dei 100 più grandi server Discord brasiliani. Un bot vive o muore in base al suo uptime e alla sua latenza verso i gateway di Discord, WhatsApp e Telegram, quindi ogni livello del nostro stack, dall’hardware all’edge di rete, è ottimizzato per mantenere il tuo processo online e reattivo 24/7.

Prestazioni progettate su misura

Ogni bot gira su SSD NVMe Samsung enterprise dietro uplink da 10Gbps, in un container isolato con CPU e RAM applicate a livello di kernel, così il picco di traffico di un vicino non diventa mai il tuo problema di latenza.

Un ecosistema completo per sviluppatori

CLI, SDK JavaScript e Python, un’estensione VSCode e GitHub Actions/Webhooks per il CI/CD. Effettua il deploy dal tuo terminale, dal tuo editor o con un git push.

Square Shield + Cloudflare

Un edge fronteggiato da Cloudflare più Square Shield mantiene il tuo bot entro i rate limit delle API delle piattaforme (Discord e altre), prevenendo i ban e i cooldown che mettono offline un bot.

Snapshot istantanei

Punti di ripristino con un clic inclusi senza costi aggiuntivi. Ripristina un deploy corrotto in pochi secondi, senza perdita di dati e senza downtime.
Provato su larga scala: la nostra reputazione è stata guadagnata gestendo i bot dietro alcune delle community più affollate dell’America Latina, il tipo di carico sostenuto e ad alto tasso di eventi che silenziosamente mette in luce le infrastrutture deboli. Il tuo gira sugli stessi cluster.

Ambienti supportati

Offriamo un’ampia compatibilità così puoi sviluppare con la tua tecnologia preferita.

Piattaforme

Discord

WhatsApp

Telegram

Twitter

Instagram

Facebook

Slack

YouTube

Linguaggi

JavaScript

Python

Java

Rust

Elixir

PHP

Go

C#

Ruby

Oltre a questi, supportiamo vari altri linguaggi e librerie. La nostra infrastruttura è flessibile per adattarsi alle esigenze del tuo progetto.

Caratteristiche principali

Infrastruttura costruita per carichi di lavoro always-on

Ogni cluster gira su SSD NVMe Samsung enterprise con uplink da 10Gbps, e il tuo bot gira in un container isolato e senza privilegi con limiti dedicati di CPU e RAM. L’isolamento è ciò che trasforma il “veloce sulla carta” in veloce in produzione: il tuo processo non lotta mai con un vicino rumoroso per l’I/O o la CPU, così i tempi di risposta restano bassi anche sotto carico sostenuto di eventi.

Square Shield: restare entro i rate limit

Discord, WhatsApp e Telegram bannano i bot che superano i rate limit dei loro gateway e delle loro REST. Square Shield si posiziona tra il tuo bot e quelle API, monitorando i pattern delle richieste per mantenerti entro il budget consentito: la differenza tra un bot che scala in modo pulito e uno che finisce in cooldown offline nel momento peggiore.

Opera con piena visibilità

I punti di ripristino ti permettono di annullare un deploy sbagliato in pochi secondi, senza perdita di dati né downtime. I piani Pro ed Enterprise aggiungono snapshot giornalieri automatici.
Trasmetti in streaming lo stdout/stderr della tua applicazione in tempo reale per eseguire il debug in produzione nel momento in cui qualcosa non funziona, senza riavviare il deploy.
Monitora il consumo di CPU, RAM e rete in tempo reale da un pannello intuitivo, così puoi dimensionare correttamente le risorse e individuare le regressioni prima dei tuoi utenti.

Strumenti di sviluppo

Per ottimizzare il tuo flusso di lavoro, offriamo un ecosistema completo di strumenti:
1

Square Cloud CLI

Gestisci le tue applicazioni direttamente dal terminale. Effettua il deploy, controlla i log e molto altro, in modo rapido e pratico.
npm install -g @squarecloud/cli
squarecloud auth login
2

Estensione VSCode

Integra la gestione dell’hosting nel tuo editor di codice preferito, semplificando il processo di sviluppo e deploy.
3

GitHub Actions

Automatizza il deploy continuo (CI/CD) del tuo bot. A ogni push sul tuo repository, la tua applicazione viene aggiornata automaticamente sulla nostra piattaforma.
Attenzione: per utilizzare il deploy tramite GitHub Actions, devi configurare un token API nei secret del tuo repository. Consulta la nostra documentazione specifica per la guida passo passo.

Come ospitare il mio bot?

File di configurazione

Il primo passo per ospitare il tuo bot su Square Cloud è creare un file di configurazione dettagliato. Questo file non è solo un semplice documento di testo, ma una guida completa che definisce le impostazioni dell’applicazione su Square Cloud. Funziona come un progetto architettonico per il tuo progetto sulla piattaforma.Una volta acquistato il piano, devi creare questo file, specificando ogni configurazione e compilandolo correttamente. I dettagli su come creare questo file sono disponibili qui, con una guida passo passo.

Creazione del file ZIP

Con il file di configurazione pronto, il passo successivo è preparare la tua applicazione per il caricamento. Questo comporta inserire i file dell’applicazione e il file di configurazione di Square Cloud all’interno di un file .zip.Tuttavia, non tutti i file devono essere inclusi in questo .zip. File come node_modules, package-lock.json, pyproject.toml e poetry.lock non sono necessari, poiché possono essere generati automaticamente lato server.

File delle dipendenze

Un altro aspetto cruciale è includere il file delle dipendenze nel .zip. Questo file indica alla piattaforma Square Cloud quali dipendenze installare per il tuo progetto. Per un progetto Node.js, questo file è package.json, mentre per un progetto Python è requirements.txt.Questi file elencano le librerie e i pacchetti necessari al corretto funzionamento dell’applicazione. Mantenere questi file aggiornati è fondamentale per evitare errori di installazione. Inoltre, è importante notare che le dipendenze native, come node-fetch in Node.js e random in Python, non devono essere incluse in questi file, poiché sono librerie native.

Caricamento del bot

Dopo aver seguito tutti i passaggi e configurato il tuo progetto per Square Cloud, è il momento di caricare il tuo bot. Accedi alla pagina di caricamento sul sito Square Cloud e invia il tuo file .zip qui.Il processo è semplice: seleziona il tuo file .zip e clicca sul pulsante di caricamento. La piattaforma Square Cloud avvierà il processo di deploy, installando le dipendenze necessarie e configurando l’ambiente in base al file di configurazione.
Caricamento dell'applicazione su Square Cloud