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

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

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

وقتی مستقیماً با فایل‌های منبع پراکسی در سیستم خود کار می‌کنید، از تکنیک‌های استقرار خط فرمان استفاده کنید. دلایل زیادی وجود دارد که ممکن است به‌صورت آفلاین کار کنید. ممکن است بخواهید از ویرایشگر XML موردعلاقه‌تان استفاده کنید یا ممکن است درحال توسعه خط‌مشی‌هایی باشید که به کدنویسی Java نیاز دارند و شما به‌طور عمده در یک IDE کار می‌کنید. تکنیک‌های شرح‌داده‌شده در این بخش به شما امکان می‌دهد فایل‌های منبع خود را در محیط «سرویس‌های میانای برنامه‌سازی کاربردی» که انتخاب کرده‌اید بارگذاری و پیاده‌سازی کنید.

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

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

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

ابزار استقرار Python در Apigee Edge با Edge management API کار می‌کند تا کارگزاران میانای برنامه‌سازی کاربردی را وارد و مستقر کند. این ابزار به‌عنوان بخشی از توزیع «نمونه‌های پلاتفرم API» در GitHub دردسترس است. به استفاده از پراکسی‌های میانای برنامه‌سازی کاربردی نمونه مراجعه کنید.

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

ابزار استقرار باید از دایرکتوری پایه در توزیع «پلاتفرم API» توزیع «نمونه‌ها» اجرا شود، جایی که دایرکتوری پایه دایرکتوری والد setup و دایرکتوری 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 را مشخص می‌کنید. اگر گزارش سانادی برای سرور مدیریت ایجاد کرده‌اید، می‌توانید نشانی وبی را به شکل زیر مشخص کنید:

https://ms_URL:8080

فهرست کامل پرچم‌های فرمان به‌شرح زیر است:

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

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

پیکربندی و اجرای دستورگان پوسته استقرار

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

از اجرای فهرست راهنمای /simplyProxy:

$ sh deploy.sh

باید موارد زیر را ببینید:

Enter your password for user {myname} in the Apigee Enterprise organization {org_name}, followed by [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 مراجعه کنید.

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

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