Skip to content

Commit

Permalink
add vue & static/ github deployment docs
Browse files Browse the repository at this point in the history
  • Loading branch information
A-Najmabadi committed Oct 5, 2024
1 parent a47533a commit a232422
Show file tree
Hide file tree
Showing 14 changed files with 816 additions and 16 deletions.
2 changes: 1 addition & 1 deletion src/pages/paas/angular/quick-start.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -289,7 +289,7 @@ import Head from "next/head";
</>,

<>
برای استقرار با Liara Github، کافیست تا مراحل زیر را طی کنید:
برای استقرار با Github، کافیست تا مراحل زیر را طی کنید:
<Step steps={[
{
step: "۱",
Expand Down
2 changes: 1 addition & 1 deletion src/pages/paas/django/quick-start.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -231,7 +231,7 @@ import Head from "next/head";
]}/>
</>,
<>
برای استقرار با Liara Github، کافیست تا مراحل زیر را طی کنید:
برای استقرار با Github، کافیست تا مراحل زیر را طی کنید:
<Step steps={[
{
step: "۱",
Expand Down
2 changes: 1 addition & 1 deletion src/pages/paas/dotnet/quick-start.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -219,7 +219,7 @@ nupkg/
]}/>
</>,
<>
برای استقرار با Liara Github، کافیست تا مراحل زیر را طی کنید:
برای استقرار با Github، کافیست تا مراحل زیر را طی کنید:
<Step steps={[
{
step: "۱",
Expand Down
2 changes: 1 addition & 1 deletion src/pages/paas/flask/quick-start.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -230,7 +230,7 @@ import Head from "next/head";
]}/>
</>,
<>
برای استقرار با Liara Github، کافیست تا مراحل زیر را طی کنید:
برای استقرار با Github، کافیست تا مراحل زیر را طی کنید:
<Step steps={[
{
step: "۱",
Expand Down
2 changes: 1 addition & 1 deletion src/pages/paas/laravel/quick-start.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -218,7 +218,7 @@ import Head from "next/head";
]}/>
</>,
<>
برای استقرار با Liara Github، کافیست تا مراحل زیر را طی کنید:
برای استقرار با Github، کافیست تا مراحل زیر را طی کنید:
<Step steps={[
{
step: "۱",
Expand Down
2 changes: 1 addition & 1 deletion src/pages/paas/nextjs/quick-start.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -248,7 +248,7 @@ import Head from "next/head";
</>,

<>
برای استقرار با Liara Github، کافیست تا مراحل زیر را طی کنید:
برای استقرار با Github، کافیست تا مراحل زیر را طی کنید:
<Step steps={[
{
step: "۱",
Expand Down
2 changes: 1 addition & 1 deletion src/pages/paas/nodejs/how-tos/deploy-app.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -250,7 +250,7 @@ import Head from "next/head";
</>,
<>
<p>
پس از <a className='' href="../create-app">ساخت برنامه</a>، باید در مسیر اصلی پروژه، یک فایل به نام <Important>liaraignore.</Important> یا <Important>gitignore.</Important> ایجاد کنید و درون آن، اسامی تمامی فایل‌ها یا پوشه‌هایی که قصد ندارید در لیارا آپلود شوند را، وارد کنید؛ به عنوان مثال، نیازی به آپلود دایرکتوری node_modules به همراه محتوای آن نیست؛ چرا که لیارا در حین استقرار برنامه، آن را برای شما می‌سازد؛ پس بایستی نام این دایرکتوری در فایل فوق، نوشته شود؛ قطعه کد قرار گرفته در لینک زیر، یک <Important>gitignore.</Important> عالی برای برنامه‌های NodeJS است که می‌توانید از آن، استفاده کنید:
پس از <a className='' href="../create-app">ساخت برنامه</a>، باید در مسیر اصلی پروژه، یک فایل به نام <Important>gitignore.</Important> ایجاد کنید و درون آن، اسامی تمامی فایل‌ها یا پوشه‌هایی که قصد ندارید در لیارا آپلود شوند را، وارد کنید؛ به عنوان مثال، نیازی به آپلود دایرکتوری node_modules به همراه محتوای آن نیست؛ چرا که لیارا در حین استقرار برنامه، آن را برای شما می‌سازد؛ پس بایستی نام این دایرکتوری در فایل فوق، نوشته شود؛ قطعه کد قرار گرفته در لینک زیر، یک <Important>gitignore.</Important> عالی برای برنامه‌های NodeJS است که می‌توانید از آن، استفاده کنید:
</p>
<div className="h-2" />
<Link href="https://github.com/liara-cloud/gitignore-templates/blob/master/nodejs/.gitignore" target="_blank">
Expand Down
2 changes: 1 addition & 1 deletion src/pages/paas/nodejs/quick-start.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -226,7 +226,7 @@ import Head from "next/head";
]}/>
</>,
<>
برای استقرار با Liara Github، کافیست تا مراحل زیر را طی کنید:
برای استقرار با Github، کافیست تا مراحل زیر را طی کنید:
<Step steps={[
{
step: "۱",
Expand Down
2 changes: 1 addition & 1 deletion src/pages/paas/php/quick-start.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -221,7 +221,7 @@ import Head from "next/head";
]}/>
</>,
<>
برای استقرار با Liara Github، کافیست تا مراحل زیر را طی کنید:
برای استقرار با Github، کافیست تا مراحل زیر را طی کنید:
<Step steps={[
{
step: "۱",
Expand Down
37 changes: 36 additions & 1 deletion src/pages/paas/react/quick-start.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -341,7 +341,7 @@ import Head from "next/head";
</>,

<>
برای استقرار با Liara Github، کافیست تا مراحل زیر را طی کنید:
برای استقرار با Github، کافیست تا مراحل زیر را طی کنید:
<Step steps={[
{
step: "۱",
Expand Down Expand Up @@ -394,7 +394,42 @@ import Head from "next/head";
}`}
</Highlight>
</div>
<div className="h-2" />
البته در نظر داشته باشید که برای اجرای موفق پروژه‌های مبتنی بر <Important>vite</Important>، باید قطعه کد زیر به فایل <Important>vite.config.js</Important> اضافه شود:
<div className="h-2" />
<div dir='ltr'>
<Highlight className="js">
{`export default {
// ... rest of configuration
build: {
outDir: "build"
}
}`}
</Highlight>
</div>
<div className="h-2" />
<p>
و یا اگر که برنامه خود را با <Important>create-react-app</Important> ساخته‌اید؛ فایل <Important>package.json</Important> می‌تواند مانند قطعه کد زیر باشد:
</p>
<div className="h-2" />
<div dir='ltr'>
<Highlight className="json">
{`{
"name": "react-getting-started",
"version": "0.1.0",
"dependencies": {
"react": "^17.0.2",
"react-dom": "^17.0.2",
"react-scripts": "4.0.3",
"web-vitals": "^1.1.2"
},
"scripts": {
"start": "react-scripts start",
"build": "react-scripts build"
}
}`}
</Highlight>
</div>

</>
)
Expand Down
151 changes: 150 additions & 1 deletion src/pages/paas/static/how-tos/deploy-app.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ import Head from "next/head";
توجه داشته باشید، در پلتفرم <Important>Static</Important> می‌توانید برنامه‌هایی که فقط شامل فایل‌های <Important>HTML</Important> , <Important>CSS</Important> و <Important>JavaScript</Important> هستند را، استقرار کنید.

<Tabs
tabs={["Liara Console", "Liara CLI"]}
tabs={["Liara Console", "Liara CLI", "Github"]}
content={[
<>
<p>
Expand Down Expand Up @@ -94,6 +94,155 @@ import Head from "next/head";
در حین فرایند استقرار، می‌توانید در ترمینال خود، لاگ‌های مربوط به آن را مشاهده بفرمایید.
</p>
</>,
<>

<p>
پس از <a className='text-[#2196f3] ' href="../create-app">ساخت برنامه</a>، باید در مسیر اصلی پروژه، یک فایل به نام <Important>gitignore.</Important> ایجاد کنید و درون آن، اسامی تمامی فایل‌ها یا پوشه‌هایی که قصد ندارید در لیارا آپلود شوند را، وارد کنید؛ به عنوان مثال، نیازی به آپلود دایرکتوری node_modules (در صورت وجود) به همراه محتوای آن نیست؛ پس بایستی نام این دایرکتوری در یکی از دو فایل فوق، نوشته شود؛ قطعه کد قرار گرفته در لینک زیر، می‌تواند یک <Important>gitignore.</Important> عالی برای برنامه‌های Static باشد که می‌توانید پس از شخصی‌سازی، از آن، استفاده کنید:
</p>
<div className="h-2" />
<Link href="https://github.com/liara-cloud/gitignore-templates/blob/master/static/.gitignore" target="_blank">
<Card className="flex cursor-pointer w-full items-center justify-between">
<div className="flex items-center gap-3">
<h4>
نمونه فایل <Important>gitignore.</Important> برای برنامه‌های Static
</h4>
</div>
<GoArrowLeft className="ml-1" />
</Card>
</Link>
<div className="h-2" />

<Alert variant='info'>
<p>
برای استقرار برنامه‌های static با Github، نیازی به فایل <Important>liara.json</Important> نخواهید داشت. اما می‌توانید تنها برای تعیین موقعیت build، از آن استفاده کنید.
</p>
</Alert>
<Alert variant='success'>همچنین بخوانید: <a className="text-[#2196f3] " href="/paas/details/build-location">تعیین موقعیت build برنامه</a></Alert>
<p>
در ادامه، بایستی یک ریپازیتوری در حساب گیت‌هاب خود برای برنامه‌مدنظرتان با نام دلخواه‌تان ایجاد کنید، برای این کار، پس از ورود به <a href="https://github.com/" className="text-[#2196f3]">گیت‌هاب</a>، وارد بخش <b>Repositories</b> شوید و بر روی دکمه <b>New</b> کلیک کنید؛ پس از نوشتن نام و توضیحات ریپازیتوری، سطح دسترسی ریپازیتوری را (public یا private)، انتخاب کنید و در نهایت بر روی دکمه <b>create repository</b> کلیک کنید تا ریپازیتوری برای‌تان ساخته شود:
</p>
<div className="h-2" />
<video
src="https://files.liara.ir/liara/docs/create-a-new-repository-in-github.mp4"
controls="controls"
className="block w-full"
width="100%"
></video>
<div className="h-2" />
<Alert variant="info">
<p>
در صورتی که از قبل، این کار را انجام داده‌اید یا قصد دارید از ریپازیتوری‌های فعلی خود استفاده کنید؛ نیازی به ساخت ریپازیتوری جدید نیست.
</p>
</Alert>
<p>
اکنون، باید پروژه نهایی خود را در ریپازیتوری‌تان در گیت‌هاب آپلود کنید؛
حتماً در نظر داشته باشید که درون پروژه‌تان، فایل <Important>gitignore.</Important> قرار داشته باشد و درون آن، فایل‌های اضافی
برنامه، که قصد ندارید آپلود شوند؛ لیست شده باشند. می‌توانید برای آپلود، مانند دستورات زیر
در ترمینال ریشه پروژه‌تان، عمل کنید:
</p>
<div className="h-4" />
<div dir='ltr'>
<Highlight className="bash">
{`git init # تعریف اولیه مخزن در ریشه پروژه`}
</Highlight>
</div>
<div dir='ltr'>
<Highlight className="bash">
{`git add . # اضافه کردن تمامی فایل‌ها به استیج`}
</Highlight>
</div>
<div dir='ltr'>
<Highlight className="bash">
{`git commit -m "make ready to deploy on liara" # ثبت کامیت`}
</Highlight>
</div>
<div dir='ltr'>
<Highlight className="bash">
{`git remote add origin https://github.com/your-account-user/your-repo-name.gi # افزودن دسترسی ریموت به مخزن`}
</Highlight>
</div>
<div dir='ltr'>
<Highlight className="bash">
{`git push origin master # آپلود پروژه در گیت‌هاب`}
</Highlight>
</div>
<div className="h-2" />
<Alert variant="success">
<p>
در صورتی که هنوز <Important>git</Important> را در سیستم عامل خود نصب ندارید؛ می‌توانید آن را از <a href="https://git-scm.com/downloads" className="text-[#2196f3]">اینجا</a>، دانلود و نصب نمایید.
</p>
</Alert>
<Alert variant="info">
<p>
اگر که از قبل، پروژه نهایی خود را، در گیت‌هاب آپلود کرده‌اید؛ نیازی به انجام مجدد این کار نیست.
</p>
</Alert>
<p>
در ادامه، بایستی حساب لیارا خود را به گیت‌هاب متصل کنید. برای اتصال حساب لیارا خود به گیت‌هاب، در لیارا بر روی پروفایل خود کلیک کرده و وارد زیر قسمت <a href="https://console.liara.ir/settings/profile" className="text-[#2196f3]">حساب کاربری</a> شوید. در ادامه
وارد منوی <a href="https://console.liara.ir/settings/github" className="text-[#2196f3]">گیت‌هاب</a> شوید و بر روی دکمه <b>اتصال به گیت‌هاب</b>، کلیک کنید. پس از
انجام این کار و وارد کردن اطلاعات مربوط به گیت‌هاب، حساب لیارا شما به گیت‌هاب متصل خواهد شد:
</p>
<div className="h-2" />
<video
src="https://files.liara.ir/liara/docs/connect-liara-account-to-github.mp4"
controls="controls"
className="block w-full"
width="100%"
></video>
<div className="h-2" />
<Alert variant="error">
<p>
در صورت مواجه با خطای "اتصال به Github"، بایستی از حساب لیارا خود، خارج شده و مجدداً به وسیله Github، به اکانت لیارا خود، وارد شوید.
</p>
</Alert>
<p>
بعد از اتصال به اکانت گیت‌هاب، بر روی گزینه <b>ویرایش دسترسی‌ها</b> کلیک کرده و ریپازیتوری (ریپازیتوری‌های) مدنظرتان را به حساب لیارا متصل کنید.
</p>
<p>
برای این کار در ابتدا، حساب شخصی یا سازمانی خود را انتخاب کنید؛ سپس
در صورتی که قصد دارید تمام ریپازیتوری‌های حساب گیت‌هاب‌تان به لیارا متصل شود؛ گزینه <b>All repositories</b> را انتخاب کنید؛
اما اگر قصد دارید که فقط یک یا چند ریپازیتوری مدنظرتان را انتخاب کنید؛ گزینه <b>Only select repositories</b> را انتخاب کرده و در ادامه ریپازیتوری‌های مدنظرتان را در کشوی باز شده، انتخاب کنید.
در نهایت، بر روی گزینه <b>Install & Authorize</b> کلیک کنید تا ریپازیتوری‌های انتخابی، به حساب لیارا، متصل شوند:
</p>
<div className="h-2" />
<video
src="https://files.liara.ir/liara/docs/edit-access-to-github-account.mp4"
controls="controls"
className="block w-full"
width="100%"
></video>
<div className="h-2" />

<p>
در نهایت، بر روی برنامه خود کلیک کرده وارد صفحه <b>استقرار جدید</b> شوید؛ سپس در منوی <b>گیت‌هاب</b>، ریپازیتوری مدنظرتان را انتخاب کرده و پس از انتخاب نوع استقرار (استقرار در صورت CI موفق یا استقرار خودکار) و branch مدنظرتان، بر روی گزینه <b>اتصال به برنامه</b> کلیک کنید تا برنامه‌تان به ریپازیتوری مدنظرتان متصل شود.
در نهایت، کافیست تا یک‌بار بر روی گزینه <b>استقرار دستی</b> کلیک کنید تا آخرین commit شما در لیارا مستقر شود:
</p>
<div className="h-2" />
<video
src="https://files.liara.ir/liara/docs/deploy-project-using-github.mp4"
controls="controls"
className="block w-full"
width="100%"
></video>
<div className="h-2" />
<p>
پس از انجام کارهای فوق، با هر بار push کردن پروژه‌تان در ریپازیتوری انتخاب شده،
یک استقرار جدید مطابق آخرین تغییرات شما در لیارا، انجام خواهد شد.
</p>
<div className="h-2" />
<Alert variant="error">
<p>
برای قطع ارتباط برنامه و ریپازیتوری نیز، می‌توانید بر روی دکمه <b>قطع اتصال</b> کلیک کنید تا تغییرات جدید، مستقر نشوند.
</p>
</Alert>
<Alert variant="info">
<p>
در صورت انتخاب گزینه <b>استقرار در صورت CI موفق</b>، تمامی تست‌های تعریف شده باید pass شده و تیک سبز رنگ گرفته باشند، در غیر این‌صورت،
پروژه‌تان در لیارا، مستقر نخواهد شد.
</p>
</Alert>
<div className="h-1" />
</>

]}
/>
Expand Down
Loading

0 comments on commit a232422

Please sign in to comment.