diff --git a/src/pages/paas/dotnet/how-tos/deploy-app.mdx b/src/pages/paas/dotnet/how-tos/deploy-app.mdx index fe2ecb30..810e01f1 100644 --- a/src/pages/paas/dotnet/how-tos/deploy-app.mdx +++ b/src/pages/paas/dotnet/how-tos/deploy-app.mdx @@ -23,7 +23,7 @@ import Head from "next/head";

@@ -216,6 +216,256 @@ import Head from "next/head";

, + <> +

+ پس از ساخت برنامه، باید در مسیر اصلی پروژه، یک فایل به نام gitignore. ایجاد کنید و درون آن، اسامی تمامی فایل‌ها یا پوشه‌هایی که قصد ندارید در لیارا آپلود شوند را، وارد کنید؛ به عنوان مثال، نیازی به آپلود دایرکتوری‌های obj و bin به همراه محتوای آن‌ها نیست؛ چرا که لیارا در حین استقرار برنامه، آن‌ها را برای شما می‌سازد؛ پس بایستی اسامی این دایرکتوری‌ها در فایل فوق، نوشته شود؛ قطعه کد قرار گرفته در لینک زیر، یک gitignore. عالی برای برنامه‌های NET. است که می‌توانید از آن، استفاده کنید: +

+
+ + +
+

+ نمونه فایل gitignore. برای برنامه‌های NET. +

+
+ +
+ +
+

+ همچنین، پروژه شما باید شامل یک فایل با پسوند csproj. باشد؛ + فایل csproj. به طور خودکار با ایجاد پروژه ساخته می‌شود و شامل تنظیمات و اطلاعاتی مانند نام پروژه، نسخه NET. مورد استفاده، وابستگی‌ها و ... می‌باشد. به عنوان مثال، محتوای یک فایل csproj. برای یک پروژه کنسولی می‌تواند به صورت زیر باشد: +

+
+
+ + {` + + + Exe + net6.0 + + + +`} + +
+
+

+ در ادامه برای تعیین پورتی که برنامه‌تان در آن به درخواست کاربران listen می‌کند؛ بایستی در مسیر اصلی پروژه، یک فایل به نام liara.json ایجاد کنید + و قطعه کد زیر را در آن قرار دهید (مقدار فیلد پورت را باید با توجه به پورت اصلی برنامه، بنویسید): +

+
+
+ + {`{ + "port": 80, +}`} + +
+
+ +

+ برای تعیین نسخه dotnet برنامه خود نیز، کافیست تا در فایل liara.json فیلد version را قرار دهید: +

+
+
+ + {`{ + "dotnet": { + "version": "6.0" + } +}`} + +
+ همچنین بخوانید: نسخه‌های قابل ارائه NET. در لیارا +

+ به صورت پیش‌فرض، منطقه‌ی زمانی برنامه‌تان بر روی Asia/Tehran تنظیم شده است؛ برای تغییر مقدار پیش‌فرض، می‌توانید از پارامتر timezone در فایل liara.json استفاده کنید؛ به عنوان مثال: +

+
+
+ + {`{ + "dotnet": { + "timezone": "America/Los_Angeles" + } +}`} + +
+
+

+ لیارا نام فایل Dll نهایی پس از build را به صورت خودکار تشخیص می‌دهد. اما در صورتی که پروژه‌ی شما متشکل از چندین پروژه‌ی دیگر هم باشد، لازم است که نام فایل را بدون پسوند در فیلد finalDllName در فایل liara.json وارد کنید، به عنوان مثال: +

+
+
+ + {`{ + "dotnet": { + "finalDllName": "MyProjectName" + } +}`} + +
+
+

+ در ادامه، لیارا فایل csproj. برنامه‌ی شما را به صورت خودکار تشخیص می‌دهد. اما برای اطمینان بیشتر از استقرار موفق، می‌توانید مسیر این فایل را به صورت نسبی، در فیلد csprojectFile در فایل liara.json مشخص کنید؛ به عنوان مثال: + +

+
+
+ + {`{ + "dotnet": { + "csprojectFile": "path/to/folder/my.csproj" + } +}`} + +
+
+

+ در نهایت، یک فایل liara.json می‌تواند مانند قطعه کد زیر باشد: +

+
+
+ + {`{ + + "port": 80, + "dotnet": { + "version": "6.0", + "timezone": "America/Los_Angeles", + } +}`} + +
+ همچنین بخوانید: تعیین موقعیت build برنامه +

+ در ادامه، بایستی یک ریپازیتوری در حساب گیت‌هاب خود برای برنامه‌مدنظرتان با نام دلخواه‌تان ایجاد کنید، برای این کار، پس از ورود به گیت‌هاب، وارد بخش Repositories شوید و بر روی دکمه New کلیک کنید؛ پس از نوشتن نام و توضیحات ریپازیتوری، سطح دسترسی ریپازیتوری را (public یا private)، انتخاب کنید و در نهایت بر روی دکمه create repository کلیک کنید تا ریپازیتوری برای‌تان ساخته شود: +

+
+ +
+ +

