استقرار برنامه Go در لیارا

در ابتدا، پس از ساخت برنامه بایستی تمام فایل‌ها و پوشه‌هایی که قصد ندارید در لیارا آپلود شوند را، از پروژه پاک کنید. به عنوان مثال، باید پوشه vendor و فایل‌هایی که پسوند آن‌ها exe. است را از پروژه خود پاک کنید؛ چرا که لیارا در حین فرایند استقرار، آن‌ها را برای شما (در صورت نیاز) ایجاد خواهد کرد. به صورت کلی، اگر که در پروژه خود فایلی به نام gitignore. دارید، کافیست تا فایل‌های و دایرکتوری‌های اشاره شده در این فایل را، از پروژه خود پاک کنید.

همچنین، اگر از کتابخانه یا پکیج خاصی در پروژه خود، استفاده می‌کنید که به صورت built-in یا پیش‌فرض در نسخه Go مدنظرتان وجود ندارد، پروژه شما باید شامل فایل go.mod باشد؛ لیارا، در حین فرایند استقرار، به صورت خودکار این فایل را پیدا می‌کند و با اجرای دستور go mod download تمامی ماژول‌های تعریف شده در این فایل را، برای‌تان نصب می‌کند. قطعه کد زیر، می‌تواند یک نمونه از فایل go.mod برای برنامه‌های Go باشد:

module example.com/myapp

go 1.20

require (
  github.com/gin-gonic/gin v1.9.0
  github.com/jinzhu/gorm v1.9.16
)

اگر که فایل go.mod در پروژه‌تان وجود ندارد، می‌توانید با اجرای دستور زیر، این فایل را ایجاد کنید:

go mod init <project_name>

در قطعه کد فوق، به جای عبارت <project_name>، بایستی نام پروژه خود را وارد کنید. همچنین، برای اصلاح فایل go.mod و جلوگیری از نصب پکیج‌های اضافی یا نصب نسخه‌های قدیمی، توصیه می‌شود که حتماً قبل از استقرار، دستور زیر را در مسیر اصلی پروژه، اجرا کنید:

go mod tidy

فایل go.sum لیستی از نسخه‌های دقیق ماژول‌های مورد نیاز پروژه را همراه با هش آن‌ها ذخیره می‌کند. این فایل تضمین می‌کند که همه سیستم‌ها از نسخه‌های یکسان و امن ماژول‌ها استفاده کنند. بنابراین، اگر که در برنامه‌تان، ماژولی را نصب کرده‌اید، باید این فایل نیز، در مسیر اصلی پروژ‌تان، وجود داشته باشد. قطعه کد زیر، می‌تواند یک نمونه از فایل go.sum برای برنامه‌های Go باشد:

github.com/gin-gonic/gin v1.9.0 h1:D9T8CZpdy7JHe7OfLM/JIQJlOGTNSG3SuRs+0IM2C7s=
github.com/gin-gonic/gin v1.9.0/go.mod h1:1eP7mI15tlNlAlSuYfXOhSThAPchDwrw2UeiT4ssShg=
github.com/jinzhu/gorm v1.9.16 h1:PyN03m0AMVE19QIppt4JHa2tiEaQnpFUK5CuBOw35sM=
github.com/jinzhu/gorm v1.9.16/go.mod h1:vnPOBfZMgAjq0QC2Rt8zgzoxzJKTKmSUHL0dRgmPeJ4=

برای ایجاد این فایل نیز کافیست تا قبل از استقرار پروژه‌تان، دستور زیر را در مسیر اصلی پروژه اجرا کنید:

go get <project_name>

در قطعه کد فوق، به جای <project_name> باید نام پروژه خود را که در فایل go.mod ثبت شده است، وارد کنید.

در ادامه، بایستی پوشه پروژه خود را درون یک فایل zip قرار بدهید؛ سپس در برنامه خود، بر روی گزینه استقرار جدید کلیک کرده؛ وارد تب Drag & Drog شوید و فایل zip را آپلود کنید تا وارد مرحله بعدی استقرار شوید:

