Aloja una app o bot de C# / .NET

El runtime de .NET ejecuta bots, workers, APIs y sitios web en C# sobre .NET 10. Square Cloud restaura tus paquetes NuGet y luego compila y ejecuta tu proyecto con dotnet run.

Antes de empezar

El SDK de .NET en tu máquina. Si no lo tienes, descárgalo desde el sitio web oficial de .NET.
Una cuenta de Square Cloud: regístrate con tu email o GitHub.
Un plan activo. Consulta los planes y elige el que se ajuste a tu proyecto.

Configurar Square Cloud

Si subes tu aplicación a través del dashboard, puedes omitir esta sección: el dashboard crea el archivo de configuración squarecloud.app por ti.

Referencia del archivo de configuración

El archivo squarecloud.app le indica a Square Cloud cómo ejecutar tu aplicación: su archivo principal, la memoria, la versión del runtime, el nombre y, para un sitio web, su subdominio.

Apunta MAIN a tu archivo de proyecto. Un archivo de configuración completo para cada tipo de app:

Bot o worker
Sitio 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

Qué ejecuta Square Cloud

Si el campo START no está definido en el archivo de configuración, Square Cloud ejecuta dotnet restore para restaurar las dependencias del proyecto y luego dotnet run --project MAIN para compilar y ejecutar el proyecto especificado en MAIN. Si el campo START está definido, el valor que contenga se ejecutará directamente. Para obtener más información sobre los parámetros del archivo de configuración, visita parámetros de configuración.

Puerto y host para sitios web y APIs

ASP.NET Core no escucha en el puerto 80 por defecto, y dotnet run aplica las URLs de Properties/launchSettings.json, que apuntan a localhost. Define la dirección en Program.cs: Square Cloud define la variable de entorno PORT como 80, y 0.0.0.0 acepta conexiones desde fuera del contenedor.

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}");

Preparar el proyecto

Archivos necesarios

squarecloud.app, en la raíz del ZIP.
Tu archivo de proyecto (.csproj) y el código fuente.

Si el archivo .csproj está dentro de una carpeta, mantén el archivo de configuración en la raíz del zip y define MAIN con su ruta, por ejemplo MAIN=folder/file.csproj. El comando predeterminado ejecuta primero dotnet restore en la raíz, que necesita ahí un archivo de proyecto o de solución; si la raíz no tiene ninguno, define START=dotnet run --project folder/file.csproj.

El archivo de configuración (squarecloud.app) debe ubicarse en la raíz del archivo zip. De lo contrario, Square Cloud no podrá encontrarlo durante el deploy.

Qué dejar fuera

bin/ y obj/: salida del build que dotnet run vuelve a crear en el servidor.

Solución de problemas

El sitio no responde

La app escucha en otro puerto o solo en localhost. Define la dirección con app.Run($"http://0.0.0.0:{port}") como se muestra en Puerto y host.

MSB1003: Specify a project or solution file

dotnet restore no encontró ningún archivo de proyecto o de solución en la raíz del ZIP. Mueve el .csproj a la raíz, o define START=dotnet run --project folder/file.csproj.

Para otros problemas, consulta Solución de problemas.

Hacer deploy

A través del panel

Accede a la página de subida

Accede a la página de subida y sube el archivo zip de tu proyecto.

Configura tu entorno

Después de subir tu zip, deberás configurar el nombre, el archivo principal o el entorno de ejecución y otros ajustes de tu proyecto.
Si estás subiendo un proyecto web, asegúrate de seleccionar “Publicación Web” y de definir un subdominio para tu proyecto.

Despliega tu proyecto

Por último, haz clic en el botón “Deploy” para alojar tu proyecto en Square Cloud.
Tras el despliegue, puedes monitorear el estado y los logs de tu proyecto desde el panel.

Confirma que tu aplicación esté en vivo

