update liara overview docs

liara-cloud · Oct 21, 2024 · e1d57a9 · e1d57a9
1 parent 25e887b
commit e1d57a9
Show file tree

Hide file tree

Showing 6 changed files with 243 additions and 11 deletions.
diff --git a/src/pages/overview/about.mdx b/src/pages/overview/about.mdx
@@ -48,10 +48,6 @@ import Head from "next/head";
 
 <Section id="liara-hosting-system" title="سیستم هاستینگ لیارا" />
 
-با لیارا، شما از یک پلتفرم هاست اشتراکی بهره‌مند می‌شوید که برخلاف VPS، به شما امکان می‌دهد تا وب‌سایت‌ها و برنامه‌های خود را بر روی یک سرور مشترک با منابع بهینه و مدیریت شده، میزبانی کنید. هاست اشتراکی به معنای استفاده چندین کاربر از یک سرور فیزیکی است که منابع آن بین کاربران تقسیم می‌شود.
-البته در نظر داشته باشید که با انجام این کار، منابع شما، کماکان محفوظ می‌ماند و توسط کاربر دیگری، استفاده نمی‌شود. همچنین ترافیک بر روی هاستینگ شما، نا محدود خواهد بود! پس جای نگرانی نیست.
-این نوع میزبانی، نیازی به مدیریت پیچیده سرور ندارد و نیازی نیست که خودتان را درگیر پیکربندی سرور کنید؛ چرا که لیارا از قبل، تمام این کارها را برای شما، انجام داده است.
-هاست اشتراکی لیارا قیمت مناسب‌تر و مدیریت ساده‌تری دارد و شما نیاز به دانش فنی برای مدیریت سرور نخواهید داشت.
-لیارا انتخابی برتر برای کسانی است که به دنبال راه‌اندازی سریع و آسان وب‌سایت‌ها و برنامه‌های خود هستند، بدون نگرانی از مسائل فنی و هزینه‌های بالای VPS.
-
+با لیارا، شما از یک پلتفرم هاست اختصاصی بهره‌مند می‌شوید که برخلاف هاست اشتراکی، تمام منابع سخت‌افزاری پلن انتخابی‌تان، به شما اختصاص داده می‌شود و بر خلاف VPS،
+به شما امکان می‌دهد تا وب‌سایت‌ها و برنامه‌های خود را بر روی یک سرور از پیش آماده شده، بدون نیاز به دانش فنی برای مدیریت سرور و انجام پیکربندی‌های سخت و پیچیده، با منابع بهینه و مدیریت شده، میزبانی کنید.
 </Layout>
diff --git a/src/pages/paas/cicd/github.mdx b/src/pages/paas/cicd/github.mdx
@@ -55,7 +55,7 @@ jobs:
         env:
           LIARA_TOKEN: \${{ secrets.LIARA_API_TOKEN }}
         run: |
-          npm i -g @liara/cli@5
+          npm i -g @liara/cli@7
           liara deploy --app="APP_NAME" --api-token="$LIARA_TOKEN" --no-app-logs`}
     </Highlight>
     </div>
@@ -122,7 +122,7 @@ jobs:
           node-version: "18"
 
       - name: Install Liara CLI
-        run: npm i -g @liara/cli@5
+        run: npm i -g @liara/cli@7
 
       - name: Deploy
         env:

diff --git a/src/pages/paas/cicd/gitlab.mdx b/src/pages/paas/cicd/gitlab.mdx
@@ -53,7 +53,7 @@ deploy:
   only:
     - master
   script:
-    - npm i -g @liara/cli@5
+    - npm i -g @liara/cli@7
     - export http_proxy=http://proxy.liara.ir:6666
     - liara deploy --app APP_NAME --api-token $TOKEN --no-app-logs`}
     </Highlight>

diff --git a/src/pages/paas/details/about.mdx b/src/pages/paas/details/about.mdx
@@ -71,6 +71,13 @@ import Head from "next/head";
 برای سوالات خود، باشید.
 از این رو، در ادامه، تمامی جزئیات مربوط به پلتفرم برای شما آماده شده‌است تا با مطالعه آن‌ها، دانش شما، بیش از پیش، ارتقا یابد:
 
+<div className="h-6" />
+<video
+src="https://files.liara.ir/liara/docs/platform.mp4"
+controls="controls"
+className="block w-full"
+width="100%"
+></video>
 <div className="h-6" />
 
     <div className="grid md:grid-cols-3 gap-4">

diff --git a/src/pages/paas/docker/quick-start.mdx b/src/pages/paas/docker/quick-start.mdx
@@ -20,7 +20,7 @@ import Head from "next/head";
 <hr className="mb-2" />
 
 <Tabs 