پس از آپلود پروژه، باید شخصی‌سازی‌های پروژه را در برنامه خود، لحاظ کنید.

در انتها، به صورت مستقیم به صفحه تاریخچه برنامه هدایت می‌شوید که می‌توانید لاگ‌های مربوط به استقرار را در آن، مشاهده بفرمایید.

پس از ساخت برنامه، باید در مسیر اصلی پروژه، یک فایل به نام liaraignore. یا gitignore. ایجاد کنید و درون آن، اسامی تمامی فایل‌ها یا پوشه‌هایی که قصد ندارید در لیارا آپلود شوند را، وارد کنید؛ به عنوان مثال، نیازی به آپلود پوشه vendor و فایل‌هایی که پسوند آن‌ها exe. می‌باشد، نیست. چرا که لیارا در حین استقرار برنامه، آن‌ها را برای شما می‌سازد؛ پس بایستی اسامی این دایرکتوری‌ها در یکی از دو فایل فوق، نوشته شود؛ قطعه کد قرار گرفته در لینک زیر، یک gitignore. عالی برای برنامه‌های Go است که می‌توانید از آن، استفاده کنید:

همچنین، اگر از کتابخانه یا پکیج خاصی در پروژه خود، استفاده می‌کنید که به صورت built-in یا پیش‌فرض در نسخه go مدنظرتان وجود ندارد، پروژه شما باید شامل فایل go.mod باشد؛ لیارا، در حین فرایند استقرار، به صورت خودکار این فایل را پیدا می‌کند و با اجرای دستور go mod download تمامی ماژول‌های تعریف شده در این فایل را، برای‌تان نصب می‌کند. قطعه کد زیر، می‌تواند یک نمونه از فایل go.mod برای برنامه‌های go باشد:

module example.com/myapp

go 1.20

require (
  github.com/gin-gonic/gin v1.9.0
  github.com/jinzhu/gorm v1.9.16
)

اگر که فایل go.mod در پروژه‌تان وجود ندارد، می‌توانید با اجرای دستور زیر، این فایل را ایجاد کنید:

go mod init <project_name>

در قطعه کد فوق، به جای عبارت <project_name>، بایستی نام پروژه خود را وارد کنید. همچنین، برای اصلاح فایل go.mod و جلوگیری از نصب پکیج‌های اضافی یا نصب نسخه‌های قدیمی، توصیه می‌شود که حتماً قبل از استقرار، دستور زیر را در مسیر اصلی پروژه، اجرا کنید:

go mod tidy

فایل go.sum لیستی از نسخه‌های دقیق ماژول‌های مورد نیاز پروژه را همراه با هش آن‌ها ذخیره می‌کند. این فایل تضمین می‌کند که همه سیستم‌ها از نسخه‌های یکسان و امن ماژول‌ها استفاده کنند. بنابراین، اگر که در برنامه‌تان، ماژولی را نصب کرده‌اید، باید این فایل نیز، در مسیر اصلی پروژ‌تان، وجود داشته باشد. قطعه کد زیر، می‌تواند یک نمونه از فایل go.sum برای برنامه‌های Go باشد:

github.com/gin-gonic/gin v1.9.0 h1:D9T8CZpdy7JHe7OfLM/JIQJlOGTNSG3SuRs+0IM2C7s=
github.com/gin-gonic/gin v1.9.0/go.mod h1:1eP7mI15tlNlAlSuYfXOhSThAPchDwrw2UeiT4ssShg=
github.com/jinzhu/gorm v1.9.16 h1:PyN03m0AMVE19QIppt4JHa2tiEaQnpFUK5CuBOw35sM=
github.com/jinzhu/gorm v1.9.16/go.mod h1:vnPOBfZMgAjq0QC2Rt8zgzoxzJKTKmSUHL0dRgmPeJ4=

برای ایجاد این فایل نیز کافیست تا قبل از استقرار پروژه‌تان، دستور زیر را در مسیر اصلی پروژه اجرا کنید:

