Haz deploy de una app, API o bot de Go

​

Antes de empezar

• Go en tu máquina. Si no lo tienes, descárgalo desde el sitio web oficial de Go.
• 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

MAIN=main.go
MEMORY=256
VERSION=recommended
DISPLAY_NAME=My bot

MAIN=main.go
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 ejecutará go run MAIN para compilar y ejecutar el archivo Go 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.
• go run MAIN compila solo el archivo definido en MAIN. Si tu paquete main está dividido en varios archivos, define START=go run ..
• Square Cloud no ejecuta go mod tidy: ejecútalo en tu máquina antes de subir para que go.mod y go.sum incluyan todas las dependencias. go run descarga esos módulos cuando la app inicia.

​

Puerto y host para sitios web y APIs

package main

import (
	"fmt"
	"log"
	"net/http"
	"os"
)

func main() {
	// Square Cloud sets PORT=80. ":" + port listens on all network interfaces.
	port := os.Getenv("PORT")
	if port == "" {
		port = "80"
	}

	http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
		fmt.Fprintln(w, "Hello, World!")
	})

	log.Fatal(http.ListenAndServe(":"+port, nil))
}

​

Preparar el proyecto

​

Archivos necesarios

• squarecloud.app, en la raíz del ZIP.
• main.go, o el archivo definido en MAIN.
• go.mod, o go.work para un workspace: una subida sin ninguno de los dos falla con INVALID_DEPENDENCY.
• go.sum, obligatorio cuando tu módulo tiene dependencias.

​

Qué dejar fuera

• Binarios compilados (archivos .exe o la salida de go build): Square Cloud compila el programa por su cuenta.
• vendor/, salvo que tu build lo use a propósito: go run descarga los módulos listados en go.sum.

​

Solución de problemas

​

Hacer deploy

​

A través del panel

1

Accede a la página de subida

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

2

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.

3

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.

4

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

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

​

Próximos pasos

​

Contáctanos