معرفی
TypeScript مسلما بهترین های هر دو جهان را ارائه می دهد: انعطاف پذیری جاوا اسکریپت و ایمنی نوع زبان های تایپ ایستا مانند جاوا و C#.
این یک انتخاب محبوب برای ساخت API های REST است زیرا به توسعه دهندگان اجازه می دهد تا خطاها را در مراحل اولیه توسعه پیدا کنند و کدهای قابل نگهداری بیشتری بنویسند. در این آموزش، ما یک TypeScript REST API ساده می‌سازیم و آن را با استفاده از Docker در Render اجرا می‌کنیم.
چرا داکر؟
Docker یک ابزار کانتینری‌سازی محبوب است که به توسعه‌دهندگان اجازه می‌دهد تا برنامه‌ها و وابستگی‌های خود را در یک تصویر واحد بسته بندی کنند که می‌تواند در هر جایی اجرا شود. تصاویر Docker قابل حمل هستند و می توانند در هر ارائه دهنده ابری از جمله Render مستقر شوند. Docker همچنین یک انتخاب عالی برای استقرار برنامه های TypeScript است زیرا به توسعه دهندگان اجازه می دهد تا محیط دقیق و وابستگی های مورد نیاز برای اجرای برنامه را مشخص کنند.
من شخصا Docker را ابزاری عالی برای استقرار برنامه های TypeScript در Render یافته ام. من از Docker برای استقرار تعدادی از برنامه های TypeScript در Render استفاده کرده ام.
Docker درد مدیریت وابستگی ها و محیط ها را از بین برده است و به من اجازه داده است که روی ساخت برنامه های خود تمرکز کنم.
چرا رندر؟
ارائه دهندگان ابری مانند AWS، Heroku، Azure و DigitalOcean طیف گسترده ای از خدمات را برای استقرار برنامه ها ارائه می دهند. با این حال، این خدمات اغلب کاملا رایگان نیستند.
به عنوان مثال، Heroku و Azure، سطوح رایگان را برای توسعه دهندگان دانش آموز ارائه می دهند، اما این سطوح از نظر تعداد ساعات و منابع در دسترس محدود هستند.
از طرف دیگر، رندر یک ردیف رایگان ارائه می دهد که نیازی به فرآیند اضافی برای بازخرید ندارد.
من Render را انتخاب کردم تا همه بتوانند این آموزش را بدون نگرانی در مورد هزینه دنبال کنند.
پیش نیازها
لیست پیش نیازهای پیگیری آموزش شامل نصب نرم افزارهای لازم و ایجاد اکانت رندر
راه اندازی TypeScript REST API
اکنون که همه پیش نیازهای لازم را داریم، می توانیم شروع به ساخت TypeScript REST API خود کنیم. دستمان را کثیف کنیم!
- ایجاد دایرکتوری جدید برای پروژه
mkdir typescript-rest-api && cd typescript-rest-api
- ایجاد یک پروژه TypeScript جدید با npm init
npm init -y
-
نصب وابستگی های لازم (مانند Express و TypeScript)
npm install express typescript @types/express @types/node ts-node-dev --save-dev -
نوشتن کد TypeScript برای نقاط انتهایی REST API
import express, { Request, Response } from "express";
// init APP
const APP = express();
APP.use(express.json());
// GET /api
APP.get("/api", (req: Request, res: Response) => {
res.send("Hello World!");
});
// POST /api
APP.post("/api", (req: Request, res: Response) => {
const { name } = req.body;
res.send(`Hello ${name}!`);
});
// start server
APP.listen(3000, () => {
console.log("Server running on port 3000");
});
- پیکربندی کامپایلر TypeScript برای کامپایل کردن کد به جاوا اسکریپت
npx tsc --init
- فایل tsconfig.json را برای مشخص کردن دایرکتوری خروجی به روز کنید
{
"compilerOptions": {
"outDir": "./dist"
}
}
- فایل package.json را به روز کنید تا اسکریپت شروع را مشخص کنید
{
"scripts": {
"start": "node ./build/index.js",
"build": "tsc",
"server": "nodemon --exec ts-node index.ts"
}
}
داکر کردن TypeScript REST API
- نوشتن یک Dockerfile برای تعیین محیط کانتینر و وابستگی ها
FROM node:14-alpine
WORKDIR /
COPY package\*.json ./
RUN npm install
COPY . .
RUN npm run build
CMD ["npm","start"]
استقرار TypeScript REST API در Render
در Render، می‌توانیم TypeScript REST API خود را به دو روش اجرا کنیم: با استفاده از Render CLI یا استفاده از داشبورد Render. در این آموزش، ما از داشبورد Render برای استقرار TypeScript REST API خود استفاده خواهیم کرد.
برای استقرار TypeScript REST API در Render، باید یک وب سرویس جدید ایجاد کنیم و موارد زیر را مشخص کنیم:
- نام: نام این سرویس است
- مخزن گیت: URL مخزن Git
- شاخه: شاخه ای که از آن مستقر می شود
- دایرکتوری ریشه: دایرکتوری اصلی پروژه (اختیاری)
- زمان اجرا: زمان اجرا برای استفاده (در مورد ما Docker)
می توانید ادامه دهید و یک وب سرویس جدید در Render ایجاد کنید. پس از ایجاد سرویس، Render به طور خودکار TypeScript REST API را مستقر می کند و آن را در URL مشخص شده در تنظیمات سرویس در دسترس قرار می دهد.
تست TypeScript REST API
- تأیید اینکه API به درستی در Render کار می کند
curl https://<service-name>.onrender.com/api
نتیجه
در این آموزش، ما یاد گرفتیم که چگونه یک TypeScript REST API ساده بسازیم و آن را با استفاده از Docker بر روی Render مستقر کنیم. ما همچنین یاد گرفتیم که چگونه API را در Render آزمایش کنیم. امیدوارم از این آموزش لذت برده باشید و برای شما مفید بوده باشد. اگر سؤال یا بازخوردی دارید، لطفاً در زیر نظر دهید.
می توانید سورس کد کامل این آموزش را در گیت هاب بیابید.
کد منبع
منابع اضافی برای یادگیری TypeScript و Docker
اسناد -TypeScript
مستندات داکر
رندر اسناد
هک مبارک!
بنتیل اینجا🚀
آیا تا به حال خواسته اید یک REST API با TypeScript و Docker بسازید؟ آیا این آموزش مفید بود؟ با گذاشتن کامنت در ادامه به من اطلاع دهید. لطفا نظرات و پیشنهادات خود را در بخش نظرات زیر به اشتراک بگذارید. من دوست دارم از شما بشنوم.
لطفاً لایک کنید، به اشتراک بگذارید و من را دنبال کنید تا مقالات جالب دیگری مانند این را دنبال کنید. ممنون که خواندید و شما را در مقاله بعدی می بینم. خداحافظ👋👋👋