go get <project_name>

در قطعه کد فوق، به جای <project_name> باید نام پروژه خود را که در فایل go.mod ثبت شده است، وارد کنید.

لیارا به صورت خودکار در مسیر اصلی پروژه، فایل با نام main.go را پیدا می‌کند و پس از build پروژه، با اجرای دستور go run، فایل اصلی را اجرا می‌کند. در صورتی که نام فایل اصلی برنامه‌تان چیز دیگری است؛ باید نام آن را در فیلدی به نام mainFile در فایل liara.json به همراه پسوند go.، مانند شکل زیر، وارد کنید:

{
"go" : {
  "mainFile" : "app.go"
 }
}

برای تعیین نسخه go برنامه خود نیز، کافیست تا در فایل liara.json فیلد version را قرار دهید:

{
"go": {
  "version": "1.22"
}
}

به صورت پیش‌فرض، منطقه‌ی زمانی برنامه‌تان بر روی Asia/Tehran تنظیم شده است؛ برای تغییر مقدار پیش‌فرض، می‌توانید از پارامتر timezone در فایل liara.json استفاده کنید؛ به عنوان مثال:

{
  "go": {
    "timezone": "America/Los_Angeles"
}
}

در نهایت، یک فایل liara.json می‌تواند مانند قطعه کد زیر باشد:

{
"app": "my-go-app", 
"platform": "go",
"port": 8080,
"go": {
  "mainFile" : "app.go",
  "version": "1.23",
  "timezone": "America/Los_Angeles"
}
}

در صورتی که قصد دارید برنامه‌تان را در تیم مدنظرتان، مستقر کنید، باید فیلد team-idرا به فایل liara.json مانند شکل زیر، اضافه کنید. مقدار این فیلد، باید شناسه تیم شما در لیارا باشد:

{
  "team-id": "your-team-id"
}

اکنون کافیست تا در مسیر اصلی پروژه و جایی که فایل liara.json قرار دارد؛ دستور زیر را اجرا کنید و منتظر بمانید تا عملیات استقرار تمام شود:

liara deploy

در حین فرایند استقرار، می‌توانید در ترمینال خود، لاگ‌های مربوط به آن را مشاهده بفرمایید.

پس از ساخت برنامه، باید در مسیر اصلی پروژه، یک فایل به نام liaraignore. یا gitignore. ایجاد کنید و درون آن، اسامی تمامی فایل‌ها یا پوشه‌هایی که قصد ندارید در لیارا آپلود شوند را، وارد کنید؛ به عنوان مثال، نیازی به آپلود پوشه vendor و فایل‌هایی که پسوند آن‌ها exe. می‌باشد، نیست. چرا که لیارا در حین استقرار برنامه، آن‌ها را برای شما می‌سازد؛ پس بایستی اسامی این دایرکتوری‌ها در یکی از دو فایل فوق، نوشته شود؛ قطعه کد قرار گرفته در لینک زیر، یک gitignore. عالی برای برنامه‌های Go است که می‌توانید از آن، استفاده کنید:

همچنین، اگر از کتابخانه یا پکیج خاصی در پروژه خود، استفاده می‌کنید که به صورت built-in یا پیش‌فرض در نسخه go مدنظرتان وجود ندارد، پروژه شما باید شامل فایل go.mod باشد؛ لیارا، در حین فرایند استقرار، به صورت خودکار این فایل را پیدا می‌کند و با اجرای دستور go mod download تمامی ماژول‌های تعریف شده در این فایل را، برای‌تان نصب می‌کند. قطعه کد زیر، می‌تواند یک نمونه از فایل go.mod برای برنامه‌های go باشد:

module example.com/myapp

go 1.20

require (
  github.com/gin-gonic/gin v1.9.0
  github.com/jinzhu/gorm v1.9.16
)

اگر که فایل go.mod در پروژه‌تان وجود ندارد، می‌توانید با اجرای دستور زیر، این فایل را ایجاد کنید:

go mod init <project_name>

