Faça deploy de uma aplicação, API ou bot em Go

​

Antes de começar

• Go na sua máquina. Se ainda não o tiver, baixe-o no site oficial do Go.
• Uma conta na Square Cloud: cadastre-se com seu e-mail ou GitHub.
• Um plano ativo. Veja os planos e escolha o que combina com o seu projeto.

​

Configure a 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

​

O que a Square Cloud executa

• Se o campo START não estiver definido no arquivo de configuração, a Square Cloud executará go run MAIN para compilar e executar o arquivo Go especificado em MAIN. Se o campo START estiver definido, o valor nele será executado diretamente. Para mais informações sobre os parâmetros do arquivo de configuração, visite parâmetros de configuração.
• O go run MAIN compila apenas o arquivo definido em MAIN. Se o seu pacote main estiver dividido em vários arquivos, defina START=go run ..
• A Square Cloud não executa go mod tidy: execute-o na sua máquina antes do upload, para que o go.mod e o go.sum listem todas as dependências. O go run baixa esses módulos quando a aplicação inicia.

​

Porta e host para sites e APIs

package main

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

func main() {
	// A Square Cloud define PORT=80. ":" + port escuta em todas as interfaces de rede.
	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))
}

​

Prepare o projeto

​

Arquivos necessários

• squarecloud.app, na raiz do ZIP.
• main.go, ou o arquivo definido em MAIN.
• go.mod, ou go.work para um workspace Go: um upload sem nenhum dos dois falha com INVALID_DEPENDENCY.
• go.sum, obrigatório quando o seu módulo tem dependências.

​

O que deixar de fora

• Binários compilados (arquivos .exe ou a saída do go build): a Square Cloud compila o programa ela mesma.
• vendor/, a menos que o seu build use essa pasta de propósito: o go run baixa os módulos listados no go.sum.

​

Solução de problemas

​

Faça o deploy

​

Via dashboard

1

Acesse a página de upload

Acesse a página de upload e envie seu arquivo zip.

2

Configure seu ambiente

Após fazer o upload do seu arquivo zip, você precisará configurar o nome, o arquivo principal ou o ambiente de execução e outras configurações do seu projeto.
Se você estiver enviando um projeto web, certifique-se de selecionar “Publicação na Web” e definir um subdomínio para o seu projeto.

3

Faça o deploy do projeto

Por fim, clique no botão “Deploy” para hospedar seu projeto na Square Cloud. Após o deploy, você poderá monitorar o status e os registros do seu projeto no dashboard.

4

Confirme que seu app está no ar

Seu primeiro deploy geralmente leva menos de um minuto. No dashboard, aguarde o status da sua aplicação mudar para em execução e verifique os registros em busca de erros de inicialização.
Se você fez deploy de um site ou API, abra https://<seu-subdominio>.squareweb.app no navegador: você deve ver sua aplicação respondendo. Se você fez deploy de um bot, envie um comando para confirmar que ele está online.

Seu app não está iniciando? Veja o guia de solução de problemas para as causas e correções mais comuns.

​

Via CLI

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

npm install -g @squarecloud/cli@latest

squarecloud auth login

squarecloud upload

squarecloud upload --file <caminho/para/zip>

squarecloud app status
squarecloud app logs

​

Próximos passos

​

Contate-nos