Tu primer despliegue suele tardar menos de un minuto. En el dashboard, espera a que el estado de tu aplicación muestre “running” y revisa los logs por si hay errores de inicio.
Si desplegaste un sitio web o una API, abre https://<tu-subdominio>.squareweb.app en tu navegador: deberías ver tu aplicación respondiendo. Si desplegaste un bot, envíale un comando para confirmar que esté online.

¿La aplicación no inicia? Consulta la guía de solución de problemas para ver las causas y soluciones más comunes.

A través de la CLI

Para usar este método, tu proyecto necesita un archivo de configuración llamado squarecloud.app en su raíz. Le indica a Square Cloud cómo ejecutar tu aplicación.

Guía del archivo de configuración

Aprende a crear el archivo de configuración squarecloud.app que define el entorno de tu aplicación.

Instala la CLI

Instala la CLI de Square Cloud. Si ya la tienes, ejecuta el mismo comando para actualizarla:

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

npm install -g @squarecloud/cli@latest

Inicia sesión

Ejecuta el comando de abajo. Abre tu navegador: aprueba el inicio de sesión allí y la CLI queda lista. No hay ninguna clave de API que copiar. Para scripts y CI, consulta autenticación de la CLI.

squarecloud auth login

Sube tu proyecto

Desde la carpeta de tu proyecto, ejecuta el comando de abajo. La CLI comprime la carpeta actual en un zip, dejando fuera lo que lista squarecloud.ignore, y lo sube:

squarecloud upload

Para subir un zip que creaste tú mismo, pásalo con --file:

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

Confirma que tu aplicación esté en vivo

Tu primer despliegue suele tardar menos de un minuto. Revisa el estado y los logs de tu aplicación directamente desde la terminal:

squarecloud app status
squarecloud app logs

Si desplegaste un sitio web o una API, abre https://<tu-subdominio>.squareweb.app en tu navegador: deberías ver tu aplicación respondiendo. Si desplegaste un bot, envíale un comando para confirmar que esté online.

¿La aplicación no inicia? Consulta la guía de solución de problemas para ver las causas y soluciones más comunes.

Próximos pasos

Variables de entorno

Mantén secretos y ajustes fuera de tu código y léelos en tiempo de ejecución.

Dominio personalizado

Sirve tu app en tu propio dominio, desde el plan Standard.

Solución de problemas

Arregla una app que no inicia o un sitio que no responde.

Contáctanos

Si continúas enfrentando dificultades técnicas, nuestro equipo de soporte especializado está disponible para ayudarte. Contáctanos y estaremos encantados de ayudarte a resolver cualquier problema: la calidad del soporte es una gran parte de por qué los desarrolladores califican a Square Cloud con 4.9/5 en 402 reseñas en Google y Trustpilot.

Servicios

Solución de problemas

Runtimes

Plataforma

Changelog

Aloja una app o bot de C# / .NET

Antes de empezar

Configurar Square Cloud

Referencia del archivo de configuración

Qué ejecuta Square Cloud

Puerto y host para sitios web y APIs

Preparar el proyecto

Archivos necesarios

Qué dejar fuera

Solución de problemas

Hacer deploy

A través del panel

A través de la CLI

Guía del archivo de configuración

Próximos pasos

Variables de entorno

Dominio personalizado

Solución de problemas

Contáctanos

​Antes de empezar

​Configurar Square Cloud

Referencia del archivo de configuración

​Qué ejecuta Square Cloud

​Puerto y host para sitios web y APIs

​Preparar el proyecto

​Archivos necesarios

​Qué dejar fuera

​Solución de problemas

​Hacer deploy

​A través del panel

​A través de la CLI

Guía del archivo de configuración

​Próximos pasos

Variables de entorno

Dominio personalizado

Solución de problemas

​Contáctanos

Antes de empezar

Configurar Square Cloud

Qué ejecuta Square Cloud

Puerto y host para sitios web y APIs

Preparar el proyecto

Archivos necesarios

Qué dejar fuera

Solución de problemas

Hacer deploy

A través del panel

A través de la CLI

Próximos pasos

Contáctanos