در قطعه کد فوق، به جای عبارت <project_name>، بایستی نام پروژه خود را وارد کنید. همچنین، برای اصلاح فایل go.mod و جلوگیری از نصب پکیج‌های اضافی یا نصب نسخه‌های قدیمی، توصیه می‌شود که حتماً قبل از استقرار، دستور زیر را در مسیر اصلی پروژه، اجرا کنید:

go mod tidy

فایل go.sum لیستی از نسخه‌های دقیق ماژول‌های مورد نیاز پروژه را همراه با هش آن‌ها ذخیره می‌کند. این فایل تضمین می‌کند که همه سیستم‌ها از نسخه‌های یکسان و امن ماژول‌ها استفاده کنند. بنابراین، اگر که در برنامه‌تان، ماژولی را نصب کرده‌اید، باید این فایل نیز، در مسیر اصلی پروژ‌تان، وجود داشته باشد. قطعه کد زیر، می‌تواند یک نمونه از فایل go.sum برای برنامه‌های Go باشد:

github.com/gin-gonic/gin v1.9.0 h1:D9T8CZpdy7JHe7OfLM/JIQJlOGTNSG3SuRs+0IM2C7s=
github.com/gin-gonic/gin v1.9.0/go.mod h1:1eP7mI15tlNlAlSuYfXOhSThAPchDwrw2UeiT4ssShg=
github.com/jinzhu/gorm v1.9.16 h1:PyN03m0AMVE19QIppt4JHa2tiEaQnpFUK5CuBOw35sM=
github.com/jinzhu/gorm v1.9.16/go.mod h1:vnPOBfZMgAjq0QC2Rt8zgzoxzJKTKmSUHL0dRgmPeJ4=

برای ایجاد این فایل نیز کافیست تا قبل از استقرار پروژه‌تان، دستور زیر را در مسیر اصلی پروژه اجرا کنید:

go get <project_name>

در قطعه کد فوق، به جای <project_name> باید نام پروژه خود را که در فایل go.mod ثبت شده است، وارد کنید.

لیارا به صورت خودکار در مسیر اصلی پروژه، فایل با نام main.go را پیدا می‌کند و پس از build پروژه، با اجرای دستور go run، فایل اصلی را اجرا می‌کند. در صورتی که نام فایل اصلی برنامه‌تان چیز دیگری است؛ می‌توانید در مسیر اصلی پروژه، یک فایل به نام liara.json ایجاد کنید و نام فایل اصلی خود را در فیلدی به نام mainFile در فایل liara.json به همراه پسوند go.، مانند شکل زیر، وارد کنید:

{
"go" : {
  "mainFile" : "app.go"
 }
}

اگر که برنامه‌تان وب‌سرور است و در پورت خاصی (به جز ۸۰۸۰) به درخواست کاربران گوش می‌دهد، باید در فیلد port، پورت برنامه را مشخص کنید. البته اگر که برنامه‌تان نیازی به پورت ندارد، نیازی به نوشتن این فیلد نخواهید داشت:

{
  "port": 8000
}

برای تعیین نسخه go برنامه خود نیز، کافیست تا در فایل liara.json فیلد version را قرار دهید:

{
"go": {
  "version": "1.23"
}
}

به صورت پیش‌فرض، منطقه‌ی زمانی برنامه‌تان بر روی Asia/Tehran تنظیم شده است؛ برای تغییر مقدار پیش‌فرض، می‌توانید از پارامتر timezone در فایل liara.json استفاده کنید؛ به عنوان مثال:

{
  "go": {
    "timezone": "America/Los_Angeles"
}
}

در نهایت، یک فایل liara.json می‌تواند مانند قطعه کد زیر باشد:

{
"port": 8080,
"go": {
  "mainFile" : "main.go",
  "version": "1.23",
  "timezone": "America/Los_Angeles"
}
}

در صورتی که قصد دارید برنامه‌تان را در تیم مدنظرتان، مستقر کنید، باید فیلد team-idرا به فایل liara.json مانند شکل زیر، اضافه کنید. مقدار این فیلد، باید شناسه تیم شما در لیارا باشد:

