Ospita un'app o un bot C# / .NET

Il runtime .NET esegue bot, worker, API e siti web in C# su .NET 10. Square Cloud ripristina i tuoi pacchetti NuGet, poi compila ed esegue il tuo progetto con dotnet run.

Prima di iniziare

L’SDK .NET sul tuo computer. Se non lo hai, scaricalo dal sito ufficiale di .NET.
Un account Square Cloud: registrati con la tua email o con GitHub.
Un piano attivo. Consulta i piani e scegli quello adatto al tuo progetto.

Configurare Square Cloud

Se carichi la tua applicazione tramite la dashboard, puoi saltare questa sezione: la dashboard crea per te il file di configurazione squarecloud.app.

Riferimento del file di configurazione

Il file squarecloud.app indica a Square Cloud come eseguire la tua applicazione: file principale, memoria, versione del runtime, nome e, per un sito, il sottodominio.

Punta MAIN al file del tuo progetto. Un file di configurazione completo per ogni tipo di app:

Bot o worker
Sito web o API

squarecloud.app

MAIN=MyBot.csproj
MEMORY=512
VERSION=recommended
DISPLAY_NAME=My bot

squarecloud.app

MAIN=MyApi.csproj
MEMORY=512
VERSION=recommended
DISPLAY_NAME=My API
SUBDOMAIN=my-api

Cosa esegue Square Cloud

Se il campo START non è definito nel file di configurazione, Square Cloud esegue dotnet restore per ripristinare le dipendenze del progetto, poi dotnet run --project MAIN per compilare ed eseguire il progetto specificato in MAIN. Se il campo START è definito, verrà eseguito direttamente il valore in esso contenuto. Per maggiori informazioni sui parametri del file di configurazione, visita parametri di configurazione.

Porta e host per siti web e API

ASP.NET Core non ascolta sulla porta 80 per impostazione predefinita, e dotnet run applica gli URL di Properties/launchSettings.json, che puntano a localhost. Imposta invece l’indirizzo in Program.cs: Square Cloud imposta la variabile d’ambiente PORT a 80, e 0.0.0.0 accetta connessioni dall’esterno del container.

Program.cs

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

app.MapGet("/", () => "Hello, World!");

var port = Environment.GetEnvironmentVariable("PORT") ?? "80";
app.Run($"http://0.0.0.0:{port}");

Preparare il progetto

File richiesti

squarecloud.app, nella radice dello ZIP.
Il file del tuo progetto (.csproj) e il codice sorgente.

Se il file .csproj si trova in una cartella, mantieni il file di configurazione nella radice dello zip e imposta MAIN sul suo percorso, per esempio MAIN=folder/file.csproj. Il comando predefinito esegue prima dotnet restore nella radice, che richiede lì un file di progetto o di soluzione; se la radice non ne ha nessuno, imposta START=dotnet run --project folder/file.csproj.

Il file di configurazione (squarecloud.app) deve trovarsi nella radice del file zip. Altrimenti, Square Cloud non riuscirà a trovarlo durante il deploy.

Cosa lasciare fuori

bin/ e obj/: output della build che dotnet run ricrea sul server.

Risoluzione dei problemi

Il sito non risponde

L’app ascolta su un’altra porta o solo su localhost. Imposta l’indirizzo con app.Run($"http://0.0.0.0:{port}") come mostrato in Porta e host.

MSB1003: Specify a project or solution file

dotnet restore non ha trovato nessun file di progetto o di soluzione nella radice dello ZIP. Sposta il .csproj nella radice, oppure imposta START=dotnet run --project folder/file.csproj.

Per altri problemi, consulta Risoluzione dei problemi.

Deploy

Tramite dashboard

Accedi alla pagina di upload

Accedi alla pagina di upload e carica il file zip del tuo progetto.

Configura il tuo ambiente

Dopo aver caricato il tuo zip, dovrai configurare il nome, il file principale o il runtime environment e altre impostazioni per il tuo progetto.
Se stai caricando un progetto web, assicurati di selezionare “Web Publication” e di impostare un sottodominio per il tuo progetto.

Esegui il deploy del tuo progetto

Infine, clicca sul pulsante “Deploy” per ospitare il tuo progetto su Square Cloud.
Dopo il deploy, puoi monitorare lo stato e i log del tuo progetto dalla dashboard.

