docs: add oca/list monk

liara-cloud · Nov 18, 2024 · 576b5b7 · 576b5b7
1 parent 136c8d5
commit 576b5b7
Show file tree

Hide file tree

Showing 3 changed files with 286 additions and 0 deletions.
diff --git a/src/components/Sidebar/data.js b/src/components/Sidebar/data.js
@@ -5731,6 +5731,41 @@ export default {
         link: "/one-click-apps/meilisearch/how-tos/choose-version"
       },
     ], 
+    listmonk: [
+      {
+        badge: (
+          <div className="flex items-center gap-2">
+            برنامه Listmonk
+          </div>
+        )
+      },
+      {
+        title: "برگشت به برنامه‌های آماده",
+        icon: <GoArrowRight />,
+        link: "/one-click-apps/about"
+      },
+      {
+        title: "راه‌اندازی سریع!",
+        icon: <GoZap  />,
+        link: "/one-click-apps/listmonk/quick-start"
+      },
+      {
+        hr: true
+      },
+      {
+        badge: (
+          <div className="flex items-center gap-2">
+          < GoPackage   />
+            شیوه‌ی
+          </div>
+        )
+      },
+      {
+        title: "تغییر نسخه‌ی برنامه مستقر شده",
+        link: "/one-click-apps/listmonk/how-tos/choose-version"
+      },
+    ], 
+
     'jupyter-notebook': [
       {
         badge: (

diff --git a/src/pages/one-click-apps/listmonk/how-tos/choose-version.mdx b/src/pages/one-click-apps/listmonk/how-tos/choose-version.mdx
@@ -0,0 +1,100 @@
+import Layout from "@/components/Layout";
+import Button from "@/components/Common/button";
+import Section from "@/components/Common/section";
+import Alert from "@/components/Common/alert";
+import Tabs from "@/components/Common/tab";
+import Step from "@/components/Common/step";
+import Card from "@/components/Common/card";
+import Important from "@/components/Common/important";
+import Highlight from "@/components/Common/highlight";
+import Link from "next/link";
+import {GoArrowLeft} from "react-icons/go";
+
+import Head from "next/head";
+
+<Layout>
+<Head>
+<title>مستندات تغییر نسخه Listmonk - لیارا</title>
+<meta property="og:title" content="مستندات خدمات رایانش ابری لیارا" />
+<meta property="og:description" content="مستندات مربوط به نحوه تغییر نسخه برنامه Listmonk در لیارا"  />
+<meta property="og:image" content="https://files.liara.ir/liara/logos/liara-poster.jpg" />
+</Head>
+# تغییر نسخه‌ی برنامه مستقر شده
+<hr className="mb-2" />
+<Tabs 
+    tabs={["Liara Console", "Liara CLI"]} 
+    content={[
+    <>
+      <p>
+        اگر که قصد دارید نسخه برنامه خود را بنا به هر دلیلی تغییر دهید؛ کافیست تا پس از <a href="../../quick-start" className="text-[#2196f3] ">ساخت برنامه در لیارا</a>، در کنسول، در برنامه‌تان، وارد صفحه <b>استقرار جدید</b> شوید، تب <b>Docker Hub</b> را انتخاب کنید و سپس بر روی گزینه <b>شروع استقرار image از Docker Hub</b> کلیک کنید؛ بعد از انجام این کار، به صفحه جدیدی هدایت می‌شوید که کافیست تنها در قسمت <b>نام image</b>، نسخه مورد نظرتان (tag) را پس از <Important>:</Important> وارد کرده و سپس مراحل استقرار را بدون اعمال تغییر دیگری، جلو ببرید:
+      </p> 
+      <div className="h-4" />
+      <video
+        src="https://files.liara.ir/liara/docs/update-one-click-app-version-by-liara-console.mp4"
+        controls="controls"
+        className="block w-full"
+        width="100%"
+      />
+      <div className="h-4" />
+      <p>
+        با انجام کار فوق، نسخه برنامه مدنظرتان، تغییر خواهد کرد.
+      </p>        
+    </>,
+    <>
+      <p>
+        اگر که قصد دارید نسخه برنامه خود را بنا به هر دلیلی تغییر دهید؛ کافیست تا پس از <a href="../../quick-start" className="text-[#2196f3] ">ساخت برنامه در لیارا</a>، در Local یک دایرکتوری با نام دلخواه ایجاد کنید.
+        وارد دایرکتوری شده و درون این دایرکتوری، یک فایل به نام <Important>liara.json</Important>، ایجاد کنید. سپس کافیست تا قطعه کد زیر را درون آن، قرار دهید:
+      </p>  
+
+<div className="h-4" />
+<div dir='ltr'>
+    <Highlight className="json">
+      {`{
+    "image": "listmonk/listmonk:<your-version>",
+    "port": 9000,
+    "app": "<your-app-name>",
+    "disks": [
+      {
+        "name": "uploads",
+        "mountTo": "/listmonk/uploads"
+      }
+  ]
+}`}
+    </Highlight>
+</div>
+<div className="h-2" />
+
+<p>
+در قطعه کد فوق، بایستی به جای عبارت <Important>{"<your-version>"}</Important> 
+ورژن موردنظر برنامه‌تان را وارد کنید.
+همچنین باید به جای عبارت
+<Important>{"<your-app-name>"}</Important> نیز، 
+شناسه برنامه خود را قرار دهید. 
+</p>
+<div className="h-2" />
+
+در نهایت کافیست با استفاده از ابزار <a href="/references/cli/about" className="text-[#2196f3] "><Important>Liara CLI</Important></a> و در جایی که فایل <Important>liara.json</Important> قرار دارد، دستور زیر را اجرا کنید تا برنامه‌تان در لیارا، مستقر شود:
+
+<div className="h-4" />
+<div dir='ltr'>
+    <Highlight className="json">
+      {`liara deploy`}
+    </Highlight>
+</div>
+<div className="h-2" />
+</>
+    ]}
+/>
+
+<Alert variant="success">
+<p>
+  برای مشاهده تمامی تگ‌های موجود، می‌توانید به <a href="https://hub.docker.com/r/listmonk/listmonk/tags" className="text-[#2196f3]">داکرهاب رسمی برنامه</a>، مراجعه کنید.
+</p>
+</Alert>
+<Alert variant="success">
+<p>
+  برای اطلاعات بیشتر مربوط به پیکربندی برنامه و اطلاع از متغیرهای محیطی آن، می‌توانید به <a href="https://listmonk.app/docs/configuration/" className="text-[#2196f3]">مستندات رسمی برنامه</a>، مراجعه کنید.
+</p>
+</Alert>
+
+</Layout>
diff --git a/src/pages/one-click-apps/listmonk/quick-start.mdx b/src/pages/one-click-apps/listmonk/quick-start.mdx
@@ -0,0 +1,151 @@
+import Layout from "@/components/Layout";
+import Button from "@/components/Common/button";
+import Section from "@/components/Common/section";
+import Alert from "@/components/Common/alert";
+import Tabs from "@/components/Common/tab";
+import Step from "@/components/Common/step";
+import Card from "@/components/Common/card";
+import Important from "@/components/Common/important";
+import Highlight from "@/components/Common/highlight";
+import Link from "next/link";
+import {GoArrowLeft} from "react-icons/go";
+
+import Head from "next/head";
+
+<Layout>
+<Head>
+<title>مستندات راه‌اندازی سریع برنامه‌های Listmonk - لیارا</title>
+<meta property="og:title" content="مستندات خدمات رایانش ابری لیارا" />
+<meta property="og:description" content="مستندات مربوط به نحوه راه‌اندازی سریع برنامه Listmonk در لیارا"  />
+<meta property="og:image" content="https://files.liara.ir/liara/logos/liara-poster.jpg" />
+</Head>
+
+# راه‌اندازی سریع برنامه‌های Listmonk
+<hr className="mb-2" />
+
+{/* <div className="h-2" />
+<video
+src="https://files.liara.ir/liara/docs/Listmonk.mp4"
+controls="controls"
+className="block w-full"
+width="100%"
+/>
+<br /> */}
+
+<a href="https://listmonk.app/" className="text-[#2196f3] ">Listmonk</a> یک نرم‌افزار متن‌باز برای مدیریت خبرنامه‌ها و کمپین‌های ایمیلی است. این ابزار بر پایه زبان Go و رابط کاربری React توسعه یافته و امکان ارسال ایمیل‌های انبوه به صورت سریع و کارآمد را فراهم می‌کند. Listmonk قابلیت‌هایی مانند مدیریت لیست‌های مشترکین، گزارش‌گیری دقیق، شخصی‌سازی ایمیل‌ها، و پشتیبانی از SMTP و API‌های ارسال ایمیل را ارائه می‌دهد. با نصب آسان و قابل اجرا در سرورهای شخصی، گزینه‌ای مناسب برای سازمان‌ها و کسب‌وکارهایی است که به دنبال راهکاری مقرون‌به‌صرفه و مستقل هستند.
+
+برای راه‌اندازی برنامه با استفاده از ابزار <Link className="text-[#2196f3] " href="/references/console/about">Liara Console</Link> کافیست تا مراحل زیر را طی کنید:
+
+<Step  steps={[
+{
+step: "۱",
+content: (
+<>
+<h3>ورود به حساب کاربری</h3>   
+<p>وارد <Link className="text-[#2196f3] " href="https://console.liara.ir">کنسول لیارا</Link> شوید و با وارد کردن ایمیل یا شماره همراه ثبت شده، به اکانت خود در لیارا، لاگین کنید.</p>
+</>
+)
+},
+{
+step: "۲",
+content: (
+<>
+<h3>راه‌اندازی برنامه</h3>
+<p>
+    بر روی منوی <b>برنامه‌های آماده</b> و سپس بر روی برنامه <b>listmonk</b>، کلیک کنید. 
+    در ادامه، می‌توانید از گزینه <b>نصب سریع</b> یا گزینه <b>نصب پیشرفته</b> برای استقرار و نصب برنامه‌تان استفاده کنید:
+</p>
+<Tabs 
+    tabs={["نصب سریع", "نصب پیشرفته"]} 
+    content={[
+    <>
+      <p>
+      در صورتی که از قابلیت <b>نصب سریع</b> استفاده کنید؛ لیارا از شما می‌خواهد که یک 
+      ‌نام برای برنامه خود، انتخاب کنید؛ که شما می‌توانید در صورت تمایل و پس از وارد کردن نام موردنظرتان برای برنامه، بر روی گزینه <b>نصب و راه‌اندازی</b> کلیک کنید تا برنامه‌‌تان ساخته و نصب شود. 
+      </p>
+
+      <div className="h-4" />
+      <img src="https://files.liara.ir/liara/docs/one-click-app-quick-setup.gif" alt="create one click app using quick setup feature" />
+      <div className="h-4" />
+
+      <p>
+        با انجام کار فوق، لیارا برای برنامه(برنامه‌ها)ی شما،   
+        شناسه منحصربه‌فرد و یک <a href="/paas/details/private-network" className="text-[#2196f3]">شبکه خصوصی</a> جدید با <a href="/paas/details/plans/hardware-plans" className="text-[#2196f3]">پلن سخت‌افزاری</a> و <a href="/paas/details/plans/software-plans" className="text-[#2196f3]">بسته امکانات </a> پیش‌فرض، ایجاد می‌کند و پس از موفقیت آمیز بودن نصب برنامه، شما می‌توانید وضعیت برنامه‌تان 
+        را در بخش <a href="/paas/details/events" className="text-[#2196f3]">رویدادها</a> و <a href="/paas/details/observations/software" className="text-[#2196f3]">لاگ‌ها</a> بررسی کنید.
+      </p>   
+    </>,
+    <>
+      <p>
+        در صورتی که بر روی گزینه <b>نصب پیشرفته</b> کلیک کنید به یک صفحه جدید هدایت می‌شوید که 
+        در این صفحه می‌توانید برای برنامه (برنامه‌ها) و دیتابیس (دیتابیس‌ها)ی مدنظرتان شناسه  
+        و <a href="/paas/details/plans/hardware-plans" className="text-[#2196f3]">پلن سخت‌‌افزاری</a> انتخاب کنید. 
+        در نظر داشته باشید که <a href="/paas/details/plans/software-plans" className="text-[#2196f3]">بسته امکانات</a> برنامه‌تان، متناسب 
+        با نیازهای برنامه‌تان است که به صورت پیش‌فرض انتخاب می‌شود.
+      </p>
+      <div className="h-4" />
+      <p>
+        در این صفحه، شما می‌توانید <a href="/paas/details/private-network" className="text-[#2196f3]">شبکه خصوصی</a> مدنظرتان را انتخاب کنید 
+        تا برنامه‌تان در شبکه خصوصی انتخاب‌شده، نصب شود. در صورتی که شبکه خصوصی برای برنامه انتخاب نشود، 
+        لیارا به صورت خودکار، یک شبکه خصوصی برای برنامه‌تان ایجاد می‌کند.
+      </p>
+      <div className="h-4" />
+      <p>
+        همچنین، شما می‌توانید با کلیک بر روی گزینه <b>ویرایش Liara Compose</b>، <Important>Liara Compose</Important> برنامه را بنا به نیاز خود، شخصی‌سازی کنید. 
+        در این فایل، شما می‌توانید تگ داکرایمیج، آیدی، پلن سخت‌افزاری، بسته امکانات، متغیرهای محیطی و ... برنامه‌تان 
+        را تغییر داده یا سازمان‌دهی کنید.
+      </p>
+      <div className="h-4" />
+      <Alert variant="success">
+        <p>
+          همچنین بخوانید: <a href="/one-click-apps/liara-compose/about/" className="text-[#2196f3]">فایل <Important>Liara Compose</Important> چیست؟</a>
+        </p>
+      </Alert>
+      <Alert variant="info">
+        <p>
+          محتوای کامل <Important>Liara Compose</Important> برنامه در <a href="https://github.com/liara-cloud/compose-templates/blob/master/Listmonk/liara-compose.yaml" className="text-[#2196f3]">اینجا</a>، قرار گرفته است.
+        </p>
+      </Alert>
+    </>
+    ]} 
+  />
+
+</>
+)
+},
+
+]}/>
+
+<div className='h-4' />
+<Alert className="info">
+  <p>
+    در اولین ورود به حساب کاربری برنامه‌تان، مقدار پیش‌فرض <Important>Username</Important> برابر با <Important>admin</Important> است و مقدار <Important>Password</Important> را نیز می‌توانید 
+    در بخش <a href="/paas/details/envs/#see-envs" className="text-[#2196f3]">متغیرهای محیطی برنامه</a> با نام <Important>LISTMONK_ADMIN_PASSWORD</Important>، ببینید.
+  </p>
+</Alert>
+<div className='h-2' />
+
+<Section id="see-also" title="همچنین بخوانید:" />
+
+<div className='h-2' />
+<div className="grid md:grid-cols-1 gap-4">
+            {[
+      {
+        title: "تغییر نسخه‌ی برنامه مستقر شده",
+        link: "/one-click-apps/Listmonk/how-tos/choose-version"
+      },
+  ].map(item =>
+    <Link href={item.link}>
+    <Card className="flex cursor-pointer w-full items-center justify-between">
+        <div className="flex items-center gap-3">
+        <h4>
+            {item.title}
+        </h4>
+        </div>
+        <GoArrowLeft className="ml-1" />
+    </Card>
+    </Link>
+            )}
+</div>
+
+
+</Layout>