Skip to content

Commit

Permalink
docs: update go platform
Browse files Browse the repository at this point in the history
  • Loading branch information
A-Najmabadi committed Dec 16, 2024
1 parent 3ab4520 commit 9b19a74
Show file tree
Hide file tree
Showing 14 changed files with 98 additions and 40 deletions.
3 changes: 3 additions & 0 deletions liara_nginx.conf
Original file line number Diff line number Diff line change
Expand Up @@ -1945,6 +1945,9 @@ location ~ ^/paas/golang/(.*)$ {
return 301 /paas/go/$1;
}

location ~ ^/tv/courses/golang/?$ {
return 301 /tv/courses/go/;
}



Expand Down
8 changes: 4 additions & 4 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 1 addition & 1 deletion package.json
Original file line number Diff line number Diff line change
Expand Up @@ -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",
Expand Down
2 changes: 1 addition & 1 deletion src/pages/paas/go/how-tos/choose-version.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ import Head from "next/head";
content={[
<>
<p>پس از بارگذاری پروژه خود در لیارا، کافیست تا در مرحله انتخاب نسخه، نسخه مورد نظر برنامه‌تان را انتخاب کنید.</p>
{/* <img src="https://files.liara.ir/liara/docs/change-go-version-in-go-using-console.png" alt="how to choose version in liara console" /> */}
<img src="https://files.liara.ir/liara/go/go-choose-version-using-console.png" alt="how to choose version in liara console" />
</>,
<>
<p>
Expand Down
70 changes: 47 additions & 23 deletions src/pages/paas/go/how-tos/deploy-app.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -79,7 +79,7 @@ require (
<div className="h-2" />
<p>
فایل <Important>go.sum</Important> لیستی از نسخه‌های دقیق ماژول‌های مورد نیاز پروژه را همراه با هش آن‌ها ذخیره می‌کند.
این فایل تضمین می‌کند که همه سیستم‌ها از نسخه‌های یکسان و امن ماژول‌ها استفاده کنند. بنابراین، توصیه می‌شود که این فایل نیز، در مسیر اصلی پروژ‌تان، وجود داشته باشد.
این فایل تضمین می‌کند که همه سیستم‌ها از نسخه‌های یکسان و امن ماژول‌ها استفاده کنند. بنابراین، اگر که در برنامه‌تان، ماژولی را نصب کرده‌اید، باید این فایل نیز، در مسیر اصلی پروژ‌تان، وجود داشته باشد.
قطعه کد زیر، می‌تواند یک نمونه از فایل <Important>go.sum</Important> برای برنامه‌های Go باشد:
</p>
<div className="h-2" />
Expand All @@ -92,7 +92,22 @@ github.com/jinzhu/gorm v1.9.16/go.mod h1:vnPOBfZMgAjq0QC2Rt8zgzoxzJKTKmSUHL0dRgm
`}
</Highlight>
</div>
<div className="h-2" />
<div className="h-2" />
<p>
برای ایجاد این فایل نیز کافیست تا قبل از استقرار پروژه‌تان، دستور زیر را در مسیر اصلی پروژه اجرا کنید:
</p>

<div className="h-2" />
<div dir='ltr'>
<Highlight className="bash">
{`go get <project_name>`}
</Highlight>
</div>
<div className="h-2" />
<p>
در قطعه کد فوق، به جای <Important>&lt;project_name&gt;</Important> باید نام پروژه خود را که در فایل <Important>go.mod</Important> ثبت شده است، وارد کنید.
</p>

<p>
در ادامه، بایستی پوشه پروژه خود را درون یک فایل zip قرار بدهید؛ سپس در برنامه خود، بر روی گزینه <b>استقرار جدید</b> کلیک کرده؛ وارد تب <b>Drag & Drog</b> شوید و فایل zip را آپلود کنید تا وارد مرحله بعدی استقرار شوید:
</p>
Expand Down Expand Up @@ -179,8 +194,8 @@ require (
<div className="h-2" />
<p>
فایل <Important>go.sum</Important> لیستی از نسخه‌های دقیق ماژول‌های مورد نیاز پروژه را همراه با هش آن‌ها ذخیره می‌کند.
این فایل تضمین می‌کند که همه سیستم‌ها از نسخه‌های یکسان و امن ماژول‌ها استفاده کنند. بنابراین، توصیه می‌شود که این فایل نیز، در مسیر اصلی پروژ‌تان، وجود داشته باشد.
قطعه کد زیر، می‌تواند یک نمونه از فایل <Important>go.sum</Important> برای برنامه‌های go باشد:
این فایل تضمین می‌کند که همه سیستم‌ها از نسخه‌های یکسان و امن ماژول‌ها استفاده کنند. بنابراین، اگر که در برنامه‌تان، ماژولی را نصب کرده‌اید، باید این فایل نیز، در مسیر اصلی پروژ‌تان، وجود داشته باشد.
قطعه کد زیر، می‌تواند یک نمونه از فایل <Important>go.sum</Important> برای برنامه‌های Go باشد:
</p>
<div className="h-2" />
<div dir='ltr'>
Expand All @@ -192,27 +207,22 @@ github.com/jinzhu/gorm v1.9.16/go.mod h1:vnPOBfZMgAjq0QC2Rt8zgzoxzJKTKmSUHL0dRgm
`}
</Highlight>
</div>
<Section id="liara-json" title="فایل liara.json" />
<div className="h-2" />
<p>
در ادامه، در مسیر اصلی پروژه، یک فایل به نام <Important>liara.json</Important> ایجاد کنید و قطعه کد زیر را در آن قرار دهید:
برای ایجاد این فایل نیز کافیست تا قبل از استقرار پروژه‌تان، دستور زیر را در مسیر اصلی پروژه اجرا کنید:
</p>
<div className="h-4" />

<div className="h-2" />
<div dir='ltr'>
<Highlight className="json">
{`{
"app": "my-go-app",
"platform": "go",
"port": 8000
}`}
</Highlight>
<Highlight className="bash">
{`go get <project_name>`}
</Highlight>
</div>
<div className='h-4' />
<div className="h-2" />
<p>
در قطعه کد فوق، در فیلد <Important>app</Important> باید شناسه برنامه خود را به جای <Important>my-go-app</Important> وارد کنید.
در فیلد <Important>platform</Important> باید نوع پلتفرم خود را که go است، مشخص کنید.
اگر که برنامه‌تان وب‌سرور است و در پورت خاصی به درخواست کاربران گوش می‌دهد، باید در فیلد <Important>port</Important>، پورت برنامه را مشخص کنید.
البته اگر که برنامه‌تان نیازی به پورت ندارد، می‌توانید این فیلد را از فایل <Important>liara.json</Important>، پاک کنید
در قطعه کد فوق، به جای <Important>&lt;project_name&gt;</Important> باید نام پروژه خود را که در فایل <Important>go.mod</Important> ثبت شده است، وارد کنید.
</p>

{/*
<Section id="liara-json-mirror" title="mirror لیارا" />
<p>
Expand Down Expand Up @@ -373,10 +383,10 @@ require (
</Highlight>
</div>
<div className="h-2" />
<p>
<p>
فایل <Important>go.sum</Important> لیستی از نسخه‌های دقیق ماژول‌های مورد نیاز پروژه را همراه با هش آن‌ها ذخیره می‌کند.
این فایل تضمین می‌کند که همه سیستم‌ها از نسخه‌های یکسان و امن ماژول‌ها استفاده کنند. بنابراین، توصیه می‌شود که این فایل نیز، در مسیر اصلی پروژ‌تان، وجود داشته باشد.
قطعه کد زیر، می‌تواند یک نمونه از فایل <Important>go.sum</Important> برای برنامه‌های go باشد:
این فایل تضمین می‌کند که همه سیستم‌ها از نسخه‌های یکسان و امن ماژول‌ها استفاده کنند. بنابراین، اگر که در برنامه‌تان، ماژولی را نصب کرده‌اید، باید این فایل نیز، در مسیر اصلی پروژ‌تان، وجود داشته باشد.
قطعه کد زیر، می‌تواند یک نمونه از فایل <Important>go.sum</Important> برای برنامه‌های Go باشد:
</p>
<div className="h-2" />
<div dir='ltr'>
Expand All @@ -388,7 +398,21 @@ github.com/jinzhu/gorm v1.9.16/go.mod h1:vnPOBfZMgAjq0QC2Rt8zgzoxzJKTKmSUHL0dRgm
`}
</Highlight>
</div>
<div className='h-4' />
<div className="h-2" />
<p>
برای ایجاد این فایل نیز کافیست تا قبل از استقرار پروژه‌تان، دستور زیر را در مسیر اصلی پروژه اجرا کنید:
</p>

<div className="h-2" />
<div dir='ltr'>
<Highlight className="bash">
{`go get <project_name>`}
</Highlight>
</div>
<div className="h-2" />
<p>
در قطعه کد فوق، به جای <Important>&lt;project_name&gt;</Important> باید نام پروژه خود را که در فایل <Important>go.mod</Important> ثبت شده است، وارد کنید.
</p>
<p>
لیارا به صورت خودکار در مسیر اصلی پروژه، فایل با نام <Important>main.go</Important> را پیدا می‌کند
و پس از build پروژه، با اجرای دستور <Important>go run</Important>، فایل اصلی را اجرا می‌کند. در صورتی
Expand Down
4 changes: 2 additions & 2 deletions src/pages/paas/go/how-tos/set-cron-job.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,7 @@ Cron job یک وظیفه زمان‌بندی شده در سیستم‌عامل

پس از آپلود پروژه خود در کنسول در بخش <b>تنظیمات پلتفرم</b>، Cron Jobهای خود را تعریف کنید:
<div className="h-4" />
<img src="https://files.liara.ir/liara/go/go-cronjob.png" alt="set cron jobs on liara" />
<img src="https://files.liara.ir/liara/go/set-cron-job-in-go-using-console.png" alt="set cron jobs on liara" />

</>,

Expand All @@ -49,7 +49,7 @@ Cron job یک وظیفه زمان‌بندی شده در سیستم‌عامل
<Highlight className="json">
{`{
"cron": [
"go run migrate.go >> /dev/null 2>&1"
"* * * * * go run migrate.go >> /dev/null 2>&1"
]
}`}
</Highlight>
Expand Down
7 changes: 6 additions & 1 deletion src/pages/paas/go/how-tos/use-disk.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,12 @@ import Head from "next/head";
controls="controls"
className="block w-full"
width="100%" />
<div className="h-4" />
<div className="h-2" />
<Alert variant="success">
<p>
پروژه و کدهای مورد استفاده در ویدیوی فوق در <a href="https://github.com/liara-cloud/go-getting-started/tree/diskSetup" className="text-[#2196f3] ">اینجا</a> قابل مشاهده و دسترسی هستند.
</p>
</Alert>

برای استفاده از <a href="/paas/disks/about" className="text-[#2196f3] ">دیسک‌ها</a> در برنامه‌های go در ابتدا باید طبق مستندات <a href="/paas/disks/create" className="text-[#2196f3] ">ساخت دیسک</a>، دیسک‌های مدنظر خود را بسازید؛ در ادامه، می‌توانید طبق مستندات <a href="/paas/disks/route" className="text-[#2196f3] ">تعریف مسیر برای دیسک</a>، دیسک‌های خود را به دایرکتوری‌های مدنظرتان، متصل کنید.

Expand Down
8 changes: 4 additions & 4 deletions src/pages/paas/go/how-tos/use-websocket.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -283,12 +283,12 @@ func main() {

برای استقرار برنامه‌های وب‌سوکت Go در لیارا، نیازی به انجام تغییر خاصی نیست. صرفاً باید به جای استفاده از آدرس <Important>ws</Important>، عبارت <Important>wss</Important> را به کار ببرید تا اتصال، ایمن و سازگار باشد.

{/* <div className="h-2" /> */}
{/* <Alert variant="info">
<div className="h-2" />
<Alert variant="info">
<p>
سورس کامل یک برنامه Django WebSocket آماده استقرار در <a href="https://github.com/liara-cloud/django-getting-started/tree/asgi" className="text-[#2196f3] ">اینجا</a> موجود است که می‌توانید از آن استفاده کنید.
سورس کامل یک برنامه Go WebSocket آماده استقرار در <a href="https://github.com/liara-cloud/go-getting-started/tree/webSocket" className="text-[#2196f3] ">اینجا</a> موجود است که می‌توانید از آن استفاده کنید.
</p>
</Alert> */}
</Alert>


</Layout>
8 changes: 4 additions & 4 deletions src/pages/paas/go/quick-start.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -70,7 +70,7 @@ import Head from "next/head";
<h3>بررسی فایل‌ go.mod و go.sum</h3>
<p>در صورتی که از کتابخانه یا پکیج خاصی استفاده می‌کنید که به صورت built-in (پیش‌فرض) در go وجود ندارد، حتماً باید در مسیر اصلی پروژه، فایل <Important>go.mod</Important>
وجود داشته باشد؛
برای ذخیره hash و نسخه وابستگی‌ها هم توصیه می‌شود از فایل <Important>go.sum</Important> نیز، استفاده کنید که با نصب اولین پکیج در پروژه‌تان، به صورت خودکار ایجاد یا آپدیت می‌شود.
برای ذخیره hash و نسخه وابستگی‌ها هم باید از فایل <Important>go.sum</Important> نیز، استفاده کنید که با نصب اولین پکیج در پروژه‌تان، به صورت خودکار ایجاد یا آپدیت می‌شود.

اگر که فایل <Important>go.mod</Important> در پروژه‌تان وجود ندارد، می‌توانید با اجرای دستور زیر، این فایل را ایجاد کنید:
</p>
Expand Down Expand Up @@ -222,7 +222,7 @@ vendor/`}
<h3>بررسی فایل‌ go.mod و go.sum</h3>
<p>در صورتی که از کتابخانه یا پکیج خاصی استفاده می‌کنید که به صورت built-in (پیش‌فرض) در go وجود ندارد، حتماً باید در مسیر اصلی پروژه، فایل <Important>go.mod</Important>
وجود داشته باشد؛
برای ذخیره hash و نسخه وابستگی‌ها هم توصیه می‌شود از فایل <Important>go.sum</Important> نیز، استفاده کنید که با نصب اولین پکیج در پروژه‌تان، به صورت خودکار ایجاد یا آپدیت می‌شود.
برای ذخیره hash و نسخه وابستگی‌ها هم باید از فایل <Important>go.sum</Important> نیز، استفاده کنید که با نصب اولین پکیج در پروژه‌تان، به صورت خودکار ایجاد یا آپدیت می‌شود.

اگر که فایل <Important>go.mod</Important> در پروژه‌تان وجود ندارد، می‌توانید با اجرای دستور زیر، این فایل را ایجاد کنید:
</p>
Expand Down Expand Up @@ -297,10 +297,10 @@ vendor/`}
step: "۳",
content: (
<>
<h3>بررسی فایل‌ go.mod و go.sum</h3>
<h3>بررسی فایل‌ go.mod و go.sum</h3>
<p>در صورتی که از کتابخانه یا پکیج خاصی استفاده می‌کنید که به صورت built-in (پیش‌فرض) در go وجود ندارد، حتماً باید در مسیر اصلی پروژه، فایل <Important>go.mod</Important>
وجود داشته باشد؛
برای ذخیره hash و نسخه وابستگی‌ها هم توصیه می‌شود از فایل <Important>go.sum</Important> نیز، استفاده کنید که با نصب اولین پکیج در پروژه‌تان، به صورت خودکار ایجاد و آپدیت می‌شود..
برای ذخیره hash و نسخه وابستگی‌ها هم باید از فایل <Important>go.sum</Important> نیز، استفاده کنید که با نصب اولین پکیج در پروژه‌تان، به صورت خودکار ایجاد و آپدیت می‌شود.

اگر که فایل <Important>go.mod</Important> در پروژه‌تان وجود ندارد، می‌توانید با اجرای دستور زیر، این فایل را ایجاد کنید:
</p>
Expand Down
5 changes: 5 additions & 0 deletions src/pages/paas/go/related-apps/beego.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -57,5 +57,10 @@ import Head from "next/head";
<div className="h-2" />

{/* بعد از <Important>port--</Important> باید پورتی را وارد کنید که برنامه‌تان در آن، به درخواست کاربران گوش می‌دهد. معمولاً این مقدار بر روی ۸۰۸۰ تنظیم می‌شود. */}
<Alert variant="success">
<p>
یک پروژه Beego آماده به استقرار در <a href="https://github.com/liara-cloud/beego-getting-started" className="text-[#2196f3] ">اینجا</a> وجود دارد که می‌توانید از آن، استفاده کنید.
</p>
</Alert>

</Layout>
7 changes: 7 additions & 0 deletions src/pages/paas/go/related-apps/echo.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -60,4 +60,11 @@ import Head from "next/head";

بعد از <Important>port--</Important> باید پورتی را وارد کنید که برنامه‌تان در آن، به درخواست کاربران گوش می‌دهد. معمولاً این مقدار بر روی ۸۰۸۰ تنظیم می‌شود.

<div className="h-2" />
<Alert variant="success">
<p>
یک پروژه Echo آماده به استقرار در <a href="https://github.com/liara-cloud/echo-getting-started" className="text-[#2196f3] ">اینجا</a> وجود دارد که می‌توانید از آن، استفاده کنید.
</p>
</Alert>

</Layout>
7 changes: 7 additions & 0 deletions src/pages/paas/go/related-apps/fiber.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -59,4 +59,11 @@ import Head from "next/head";

بعد از <Important>port--</Important> باید پورتی را وارد کنید که برنامه‌تان در آن، به درخواست کاربران گوش می‌دهد. معمولاً این مقدار بر روی ۸۰۸۰ تنظیم می‌شود.

<div className="h-2" />
<Alert variant="success">
<p>
یک پروژه Fiber آماده به استقرار در <a href="https://github.com/liara-cloud/fiber-getting-started" className="text-[#2196f3] ">اینجا</a> وجود دارد که می‌توانید از آن، استفاده کنید.
</p>
</Alert>

</Layout>
7 changes: 7 additions & 0 deletions src/pages/paas/go/related-apps/gin.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -58,4 +58,11 @@ import Head from "next/head";

بعد از <Important>port--</Important> باید پورتی را وارد کنید که برنامه‌تان در آن، به درخواست کاربران گوش می‌دهد. معمولاً این مقدار بر روی ۸۰۸۰ تنظیم می‌شود.

<div className="h-2" />
<Alert variant="success">
<p>
یک پروژه Gin آماده به استقرار در <a href="https://github.com/liara-cloud/gin-getting-started" className="text-[#2196f3] ">اینجا</a> وجود دارد که می‌توانید از آن، استفاده کنید.
</p>
</Alert>

</Layout>
File renamed without changes.

0 comments on commit 9b19a74

Please sign in to comment.