Fai il deploy di un'app, un'API o un bot Go

​

Prima di iniziare

• Go sul tuo computer. Se non lo hai, scaricalo dal sito ufficiale di Go.
• 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

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

​

Cosa esegue Square Cloud

• Se il campo START non è definito nel file di configurazione, Square Cloud eseguirà go run MAIN per compilare ed eseguire il file Go 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.
• go run MAIN compila solo il file indicato in MAIN. Se il tuo package main è diviso in più file, imposta START=go run ..
• Square Cloud non esegue go mod tidy: eseguilo sul tuo computer prima dell’upload, così go.mod e go.sum elencano ogni dipendenza. go run scarica quei moduli all’avvio dell’app.

​

Porta e host per siti web e API

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

​

Preparare il progetto

​

File richiesti

• squarecloud.app, nella radice dello ZIP.
• main.go, o il file indicato in MAIN.
• go.mod, o go.work per un workspace: un upload senza nessuno dei due fallisce con INVALID_DEPENDENCY.
• go.sum, obbligatorio quando il tuo modulo ha dipendenze.

​

Cosa lasciare fuori

• I binari compilati (file .exe o l’output di go build): Square Cloud compila il programma da solo.
• vendor/, a meno che la tua build non lo usi di proposito: go run scarica i moduli elencati in go.sum.

​

Risoluzione dei problemi

​

Deploy

​

Tramite dashboard

1

Accedi alla pagina di upload

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

2

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.

3

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.

4

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

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

​

Prossimi passi

​

Contattaci