مرجع

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

«میانای خط فرمان» apigee-remote-service-cli به شما کمک می‌کند «وقث‌دهنده Apigee برای Envoy» را تدارک ببینید و مدیریت کنید.

فرمان‌های اتصال

اتصال، سرویس مستقر در شبکه Istio را با محصول Apigee API مرتبط می‌کند. «خط فرمان» به شما امکان می‌دهد پیوندها را ایجاد، حذف، و فهرست کنید.

توجه: در «میانای کاربری ساخت محصول»، می‌توانید یک یا چند سرویس را با محصول مشخص کنید. انجام این کار معادل ایجاد اتصال بااستفاده از CLI است.

افزودن اتصال

یک هدف از دور را به محصول API اضافه می‌کند.

کاربرد

برای Edge Public Cloud:

apigee-remote-service-cli bindings add [service_name] [product_name]  -o [organization] -e [environment] -u [username] -p [password] -c [config]

برای Edge Private Cloud:

apigee-remote-service-cli bindings add [service_name] [product_name]  -o [organization] -e [environment] -u [username] -p [password] -r [runtime] -c [config]

برای Apigee hybrid:

apigee-remote-service-cli bindings add [service_name] [product_name]  -o [organization] -e [environment] -t [token]

پارامترها

پارامترها نوع شرح
-c, --config رشته (الزامی) مسیر فایل پیکربندی «سرویس از دور Apigee». نکته: وقتی این گزینه را مشخص می‌کنید، می‌توانید اکثر پارامترهای فرمان دیگر را حذف کنید. استفاده از گزینه --config را ببینید.
-e, --env رشته (الزامی) محیطی در سازمانتان.
-h, --help راهنمای پارامترهای فرمان را نمایش می‌دهد.
--insecure هنگام استفاده از SSL، اتصال‌های سرور ناامن مجاز شود
--legacy اگر از Apigee Edge Cloud استفاده می‌کنید، این پرچم را تنظیم کنید. نشانی‌های وب مدیریت و زمان اجرا را برای Edge Cloud تنظیم می‌کند.
--opdk اگر از Apigee Edge برای «ابر خصوصی» استفاده می‌کنید، این پرچم را تنظیم کنید.
-o, --org رشته (الزامی) سازمان Apigee. باید سرپرست سازمان باشید.
-p, --password رشته (فقط برای اصالت‌سنجی پایه الزامی است) گذرواژه Apigee شما. می‌توانید به‌صورت اختیاری گذرواژه را در فایل .netrc مشخص کنید. اگر این کار را انجام دهید، دیگر لازم نیست گذرواژه‌تان را در خط فرمان ارائه دهید. همچنین استفاده از .netrc برای اعتبارنامه‌ها را ببینید.
-r, --runtime رشته نشانی وب پایه زمان اجرای Apigee (برای ترکیبی یا opdk الزامی است).
-t, --token رشته (فقط برای اصالت‌سنجی کد OAuth الزامی است) کد OAuth یا SAML که از اطلاعات حساب Apigee خودتان تولید می‌کنید. برای اطلاعات درباره تولید نشان، استفاده از get_token و دسترسی به مدیریت API با SAML را ببینید.
-u, --username رشته (فقط برای اصالت‌سنجی پایه الزامی است) نام کاربری Apigee شما (معمولاً نشانی ایمیل). می‌توانید به‌صورت اختیاری نام کاربری را در فایل .netrc مشخص کنید. اگر این کار را انجام دهید، نیازی نیست نام کاربری‌تان را در خط فرمان ارائه دهید. همچنین استفاده از .netrc برای اعتبارنامه‌ها را ببینید.
-v, --verbose (اختیاری) برونداد مفصلی تولید می‌کند.

مثال

./apigee-remote-service-cli bindings add httpbin.org envoy-test -o myorg -e test -u user@example.com -c config.yaml -p xxxxxx
product envoy-test is now bound to: httpbin.org

فهرست پیوندها

فهرست همه محصولات API که به «سرویس راه دور» محدود شده‌اند.