Caricamento dell'applicazione su Square Cloud

Conferma che la tua app sia online

Il primo deploy richiede di solito meno di un minuto. Nella dashboard, attendi che lo stato della tua applicazione mostri “in esecuzione” e controlla i log per eventuali errori di avvio.
Se hai fatto il deploy di un sito web o di un’API, apri https://<tuo-sottodominio>.squareweb.app nel tuo browser: dovresti vedere la tua applicazione rispondere. Se hai fatto il deploy di un bot, invia un comando per confermare che sia online.

La tua app non si avvia? Consulta la guida alla risoluzione dei problemi per le cause più comuni e le relative soluzioni.

Tramite CLI

Per utilizzare questo metodo, il tuo progetto deve avere un file di configurazione chiamato squarecloud.app nella sua radice. Indica a Square Cloud come eseguire la tua applicazione.

Guida al file di configurazione

Scopri come creare il file di configurazione squarecloud.app che definisce l’ambiente della tua applicazione.

Installa la CLI

Installa la CLI di Square Cloud. Se ce l’hai già, esegui lo stesso comando per aggiornarla:

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

npm install -g @squarecloud/cli@latest

Accedi

Esegui il comando qui sotto. Apre il tuo browser: approva l’accesso lì e la CLI è pronta. Non c’è nessuna chiave API da copiare. Per script e CI, consulta Autenticazione della CLI.

squarecloud auth login

Carica il tuo progetto

Dalla cartella del tuo progetto, esegui il comando qui sotto. La CLI comprime la cartella corrente, escludendo ciò che elenca squarecloud.ignore, e la carica:

squarecloud upload

Per caricare uno zip che hai creato tu, passalo con --file:

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

Conferma che la tua app sia online

Il primo deploy richiede di solito meno di un minuto. Controlla lo stato e i log della tua applicazione direttamente dal terminale:

squarecloud app status
squarecloud app logs

Se hai fatto il deploy di un sito web o di un’API, apri https://<tuo-sottodominio>.squareweb.app nel tuo browser: dovresti vedere la tua applicazione rispondere. Se hai fatto il deploy di un bot, invia un comando per confermare che sia online.

La tua app non si avvia? Consulta la guida alla risoluzione dei problemi per le cause più comuni e le relative soluzioni.

Prossimi passi

Variabili d'ambiente

Tieni segreti e impostazioni fuori dal codice e leggili in fase di esecuzione.

Dominio personalizzato

Pubblica la tua app sul tuo dominio, dal piano Standard in su.

Risoluzione dei problemi

Sistema un’app che non si avvia o un sito che non risponde.

Contattaci

Se continui a riscontrare difficoltà tecniche, il nostro team di supporto specializzato è disponibile ad assisterti. Contattaci e saremo felici di aiutarti a risolvere qualsiasi problema: la qualità del supporto è una parte importante del motivo per cui gli sviluppatori valutano Square Cloud 4,9/5 su 402 recensioni su Google e Trustpilot.

Servizi

Risoluzione dei problemi

Runtimes

Piattaforma

Changelog

Ospita un'app o un bot C# / .NET

Prima di iniziare

Configurare Square Cloud

Riferimento del file di configurazione

Cosa esegue Square Cloud

Porta e host per siti web e API

Preparare il progetto

File richiesti

Cosa lasciare fuori

Risoluzione dei problemi

Deploy

Tramite dashboard

Tramite CLI

Guida al file di configurazione

Prossimi passi

Variabili d'ambiente

Dominio personalizzato

Risoluzione dei problemi

Contattaci

​Prima di iniziare

​Configurare Square Cloud

Riferimento del file di configurazione

​Cosa esegue Square Cloud

​Porta e host per siti web e API

​Preparare il progetto

​File richiesti

​Cosa lasciare fuori

​Risoluzione dei problemi

​Deploy

​Tramite dashboard

​Tramite CLI

Guida al file di configurazione

​Prossimi passi

Variabili d'ambiente

Dominio personalizzato

Risoluzione dei problemi

​Contattaci

Prima di iniziare

Configurare Square Cloud

Cosa esegue Square Cloud

Porta e host per siti web e API

Preparare il progetto

File richiesti

Cosa lasciare fuori

Risoluzione dei problemi

Deploy

Tramite dashboard

Tramite CLI

Prossimi passi

Contattaci