Skip to content

Commit

Permalink
docs: Add Section to deploy pages for all options
Browse files Browse the repository at this point in the history
  • Loading branch information
@A-Najmabadi
A-Najmabadi committed Nov 21, 2024
1 parent 06e072b commit 43a088d
Show file tree
Hide file tree
Showing 13 changed files with 67 additions and 37 deletions.
4 changes: 3 additions & 1 deletion src/pages/paas/angular/how-tos/deploy-app.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -213,6 +213,7 @@ import Head from "next/head";
</Highlight>
</div>
<div className="h-2" />
<Section id="liara-json" title="فایل liara.json" />
<p>
در ادامه، در مسیر اصلی پروژه، یک فایل به نام <Important>liara.json</Important> ایجاد کنید و قطعه کد زیر را در آن قرار دهید:
</p>
Expand All @@ -230,6 +231,7 @@ import Head from "next/head";
در قطعه کد فوق، در فیلد <Important>app</Important> باید شناسه برنامه خود را به جای <Important>my-web-app</Important> وارد کنید.
در فیلد <Important>platform</Important> باید نوع پلتفرم خود را که Angular است، مشخص کنید.
</p>
<Section id="liara-json-mirror" title="mirror لیارا" />
<p>
لیارا در جهت استقرار سریع‌تر، برای نصب پکیج‌های <Important>npm</Important>، از <Important>mirror</Important> اختصاصی خود استفاده می‌کند؛ از همین رو، ممکن است که در نصب برخی از پکیج‌های جدید، دچار مشکل شود. برای رفع این مشکل، می‌توانید mirror لیارا را با قراردادن قطعه کد زیر در فایل <Important>liara.json</Important>، غیرفعال کنید:
</p>
Expand All @@ -243,7 +245,7 @@ import Head from "next/head";
}`}
</Highlight>
</div>
<div className='h-4' />
<Section id="liara-json-sourcemap" title="قابلیت Source Map" />
<p>
Source Map یک فایل است که به ابزارهای دیباگ این امکان را می‌دهد تا کد منبع اصلی (مثل فایل‌های جاوااسکریپت، TypeScript یا SCSS) را به کد تبدیل شده (مثل فایل‌های minified) مرتبط کنند.
Source Map در پلتفرم Angular لیارا به‌صورت پیش‌فرض غیرفعال است اما درصورت نیاز به فعال کردن این قابلیت می‌توانید قطعه‌کد زیر را در فایل <Important>liara.json</Important> قرار دهید:
Expand Down
16 changes: 10 additions & 6 deletions src/pages/paas/django/how-tos/deploy-app.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -102,7 +102,7 @@ tzdata==2024.1
`}
</Highlight>
</div>
<div className='h-4' />
<Section id="liara-json" title="فایل liara.json" />
<p>
در ادامه، در مسیر اصلی پروژه، یک فایل به نام <Important>liara.json</Important> ایجاد کنید و قطعه کد زیر را در آن قرار دهید:
</p>
Expand All @@ -120,6 +120,8 @@ tzdata==2024.1
در قطعه کد فوق، در فیلد <Important>app</Important> باید شناسه برنامه خود را به جای <Important>my-web-app</Important> وارد کنید.
در فیلد <Important>platform</Important> باید نوع پلتفرم خود را که django است، مشخص کنید.
</p>
<Section id="liara-json-mirror" title="mirror لیارا" />

