From 9b19a74bcac6d24e23f810bc9c53596e4a1a7501 Mon Sep 17 00:00:00 2001 From: Ali Najmabadi Date: Mon, 16 Dec 2024 16:05:34 +0330 Subject: [PATCH] docs: update go platform --- liara_nginx.conf | 3 + package-lock.json | 8 +-- package.json | 2 +- src/pages/paas/go/how-tos/choose-version.mdx | 2 +- src/pages/paas/go/how-tos/deploy-app.mdx | 70 +++++++++++++------- src/pages/paas/go/how-tos/set-cron-job.mdx | 4 +- src/pages/paas/go/how-tos/use-disk.mdx | 7 +- src/pages/paas/go/how-tos/use-websocket.mdx | 8 +-- src/pages/paas/go/quick-start.mdx | 8 +-- src/pages/paas/go/related-apps/beego.mdx | 5 ++ src/pages/paas/go/related-apps/echo.mdx | 7 ++ src/pages/paas/go/related-apps/fiber.mdx | 7 ++ src/pages/paas/go/related-apps/gin.mdx | 7 ++ src/pages/tv/courses/{golang.js => go.js} | 0 14 files changed, 98 insertions(+), 40 deletions(-) rename src/pages/tv/courses/{golang.js => go.js} (100%) diff --git a/liara_nginx.conf b/liara_nginx.conf index 53f2cbd9..ed9fd3ef 100644 --- a/liara_nginx.conf +++ b/liara_nginx.conf @@ -1945,6 +1945,9 @@ location ~ ^/paas/golang/(.*)$ { return 301 /paas/go/$1; } +location ~ ^/tv/courses/golang/?$ { + return 301 /tv/courses/go/; +} diff --git a/package-lock.json b/package-lock.json index d98e160f..5107f687 100644 --- a/package-lock.json +++ b/package-lock.json @@ -8,7 +8,7 @@ "name": "new-docs", "version": "0.1.0", "dependencies": { - "@liara/platformicons": "^3.12.0", + "@liara/platformicons": "^3.13.0", "@mdx-js/loader": "^3.0.1", "@mdx-js/react": "^3.0.1", "@next/mdx": "^14.2.3", @@ -110,9 +110,9 @@ } }, "node_modules/@liara/platformicons": { - "version": "3.12.0", - "resolved": "https://registry.npmjs.org/@liara/platformicons/-/platformicons-3.12.0.tgz", - "integrity": "sha512-1oelyDnEBsKxFfqSrmVpQfOQap1WQr3qzTtRqcJWZdEjvBKo4NECEH6LKvEWgV2nM3F5Cd5WYS+pjL9O5ZtL7A==" + "version": "3.13.0", + "resolved": "https://registry.npmjs.org/@liara/platformicons/-/platformicons-3.13.0.tgz", + "integrity": "sha512-RCzKMhZZztXG5VrAks7VmVNdqUsStiDdqlHMDsSQ+IIP09e9ftbABwamd7tigx9sJ0qc7bIy6E1opU8K4mZrxQ==" }, "node_modules/@mdx-js/loader": { "version": "3.0.1", diff --git a/package.json b/package.json index d4564914..ed90068a 100644 --- a/package.json +++ b/package.json @@ -10,7 +10,7 @@ "sitemap": "node sitemap/generate.js" }, "dependencies": { - "@liara/platformicons": "^3.12.0", + "@liara/platformicons": "^3.13.0", "@mdx-js/loader": "^3.0.1", "@mdx-js/react": "^3.0.1", "@next/mdx": "^14.2.3", diff --git a/src/pages/paas/go/how-tos/choose-version.mdx b/src/pages/paas/go/how-tos/choose-version.mdx index ef40f2ec..e8572638 100644 --- a/src/pages/paas/go/how-tos/choose-version.mdx +++ b/src/pages/paas/go/how-tos/choose-version.mdx @@ -57,7 +57,7 @@ import Head from "next/head"; content={[ <>

پس از بارگذاری پروژه خود در لیارا، کافیست تا در مرحله انتخاب نسخه، نسخه مورد نظر برنامه‌تان را انتخاب کنید.

- {/* how to choose version in liara console */} + how to choose version in liara console , <>

diff --git a/src/pages/paas/go/how-tos/deploy-app.mdx b/src/pages/paas/go/how-tos/deploy-app.mdx index 7f0e677b..6b4b02ba 100644 --- a/src/pages/paas/go/how-tos/deploy-app.mdx +++ b/src/pages/paas/go/how-tos/deploy-app.mdx @@ -79,7 +79,7 @@ require (

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

@@ -92,7 +92,22 @@ github.com/jinzhu/gorm v1.9.16/go.mod h1:vnPOBfZMgAjq0QC2Rt8zgzoxzJKTKmSUHL0dRgm `}
-
+
+

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

+ +
+
+ + {`go get `} + +
+
+

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

+

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

@@ -179,8 +194,8 @@ require (

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

@@ -192,27 +207,22 @@ github.com/jinzhu/gorm v1.9.16/go.mod h1:vnPOBfZMgAjq0QC2Rt8zgzoxzJKTKmSUHL0dRgm `}
-
+

- در ادامه، در مسیر اصلی پروژه، یک فایل به نام liara.json ایجاد کنید و قطعه کد زیر را در آن قرار دهید: + برای ایجاد این فایل نیز کافیست تا قبل از استقرار پروژه‌تان، دستور زیر را در مسیر اصلی پروژه اجرا کنید:

-
+ +
- - {`{ - "app": "my-go-app", - "platform": "go", - "port": 8000 -}`} - + + {`go get `} +
-
+

- در قطعه کد فوق، در فیلد app باید شناسه برنامه خود را به جای my-go-app وارد کنید. - در فیلد platform باید نوع پلتفرم خود را که go است، مشخص کنید. - اگر که برنامه‌تان وب‌سرور است و در پورت خاصی به درخواست کاربران گوش می‌دهد، باید در فیلد port، پورت برنامه را مشخص کنید. - البته اگر که برنامه‌تان نیازی به پورت ندارد، می‌توانید این فیلد را از فایل liara.json، پاک کنید + در قطعه کد فوق، به جای <project_name> باید نام پروژه خود را که در فایل go.mod ثبت شده است، وارد کنید.

+ {/*

@@ -373,10 +383,10 @@ require (

-

+

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

@@ -388,7 +398,21 @@ github.com/jinzhu/gorm v1.9.16/go.mod h1:vnPOBfZMgAjq0QC2Rt8zgzoxzJKTKmSUHL0dRgm `}
-
+
+

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

+ +
+
+ + {`go get `} + +
+
+

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

لیارا به صورت خودکار در مسیر اصلی پروژه، فایل با نام main.go را پیدا می‌کند و پس از build پروژه، با اجرای دستور go run، فایل اصلی را اجرا می‌کند. در صورتی diff --git a/src/pages/paas/go/how-tos/set-cron-job.mdx b/src/pages/paas/go/how-tos/set-cron-job.mdx index 2f4552dc..2e8e3a89 100644 --- a/src/pages/paas/go/how-tos/set-cron-job.mdx +++ b/src/pages/paas/go/how-tos/set-cron-job.mdx @@ -34,7 +34,7 @@ Cron job یک وظیفه زمان‌بندی شده در سیستم‌عامل پس از آپلود پروژه خود در کنسول در بخش تنظیمات پلتفرم، Cron Jobهای خود را تعریف کنید:

- set cron jobs on liara + set cron jobs on liara , @@ -49,7 +49,7 @@ Cron job یک وظیفه زمان‌بندی شده در سیستم‌عامل {`{ "cron": [ - "go run migrate.go >> /dev/null 2>&1" + "* * * * * go run migrate.go >> /dev/null 2>&1" ] }`} diff --git a/src/pages/paas/go/how-tos/use-disk.mdx b/src/pages/paas/go/how-tos/use-disk.mdx index bfe3b175..cab5ee22 100644 --- a/src/pages/paas/go/how-tos/use-disk.mdx +++ b/src/pages/paas/go/how-tos/use-disk.mdx @@ -28,7 +28,12 @@ import Head from "next/head"; controls="controls" className="block w-full" width="100%" /> -
+
+ +

+پروژه و کدهای مورد استفاده در ویدیوی فوق در اینجا قابل مشاهده و دسترسی هستند. +

+
برای استفاده از دیسک‌ها در برنامه‌های go در ابتدا باید طبق مستندات ساخت دیسک، دیسک‌های مدنظر خود را بسازید؛ در ادامه، می‌توانید طبق مستندات تعریف مسیر برای دیسک، دیسک‌های خود را به دایرکتوری‌های مدنظرتان، متصل کنید. diff --git a/src/pages/paas/go/how-tos/use-websocket.mdx b/src/pages/paas/go/how-tos/use-websocket.mdx index efb4be1e..ede4f24e 100644 --- a/src/pages/paas/go/how-tos/use-websocket.mdx +++ b/src/pages/paas/go/how-tos/use-websocket.mdx @@ -283,12 +283,12 @@ func main() { برای استقرار برنامه‌های وب‌سوکت Go در لیارا، نیازی به انجام تغییر خاصی نیست. صرفاً باید به جای استفاده از آدرس ws، عبارت wss را به کار ببرید تا اتصال، ایمن و سازگار باشد. -{/*
*/} -{/* +
+

-سورس کامل یک برنامه Django WebSocket آماده استقرار در اینجا موجود است که می‌توانید از آن استفاده کنید. +سورس کامل یک برنامه Go WebSocket آماده استقرار در اینجا موجود است که می‌توانید از آن استفاده کنید.

-
*/} + \ No newline at end of file diff --git a/src/pages/paas/go/quick-start.mdx b/src/pages/paas/go/quick-start.mdx index 23bf3c17..aa1dbe3c 100644 --- a/src/pages/paas/go/quick-start.mdx +++ b/src/pages/paas/go/quick-start.mdx @@ -70,7 +70,7 @@ import Head from "next/head";

بررسی فایل‌ go.mod و go.sum

در صورتی که از کتابخانه یا پکیج خاصی استفاده می‌کنید که به صورت built-in (پیش‌فرض) در go وجود ندارد، حتماً باید در مسیر اصلی پروژه، فایل go.mod وجود داشته باشد؛ - برای ذخیره hash و نسخه وابستگی‌ها هم توصیه می‌شود از فایل go.sum نیز، استفاده کنید که با نصب اولین پکیج در پروژه‌تان، به صورت خودکار ایجاد یا آپدیت می‌شود. + برای ذخیره hash و نسخه وابستگی‌ها هم باید از فایل go.sum نیز، استفاده کنید که با نصب اولین پکیج در پروژه‌تان، به صورت خودکار ایجاد یا آپدیت می‌شود. اگر که فایل go.mod در پروژه‌تان وجود ندارد، می‌توانید با اجرای دستور زیر، این فایل را ایجاد کنید:

@@ -222,7 +222,7 @@ vendor/`}

بررسی فایل‌ go.mod و go.sum

در صورتی که از کتابخانه یا پکیج خاصی استفاده می‌کنید که به صورت built-in (پیش‌فرض) در go وجود ندارد، حتماً باید در مسیر اصلی پروژه، فایل go.mod وجود داشته باشد؛ - برای ذخیره hash و نسخه وابستگی‌ها هم توصیه می‌شود از فایل go.sum نیز، استفاده کنید که با نصب اولین پکیج در پروژه‌تان، به صورت خودکار ایجاد یا آپدیت می‌شود. + برای ذخیره hash و نسخه وابستگی‌ها هم باید از فایل go.sum نیز، استفاده کنید که با نصب اولین پکیج در پروژه‌تان، به صورت خودکار ایجاد یا آپدیت می‌شود. اگر که فایل go.mod در پروژه‌تان وجود ندارد، می‌توانید با اجرای دستور زیر، این فایل را ایجاد کنید:

@@ -297,10 +297,10 @@ vendor/`} step: "۳", content: ( <> -

بررسی فایل‌ go.mod و go.sum

+

بررسی فایل‌ go.mod و go.sum

در صورتی که از کتابخانه یا پکیج خاصی استفاده می‌کنید که به صورت built-in (پیش‌فرض) در go وجود ندارد، حتماً باید در مسیر اصلی پروژه، فایل go.mod وجود داشته باشد؛ - برای ذخیره hash و نسخه وابستگی‌ها هم توصیه می‌شود از فایل go.sum نیز، استفاده کنید که با نصب اولین پکیج در پروژه‌تان، به صورت خودکار ایجاد و آپدیت می‌شود.. + برای ذخیره hash و نسخه وابستگی‌ها هم باید از فایل go.sum نیز، استفاده کنید که با نصب اولین پکیج در پروژه‌تان، به صورت خودکار ایجاد و آپدیت می‌شود. اگر که فایل go.mod در پروژه‌تان وجود ندارد، می‌توانید با اجرای دستور زیر، این فایل را ایجاد کنید:

diff --git a/src/pages/paas/go/related-apps/beego.mdx b/src/pages/paas/go/related-apps/beego.mdx index 8e3a006e..01bb66b0 100644 --- a/src/pages/paas/go/related-apps/beego.mdx +++ b/src/pages/paas/go/related-apps/beego.mdx @@ -57,5 +57,10 @@ import Head from "next/head";
{/* بعد از port-- باید پورتی را وارد کنید که برنامه‌تان در آن، به درخواست کاربران گوش می‌دهد. معمولاً این مقدار بر روی ۸۰۸۰ تنظیم می‌شود. */} + +

+یک پروژه Beego آماده به استقرار در اینجا وجود دارد که می‌توانید از آن، استفاده کنید. +

+
\ No newline at end of file diff --git a/src/pages/paas/go/related-apps/echo.mdx b/src/pages/paas/go/related-apps/echo.mdx index 36cba535..fe26f9f7 100644 --- a/src/pages/paas/go/related-apps/echo.mdx +++ b/src/pages/paas/go/related-apps/echo.mdx @@ -60,4 +60,11 @@ import Head from "next/head"; بعد از port-- باید پورتی را وارد کنید که برنامه‌تان در آن، به درخواست کاربران گوش می‌دهد. معمولاً این مقدار بر روی ۸۰۸۰ تنظیم می‌شود. +
+ +

+یک پروژه Echo آماده به استقرار در اینجا وجود دارد که می‌توانید از آن، استفاده کنید. +

+
+ \ No newline at end of file diff --git a/src/pages/paas/go/related-apps/fiber.mdx b/src/pages/paas/go/related-apps/fiber.mdx index a9ecc259..480bf205 100644 --- a/src/pages/paas/go/related-apps/fiber.mdx +++ b/src/pages/paas/go/related-apps/fiber.mdx @@ -59,4 +59,11 @@ import Head from "next/head"; بعد از port-- باید پورتی را وارد کنید که برنامه‌تان در آن، به درخواست کاربران گوش می‌دهد. معمولاً این مقدار بر روی ۸۰۸۰ تنظیم می‌شود. +
+ +

+یک پروژه Fiber آماده به استقرار در اینجا وجود دارد که می‌توانید از آن، استفاده کنید. +

+
+ \ No newline at end of file diff --git a/src/pages/paas/go/related-apps/gin.mdx b/src/pages/paas/go/related-apps/gin.mdx index 66f7df66..2a7e485d 100644 --- a/src/pages/paas/go/related-apps/gin.mdx +++ b/src/pages/paas/go/related-apps/gin.mdx @@ -58,4 +58,11 @@ import Head from "next/head"; بعد از port-- باید پورتی را وارد کنید که برنامه‌تان در آن، به درخواست کاربران گوش می‌دهد. معمولاً این مقدار بر روی ۸۰۸۰ تنظیم می‌شود. +
+ +

+یک پروژه Gin آماده به استقرار در اینجا وجود دارد که می‌توانید از آن، استفاده کنید. +

+
+ \ No newline at end of file diff --git a/src/pages/tv/courses/golang.js b/src/pages/tv/courses/go.js similarity index 100% rename from src/pages/tv/courses/golang.js rename to src/pages/tv/courses/go.js