شما در حال مشاهده مستندات Apigee Edge هستید.
به مستندات Apigee X مراجعه کنید . اطلاعات
این مبحث سادهترین روش برای قرار دادن یک برنامه Node.js در یک پروکسی API با استفاده از رابط کاربری مدیریتی را توضیح میدهد.
مقدمه
احتمالاً اولین برنامه Node.js که تا به حال ساختهاید، یک سرور HTTP بوده که به درخواستها با "Hello World!" پاسخ میدهد. سادهترین راه برای امتحان کردن Node.js در Apigee Edge انجام کاری بسیار مشابه است. تنها با چند کلیک ماوس، یک سرور HTTP Node.js پروکسی شده و فعال در Edge خواهید داشت. پس از آن، میتوانید از ویرایشگر کد در رابط کاربری برای تغییر برنامه Node.js، اضافه کردن فایلهای Node.js اضافی، اضافه کردن سیاستها و غیره استفاده کنید.
ایجاد پروکسی API نمونه Hello World!
این بخش نحوه ایجاد یک پروکسی API Edge را که با یک سرور HTTP Node.js تعامل دارد، توضیح میدهد. کد سرور HTTP Node.js از قبل برای شما نوشته شده است و با دنبال کردن این مراحل ساده، به طور خودکار در Edge مستقر میشود.- در ویزارد ساخت پروکسی، Node.js App را انتخاب کنید.
- روی بعدی کلیک کنید.
- مراحل ساخت پروکسی را دنبال کنید و انتخابهای زیر را انجام دهید.
میدان انتخاب جزئیات نام پروکسی Nodejs-Helloرا وارد کنید. نامی که برای API شما نمایش داده میشود.مسیر پایه پروکسی وارد nodejs-hello شوید منبع نمونه "Hello World" را انتخاب کنید. (در ادامه در مورد گزینههای دیگر صحبت خواهیم کرد.) توضیحات توضیحات مربوط به API را وارد کنید. امنیت عبور (هیچ) گزینه عبور (بدون دسترسی) را انتخاب کنید. یک پروکسی عبور ساده ایجاد میکند. میزبانهای مجازی پیشفرض، امن مقادیر پیشفرض را تغییر ندهید. برای کسب اطلاعات بیشتر در مورد میزبانهای مجازی، به «درباره میزبانهای مجازی (بتا)» مراجعه کنید. ساختن محیطهای استقرار آزمون را انتخاب کنید. - روی ساخت و استقرار کلیک کنید
در پاسخ، باید تأییدیهای مبنی بر موفقیتآمیز بودن ایجاد و استقرار پروکسی API جدید شما در محیط «آزمایشی» مشاهده کنید. - برای نمایش صفحه جزئیات پروکسی API، روی گزینه «مشاهده پروکسی <proxy name>» در ویرایشگر کلیک کنید.
فراخوانی پروکسی hello
وقتی شماhello proxy را فراخوانی میکنید، برنامه Node.js به طور خودکار اجرا میشود و با عبارت "Hello, World!" پاسخ میدهد. توجه داشته باشید که مگر اینکه شما طور دیگری مشخص کرده باشید، برنامه Node.js در محیطی به نام test مستقر میشود. در اینجا فراخوانی اولیه با استفاده از Curl آمده است (نام سازمان خود را به جای myorg قرار دهید).
$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, World!
مشاهده و ویرایش کد Node.js
بیایید نگاهی به کد Node.js که به پروکسی API اضافه شده است بیندازیم. به صفحه خلاصه پروکسی Hello World بروید و روی Develop کلیک کنید.
این کار نمای توسعه (Develop view) را باز میکند که شامل یک ویرایشگر کد است. میتوانید کد را مستقیماً در آنجا ویرایش کنید.
برای مثال، پاسخ را از Hello, World! به چیز دیگری مانند Hello, Node! تغییر دهید، سپس روی «ذخیره» کلیک کنید. پروکسی ذخیره و مجدداً مستقر میشود.
در نهایت، برای تأیید تغییر، پروکسی را دوباره فراخوانی کنید:
$ curl http://myorg-test.apigee.net/nodejs-hello
Hello, Node!
اطلاعات بیشتر در مورد اجرای برنامههای Node.js روی Apigee Edge
مانند تمام برنامههای Node.js، برنامههای Node.js که روی Apigee Edge اجرا میشوند، در یک نخ کنترل واحد اجرا میشوند. نیازی (و در واقع هیچ توانایی) برای شروع نخ دیگر یا همگامسازی متغیرها بین نخها وجود ندارد. از آنجایی که Node.js برنامهنویسی غیر مسدودکننده را اجرا میکند، یک اسکریپت واحد میتواند از هزاران درخواست همزمان پشتیبانی کند، زیرا اسکریپت هر زمان که مجبور به انتظار برای چیزی باشد، CPU را رها میکند و بعداً از وقوع آن مطلع میشود.
برای استفاده از Node.js در Apigee Edge، باید یک فایل اسکریپت اصلی Node.js مشخص کنید. این اسکریپت باید برای مدیریت درخواستهای ورودی پیکربندی شود، که معمولاً با استفاده از ماژولهای http یا https ، ایجاد یک کلاینت و غیره انجام میشود. (اگر اسکریپت اصلی به این روش پیکربندی نشده باشد، پس از استقرار، به سادگی اجرا و خارج میشود.) در Apigee Edge، هر اسکریپت برنامه Node.js از ابتدا هنگام استقرار پروکسی شروع میشود و هنگامی که پروکسی مستقر نمیشود، متوقف میشود. در این بین، منتظر درخواستهای جدید میماند و آنها را پردازش میکند. برای اطلاعات بیشتر، به بخش «استناد به فایل Node.js وارد شده» در استقرار یک برنامه مستقل Node.js مراجعه کنید.
مراحل بعدی
همچنین میتوانید برنامههای مستقل Node.js را مستقیماً از سیستم فایل خود ایجاد و مستقر کنید. موضوع بعدی، استقرار یک برنامه مستقل Node.js ، نحوه استفاده از دستور apigeetool را برای استقرار یک برنامه Node.js از خط فرمان توضیح میدهد.