کاربرد

برای Edge Public Cloud:

apigee-remote-service-cli bindings list -o [organization] -e [environment] -u [username] -p [password]

برای Edge Private Cloud:

apigee-remote-service-cli bindings list -o [organization] -e [environment] -u [username] -p [password] -r [runtime] 

پارامترها

پارامترها نوع شرح
-c, --config رشته (الزامی) مسیر فایل پیکربندی «سرویس از دور Apigee». نکته: وقتی این گزینه را مشخص می‌کنید، می‌توانید اکثر پارامترهای فرمان دیگر را حذف کنید. استفاده از گزینه --config را ببینید.
-e, --env رشته (الزامی) محیطی در سازمانتان.
-h, --help راهنمای پارامترهای فرمان را نمایش می‌دهد.
--insecure هنگام استفاده از SSL، اتصال‌های سرور ناامن مجاز شود
--legacy اگر از Apigee Edge Cloud استفاده می‌کنید، این پرچم را تنظیم کنید. نشانی‌های وب مدیریت و زمان اجرا را برای Edge Cloud تنظیم می‌کند.
--opdk اگر از Apigee Edge برای «ابر خصوصی» استفاده می‌کنید، این پرچم را تنظیم کنید.
-o, --org رشته (الزامی) سازمان Apigee. باید سرپرست سازمان باشید.
-p, --password رشته (فقط برای اصالت‌سنجی پایه الزامی است) گذرواژه Apigee شما. می‌توانید به‌صورت اختیاری گذرواژه را در فایل .netrc مشخص کنید. اگر این کار را انجام دهید، دیگر لازم نیست گذرواژه‌تان را در خط فرمان ارائه دهید. همچنین استفاده از .netrc برای اعتبارنامه‌ها را ببینید.
-r, --runtime رشته نشانی وب پایه زمان اجرای Apigee (برای ترکیبی یا opdk الزامی است).
-t, --token رشته (فقط برای اصالت‌سنجی کد OAuth الزامی است) کد OAuth یا SAML که از اطلاعات حساب Apigee خودتان تولید می‌کنید. برای اطلاعات درباره تولید نشان، استفاده از get_token و دسترسی به مدیریت API با SAML را ببینید.
-u, --username رشته (فقط برای اصالت‌سنجی پایه الزامی است) نام کاربری Apigee شما (معمولاً نشانی ایمیل). می‌توانید به‌صورت اختیاری نام کاربری را در فایل .netrc مشخص کنید. اگر این کار را انجام دهید، نیازی نیست نام کاربری‌تان را در خط فرمان ارائه دهید. همچنین استفاده از .netrc برای اعتبارنامه‌ها را ببینید.
-v, --verbose (اختیاری) برونداد مفصلی تولید می‌کند.

مثال

apigee-remote-service-cli bindings list -o myorg -e test -u user@example.com -c config.yaml -p abc123
PI Products
============
Bound
-----
envoy-test:
  Quota: 5 requests every 1 minute
  Target bindings:
    httpbin.org
  Paths:
httpbin:
  Quota: 5 requests every 1 minute
  Target bindings:
    httpbin.org
  Paths:
    /httpbin
    /

Unbound
-------
product-1:
  Quota: 100 requests every 1 hour
product-2:
  Quota: 1000 requests every 1 month
product-3:
product-4:

برداشتن اتصال

پیوند «سرویس راه دور» برای Envoy را از محصول API بردارید.

توجه: همچنین می‌توانید «سرویس از دور» را برای اتصال Envoy با برداشتن نام سرویس از محصول در «واسط کاربر Edge» بردارید.

کاربرد

برای Edge Public Cloud:

apigee-remote-service-cli bindings remove [service_name] [product_name]  -o [organization] -e [environment] -u [username] -p [password] -c [config]

برای Edge Private Cloud:

apigee-remote-service-cli bindings remove [service_name] [product_name]  -o [organization] -e [environment] -u [username] -p [password] -r [runtime] -c [config]

برای Apigee hybrid:

apigee-remote-service-cli bindings remove [service_name] [product_name]  -o [organization] -e [environment] -t [token]

پارامترها

پارامترها نوع شرح
-c, --config رشته (الزامی) مسیر فایل پیکربندی «سرویس از دور Apigee». نکته: وقتی این گزینه را مشخص می‌کنید، می‌توانید اکثر پارامترهای فرمان دیگر را حذف کنید. استفاده از گزینه --config را ببینید.
-e, --env رشته (الزامی) محیطی در سازمانتان.
-h, --help راهنمای پارامترهای فرمان را نمایش می‌دهد.
--insecure هنگام استفاده از SSL، اتصال‌های سرور ناامن مجاز شود
--legacy اگر از Apigee Edge Cloud استفاده می‌کنید، این پرچم را تنظیم کنید. نشانی‌های وب مدیریت و زمان اجرا را برای Edge Cloud تنظیم می‌کند.
--opdk اگر از Apigee Edge برای «ابر خصوصی» استفاده می‌کنید، این پرچم را تنظیم کنید.
-o, --org رشته (الزامی) سازمان Apigee. باید سرپرست سازمان باشید.
-p, --password رشته (فقط برای اصالت‌سنجی پایه الزامی است) گذرواژه Apigee شما. می‌توانید به‌صورت اختیاری گذرواژه را در فایل .netrc مشخص کنید. اگر این کار را انجام دهید، دیگر لازم نیست گذرواژه‌تان را در خط فرمان ارائه دهید. همچنین استفاده از .netrc برای اعتبارنامه‌ها را ببینید.
-r, --runtime رشته نشانی وب پایه زمان اجرای Apigee (برای ترکیبی یا opdk الزامی است).
-t, --token رشته (فقط برای اصالت‌سنجی کد OAuth الزامی است) کد OAuth یا SAML که از اطلاعات حساب Apigee خودتان تولید می‌کنید. برای اطلاعات درباره تولید نشان، استفاده از get_token و دسترسی به مدیریت API با SAML را ببینید.
-u, --username رشته (فقط برای اصالت‌سنجی پایه الزامی است) نام کاربری Apigee شما (معمولاً نشانی ایمیل). می‌توانید به‌صورت اختیاری نام کاربری را در فایل .netrc مشخص کنید. اگر این کار را انجام دهید، نیازی نیست نام کاربری‌تان را در خط فرمان ارائه دهید. همچنین استفاده از .netrc برای اعتبارنامه‌ها را ببینید.
-v, --verbose (اختیاری) برونداد مفصلی تولید می‌کند.

مثال

./apigee-remote-service-cli bindings remove httpbin.org envoy-test -o myorg -e test -u user@example.com -c config.yaml -p xxxxxx
product envoy-test is no longer bound to: httpbin.org

فرمان راهنما

برای همه فرمان‌های apigee-remote-service-cli راهنمای آنلاین ارائه می‌شود. کافی است تایپ کنید:

apigee-remote-service-cli help

برای دریافت راهنمایی درباره هر فرمان، تایپ کنید:

apigee-remote-service-cli [command] help

برای مثال:

apigee-remote-service-cli provision help

فرمان آماده‌سازی

دستور apigee-remote-service-cli provision یک پراکسی در سازمان Apigee Edge شما نصب می‌کند، گواهینامه‌ای راه‌اندازی می‌کند، و اطلاعات اعتباری تولید می‌کند که برای پیکربندی «آداپتور Apigee برای Envoy» به آن‌ها نیاز خواهید داشت.

کاربرد

اگر در «ابر عمومی Edge» هستید:

apigee-remote-service-cli provision -o $ORG -e $ENV -u $USERNAME -p $PASSWORD

اگر در «ابر خصوصی Edge» هستید:

apigee-remote-service-cli provision --opdk -o $ORG -e $ENV -u $USERNAME --management $MGMT_SERVER_URL --runtime $RUNTIME_URL -p $PASSWORD

پارامترها

