استقرار پراکسی ها از خط فرمان

شما در حال مشاهده اسناد Apigee Edge هستید.
به مستندات Apigee X بروید . اطلاعات

این مبحث نحوه استقرار یک پروکسی از خط فرمان را توضیح می دهد. Apigee Edge دو گزینه برای استقرار از خط فرمان ارائه می دهد. اولین مورد استفاده از ابزار استقرار Apigee Edge است که در پایتون نوشته شده است. مورد دیگر پیکربندی و اجرای یک اسکریپت پوسته است.

هنگامی که مستقیماً با فایل های منبع پراکسی روی سیستم خود کار می کنید، از تکنیک های استقرار خط فرمان استفاده کنید. دلایل زیادی وجود دارد که چرا شما ممکن است به صورت آفلاین کار کنید. ممکن است بخواهید از یک ویرایشگر XML مورد علاقه استفاده کنید یا ممکن است در حال توسعه خط مشی هایی باشید که به کدنویسی جاوا نیاز دارند و عمدتاً در یک IDE کار می کنید. تکنیک های توضیح داده شده در این بخش به شما امکان می دهد فایل های منبع خود را در محیط API Services که انتخاب می کنید آپلود و مستقر کنید.

اگر عمدتاً در رابط کاربری مدیریت کار می‌کنید، به استقرار پراکسی‌ها در رابط کاربری مراجعه کنید.

شما در حال مشاهده اسناد Apigee Edge هستید.
به مستندات Apigee X بروید . اطلاعات

اجرای ابزار استقرار Apigee Edge Python

ابزار استقرار Apigee Edge Python با API مدیریت Edge برای وارد کردن و استقرار پراکسی‌های API کار می‌کند. این ابزار به عنوان بخشی از توزیع API Platform Samples در GitHub در دسترس است. استفاده از نمونه پروکسی های API را ببینید.

از ابزار Apigee Edge Python برای وارد کردن (آپلود) و استقرار API خود در یک فرآیند ساده استفاده کنید.

ابزار Deploy باید از دایرکتوری پایه در توزیع API Platform Samples اجرا شود، جایی که دایرکتوری پایه دایرکتوری والد دایرکتوری setup and tools است.

در دستور زیر، نام پراکسی، نام کاربری و رمز عبور Edge، سازمان و محیط Edge و مسیر دایرکتوری حاوی دایرکتوری " apiproxy" پروکسی API را جایگزین کنید:

python tools/deploy.py -n proxyname -u name:passW -o org -e env -d proxypath -p /

به عنوان مثال:

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p /

این دستور فایل های شما را فشرده می کند، آنها را به سازمان شما در Apigee Edge می فرستد و آنها را در محیط مشخص شده مستقر می کند.

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

در مورد موفقیت، خروجی را به شکل زیر می بینید:

Writing ./<proxybasedir>/apiproxy/weatherapi.xml to apiproxy/weatherapi.xml
Writing ./<proxybasedir>/apiproxy/proxies/default.xml to apiproxy/proxies/default.xml
Writing ./<proxybasedir>/apiproxy/targets/default.xml to apiproxy/targets/default.xml
Imported new proxy version 1
Environment: test
  Revision: 1 BasePath = /
  State: deployed

به‌طور پیش‌فرض، این ابزار، پروکسی API را در https://api.enterprise.apigee.com ، مربوط به Edge در ابر، آپلود می‌کند. همچنین می‌توانید از این ابزار برای آپلود پراکسی API در یک نسخه داخلی Edge با مشخص کردن پرچم -h استفاده کنید:

python tools/deploy.py -n weatherapi -u me@myCo.com:foo -o myCo -e test -d weatherapi -p / -h https://192.168.11.111:8080

در این مثال، شما آدرس IP سرور مدیریت Edge را مشخص می کنید. اگر یک رکورد DNS برای سرور مدیریت ایجاد کرده اید، می توانید یک URL را به شکل زیر مشخص کنید:

https://ms_URL:8080

لیست کامل پرچم‌ها برای دستور عبارتند از:

  • -n : نام پروکسی API شما.
  • -u : نام کاربری و رمز عبور حساب شما در سازمانی در Apigee Edge.
  • -o : نام سازمانی که در آن حساب کاربری دارید.
  • -e : محیطی که باید پراکسی API در آن مستقر شود ( test یا prod ).
  • -d : مسیر دایرکتوری حاوی فایل های پروکسی API شما. فایل های پروکسی API شما باید در پوشه ای به نام "apiproxy" ذخیره شوند. این مقدار مسیر دایرکتوری است که حاوی دایرکتوری "apiproxy" است و نه مسیر خود دایرکتوری "apiproxy".
  • -p : مسیر URI که به عنوان تطبیق الگو برای مسیریابی پیام ورودی به این استقرار پراکسی API استفاده می شود. در بیشتر موارد، می‌توانید این مقدار را روی «/» تنظیم کنید، مگر اینکه نیازمندی‌های پیشرفته‌ای برای استقرار و مسیریابی داشته باشید. مسیر اصلی مورد استفاده برای مسیریابی پروکسی API در فایل پیکربندی ProxyEndpoint پروکسی API تعریف شده است.
  • -h : URL لبه. به‌طور پیش‌فرض، URL https://api.enterprise.apigee.com است که مربوط به Edge در فضای ابری است. برای استقرار در محل، از URL سرور مدیریت Edge و پورت 8080 استفاده کنید، مانند: 
    https://ms_URL:8080

    یا از آدرس IP سرور مدیریت مانند https://192.168.11.111:8080 استفاده کنید.

پیکربندی و اجرای اسکریپت deploy shell

ساده ترین روش اجرای اسکریپت استقرار ارائه شده با نمونه پراکسی API است. اسکریپت های پوسته ابزار استقرار Apigee Edge Python را بسته بندی می کنند.

از پوشه /simplyProxy اجرا کنید:

$ sh deploy.sh

باید ببینید:

Enter your password for user {myname} in the Apigee Enterprise organization {org_name}, followed by [ENTER]:

رمز عبور خود را وارد کنید، ENTER را فشار دهید.

سپس باید ببینید:

Deploying to test on https://api.enterprise.apigee.com using {myname} on enterprise.apigee.com and {org_name} on enterprise.apigee.com

اگر موارد زیر را مشاهده کردید:

Enter your password for user Your USERNAME on enterprise.apigee.com in the Apigee Enterprise organization Your ORG on enterprise.apigee.com, followed by [ENTER]:

این بدان معنی است که شما باید فایل /setup/setenv.sh را در توزیع نمونه های پلت فرم تغییر دهید. برای دستورالعمل‌ها، به README یا Apigee Edge API مراجعه کنید.

در صورت موفقیت، ابزار استقرار فایل‌ها را تحت /apiproxy, بسته را در Apigee Edge به سازمان شما وارد می‌کند، و سپس پروکسی API را در محیط «تست» مستقر می‌کند.

پروکسی API شما آماده فراخوانی است.