هاست Go با باینری استاتیک

Go همان‌طور که باید اجرا شود

go.mod در ریشه یعنی پروژه‌ی Go. نسخه‌ی کامپایلر از خط go در go.mod خوانده می‌شود، ماژول‌ها از پروکسی داخلی Go دانلود می‌شوند و برنامه با CGO_ENABLED=0 و -ldflags="-s -w" کامپایل می‌شود.

باینری حاصل در یک ایمیج scratch قرار می‌گیرد که جز خود برنامه چیزی ندارد. Gin، Echo، Fiber، Chi و net/http بدون تغییر اجرا می‌شوند؛ فقط پورت را از PORT بخوانید.

مسیر بیلد Go

1. تشخیص

   go.mod در ریشه.

   go.mod

2. دانلود ماژول‌ها

   ماژول‌ها از پروکسی داخلی Go گرفته می‌شوند.

   go mod download

3. کامپایل

   باینری استاتیک و بدون سمبل ساخته می‌شود.

   CGO_ENABLED=0 go build

4. اجرا

   باینری روی ایمیج scratch اجرا می‌شود.

   /server

خروجی یک استقرار واقعی

$ sakoocloud deploy
✔ Packed 0.1MB
✔ Source uploaded
ℹ Build started · dep_7k2m9q
#4 [builder 1/5] FROM golang:1.22-alpine
#6 [builder 3/5] RUN go mod download
#8 [builder 4/5] RUN CGO_ENABLED=0 go build -ldflags="-s -w" -o /server
#10 [stage-1 1/1] COPY --from=builder /server /server
#12 exporting to image
✔ Deployed — app is running.
→ https://my-go-api.sakooapps.ir

کمترین چیزی که لازم دارید

پورت را از متغیر PORT بخوانید.

package main

import (
	"net/http"
	"os"
)

func main() {
	port := os.Getenv("PORT")
	if port == "" {
		port = "8080"
	}
	http.HandleFunc("/health", func(w http.ResponseWriter, r *http.Request) {
		w.Write([]byte(`{"ok":true}`))
	})
	http.ListenAndServe(":"+port, nil)
}

sakoocloud apps create --name my-go-api --runtime go --port 8080
sakoocloud deploy

تنظیمات

اتصال به دیتابیس

بعد از لینک کردن دیتابیس، DATABASE_URL را با os.Getenv بخوانید.

sakoocloud apps link-db <db-id> --app my-go-api

pool, err := pgxpool.New(ctx, os.Getenv("DATABASE_URL"))
if err != nil {
	log.Fatal(err)
}

همراه هر استقرار

این‌ها به رانتایم بستگی ندارند و برای هر اپ روی سکو کلود فعال‌اند. بعضی، مثل مقیاس‌دهی خودکار و کران‌جاب، به پلن بستگی دارند.

• دامنه‌ی اختصاصی و SSLدامنه را اضافه کنید؛ گواهی خودکار صادر و تمدید می‌شود.
• متغیرهای محیطی و سکرتمقادیر رمزگذاری‌شده فقط در زمان اجرا به اپ می‌رسند.
• مرحله‌ی انتشارmigration بعد از بیلد و پیش از جایگزینی نسخه‌ی قبلی اجرا می‌شود.
• لاگ زندهلاگ بیلد و زمان اجرا، در CLI و کنسول.
• بازگشت به نسخه‌ی قبلهر استقرار قبلی با یک دستور برمی‌گردد.
• مقیاس‌دهیمنابع و تعداد نمونه‌ها را تغییر دهید یا خودکارش کنید.
• دیسک ماندگاربرای فایل‌هایی که باید بعد از هر استقرار بمانند.
• کران‌جابدستور زمان‌بندی‌شده با همان ایمیج و متغیرها.
• استقرار خودکار با گیتهر push روی شاخه‌ی هدف بیلد و مستقر می‌شود.

خطاهای رایج

http.ListenAndServe(":"+os.Getenv("PORT"), nil)

پرسش‌های متداول

جزئیات بیشتر در راهنمای Go در مستندات و مرجع CLI.