پارامترها نوع شرح
-c, --config رشته مسیر فایل پیکربندی «سرویس از دور Apigee». نکته: وقتی این گزینه را مشخص می‌کنید، می‌توانید اکثر پارامترهای فرمان دیگر را حذف کنید. استفاده از گزینه --config را ببینید.
-e, --environment رشته (الزامی) محیطی در سازمانتان.
-f, --force-proxy-install (اختیاری) اگر پراکسی remote-service ازقبل در سازمانتان نصب شده باشد، آن را مجبور می‌کند دوباره نصب شود.
-h, --help راهنمای پارامترهای فرمان را نمایش می‌دهد.
-k, --key رشته کلید برگشتی از فرمان apigee-remote-service-cli provision را مشخص می‌کند.
--legacy Apigee SaaS (نشانی وب مدیریت و زمان اجرا را تنظیم می‌کند)
-m, --management رشته (اگر از Apigee Private Cloud استفاده می‌کنید الزامی است) نشانی وب پایه مدیریت Apigee شما. پیش‌فرض: https://api.enterprise.apigee.com
-n, --namespace رشته پیکربندی را به‌عنوان Envoy ConfigMap در فضای نام مشخص‌شده منتشر کنید.
--opdk رشته Apigee OPDK.
-o, --organization رشته (الزامی) سازمان Apigee شما. باید سرپرست سازمان باشید.
-p, --password رشته (فقط برای اصالت‌سنجی پایه الزامی است) گذرواژه Apigee شما. می‌توانید به‌صورت اختیاری گذرواژه را در فایل .netrc مشخص کنید. اگر این کار را انجام دهید، دیگر لازم نیست گذرواژه‌تان را در خط فرمان ارائه دهید. همچنین استفاده از .netrc برای اعتبارنامه‌ها را ببینید.
--rotate-int قطع توپ اگر n > 0، کلید خصوصی جدیدی تولید کنید و n کلید عمومی را نگه دارید (فقط ترکیبی)
-r, --runtime رشته نشانی وب پایه زمان اجرای Apigee (برای ترکیبی یا opdk الزامی است)
-s, --secret رشته رمز برگردانده‌شده از فرمان apigee-remote-service-cli provision را مشخص می‌کند.
--strength قطع توپ (اختیاری) قدرت رمزگذاری را برای گواهینامه‌های SSL مورداستفاده در آماده‌سازی آداپتور مشخص می‌کند. پیش‌فرض ۲۰۴۸
-t, --token رشته (فقط ترکیبی) کد Apigee OAuth یا SAML.
-u, --username رشته (فقط برای اصالت‌سنجی پایه الزامی است) نام کاربری Apigee شما (معمولاً نشانی ایمیل). می‌توانید به‌صورت اختیاری نام کاربری را در فایل .netrc مشخص کنید. همچنین استفاده از .netrc برای اعتبارنامه‌ها را ببینید.
-v, --verbose (اختیاری) برونداد مفصلی تولید می‌کند.
--virtual-hosts رشته میزبان‌های مجازی پیش‌فرض را که «default,secure» هستند ملغی می‌کند. اگر میزبان‌های مجازی دیگری غیراز این پیش‌فرض‌ها برای محیط-سازمان Edge خود مشخص کرده‌اید، از این گزینه استفاده کنید. برای آشنایی با میزبان‌های مجازی، مستندات Edge را ببینید.
--years قطع توپ (اختیاری) تعداد سال‌های قبل‌از منقضی شدن گواهینامه SSL مورداستفاده در تدارک دیدن. پیش‌فرض: ۱

مثال

حتماً برونداد فرمان provision را در فایلی ضبط کنید که به‌عنوان ورودی برای سایر عملیات «آداپتور Apigee برای Envoy» استفاده می‌شود.

مثال Edge Public Cloud:

apigee-remote-service-cli provision --legacy --username $USER --password $PASSWORD --organization $ORG --environment $ENV > config.yaml

مثال Apigee hybrid:

apigee-remote-service-cli provision --organization $ORG --environment $ENV --runtime $RUNTIME --namespace $NAMESPACE --token $TOKEN > config.yaml

