Edge for Private Cloud نسخه ۴.۱۷.۰۱
میزبان مجازی در Edge دامنه‌ها و درگاه‌های Edge Router را که پراکسی میانای برنامه‌سازی کاربردی در آن‌ها نمایش داده می‌شود و، به‌طور گسترده‌تر، نشانی وبی را که برنامه‌ها برای دسترسی به پراکسی میانای برنامه‌سازی کاربردی استفاده می‌کنند تعریف می‌کند. میزبان مجازی همچنین تعیین می‌کند که آیا دسترسی به پراکسی میانای برنامه‌سازی کاربردی بااستفاده از پروتکل HTTP انجام می‌شود یا بااستفاده از پروتکل HTTPS رمزگذاری‌شده.
به‌عنوان بخشی از فرایند آماده‌سازی Edge، باید سازمان، محیط، و میزبان مجازی ایجاد کنید. Edge فرمان setup-org را ارائه می‌دهد تا این فرایند را برای کاربران جدید آسان‌تر کند.
وقتی میزبان مجازی را ایجاد می‌کنید، باید اطلاعات زیر را مشخص کنید:
- نام میزبان مجازی که از آن برای ارجاع به آن در پراکسی‌های API خود استفاده می‌کنید.
- درگاه روی «رهیاب» برای میزبان مجازی. معمولاً این درگاه‌ها از ۹۰۰۱ شروع می‌شوند و برای هر میزبان مجازی جدید یکی اضافه می‌شود.
- نام مستعار میزبان میزبان مجازی. معمولاً نام ساناد میزبان مجازی.
Edge Router سرصفحه میزبان درخواست ورودی را با فهرست نام‌های مستعار میزبان دردسترس مقایسه می‌کند تا پروکسی API را که درخواست را مدیریت می‌کند تعیین کند. هنگام درخواست ازطریق میزبان مجازی، یا نام دامنه‌ای را مشخص کنید که با نام مستعار میزبان مجازی مطابقت داشته باشد، یا نشانی IP «رهیاب» و سرصفحه میزبان حاوی نام مستعار میزبان را مشخص کنید.
برای مثال، اگر میزبان مجازی با نام مستعار میزبان myapis.apigee.net در درگاه 9001 ایجاد کرده‌اید، درخواست cURL به API ازطریق آن میزبان مجازی می‌تواند از یکی از فرم‌های زیر استفاده کند:
- اگر ورودی ساناد برای myapis.apigee.net دارید:
curl http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path} - اگر ورودی ساناد برای myapis.apigee.net ندارید:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path} -H 'Host: myapis.apigee.net'
در این فرم، نشانی IP «مسیریاب» را مشخص می‌کنید و نام مستعار میزبان را در سرصفحه «میزبان» ارسال می‌کنید.
توجه: فرمان curl، اکثر مرورگرها، و بسیاری از ابزارهای دیگر به‌طور خودکار سرصفحه «میزبان» را با دامنه به‌عنوان بخشی از درخواست اضافه می‌کنند، بنابراین می‌توانید از فرمان curl به این شکل استفاده کنید:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path}
گزینه‌هایی برای زمانی که ورودی ساناد برای میزبان مجازی ندارید
یک گزینه وقتی ورودی ساناد ندارید این است که نام مستعار میزبان را روی نشانی IP رهیاب و درگاه میزبان مجازی، به‌صورت <routerIP>:port تنظیم کنید. برای مثال:
192.168.1.31:9001
سپس یک فرمان curl در فرم زیر ایجاد می‌کنید:
curl http://<routerIP>:9001/{proxy-base-path}/{resource-path} این گزینه ترجیح داده می‌شود چون با Edge UI خوب کار می‌کند.
اگر چند «رهیاب» دارید، برای هر «رهیاب» یک نام مستعار میزبان اضافه کنید و نشانی IP هر «رهیاب» و درگاه میزبان مجازی را مشخص کنید.
یا می‌توانید نام مستعار میزبان را روی مقداری مثل temp.hostalias.com تنظیم کنید. سپس باید سرصفحه میزبان را در هر درخواست ارسال کنید:
curl -v http://<routerIP>:9001/{proxy-base-path}/{resource-path} -H 'host: temp.hostalias.com'یا نام مستعار میزبان را به فایل /etc/hosts اضافه کنید. برای مثال، این خط را به /etc/hosts اضافه کنید:
192.168.1.31 temp.hostalias.com
سپس می‌توانید درخواستی ایجاد کنید که گویی ورودی ساناد دارید:
curl -v http://myapis.apigee.net:9001/{proxy-base-path}/{resource-path}استفاده از درگاه محافظت‌شده در میزبان مجازی
اگر می‌خواهید میزبان مجازی ایجاد کنید که «رهیاب» را به درگاه محافظت‌شده‌ای، مثلاً شماره درگاه‌های کمتر از ۱۰۲۴، مقید کند، باید «رهیاب» را پیکربندی کنید تا به‌عنوان کاربری اجرا شود که به آن درگاه‌ها دسترسی دارد. به‌طور پیش‌فرض، «مسیریاب» به‌عنوان کاربر «apigee» اجرا می‌شود که به درگاه‌های دارای امتیاز دسترسی ندارد.
برای اجرای Router به‌عنوان کاربری دیگر:
- به‌عنوان root، فایل /opt/apigee/etc/edge-router.d/RUN_USER.sh را ایجاد کنید.
- ورودی زیر را به فایل اضافه کنید:
RUN_USER=root
اگر نمی‌خواهید «مسیریاب» را به‌عنوان root اجرا کنید، کاربری را مشخص کنید که به درگاه دسترسی داشته باشد. - فایل را ذخیره کنید.
- اگر کاربری غیراز root مشخص کرده‌اید، مالک فایل را به آن کاربر تغییر دهید:
> chown USER:USER /opt/apigee/etc/edge-router.d/RUN_USER.sh - رهیاب را بازراه‌اندازی کنید:
> /opt/apigee/apigee-service/bin/apigee-service edge-router restart