درحال مشاهده اسناد Apigee Edge هستید.
به
اسناد Apigee X بروید. اطلاعات
نمای کلی
«میانای خط فرمان Edge Microgateway» به شما امکان میدهد همه جنبههای نمونه Edge Microgateway را کنترل و مدیریت کنید.
مدیریت گواهینامهها
فرمانهای cert به شما امکان میدهد جفت کلید عمومی/خصوصی را که برای امضای نشانهای حامل استفاده میشود نصب و مدیریت کنید. مشتریان از این نشانها برای برقراری تماسهای ایمن ازطریق Edge Microgateway استفاده میکنند. کلیدها در Apigee Edge در یک خزانه امن ذخیره میشوند. Edge Microgateway از کلید عمومی برای اعتبارسنجی نشانهای حامل امضاشده استفاده میکند. این کلیدها زمانی تولید میشوند که فرمان edgemicro configure را اجرا میکنید، همانطور که در راهاندازی و پیکربندی Edge Microgateway توضیح داده شده است. درصورت نیاز میتوانید از دستورات cert که در اینجا توضیح داده شده است برای بازتولید و مدیریت این کلیدها استفاده کنید.
نصب گواهینامه
کلیدها را بااستفاده از سرویس فروشگاه امن Apigee Edge در خزانه نصب میکند و کلید عمومی را بهعنوان برونداد برمیگرداند. جفت کلیدها به سازمان مشخصی محدود میشوند.
استفاده
edgemicro cert install -o [organization] -e [environment] -u [username] -p [password] --force
پارامترها
| پارامترها | شرح |
|---|---|
-o, --org |
سازمان Apigee که Edge Microgateway را برای آن پیکربندی کردهاید. |
-e, --env |
محیطی که Edge Microgateway را برای آن پیکربندی کردهاید. |
-u, --username |
نام کاربری Apigee شما. باید سرپرست سازمان مشخصشده باشید. |
-p, --password |
(اختیاری) گذرواژه شما. اگر این پارامتر را در خط فرمان ارائه نکنید، از شما خواسته میشود آن را ارائه کنید. |
-f, --force |
(اختیاری) اگر کلیدی ازقبل در خزانه ذخیره شده است، جایگزینی آن را اجباری کنید. |
-h, --help |
اطلاعات استفاده از برونداد. |
مثال
edgemicro cert install -o docs -e test -u jdoe@example.com -f
برونداد
current nodejs version is v6.1.0 current edgemicro version is 2.2.4-beta password: deleting vault creating vault adding private_key adding public_key installed cert
حذف گواهینامه
جفت کلید را برای سازمان حذف میکند.
استفاده
edgemicro cert delete -o [organization] -e [environment] -u [username] -p [password]
پارامترها
| پارامترها | شرح |
|---|---|
-o, --org |
سازمان Apigee که Edge Microgateway را برای آن پیکربندی کردهاید. |
-e, --env |
محیطی که Edge Microgateway را برای آن پیکربندی کردهاید. |
-u, --username |
نام کاربری Apigee شما. باید سرپرست سازمان مشخصشده باشید. |
-p, --password |
(اختیاری) گذرواژه شما. اگر این پارامتر را در خط فرمان ارائه نکنید، از شما خواسته میشود آن را ارائه دهید. |
-h, --help |
اطلاعات استفاده از برونداد. |
مثال
edgemicro cert delete -o docs -e test -u jdoe@example.com
برونداد
deleting vault Vault deleted!
بررسی گواهینامه
بررسی میکند که سازمانتان گواهینامه نصبشده داشته باشد.
استفاده
edgemicro cert check -o [organization] -e [environment] -u [username] -p [password]
پارامترها
| پارامترها | شرح |
|---|---|
-o, --org |
سازمان Apigee که Edge Microgateway را برای آن پیکربندی کردهاید. |
-e, --env |
محیطی که Edge Microgateway را برای آن پیکربندی کردهاید. |
-u, --username |
نام کاربری Apigee شما. باید سرپرست سازمان مشخصشده باشید. |
-p, --password |
(اختیاری) گذرواژه شما. اگر این پارامتر را در خط فرمان ارائه نکنید، از شما خواسته میشود آن را ارائه دهید. |
-h, --help |
اطلاعات استفاده از برونداد. |
مثال
edgemicro cert check -o docs -e test -u jdoe@example.com
برونداد (موفقیتآمیز)
checked cert successfully
برونداد (ناموفق)
اگر گواهینامه وجود نداشته باشد، خطا برگردانده میشود.
دریافت کلید عمومی
کلید عمومی را برای سازمان مشخصشده برمیگرداند. به اصالتسنجی نیاز ندارد.
استفاده
edgemicro cert public-key -o [organization] -e [environment]
پارامترها
| پارامترها | شرح |
|---|---|
-o, --org |
سازمان Apigee که Edge Microgateway را برای آن پیکربندی کردهاید. |
-e, --env |
محیطی که Edge Microgateway را برای آن پیکربندی کردهاید. |
-h, --help |
اطلاعات استفاده از برونداد. |
مثال
edgemicro cert public-key -o docs -e test
برونداد (نمونه)
-----BEGIN CERTIFICATE----- MIICpDCCAYwCCQCKpXWGum9uTjANBgkq9w0BAQsFADAUMRIwEAYDVQQDEwls b2NhbGhvc3cNMTYxMTAyMjAxNTA2WhcNMTYxMTAzMjAxNTA2WjAUMRIwEAYD VQQDEwlsb2Nvc3QwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQDD ETr/ne/gP47+9LgjLvBJjpbFVdaeUabZZ3wbA7sSIVnnNXWt3yPklrWSfIh+ L2+dq4k+YunsQE2+dwPdXA2x8DPGvqGcCdWPxnpZ7ix5Akbs8i/J+Ue0pXT4 jkpWbaDDftGL2tcxwP45yI+slpDYvmWRps07TFXkAPjGEHYPvCT9/v/35GkL 0h4v0S+XfpcjS5c47o7CIWlkgEM5GBosQUb17kuVR48392vGFPsnCP34iNe7 zguhiCXYg2zkOcj/N3AE4xKIhCz0QcewULy08GltWMmyjJ/30zs8P41JqoA4 RwfeEZ8RenN3rJQim1ppAAEwDQYJKoZIhvcNAQELBQADggEBAHcORIfc+ySe 2FMmqicNe6Wt5V/5zOaBMLsGQdqGOHB5cQc79sMBrk680KVhrwHXZ2nBIkVe UEL+2qLY1VLfswBNAvcNwV9U4TwHq4eIANiD751oJK1tHmM/ujThQkwNf96o 6I7Ws+wfpGO3ppJCttRbtnATIxrwsCHN4i5lbW/tJSL7t/Zf6T1B+YSJU9AF xuvLq22cCqyYJQdmKq2vVS55WRZdllm+mRtJrv7MLM9gfDPRxVlwrBz/eQHy Fv+dwzxcvQjkz03RNhZUodzuD34DPJoYeK++rItsddwQ26KTahH80yYTAFzY x9gfPf1/+qo=? -----END CERTIFICATE-----
پیکربندی Edge Microgateway برای Apigee Edge Cloud
«دروازه کوچک Edge» را قادر میسازد با نمونه Apigee Edge Cloud کار کند. این عامل مجموعهای از دستورات را برای استقرار پراکسی اصالتسنجی موردنیاز در Edge، تولید کدهای اصالتسنجی، و بهروزرسانی فایلهای پیکربندی اجرا میکند. برای دیدن نمونه کاری کامل، به راهاندازی و پیکربندی Edge Microgateway مراجعه کنید.
استفاده
edgemicro configure -o [organization] -e [environment] -u [username] -p [password]
پارامترها
| پارامترها | شرح |
|---|---|
-o, --org |
سازمان Apigee که Edge Microgateway را برای آن پیکربندی کردهاید. |
-e, --env |
محیطی که Edge Microgateway را برای آن پیکربندی کردهاید. |
-u, --username |
نام کاربری Apigee شما. باید سرپرست سازمان مشخصشده باشید. |
-p, --password |
(اختیاری) گذرواژه شما. اگر این پارامتر را در خط فرمان ارائه نکنید، از شما خواسته میشود آن را ارائه کنید. |
-r, --url |
(اختیاری) نام مستعار میزبان مجازی را برای سازمان:محیط شما مشخص میکند. برای آشنایی با میزبانهای مجازی، به مستندات Edge مراجعه کنید. پیشفرض: org-env.apigee.net |
-v, --virtualHosts |
(اختیاری) میزبانهای مجازی پیشفرض، که «default,secure» هستند، را ملغی میکند. اگر میزبانهای مجازی مشخصشدهای برای سازمان Edge:محیط خود دارید که غیر از این پیشفرضها است، از این گزینه استفاده کنید. برای آشنایی با میزبانهای مجازی، به مستندات Edge مراجعه کنید. |
-d, --debug |
(اختیاری) اطلاعات اشکالزدایی ارائه میدهد. |
-h, --help |
اطلاعات استفاده از برونداد. |
یادداشتهای استفاده
این فرمان اطلاعات پیکربندی را در ~/.edgemicro/org-env-config.yaml ذخیره میکند.
مثال
edgemicro configure -o docs -e test -u jdoe@example.com
برونداد
درصورت موفقیت، فرمان مجموعهای از کلیدها را برمیگرداند که باید هنگام شروع Edge Microgateway از آنها استفاده کنید.
... The following credentials are required to start edge micro key: d2f0a246ad52b5d2a8b04ba65b43c76348aba586691cf6185cd7bb9fb78fe9f secret: 59813bc1db4a7ada182705ae40893c28a6fae680c3deb42aefbf1a4db42e372 edgemicro configuration complete!
درحال تولید کلیدها
دستور genkeys جفت کلید و رمزی را تولید میکند که Edge Microgateway از آن برای اصالتسنجی خود هنگام پست کردن ناهمزمان دادههای Analytics در Apigee Edge استفاده میکند.
استفاده
edgemicro genkeys -o [organization] -e [environment] -u [username] -p [password]
پارامترها
| پارامترها | شرح |
|---|---|
-o, --org |
سازمان Apigee که Edge Microgateway را برای آن پیکربندی کردهاید. |
-e, --env |
محیطی که Edge Microgateway را برای آن پیکربندی کردهاید. |
-u, --username |
نام کاربری Apigee شما. باید سرپرست سازمان مشخصشده باشید. |
-p, --password |
(اختیاری) گذرواژه شما. اگر این پارامتر را در خط فرمان ارائه نکنید، از شما خواسته میشود آن را ارائه دهید. |
-h, --help |
اطلاعات استفاده از برونداد. |
یادداشتهای استفاده
درصورت موفقیت، فرمان سه مورد را برمیگرداند. اولین مورد نشانی وبی است که باید در فایل پیکربندی قرار دهید. دو مورد دیگر جفت کلیدی هستند که هنگام شروع نمونه Edge Microgateway موردنیاز است.
- نشانی وب bootstrap: این نشانی وب به سرویس Apigee Edge اشاره میکند که نمونه Edge Microgateway را قادر میسازد دادههای Analytics را به Apigee Edge ارسال کند. باید آن نشانی وب را در فایل پیکربندی Edge Microgateway کپی کنید: ~
/.edgemicro/org-env-config.yaml. - کلید: کلید. این کلید و رمز بهعنوان ورودی فرمان «میانای خط فرمان» که برای شروع نمونه Edge Microgateway استفاده میشود لازم است.
- رمز: رمز.
مثال
edgemicro genkeys -o docs -e test -u jdoe@example.com
برونداد (نمونه)
پساز موفقیت، فرمان مجموعهای از کلیدها را برمیگرداند که باید هنگام شروع Edge Microgateway از آنها استفاده کنید.
configuring host edgemicroservices-us-east-1.apigee.net for region us-east-1 Please copy the following property to the edge micro agent config bootstrap: https://edgemicroservices-us-east-1.apigee.net/edgemicro/bootstrap/organization/jdoe/environment/test The following credentials are required to start edge micro key: db39324077989c75eac34c13d285772ea8e3b982b957b3f52916f3048511443f secret: 5bf8da39de0056f88fdd5f25a8602d22f312c1c8c870580a5fef55ac6637b7ae finished
پیکربندی Edge Microgateway برای Apigee Edge Private Cloud
Edge Microgateway را پیکربندی میکند تا با نصب Apigee Edge Private Cloud کار کند.
استفاده
edgemicro private configure -o [organization] -e [environment] -u [username] -p [password]
پارامترها
| پارامترها | شرح |
|---|---|
-o, --org |
سازمان Apigee که Edge Microgateway را برای آن پیکربندی کردهاید. |
-e, --env |
محیطی که Edge Microgateway را برای آن پیکربندی کردهاید. |
-u, --username |
نام کاربری Apigee شما. باید سرپرست سازمان مشخصشده باشید. |
-p, --password |
(اختیاری) گذرواژه شما. اگر این پارامتر را در خط فرمان ارائه نکنید، از شما خواسته میشود آن را ارائه کنید. |
-r, --runtime-url |
نشانی وب زمان اجرا را برای نمونه ابر خصوصی شما مشخص میکند. |
-m, --mgmt-url |
نشانی وب سرور مدیریت برای نمونه ابر خصوصی شما. |
-v, --virtualHosts |
فهرست جداشده با کاما از میزبانهای مجازی برای سازمان:محیط. «default,secure» پیشفرض. |
-d, --debug |
(اختیاری) اطلاعات اشکالزدایی ارائه میدهد. |
-h, --help |
اطلاعات استفاده از برونداد. |
یادداشتهای استفاده
این فرمان اطلاعات پیکربندی را در ~/.edgemicro/org-env-config.yaml ذخیره میکند.
مثال
edgemicro private configure -o docs -e test -u jdoe@example.com -r http://192.162.55.100:9002 -m http://192.162.55.100:8080
برونداد
پساز موفقیت، فرمان مجموعهای از کلیدها را برمیگرداند که باید هنگام شروع Edge Microgateway از آنها استفاده کنید.
... The following credentials are required to start edge micro key: d2f0a246ad52b5d2a8b04ba65b43c76348aba586691cf6185cd7bb9fb78fe9f secret: 59813bc1db4a7ada182705ae40893c28a6fae680c3deb42aefbf1a4db42e372 edgemicro configuration complete!
درحال شروع Edge Microgateway
قبلاز شروع Edge Microgateway، ابتدا باید edgemicro configure (ابر عمومی) یا edgemicro private configure (ابر خصوصی) را اجرا کنید. فرمان پیکربندی مقادیر کلید و رمز را که برای شروع Edge Microgateway لازم است برمیگرداند.
استفاده
edgemicro start -o [organization] -e [environment] -k [public-key] -s [secret-key]
پارامترها
| پارامترها | شرح |
|---|---|
-o, --org |
سازمان Apigee که Edge Microgateway را برای آن پیکربندی کردهاید. |
-e, --env |
محیطی که Edge Microgateway را برای آن پیکربندی کردهاید. |
-k, --key |
مقدار کلیدی که هنگام اجرای فرمان «edgemicro configure» برگردانده میشود. |
-s, --secret |
مقدار رمز برگرداندهشده که هنگام اجرای فرمان «edgemicro configure» برگردانده میشود. |
-p, --processes |
(اختیاری) تعداد فرایندهایی که باید شروع شود. پیشفرض: تعداد هستههای سیستم شما. |
-d, --pluginDir |
(اختیاری) مسیر مطلق به دایرکتوری افزایه. |
-r, --port |
(اختیاری) شماره درگاه مشخصشده در فایل ~/.edgemicro/org-env-config.yaml را ملغی میکند. پیشفرض: ۸۰۰۰ |
-c, --cluster |
(اختیاری) «دروازه کوچک Edge» را در حالت خوشهای شروع میکند. توجه: از نسخه ۲.۳.۱، این گزینه برداشته شده است. در نسخه ۲.۳.۱ و نسخههای جدیدتر، Edge Micro همیشه در حالت خوشهای شروع میشود. |
-c --config |
(اختیاری) مکان فایل default config.yaml را مشخص میکند. بهطور پیشفرض، این فایل در ./config/config.yaml است. |
-d, --debug |
(اختیاری) اطلاعات اشکالزدایی ارائه میدهد. |
-h, --help |
اطلاعات استفاده از برونداد. |
درحال تنظیم درگاه
فرمان start به شما امکان میدهد شماره درگاهی را مشخص کنید تا درگاه مشخصشده در فایل پیکربندی را ملغی کنید. همچنین میتوانید بااستفاده از متغیر محیطی PORT شماره درگاه را مشخص کنید. برای مثال:
edgemicro start -o docs -e test -k abc123 -s xyz456 -p 2 --port 8002
یا
export PORT=8002 edgemicro start -o org -e test -k key -s secret -p 2
اگر درگاه درحال استفاده باشد، Edge Microgateway خطا برمیگرداند.
درباره خوشهبندی
Edge Microgateway از واحد خوشهای Node.js برای فعال کردن خوشهبندی استفاده میکند. خوشهبندی به Edge Microgateway امکان میدهد از سیستمهای چند هستهای بهرهمند شود. برای جزئیات، این مستندات Node.js را ببینید.
مثال
edgemicro start -o docs -e test -k abc123 -s xyz456
برونداد نمونه:
... PROCESS PID : 54709 installed plugin from analytics installed plugin from analytics installed plugin from oauth installed plugin from oauth installed plugin from analytics installed plugin from oauth 5a86b570-a142-11e6-aa1f-6730e9065d6c edge micro listening on port 8000 5a86dc80-a142-11e6-962c-43d9cc723190 edge micro listening on port 8000 5a8751b0-a142-11e6-8241-cf1c517c91eb edge micro listening on port 8000 installed plugin from analytics installed plugin from oauth 5a924e30-a142-11e6-8740-2944162ce275 edge micro listening on port 8000
مدیریت نشانهها
فرمانهای token به شما امکان میدهند کد دسترسی OAuth2 امضاشده را دریافت، رمزگشایی، و درستیسنجی کنید. همچنین تماسهای API ایمن با کد دسترسی OAuth2 را ببینید.
رمزگشایی دادهواحد
نماد حامل امضاشده و کدبندیشده را به نمایش نوشتار ساده JSON JWT (نماد وب Java) آن رمزگشایی میکند. رمز اطلاعاتی درباره برنامه توسعهدهنده Apigee Edge که کلیدهای استفادهشده برای ایجاد رمز را ارائه کرده است منتقل میکند، ازجمله نام برنامه، client_id، فهرست محصولات، و غیره.
استفاده
edgemicro token decode -f [filename]
پارامترها
| پارامترها | شرح |
|---|---|
-f, --file |
نام فایلی که حاوی نشان JWT برای رمزگشایی است. |
-h, --help |
اطلاعات استفاده از برونداد. |
مثال
edgemicro token decode -f token.jwt
برونداد (نمونه)
{ header: { typ: 'JWT', alg: 'RS256' }, payload: { application_name: 'b43342ef-86f6-4666-a121-b9ac2025d217', client_id: 'O9ZQRZKnn1rdgcKQgsABSMdOsKS', scopes: [], api_product_list: [ 'MicroTest' ], iat: 1436280566, exp: 1436282365 }, signature: '' }
تولید کد
یک کد حامل امضاشده تولید میکند. این کد به برنامههای کارخواه اجازه میدهد تماسهای API اصالتسنجیشده با Edge Microgateway برقرار کنند. این کد یک «کد وب JSON» (JWT) سازگار با OAuth 2.0 است. این ابزار مقادیر «کلید مصرفکننده» (شناسه کارخواه) و «رمز مصرفکننده» (رمز کارخواه) را از برنامه توسعهدهنده ثبتشده در Apigee Edge بهعنوان ورودی میخواهد. همچنین تماسهای API ایمن با کد دسترسی OAuth2 را ببینید.
استفاده
edgemicro token get -o [org] -e [env] -i [client_id] -s [client_secret]
پارامترها
| پارامترها | شرح |
|---|---|
-o, --org |
سازمان Apigee که Edge Microgateway را برای آن پیکربندی کردهاید. |
-e, --env |
محیطی که Edge Microgateway را برای آن پیکربندی کردهاید. |
-1, --key |
«شناسه مشتری» از «برنامه توسعهدهنده» مرتبط با پراکسی آگاه از Microgateway. |
-s, --secret |
«رمز کارخواه» از برنامه «توسعهدهنده» منسوب به پراکسی آگاه از «درگاه کوچک». |
-h, --help |
اطلاعات استفاده از برونداد. |
مثال
edgemicro token get -o docs -e test -i 5UzOwAXGoOeo60aew94PPG5MAZE3aJp -s 6vahKFGS9a3qMLwz
برونداد (نمونه)
{ token: 'eyJ0eXAiOiJKV1JhbGciOiJSUzI1NiJ9Glvbl9uYW1lIjoiNWNiMGY0NTV6TV3
EtOWMzOC00YmJjLWIzNzEtZGMxZTQzOGMxIiwiY2xpZW50X2lkIjoiNVV6T3dBWEdvSU9lbz
YwYWV3OTRQN0c1TUFaRTNhSnAiLCJzY2MiOltdLCJhcGlfcHJvZHVjdF9saXN0IjpbIkVkZ2
VNaWNyb1Rlc3RQcm9kdWN0Il0sImlhdCI3ODEyMzQ2MSwiZXhwIjoxNDc4MTI1MjYwfQ.Dx5
f5U7PXm8koNGmFX4N6VrxKMJnpndKgoJ5zWSJvBZ6Ccvhlpd85ipIIA5S2A5nx4obYWp_rpY
RJpIGYwyxP6Oq2j0rxnVjdCC4qyYMgthZjhKgEBVBe3s1ndP72GP2vV6PsSA9RQ2-yzsy9r0
TzhAZ3NJTxT1tS0XKqKngE-OhR3fJHVLAzdMDT0AmS9H0Z2NAJtQOuK6RTpCjG9B6Bc48AEM
sj7QSM-1LWiQ8LdY8k_BoC06qsTI7bCQGWwTuqL-ismbcx2bxovUxSemZIaoROfuF-dCZHG3
2aTP75WxBvvNgBBvPvQtPzbeSOtEaww' }ایجاد درخواست HTTP برای دریافت کد
همچنین میتوانید درخواست HTTP خام برای دریافت کردن کد ایجاد کنید. در اینجا یک مثال curl آورده شده است. کافی است نامهای سازمان و محیط خود را در نشانی وب جایگزین کنید و مقادیر «شناسه مصرفکننده» و «رمز مصرفکننده» را برای پارامترهای client_id و client_secret جایگزین کنید:
curl -i -X POST "http://<org>-<test>.apigee.net/edgemicro-auth/token" -d '{"grant_type": "client_credentials", "client_id": "4t8X137pOUUtMR7wag3M1yZTcRxeK", "client_secret": "RAcOFVOvO0jns"}' -H "Content-Type: application/json"
تأیید کد
توکن حامل امضاشده را دربرابر کلید عمومی ذخیرهشده در Apigee Edge برای سازمان و محیط مشخصشده تأیید میکند.
استفاده
edgemicro token verify -o [org] -e [env] -f [filename]
پارامترها
| پارامترها | شرح |
|---|---|
-o, --org |
سازمان Apigee که Edge Microgateway را برای آن پیکربندی کردهاید. |
-e, --env |
محیطی که Edge Microgateway را برای آن پیکربندی کردهاید. |
-f, --file |
نام فایلی که حاوی JWT برای درستیسنجی است. |
-h, --help |
اطلاعات استفاده از برونداد. |
مثال
edgemicro token get -o docs -e test -f token.jwt
نمونه برونداد برای کد معتبر
{ application_name: 'b43342ef-86f6-4666-a121-b9ac2025d217',
client_id: 'O9ZQRZKnn1rdgcKQsAZUBkQSMdOsKS',
scopes: [],
api_product_list: [ 'MicroTest' ],
iat: 1436396155,
exp: 1436397954 }نمونه برونداد برای کد نامعتبر
{ [JsonWebTokenError: invalid token] name: 'JsonWebTokenError', message: 'invalid token' }نمونه برونداد برای دادهواحد منقضیشده
{ [TokenExpiredError: jwt expired]
name: 'TokenExpiredError',
message: 'jwt expired',
expiredAt: Tue Jul 07 2015 09:19:25 GMT-0600 (MDT) }درحال دریافت مستقیم کدهای حامل
ممکن است ترجیح دهید با ارسال درخواست HTTP به نقطه پایانی نشان در Apigee Edge، نشانهای حامل را مستقیماً دریافت کنید. نقطه پایان کد واقعی در پراکسی که با فرمان deploy-edge-service CLI مستقر شده است پیادهسازی میشود.
در اینجا یک مثال curl آورده شده است. کافی است نامهای سازمان و محیط خود را در نشانی وب جایگزین کنید و مقادیر «شناسه مصرفکننده» و «رمز مصرفکننده» را که از برنامه توسعهدهنده در Apigee Edge بهدست آمده است با پارامترهای client_id و client_secret جایگزین کنید:
curl -i -X POST "http://<org>-<test>.apigee.net/edgemicro-auth/token" -d '{"grant_type": "client_credentials", "client_id": "4t8X137pOUUtMR7wag3M1yZTcRxeK", "client_secret": "RAcOFVOvO0jns"}' -H "Content-Type: application/json"
برونداد نمونه:
HTTP/1.1 200 OK X-Powered-By: Express Cache-Control: no-store Pragma: no-cache Content-Type: application/json; charset=utf-8 Content-Length: 640 ETag: W/"280-ze/g/k+c9taqp110vjYQ" Date: Fri, 17 07 2015 15:49:24 GMT Connection: keep-alive "<long string of numbers and letters>"
درحال مقداردهی اولیه پیکربندی جدید Edge Microgateway
این فرمان را یکبار پساز نصب اولیه Edge Microgateway اجرا کنید. فایل پیکربندی پیشفرض جدیدی ایجاد میکند: ~/.edgemicro/default.yaml.
استفاده
edgemicro init
پارامترها
| پارامترها | شرح |
|---|---|
-h, --help |
اطلاعات استفاده از برونداد. |
مثال
edgemicro init
برونداد (موفقیتآمیز)
config initialized to /MyHome/.edgemicro/default.yaml
درحال درستیسنجی پیکربندی Edge Microgateway
تأیید میکند که Edge Microgateway بهدرستی پیکربندی شده است.
استفاده
edgemicro verify -o [organization] -e [environment] -k [public-key] -s [secret-key]
پارامترها
| پارامترها | شرح |
|---|---|
-o, --org |
سازمان Apigee که Edge Microgateway را برای آن پیکربندی کردهاید. |
-e, --env |
محیطی که Edge Microgateway را برای آن پیکربندی کردهاید. |
-k, --key |
مقدار کلیدی که هنگام اجرای فرمان «edgemicro configure» برگردانده میشود. |
-s, --secret |
مقدار رمز برگرداندهشده که هنگام اجرای فرمان «edgemicro configure» برگردانده میشود. |
-h, --help |
اطلاعات استفاده از برونداد. |
مثال
edgemicro verify -o docs -e test -k abc123 -s xyz456
برونداد (موفقیتآمیز)
logging to /var/tmp/edgemicro-My-Machine.local-a0c48610-a148-11e6-8466-93f081b05988 installed plugin from analytics installed plugin from oauth a0c48610-a148-11e6-8466-93f081b05988 edge micro listening on port 8000 verifying analytics negative case: OK verifying bootstrap url availability:OK verifying jwt_public_key availability: OK verifying products availability: OK verifying quota with configured products: OK verifying analytics with payload: OK verification complete
وضعیت خوشه ریزدروازه را بررسی کنید
افزودهشده: v2.2.4-beta
بهطور پیشفرض، Edge Microgateway در حالت خوشهای شروع میشود. میتوانید از این فرمان برای بررسی وضعیت خوشه استفاده کنید.
استفاده
edgemicro status
پارامترها
| پارامترها | شرح |
|---|---|
-h, --help |
اطلاعات استفاده از برونداد. |
مثال
edgemicro status
برونداد (موفقیتآمیز)
current nodejs version is v6.1.0 current edgemicro version is 2.2.4-beta edgemicro is running with 4 workers
درحال متوقف کردن خوشه ریزدروازه
افزودهشده: v2.2.4-beta
خوشه Edge Microgateway را متوقف میکند.
استفاده
edgemicro stop
پارامترها
| پارامترها | شرح |
|---|---|
-h, --help |
اطلاعات استفاده از برونداد. |
مثال
edgemicro stop
برونداد (موفقیتآمیز)
current nodejs version is v6.1.0 current edgemicro version is 2.2.4-beta Stop Completed Successfully
درحال مجدد بار کردن خوشه ریزدروازه
افزودهشده: v2.2.4-beta
پساز تغییر پیکربندی، بازراهاندازی بدون توقف ارائه میدهد. با کشیدن پیکربندی جدید، Edge Microgateway را مجدد بار میکند.
استفاده
edgemicro reload -o [organization] -e [environment] -k [public-key] -s [secret-key]
پارامترها
>| پارامترها | شرح |
|---|---|
-o, --org |
سازمان Apigee که Edge Microgateway را برای آن پیکربندی کردهاید. |
-e, --env |
محیطی که Edge Microgateway را برای آن پیکربندی کردهاید. |
-k, --key |
مقدار کلیدی که هنگام اجرای فرمان «edgemicro configure» برگردانده میشود. |
-s, --secret |
مقدار رمز برگرداندهشده که هنگام اجرای فرمان «edgemicro configure» برگردانده میشود. |
-h, --help |
اطلاعات استفاده از برونداد. |
مثال
edgemicro reload -o docs -e test -k abc123 -s xyz456
برونداد (موفقیتآمیز)
... Reload Completed Successfully