فرمان‌های کد

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

ایجاد کردن نشان JWT

می‌توانید از یک نشان JWT برای برقراری تماس‌های پراکسی API اصیل‌سازی‌شده به هدف سرویس راه دور استفاده کنید. همچنین استفاده از اصالت‌سنجی مبتنی بر JWT را ببینید.

کاربرد

برای Edge Public Cloud:
apigee-remote-service-cli token create -c [config_file] --id [consumer_key] --secret [consumer_secret] -o [org] -e [env]
برای Edge Private Cloud:
apigee-remote-service-cli token create -c [config_file] --id [consumer_key] --secret [consumer_secret] -r [runtime] -o [org] -e [env]
برای Apigee hybrid:
apigee-remote-service-cli token create -c [config_file] --id [consumer_key] --secret [consumer_secret] -r [runtime] -o [org] -e [env]

پارامترها

پارامترها نوع شرح
-c, --config رشته (الزامی) مسیر فایل پیکربندی «سرویس از دور Apigee». نکته: وقتی این گزینه را مشخص می‌کنید، می‌توانید اکثر پارامترهای فرمان دیگر را حذف کنید. استفاده از گزینه --config را ببینید.
-e, --env رشته (الزامی) محیطی در سازمانتان.
-h, --help راهنمای پارامترهای فرمان را نمایش می‌دهد.
--insecure هنگام استفاده از SSL، اتصال‌های سرور ناامن مجاز شود.
-o, --org رشته (الزامی) سازمان Apigee. باید سرپرست سازمان باشید.
-r, --runtime رشته نشانی وب پایه زمان اجرای Apigee (فقط برای ترکیبی یا opdk الزامی است).
-v, --verbose (اختیاری) برونداد مفصلی تولید می‌کند.

مثال

apigee-remote-service-cli token create -o myorg -e test -i YUmlZAcBKNsTAelJqPZFl3sh58ObATX9 -s icTARgaKHqvUH1dq -c config.yaml

خروجی

درصورت موفقیت، برونداد نشان JST مشابه زیر را خواهید دید:
eyJraWQiOiIxIiwidHlwIjoiSldUIiwiYWxnIjoiUlMyNTYifQ.eyJhY2Nlc3NfdG9rZW4iOiJ0a2tlVzVKQTY2a0pZYTB4bFV1cVBsUW1BMU43IiwiYXVkIjoiaXN0aW8iLCJuYmYiOjE1MzAxMzg1OTEsImFwaV9wcm9kdWN0X2xpc3QiOlsiaXN0aW8tcHJvZHVjdCJdLCJhcHBsaWNhdGlvbl9uYW1lIjoiaXN0aW8tYXBwIiwiZGV2ZWxvcGVyX2VtYWlsIjoicFluZ2Zsb3lkQGdvb2dsZS5jb20iLCJpc3MiOiJodHRwczovL2FwaWdlZXNlYXJjaC10ZXN0LmFwaWdlZS5uZXQvaXN0aW8tYXV0aC90b2tlbiIsImV4cCI6MTUzMDEzOTQ5MSwiaWF0IjoxNTMwMTM4NTkxLCJqdGkiOiIxODgzMzViZi0wMmE4LTRjZGUsOGFkOS0yMWJmNDZjNmRjZDkiLCJjbGllbnRfaWQiOiJZVW1sWkFjQktOc1RBZWxKcVBZRmwzc2g1OE9iQVRYOSJ9.AL7pKSTmond-NSPRNNHVbIzTdAnZjOXcjQ-BbOJ_8lsQvF7PuiOUrGIhY5XTcJusisKgbCdtIxBl8Wq1EiQ_fKnUc3JYYOqzpTB5bGoFy0Yqbfu96dneuWyzgZnoQBkqwZkbQTIg7WNTGx1TJX-UTePvBPxAefiAbaEUcigX9tTsXPoRJZOTrm7IOeKpxpB_gQYkxQtV1_NbERxjTPyMbHdMWal9_xRVzSt7mpTGudMN9OR-VtQ1uXA67GOqhZWcOzq57qImOiCMbaoKnKUADevyWjX_VscN5ZZUtzQUQhTrmv8aR69-uVhMIPKp9juMyYKaYn2IsYZEeCWfhfV45Q