<p>
از آنجایی که لیارا برای نصب پکیج‌های فایل <Important>requirements.txt</Important>، از <Important>mirror</Important> اختصاصی خود استفاده می‌کند؛ از همین رو، ممکن است که در نصب برخی از پکیج‌های جدید، دچار مشکل شود. برای رفع این مشکل، می‌توانید mirror لیارا را با قراردادن قطعه کد زیر در فایل <Important>liara.json</Important>، غیرفعال کنید:
</p>
Expand All @@ -133,7 +135,7 @@ tzdata==2024.1
}`}
</Highlight>
</div>
<div className='h-4' />
<Section id="liara-json-version" title="تعیین نسخه" />
<p>
برای تعیین نسخه Python برنامه خود نیز، کافیست تا در فایل <Important>liara.json</Important> فیلد <Important>pythonVersion</Important> را قرار دهید:
</p>
Expand All @@ -149,6 +151,7 @@ tzdata==2024.1
</div>
<div className='h-4' />
<Alert variant='success'>همچنین بخوانید: <a className="text-[#2196f3] " href="../choose-version">نسخه‌های قابل ارائه Python در لیارا</a></Alert>
<Section id="liara-json-timezone" title="تعیین منطقه زمانی" />
<p>
به صورت پیش‌فرض، منطقه‌ی زمانی برنامه‌تان بر روی Asia/Tehran تنظیم شده است؛ برای تغییر مقدار پیش‌فرض، می‌توانید از پارامتر <Important>timezone</Important> در فایل <Important>liara.json</Important> استفاده کنید؛ به عنوان مثال:
</p>
Expand All @@ -162,7 +165,7 @@ tzdata==2024.1
}`}
</Highlight>
</div>
<div className='h-4' />
<Section id="liara-json-collectstatic" title="دستور collectstatic" />
<p>
لیارا در هر استقرار، به صورت خودکار دستور <Important>python manage.py collectstatic</Important> را برای جمع‌آوری تمامی فایل‌های Static (مانند JS , CSS , تصاویر و ...) و قراردادن آن‌ها در <Important>STATIC_ROOT</Important>، اجرا می‌کند. برای جلوگیری از اجرای خودکار این دستور، بایستی فیلد <Important>collectStatic</Important> را در فایل liara.json، به شکل زیر، مقداردهی کنید:
</p>
Expand All @@ -176,7 +179,7 @@ tzdata==2024.1
}`}
</Highlight>
</div>
<div className='h-4' />
<Section id="liara-json-multi-language" title="برنامه چندزبانه" />
<p>
همچنین، اگر برنامه شما چند زبانه است و نیازمند اجرای دستور <Important>python manage.py compilemessages</Important> در هر بار استقرار هستید؛ بایستی در فایل liara.json، مقدار فیلد <Important>compileMessages</Important> را به شکل زیر، وارد کنید:
</p>
Expand All @@ -190,7 +193,7 @@ tzdata==2024.1
}`}
</Highlight>
</div>
<div className='h-4' />
<Section id="liara-json-settings-py" title="تغییر فایل settings.py" />
<p>
لیارا، به صورت خودکار فایل <Important>settings.py</Important> برنامه‌تان را پیدا کرده و در انتهای آن، تنظیمات مشخصی را برای اجرای برنامه، اضافه می‌کند؛ در صورتی که قصد ندارید این فایل دست‌خوش تغییرات شود، کافیست تا مقدار فیلد <Important>modifySettings</Important> را در فایل liara.json به شکل زیر، وارد کنید:
</p>
Expand All @@ -204,7 +207,7 @@ tzdata==2024.1
}`}
</Highlight>
</div>
<div className='h-4' />
<Section id="liara-json-gdal" title="استفاده از GDAL" />
<p>
برای استفاده از GDAL در پلتفرم Django نیز، می‌توانید فیلد <Important>geospatial</Important> را به شکل زیر، به فایل liara.json برنامه خود، اضافه کنید:
</p>
Expand Down Expand Up @@ -322,6 +325,7 @@ tzdata==2024.1
</div>
<div className='h-4' />
<Alert variant='success'>همچنین بخوانید: <a className="text-[#2196f3] " href="../choose-version">نسخه‌های قابل ارائه Python در لیارا</a></Alert>
<Section id="liara-json-timezone" title="تعیین منطقه زمانی" />
<p>
به صورت پیش‌فرض، منطقه‌ی زمانی برنامه‌تان بر روی Asia/Tehran تنظیم شده است؛ برای تغییر مقدار پیش‌فرض، می‌توانید از پارامتر <Important>timezone</Important> در فایل <Important>liara.json</Important> استفاده کنید؛ به عنوان مثال:
</p>
Expand Down
10 changes: 5 additions & 5 deletions src/pages/paas/docker/how-tos/deploy-app.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -273,7 +273,7 @@ CMD ["./main"]`}
شما می‌توانید با استفاده از دستور <Important>EXPOSE</Important> پورتی که برنامه توسط آن به درخواست کاربران گوش می‌دهد را مشخص کنید. البته چون که در حین استقرار، لیارا از شما port برنامه را می‌پرسد بنابراین برای استقرار برنامه‌های داکرایز شده در لیارا، نیازی به نوشتن این دستور در <Important>Dockerfile</Important> نیست.
</p>
</Alert>
<div className='h-4' />
<Section id="liara-json" title="فایل liara.json" />
<p>
در ادامه، در مسیر اصلی پروژه، یک فایل به نام <Important>liara.json</Important> ایجاد کنید و قطعه کد زیر را در آن قرار دهید:
</p>
Expand All @@ -292,7 +292,7 @@ CMD ["./main"]`}
در قطعه کد فوق، در فیلد <Important>app</Important> باید شناسه برنامه خود را به جای <Important>my--app</Important> و در فیلد <Important>port</Important>، پورتی که برنامه در آن، به درخواست کاربران، گوش می‌دهد، را وارد کنید.
در فیلد <Important>platform</Important> باید نوع پلتفرم خود را که docker است، مشخص کنید.
</p>
<div className='h-4' />
<Section id="liara-json-find-dockerfile" title="تعیین Dockerfile" />
<p>
ممکن است بخواهید چندین پروژه، که در یک <Important>monorepo</Important> قرار دارند را با <Important>Dockerfile</Important> های مختلفی استقرار کنید؛ یا اینکه از نام و مسیر دلخواه برای <Important>Dockerfile</Important>تان استفاده کنید. برای این کار می‌توانید قطعه کد زیر را به فایل <Important>liara.json</Important>، اضافه کنید و در فیلد <Important>dockerfile</Important>، مسیر Dokcerfile خود را مشخص کنید:
</p>
Expand All @@ -306,7 +306,7 @@ CMD ["./main"]`}
}`}
</Highlight>
</div>
<div className='h-4' />
<Section id="liara-json-cache" title="استفاده از Cache" />
<p>
همچنین می‌توانید در فیلدی به نام <Important>cache</Important> تعیین کنید که در حین فرایند build برنامه، از cache استفاده شود یا خیر؛ این مقدار، به صورت پیش‌فرض، بر روی <Important>true</Important> قرار دارد:
</p>
Expand All @@ -320,7 +320,7 @@ CMD ["./main"]`}
}`}
</Highlight>
</div>
<div className='h-4' />
<Section id="liara-json-args" title="تعریف ARGs" />
<p>
در داکر، دستور <Important>ARG</Important> برای تعریف متغیرهای زمان ساخت (build-time variables) استفاده می‌شود. این متغیرها می‌توانند در طول فرآیند ساخت image استفاده شوند تا پارامترهای مهمی مانند نسخه نرم‌افزار و ... را تعیین کنند. این متغیرها در مرحله ساخت image در دسترس هستند و به صورت کلید-مقدار تعریف می‌شوند.
شما می‌توانید ARGهای‌تان را در آرایه‌ای به نام <Important>args</Important>، تعریف کنید، به عنوان مثال:
Expand All @@ -335,7 +335,7 @@ CMD ["./main"]`}
}`}
</Highlight>
</div>
<div className='h-4' />
<Section id="liara-json-main-args" title="تعیین فرمان اصلی" />
<p>
دستور <Important>ENTRYPOINT</Important> برای تعیین فرمان اصلی است که باید هنگام اجرای کانتینر، run شود. این فرمان تعیین می‌کند که کانتینر چه چیزی را باید به عنوان فرآیند اصلی خود اجرا کند.
برای تغییر <Important>ENTRYPOINT</Important> در image خود، کافیست تا قطعه کدی مشابه قطعه کد زیر را به آرایه‌ای به نام <Important>args</Important>، در فایل <Important>liara.json</Important>، اضافه کنید:
Expand Down
10 changes: 6 additions & 4 deletions src/pages/paas/dotnet/how-tos/deploy-app.mdx
View file
Original file line number Diff line number Diff line change
Expand Up @@ -109,7 +109,7 @@ import Head from "next/head";
`}
</Highlight>
</div>
<div className='h-4' />
<Section id="liara-json" title="فایل liara.json" />
<p>
در ادامه، در مسیر اصلی پروژه، یک فایل به نام <Important>liara.json</Important> ایجاد کنید و قطعه کد زیر را در آن قرار دهید:
</p>
Expand All @@ -129,7 +129,7 @@ import Head from "next/head";
در فیلد <Important>port</Important>، بایستی پورتی را وارد کنید که برنامه‌تان در آن، به درخواست کاربران listen می‌کند. این مقدار به صورت پیش‌فرض، در برنامه‌های NET. لیارا، برابر با 80 است.
در فیلد<Important>platform</Important> نیز، باید نوع پلتفرم خود را که dotnet است، مشخص کنید.
</p>
<div className="h-4" />
<Section id="liara-json-version" title="تعیین نسخه" />