-  tabs={["Liara Console", "Liara CLI"]} 
+  tabs={["Liara Console", "Liara CLI", "Github"]} 
   content={[
   <>
   <video
@@ -225,7 +225,7 @@ CMD ["./main"]`}
   step: "۶",
   content: (
   <>
-        <h3>ایجاد Dockerfile</h3>
+    <h3>ایجاد Dockerfile</h3>
     <p>
       در مسیر اصلی پروژه، یک فایل به نام <Important>Dockerfile</Important> ایجاد کنید و بنا به نیازهای پروژه خود، دستورات مرتبط را درون این فایل، قرار دهید تا پروژه‌تان Dockerize شود. 
       به عنوان مثال، اگر که برنامه‌تان مبتنی بر فریم‌ورک Golang است، می‌توانید قطعه کد زیر را در <Important>Dockerfile</Important>، قرار دهید:    
@@ -282,10 +282,232 @@ CMD ["./main"]`}
 
 ]}/>
   </>,
+  <>
+    <video
+    src="https://files.liara.ir/liara/docs/docker-github.mp4"
+    controls="controls"
+    className="block w-full"
+    width="100%"
+    ></video>
+    <br />
+  برای استقرار با Github، کافیست تا مراحل زیر را طی کنید:
+    <Step  steps={[
+{
+  step: "۱",
+  content: (
+  <>
+    <h3>ورود به حساب کاربری</h3>   
+    <p>وارد <Link className="text-[#2196f3] " href="https://console.liara.ir">کنسول لیارا</Link> شوید و با وارد کردن ایمیل یا شماره همراه ثبت شده، به اکانت خود در لیارا، لاگین کنید.</p>
+  </>
+  )
+  },
+  {
+  step: "۲",
+  content: (
+  <>
+    <h3>ایجاد برنامه</h3>
+    <p>برنامه Docker خود را با شناسه، <Link className="text-[#2196f3] " href="../details/private-network">شبکه خصوصی</Link> و <Link className="text-[#2196f3] " href="../details/plans/about">منابع سخت‌افزاری و بسته امکانات</Link> مدنظرتان ایجاد کنید.</p>
+  </>
+  )
+  },
+  {
+  step: "۳",
+  content: (
+  <>
+    <h3>ایجاد Dockerfile</h3>
+    <p>
+      در مسیر اصلی پروژه، یک فایل به نام <Important>Dockerfile</Important> ایجاد کنید و بنا به نیازهای پروژه خود، دستورات مرتبط را درون این فایل، قرار دهید تا پروژه‌تان Dockerize شود. 
+      به عنوان مثال، اگر که برنامه‌تان مبتنی بر فریم‌ورک Golang است، می‌توانید قطعه کد زیر را در <Important>Dockerfile</Important>، قرار دهید:    
+    </p>
+    <div className="h-2" />
+    <div dir='ltr'>
+    <Highlight className="docker">
+      {`# Use the official Golang image as the base image
+FROM golang:latest
+        
+# Set the working directory inside the container
+WORKDIR /app
+
+# Copy the local code to the container
+COPY . .
+
+# Download Go modules
+RUN go mod download
+
+# Build the Go application
+RUN go build -o main .
+
+# Expose port 8080 to the outside world
+# EXPOSE 8080
+
+# Command to run the executable
+CMD ["./main"]`}
+    </Highlight>
+    </div>
+    <div className="h-2" />
+    <Alert variant="info">
+    <p>
+      شما می‌توانید با استفاده از دستور <Important>EXPOSE</Important> پورتی که برنامه توسط آن به درخواست کاربران گوش می‌دهد را مشخص کنید. البته چون که در حین استقرار، لیارا از شما port برنامه را می‌پرسد بنابراین برای استقرار برنامه‌های داکرایز شده در لیارا، نیازی به نوشتن این دستور در <Important>Dockerfile</Important> نیست.
+    </p>
+    </Alert>
+  </>
+  )
+  },
+  {
+  step: "۴",
+  content: (
+  <>
+    <h3>ساخت فایل <Important>liara.json</Important></h3>
+    <p>
+      در مسیر اصلی پروژه، یک فایل به نام <Important>liara.json</Important> ایجاد کنید و پیکربندی‌های مدنظرتان را در این فایل بنویسید؛ به عنوان مثال:
+    </p>
+        <div className="h-4" />
+        <div dir='ltr'>
+            <Highlight className="json">
+                {`{ 
+    {
+    "port": 8080,
+    "build": {
+        "dockerfile": "./Dockerfile",
+        "cache": false,
+        "args": ["APP_VERSION=2.0.0"]
+    },
+
+    "docker": {
+        "timezone": "America/Los_Angeles"
+    },
+
+    "args": [
+    "sh",
+    "-c",
+    "sleep 10 && /entrypoint.sh run"
+    ]
+  }
+}`}
+            </Highlight>
+        </div>
+        <Alert variant='error'>
+          <p>
+            در فایل فوق، برای جلوگیری از خطا خوردن فرایند استقرار، از فیلدهای <Important>app</Important> و <Important>platform</Important> استفاده نکنید؛ چرا که لیارا، آن‌ها را به صورت خودکار، تشخیص خواهد داد.
+          </p>  
+        </Alert>
+  </>
+  )
+  },
+  {
+  step: "۵",
+  content: (
+
+  <>
+    <h3>ساخت ریپازیتوری در گیت‌هاب</h3>
+    <p>
+      یک ریپازیتوری در حساب گیت‌هاب خود برای برنامه‌مدنظرتان با نام دلخواه‌تان ایجاد کنید.
+    </p>
+  <div className="h-2" />
+  <Alert variant="success">
+<p>
+در صورتی که از قبل، این کار را انجام داده‌اید یا قصد دارید از ریپازیتوری‌های فعلی خود استفاده کنید؛ از این مرحله بگذرید.
+</p>
+</Alert>
+  </>
+  )
+  },
+  {
+  step: "۶",
+  content: (
+  <>
+    <h3>آپلود پروژه در گیت‌هاب</h3>
+    <p>
+      پروژه نهایی خود را در ریپازیتوری‌تان در گیت‌هاب آپلود کنید؛
+      حتماً در نظر داشته باشید که درون پروژه‌تان، فایل <Important>gitignore.</Important> قرار داشته باشد و درون آن، فایل‌های اضافی 
+      برنامه، که قصد ندارید آپلود شوند؛ لیست شده باشند.
+    </p>
+  </>
+  )
+  },
+  {
+  step: "۷",
+  content: (
+  <>
+    <h3>اتصال لیارا به گیت‌هاب</h3>
+    <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-1" />
+    <img src="https://files.liara.ir/liara/docs/connect-to-github-on-liara.png" alt="connect to github on liara account" />
+    <div className="h-1" />
+    <p> 
+      پس از 
+      انجام این کار و وارد کردن اطلاعات مربوط به گیت‌هاب، حساب لیارا شما به گیت‌هاب متصل خواهد شد.
+    </p>
+    <div className="h-1" />
+    <img src="https://files.liara.ir/liara/docs/added-github-account-on-liara.png" alt="added github account on liara" />
+    <div className="h-1" />
+
+  <div className="h-2" />
+  <Alert variant="error">
+<p>
+  در صورت مواجه با خطای "اتصال به Github"، بایستی از حساب لیارا خود، خارج شده و مجدداً به وسیله Github، به اکانت لیارا خود، وارد شوید.
+</p>
+</Alert>
+  </>
+  )
+  },
+  {
+  step: "۸",
+  content: (
+  <>
+    <h3>ویرایش دسترسی‌ها</h3>
+    <p>
+      بعد از اتصال به اکانت گیت‌هاب، بر روی گزینه <b>ویرایش دسترسی‌ها</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" />
+  </>
+  )
+  },
+  {
+  step: "۹",
+  content: (
+  <>
+    <h3>استقرار برنامه</h3>
+    <p>
+        در نهایت، بر روی برنامه خود کلیک کرده وارد صفحه <b>استقرار جدید</b> شوید؛ سپس در منوی <b>گیت‌هاب</b>، ریپازیتوری مدنظرتان را انتخاب کرده و پس از انتخاب نوع استقرار و 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" />
+    <Alert variant="info">
+<p>
+  برای قطع ارتباط برنامه و ریپازیتوری نیز، می‌توانید بر روی دکمه <b>قطع اتصال</b> کلیک کنید تا تغییرات جدید، مستقر نشوند.
+</p>
+</Alert>
+<div className="h-1" />
+
+  </>
+  )
+  }
 
+]}/>
+
+  </>,
 ]} 
 />
 
+
 <br/>   
 <Alert variant="info">
 <p>

diff --git a/src/pages/paas/static/quick-start.mdx b/src/pages/paas/static/quick-start.mdx
@@ -197,6 +197,13 @@ import Head from "next/head";
 ]}/>
   </>,
     <>
+    <video
+    src="https://files.liara.ir/liara/docs/static-github.mp4"
+    controls="controls"
+    className="block w-full"
+    width="100%"
+    ></video>
+    <br />
     برای استقرار با Github، کافیست تا مراحل زیر را طی کنید:
     <Step  steps={[
 {