بازرسی کد JWT

با این فرمان می‌توانید یک کد JWT را بازرسی کنید. همچنین بازرسی کردن یک کد را ببینید.

کاربرد

برای Edge Public Cloud:
apigee-remote-service-cli token inspect -o [organization] -e [environment] -f [token_file]
برای Edge Private Cloud:
apigee-remote-service-cli token inspect -o [organization] -e [environment] -f [token_file] --runtime [host_alias]
برای Apigee hybrid:
apigee-remote-service-cli token inspect -o [organization] -e [environment] -f [token_file] --runtime [host_alias]

پارامترها

پارامترها نوع شرح
-c, --config رشته (الزامی) مسیر فایل پیکربندی «سرویس از دور Apigee». نکته: وقتی این گزینه را مشخص می‌کنید، می‌توانید اکثر پارامترهای فرمان دیگر را حذف کنید. استفاده از گزینه --config را ببینید.
-e, --env رشته (الزامی) محیطی در سازمانتان.
-h, --help راهنمای پارامترهای فرمان را نمایش می‌دهد.
--insecure هنگام استفاده از SSL، اتصال‌های سرور ناامن مجاز شود.
-o, --org رشته (الزامی) سازمان Apigee. باید سرپرست سازمان باشید.
-r, --runtime رشته نشانی وب پایه زمان اجرای Apigee (فقط برای ترکیبی یا opdk الزامی است).
-v, --verbose (اختیاری) برونداد مفصلی تولید می‌کند.

مثال

apigee-remote-service-cli token inspect -c config.yaml <<< $TOKEN

خروجی

درصورت موفقیت، بروندادی مشابه با برونداد زیر خواهید دید:
{
	"aud": [
		"remote-service-client"
	],
	"exp": 1591741549,
	"iat": 1591740649,
	"iss": "https://apigee-docs-test.apigee.net/remote-service/token",
	"jti": "99325d2e-6440-4278-9f7f-b252a1a79e53",
	"nbf": 1591740649,
	"access_token": "VfzpXzBGAQ07po0bPMKY4JgQjus",
	"api_product_list": [
		"httpbin"
	],
	"application_name": "httpbin",
	"client_id": "GYDGHy5TRpV8AejXCOlreP7dPVepA8H",
	"developer_email": "user@example.com",
	"scope": ""
}
verifying...
token ok.

چرخاندن کد JWT

در زمانی پس‌از تولید اولیه JWT، ممکن است نیاز داشته باشید جفت کلید عمومی/خصوصی ذخیره‌شده توسط Apigee Edge در نقشه مقدار-کلید رمزگذاری‌شده (KVM) را تغییر دهید. این فرایند تولید جفت کلید جدید را چرخش کلید می‌نامند. وقتی کلیدها را می‌چرخانید، جفت کلید خصوصی/عمومی جدیدی تولید می‌شود و در KVM «istio» در سازمان/محیط Apigee Edge شما ذخیره می‌شود. علاوه‌براین، کلید عمومی قدیمی همراه با مقدار شناسه کلید اصلی آن حفظ می‌شود.

کاربرد

اگر در «ابر عمومی Edge» هستید:
apigee-remote-service-cli token rotate-cert -c [config_file] -o [organization] -e [environment] -k [provision_key] -s [provision_secret] --kid [new_key_id]
اگر در «ابر خصوصی Edge» هستید:
apigee-remote-service-cli token rotate-cert -o [organization] -e [environment] -u [username] -p [password] -k [provision_key] -s [provision_secret] --kid [new_key_id]

پارامترها