<p>
برای تعیین نسخه dotnet برنامه خود نیز، کافیست تا در فایل <Important>liara.json</Important> فیلد <Important>version</Important> را قرار دهید:
Expand All @@ -146,6 +146,7 @@ import Head from "next/head";
</div>
<div className='h-4' />
<Alert variant='success'>همچنین بخوانید: <a className="text-[#2196f3] " href="../choose-version">نسخه‌های قابل ارائه NET. در لیارا</a></Alert>
<Section id="liara-json-timezone" title="تعیین منطقه زمانی" />
<p>
به صورت پیش‌فرض، منطقه‌ی زمانی برنامه‌تان بر روی Asia/Tehran تنظیم شده است؛ برای تغییر مقدار پیش‌فرض، می‌توانید از پارامتر <Important>timezone</Important> در فایل <Important>liara.json</Important> استفاده کنید؛ به عنوان مثال:
</p>
Expand All @@ -159,7 +160,7 @@ import Head from "next/head";
}`}
</Highlight>
</div>
<div className='h-4' />
<Section id="liara-json-dll" title="تعیین فایل DLL" />
<p>
لیارا نام فایل Dll نهایی پس از build را به صورت خودکار تشخیص می‌دهد. اما در صورتی که پروژه‌ی شما متشکل از چندین پروژه‌ی دیگر هم باشد، لازم است که نام فایل را بدون پسوند در فیلد <Important>finalDllName</Important> در فایل <Important>liara.json</Important> وارد کنید، به عنوان مثال:
</p>
Expand All @@ -173,7 +174,7 @@ import Head from "next/head";
}`}
</Highlight>
</div>
<div className='h-4' />
<Section id="liara-json-find-csproj" title="تعیین فایل csproj" />
<p>
در ادامه، لیارا فایل csproj. برنامه‌ی شما را به صورت خودکار تشخیص می‌دهد. اما برای اطمینان بیشتر از استقرار موفق، می‌توانید مسیر این فایل را به صورت نسبی، در فیلد <Important>csprojectFile</Important> در فایل <Important>liara.json</Important> مشخص کنید؛ به عنوان مثال:

Expand Down Expand Up @@ -288,6 +289,7 @@ import Head from "next/head";
</Highlight>
</div>
<Alert variant='success'>همچنین بخوانید: <a className="text-[#2196f3] " href="../choose-version">نسخه‌های قابل ارائه NET. در لیارا</a></Alert>
<Section id="liara-json-timezone" title="تعیین منطقه زمانی" />
<p>
به صورت پیش‌فرض، منطقه‌ی زمانی برنامه‌تان بر روی Asia/Tehran تنظیم شده است؛ برای تغییر مقدار پیش‌فرض، می‌توانید از پارامتر <Important>timezone</Important> در فایل <Important>liara.json</Important> استفاده کنید؛ به عنوان مثال:
</p>
Expand Down
Loading

0 comments on commit 43a088d

Please sign in to comment.