+ در صورتی که از قبل، این کار را انجام داده‌اید یا قصد دارید از ریپازیتوری‌های فعلی خود استفاده کنید؛ نیازی به ساخت ریپازیتوری جدید نیست. +

+
+

+ اکنون، باید پروژه نهایی خود را در ریپازیتوری‌تان در گیت‌هاب آپلود کنید؛ + حتماً در نظر داشته باشید که درون پروژه‌تان، فایل gitignore. قرار داشته باشد و درون آن، فایل‌های اضافی + برنامه، که قصد ندارید آپلود شوند؛ لیست شده باشند. می‌توانید برای آپلود، مانند دستورات زیر + در ترمینال ریشه پروژه‌تان، عمل کنید: +

+
+
+ + {`git init # تعریف اولیه مخزن در ریشه پروژه`} + +
+
+ + {`git add . # اضافه کردن تمامی فایل‌ها به استیج`} + +
+
+ + {`git commit -m "make ready to deploy on liara" # ثبت کامیت`} + +
+
+ + {`git remote add origin https://github.com/your-account-user/your-repo-name.gi # افزودن دسترسی ریموت به مخزن`} + +
+
+ + {`git push origin master # آپلود پروژه در گیت‌هاب`} + +
+
+ +

+ در صورتی که هنوز git را در سیستم عامل خود نصب ندارید؛ می‌توانید آن را از اینجا، دانلود و نصب نمایید. +

+
+ +

+ اگر که از قبل، پروژه نهایی خود را همراه با فایل liara.json، در گیت‌هاب آپلود کرده‌اید؛ نیازی به انجام مجدد این کار نیست. +

+
+

+ در ادامه، بایستی حساب لیارا خود را به گیت‌هاب متصل کنید. برای اتصال حساب لیارا خود به گیت‌هاب، در لیارا بر روی پروفایل خود کلیک کرده و وارد زیر قسمت حساب کاربری شوید. در ادامه + وارد منوی گیت‌هاب شوید و بر روی دکمه اتصال به گیت‌هاب، کلیک کنید. پس از + انجام این کار و وارد کردن اطلاعات مربوط به گیت‌هاب، حساب لیارا شما به گیت‌هاب متصل خواهد شد: +

+
+ +
+ +

+ در صورت مواجه با خطای "اتصال به Github"، بایستی از حساب لیارا خود، خارج شده و مجدداً به وسیله Github، به اکانت لیارا خود، وارد شوید. +

+
+

+ بعد از اتصال به اکانت گیت‌هاب، بر روی گزینه ویرایش دسترسی‌ها کلیک کرده و ریپازیتوری (ریپازیتوری‌های) مدنظرتان را به حساب لیارا متصل کنید. +

+

+ برای این کار در ابتدا، حساب شخصی یا سازمانی خود را انتخاب کنید؛ سپس + در صورتی که قصد دارید تمام ریپازیتوری‌های حساب گیت‌هاب‌تان به لیارا متصل شود؛ گزینه All repositories را انتخاب کنید؛ + اما اگر قصد دارید که فقط یک یا چند ریپازیتوری مدنظرتان را انتخاب کنید؛ گزینه Only select repositories را انتخاب کرده و در ادامه ریپازیتوری‌های مدنظرتان را در کشوی باز شده، انتخاب کنید. + در نهایت، بر روی گزینه Install & Authorize کلیک کنید تا ریپازیتوری‌های انتخابی، به حساب لیارا، متصل شوند: +

+
+ +
+ +

+ در نهایت، بر روی برنامه خود کلیک کرده وارد صفحه استقرار جدید شوید؛ سپس در منوی گیت‌هاب، ریپازیتوری مدنظرتان را انتخاب کرده و پس از انتخاب نوع استقرار (استقرار در صورت CI موفق یا استقرار خودکار) و branch مدنظرتان، بر روی گزینه اتصال به برنامه کلیک کنید تا برنامه‌تان به ریپازیتوری مدنظرتان متصل شود. + در نهایت، کافیست تا یک‌بار بر روی گزینه استقرار دستی کلیک کنید تا آخرین commit شما در لیارا مستقر شود: +

+
+ +
+

+ پس از انجام کارهای فوق، با هر بار push کردن پروژه‌تان در ریپازیتوری انتخاب شده، + یک استقرار جدید مطابق آخرین تغییرات شما در لیارا، انجام خواهد شد. +

+
+ +

+ برای قطع ارتباط برنامه و ریپازیتوری نیز، می‌توانید بر روی دکمه قطع اتصال کلیک کنید تا تغییرات جدید، مستقر نشوند. +

+
+ +

+ در صورت انتخاب گزینه استقرار در صورت CI موفق، تمامی تست‌های تعریف شده باید pass شده و تیک سبز رنگ گرفته باشند، در غیر این‌صورت، + پروژه‌تان در لیارا، مستقر نخواهد شد. +

+
+
+ + + ]} /> diff --git a/src/pages/paas/dotnet/quick-start.mdx b/src/pages/paas/dotnet/quick-start.mdx index c93fcce6..8bdfae5c 100644 --- a/src/pages/paas/dotnet/quick-start.mdx +++ b/src/pages/paas/dotnet/quick-start.mdx @@ -19,7 +19,7 @@ import Head from "next/head";