Déployer une app, une API ou un bot Go

​

Avant de commencer

• Go sur votre machine. Si ce n’est pas le cas, téléchargez-le depuis le site officiel de Go.
• Un compte Square Cloud : inscrivez-vous avec votre e-mail ou GitHub.
• Un plan actif. Consultez les plans et choisissez celui qui convient à votre projet.

​

Configurer 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

​

Ce que Square Cloud exécute

• Si le champ START n’est pas défini dans le fichier de configuration, Square Cloud exécutera go run MAIN pour compiler et exécuter le fichier Go spécifié dans MAIN. Si le champ START est défini, la valeur qu’il contient sera exécutée directement. Pour plus d’informations sur les paramètres du fichier de configuration, consultez les paramètres de configuration.
• go run MAIN ne compile que le fichier défini dans MAIN. Si votre package main est réparti sur plusieurs fichiers, définissez START=go run ..
• Square Cloud n’exécute pas go mod tidy : exécutez-le sur votre machine avant l’envoi afin que go.mod et go.sum listent toutes les dépendances. go run télécharge ces modules au démarrage de l’application.

​

Port et hôte pour les sites web et les 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))
}

​

Préparer le projet

​

Fichiers requis

• squarecloud.app, à la racine du ZIP.
• main.go, ou le fichier défini dans MAIN.
• go.mod, ou go.work pour un workspace : un envoi sans l’un ni l’autre échoue avec INVALID_DEPENDENCY.
• go.sum, obligatoire lorsque votre module a des dépendances.

​

Ce qu’il faut exclure

• Les binaires compilés (fichiers .exe ou résultat de go build) : Square Cloud compile lui-même le programme.
• vendor/, sauf si votre build l’utilise volontairement : go run télécharge les modules listés dans go.sum.

​

Dépannage

​

Déployer

​

Via le tableau de bord

1

Accéder à la page d'upload

Accédez à la page d’upload et téléversez le fichier zip de votre projet.

2

Configurer votre environnement

Après avoir téléversé votre zip, vous devrez configurer le nom, le fichier principal ou l’environnement d’exécution ainsi que d’autres paramètres de votre projet.
Si vous téléversez un projet web, veillez à sélectionner « Publication Web » et à définir un sous-domaine pour votre projet.

3

Déployer votre projet

Enfin, cliquez sur le bouton « Deploy » pour héberger votre projet sur Square Cloud.
Une fois le déploiement effectué, vous pouvez suivre l’état et les logs de votre projet depuis le tableau de bord.

4

Confirmez que votre application est en ligne

Votre premier déploiement prend généralement moins d’une minute. Dans le tableau de bord, attendez que le statut de votre application affiche « en cours d’exécution » et vérifiez les logs pour détecter d’éventuelles erreurs de démarrage.
Si vous avez déployé un site web ou une API, ouvrez https://<votre-sous-domaine>.squareweb.app dans votre navigateur, vous devriez voir votre application répondre. Si vous avez déployé un bot, envoyez-lui une commande pour confirmer qu’il est en ligne.

Votre application ne démarre pas ? Consultez le guide de dépannage pour les causes les plus courantes et leurs solutions.

​

Via 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

​

Prochaines étapes

​

Contactez-nous