{
  "team-id": "your-team-id"
}

در ادامه، بایستی یک ریپازیتوری در حساب گیت‌هاب خود برای برنامه‌مدنظرتان با نام دلخواه‌تان ایجاد کنید، برای این کار، پس از ورود به گیت‌هاب، وارد بخش Repositories شوید و بر روی دکمه New کلیک کنید؛ پس از نوشتن نام و توضیحات ریپازیتوری، سطح دسترسی ریپازیتوری را (public یا private)، انتخاب کنید و در نهایت بر روی دکمه create repository کلیک کنید تا ریپازیتوری برای‌تان ساخته شود:

اکنون، باید پروژه نهایی خود را در ریپازیتوری‌تان در گیت‌هاب آپلود کنید؛ حتماً در نظر داشته باشید که درون پروژه‌تان، فایل gitignore. قرار داشته باشد و درون آن، فایل‌های اضافی برنامه، که قصد ندارید آپلود شوند؛ لیست شده باشند. می‌توانید برای آپلود، مانند دستورات زیر در ترمینال ریشه پروژه‌تان، عمل کنید:

git init # تعریف اولیه مخزن در ریشه پروژه

git add . # اضافه کردن تمامی فایل‌ها به استیج

git commit -m "make ready to deploy on liara" # ثبت کامیت

git remote add origin https://github.com/your-account-user/your-repo-name.git # افزودن دسترسی ریموت به مخزن

git push origin master # آپلود پروژه در گیت‌هاب

در ادامه، بایستی حساب لیارا خود را به گیت‌هاب متصل کنید. برای اتصال حساب لیارا خود به گیت‌هاب، در لیارا بر روی پروفایل خود کلیک کرده و وارد زیر قسمت حساب کاربری شوید. در ادامه وارد منوی گیت‌هاب شوید و بر روی دکمه اتصال به گیت‌هاب، کلیک کنید. پس از انجام این کار و وارد کردن اطلاعات مربوط به گیت‌هاب، حساب لیارا شما به گیت‌هاب متصل خواهد شد:

بعد از اتصال به اکانت گیت‌هاب، بر روی گزینه ویرایش دسترسی‌ها کلیک کرده و ریپازیتوری (ریپازیتوری‌های) مدنظرتان را به حساب لیارا متصل کنید.

برای این کار در ابتدا، حساب شخصی یا سازمانی خود را انتخاب کنید؛ سپس در صورتی که قصد دارید تمام ریپازیتوری‌های حساب گیت‌هاب‌تان به لیارا متصل شود؛ گزینه All repositories را انتخاب کنید؛ اما اگر قصد دارید که فقط یک یا چند ریپازیتوری مدنظرتان را انتخاب کنید؛ گزینه Only select repositories را انتخاب کرده و در ادامه ریپازیتوری‌های مدنظرتان را در کشوی باز شده، انتخاب کنید. در نهایت، بر روی گزینه Install & Authorize کلیک کنید تا ریپازیتوری‌های انتخابی، به حساب لیارا، متصل شوند:

در نهایت، بر روی برنامه خود کلیک کرده وارد صفحه استقرار جدید شوید؛ سپس در منوی گیت‌هاب، ریپازیتوری مدنظرتان را انتخاب کرده و پس از انتخاب نوع استقرار (استقرار در صورت CI موفق یا استقرار خودکار) و branch مدنظرتان، بر روی گزینه اتصال به برنامه کلیک کنید تا برنامه‌تان به ریپازیتوری مدنظرتان متصل شود. در نهایت، کافیست تا یک‌بار بر روی گزینه استقرار دستی کلیک کنید تا آخرین commit شما در لیارا مستقر شود:

پس از انجام کارهای فوق، با هر بار push کردن پروژه‌تان در ریپازیتوری انتخاب شده، یک استقرار جدید مطابق آخرین تغییرات شما در لیارا، انجام خواهد شد.