پارامترها نوع شرح
-c, --config رشته (الزامی) مسیر فایل پیکربندی «سرویس از دور Apigee». نکته: وقتی این گزینه را مشخص می‌کنید، می‌توانید اکثر پارامترهای فرمان دیگر را حذف کنید. استفاده از گزینه --config را ببینید.
-e, --env رشته (الزامی) محیطی در سازمانتان.
-h, --help راهنمای پارامترهای فرمان را نمایش می‌دهد.
--insecure هنگام استفاده از SSL، اتصال‌های سرور ناامن مجاز شود
--truncate قطع توپ تعداد گواهینامه‌هایی که باید در jwks نگه داشته شود (پیش‌فرض ۲)
-o, --org رشته (الزامی) سازمان Apigee. باید سرپرست سازمان باشید.
-r, --runtime رشته نشانی وب پایه زمان اجرای Apigee (برای هیبریدی یا opdk الزامی است).
-v, --verbose (اختیاری) برونداد مفصلی تولید می‌کند.

مثال

apigee-remote-service-cli token rotate-cert -c config.yaml -o myorg -e test -k 2e238ffa15dc5ab6a1e97868e7581f6c60ddb8575478582c256d8b7e5b2677a8 -s 51058077223fa7b683c3bea845c5cca138340d1d5583922b6d465f9f918a4b08

خروجی

certificate successfully rotated

استفاده از .netrc برای اعتبارنامه‌ها

اگر در «ابر عمومی Edge» هستید و ورودی‌ای برای ماشین api.enterprise.apigee.com دارید، apigee-remote-service-cli به‌طور خودکار username و password (برای اصالت‌سنجی پایه درصورت نیاز) را از فایل .netrc در دایرکتوری خانه شما برمی‌دارد. اگر در Apigee Private Cloud هستید، مقدار ماشین همان نشانی وب management شما است (برای مثال: http://192.162.55.100). برای مثال در Edge Public Cloud:
machine api.enterprise.apigee.com
login jdoe@google.com
password abc123
برای مثال در Edge Private Cloud:
machine http://192.162.55.100
login jdoe@google.com
password abc123

فرمان نسخه

نسخه CLI را چاپ کنید.

apigee-remote-service-cli version

استفاده از گزینه فرمان --config

گزینه --config مکان فایل پیکربندی تولیدشده توسط فرمان provision را مشخص می‌کند. یکی از مزایای مفید این گزینه این است که به شما امکان می‌دهد از اکثر پارامترهای فرمان دیگر که «واسط خط فرمان» از فایل پیکربندی می‌کشد، رد شوید. این گزینه‌ها شامل موارد زیر است:
  • سازمان
  • محیط
  • زمان اجرا
  • مدیریت
  • ناامن
  • فضای نام
  • قدیمی
  • opdk

برای مثال، می‌توانید فرمان provision را به‌این صورت اجرا کنید:

apigee-remote-service-cli provision --config='old-config.yaml' > new-config.yaml

فایل پیکربندی

این بخش فایل پیکربندی نمونه‌ای را با همه گزینه‌های دردسترس نشان می‌دهد.

global:
  temp_dir: /tmp/apigee-istio
  keep_alive_max_connection_age: 10m
  api_address: :5000
  metrics_address: :5001
  tls:
    cert_file: tls.crt
    key_file: tls.key
tenant:
  internal_api: https://istioservices.apigee.net/edgemicro
  remote_service_api: https://org-test.apigee.net/remote-service
  org_name: org
  env_name: env
  key: mykey
  secret: mysecret
  client_timeout: 30s
  allow_unverified_ssl_cert: false
products:
  refresh_rate: 2m
analytics:
  legacy_endpoint: false
  file_limit: 1024
  send_channel_size: 10
  collection_interval: 10s
  fluentd_endpoint: apigee-udca-myorg-test.apigee.svc.cluster.local:20001
  tls:
    ca_file: /opt/apigee/tls/ca.crt
    cert_file: /opt/apigee/tls/tls.crt
    key_file: /opt/apigee/tls/tls.key
    allow_unverified_ssl_cert: false
auth:
  api_key_claim: claim
  api_key_cache_duration: 30m
  api_key_header: x-api-key
  api_target_header: :authority
  reject_unauthorized: true
  jwks_poll_interval: 0s