مرجع CLI برای Edge Microgateway

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

Edge Microgateway v. 2.3.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