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

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

This topic explains how to deploy a proxy from the command line. Apigee Edge provides two options for deploying from the command line. The first is to use an Apigee Edge deploy tool written in Python. The other is to configure and run a shell script.

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

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

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

اجرای ابزار استقرار پایتون Apigee Edge

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

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

ابزار استقرار باید از دایرکتوری پایه در توزیع API Platform Samples اجرا شود، که در آن دایرکتوری پایه، دایرکتوری والد دایرکتوری 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 در فضای ابری است. همچنین می‌توانید با مشخص کردن آپشن -h از این ابزار برای آپلود پروکسی API در نسخه داخلی Edge استفاده کنید:

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 : آدرس اینترنتی Edge. به طور پیش‌فرض، آدرس اینترنتی https://api.enterprise.apigee.com است که مربوط به Edge در فضای ابری است. برای استقرار در محل، از آدرس اینترنتی سرور مدیریت Edge و پورت ۸۰۸۰ استفاده کنید، مانند:

  https://ms_URL:8080

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

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

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

از دایرکتوری /simplyProxy دستور زیر را اجرا کنید:

شما باید ببینید:

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 یا APIهای Apigee Edge مراجعه کنید.

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

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