مرجع

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

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

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

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

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

فهرست همه محصولات 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 تنظیم می‌کند.
--mfa داده‌واحد مجوزدهی چندعاملی Apigee (فقط با --legacy استفاده می‌شود)
--opdk اگر از Apigee Edge برای «ابر خصوصی» استفاده می‌کنید، این پرچم را تنظیم کنید.
-o, --org رشته (الزامی) سازمان Apigee. باید سرپرست سازمان باشید.
-p, --password رشته (فقط برای اصالت‌سنجی پایه الزامی است) گذرواژه Apigee شما. می‌توانید به‌صورت اختیاری گذرواژه را در فایل .netrc مشخص کنید. اگر این کار را انجام دهید، دیگر لازم نیست گذرواژه‌تان را در خط فرمان ارائه دهید. همچنین استفاده از .netrc برای اعتبارنامه‌ها را ببینید.
-r, --runtime رشته (فقط «ابر خصوصی») نشانی وب زمان اجرا را برای نمونه «ابر خصوصی» شما مشخص می‌کند.
-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:

تأیید پیوند

تأیید کنید که محصول API محدود مشخص‌شده و برنامه‌های توسعه‌دهنده مرتبط با آن نیز محصول سرویس راه دور مرتبط با خود را داشته باشند. اگر نام محصول API را مشخص نکنید، فرمان همه محصولات پیوندشده را بررسی می‌کند.

کاربرد

برای Edge Public Cloud:

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

برای Edge Private Cloud:

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

که در آن product_name اختیاری است. اگر نام محصولی را مشخص نکنید، همه محصولات پیوندشده بررسی می‌شوند.

پارامترها

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

مثال

./apigee-remote-service-cli bindings verify my-product -o myorg -e test -u user@example.com -c config.yaml -p xxxxxx
  app my-app associated with product my-product is verified

فرمان راهنما

برای همه فرمان‌های 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

پارامترها

پارامترها نوع شرح
--analytics-sa رشته این پرچم فقط برای نصب‌های Apigee hybrid و Apigee on Google Cloud دردسترس است.

از این پرچم برای مشخص کردن مسیر فایل کلید حساب سرویس Google Cloud استفاده کنید، جایی که حساب سرویس نقش Apigee Analytics Agent را دارد. «حساب سرویس» توسط آداپتور برای بارگذاری مستقیم داده‌های تجزیه‌وتحلیل در Apigee استفاده می‌شود. اگر از Apigee hybrid استفاده می‌کنید، این گزینه به شما امکان می‌دهد زمان اجرای ترکیبی را در یک خوشه و آداپتور را در خوشه دیگری نصب کنید.

-c, --config رشته مسیر فایل پیکربندی «سرویس از دور Apigee». همچنین استفاده از گزینه --config را ببینید.
-e, --environment رشته (الزامی) محیطی در سازمانتان.
-f, --force-proxy-install (اختیاری) اگر پراکسی remote-service ازقبل در سازمانتان نصب شده باشد، آن را مجبور می‌کند دوباره نصب شود.
-h, --help راهنمای پارامترهای فرمان را نمایش می‌دهد.
-k, --key رشته کلید برگشتی از فرمان apigee-remote-service-cli provision را مشخص می‌کند.
--legacy اگر از Apigee Edge Cloud استفاده می‌کنید، این پرچم را تنظیم کنید. نشانی‌های وب مدیریت و زمان اجرا را برای Edge Cloud تنظیم می‌کند.
--mfa داده‌واحد مجوزدهی چندعاملی Apigee (فقط با --legacy استفاده می‌شود)
-m, --management رشته (اگر از Apigee Private Cloud استفاده می‌کنید الزامی است) نشانی وب پایه مدیریت Apigee شما. پیش‌فرض: https://api.enterprise.apigee.com
-n, --namespace رشته پیکربندی را به‌عنوان Envoy ConfigMap در فضای نام مشخص‌شده منتشر کنید. پیش‌فرض: apigee
--opdk رشته Apigee OPDK.
-o, --organization رشته (الزامی) سازمان Apigee شما. باید سرپرست سازمان باشید.
-p, --password رشته (فقط برای اصالت‌سنجی پایه الزامی است) گذرواژه Apigee شما. می‌توانید به‌صورت اختیاری گذرواژه را در فایل .netrc مشخص کنید. اگر این کار را انجام دهید، دیگر لازم نیست گذرواژه‌تان را در خط فرمان ارائه دهید. همچنین استفاده از .netrc برای اعتبارنامه‌ها را ببینید.
--rotate-int قطع توپ اگر n > 0، کلید خصوصی جدیدی تولید کنید و n کلید عمومی را نگه دارید (فقط ترکیبی)
-r, --runtime رشته (فقط «ابر خصوصی») نشانی وب زمان اجرا را برای نمونه «ابر خصوصی» شما مشخص می‌کند.
-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 --mfa $MFA --username $USER --password $PASSWORD --organization $ORG --environment $ENV > config.yaml

فرمان نمونه‌ها

فایل‌های پیکربندی نمونه برای استقرار Envoy یا Istio بومی ایجاد می‌کند.

کاربرد

apigee-remote-service-cli samples create [flags]

شرح

این فرمان به فایل config.yaml معتبری که ازطریق آماده‌سازی تولید شده است نیاز دارد. به‌طور پیش‌فرض، فایل‌های نمونه در دایرکتوری‌ای به‌نام ./samples برونداد می‌شوند. این فرمان این دایرکتوری را برای شما ایجاد می‌کند.

اگر از Envoy بومی استفاده می‌کنید، این فرمان میزبان سرویس هدف و نام موردنظر را برای خوشه‌اش می‌گیرد. اگر پوشه‌ای حاوی tls.key و tls.crt ازطریق --tls ارائه شود، اتصال SSL سفارشی را نیز از پراکسی Envoy به خوشه سرویس راه دور تنظیم می‌کند.

اگر از Istio استفاده می‌کنید، جایی که پراکسی Envoy به‌عنوان یک چرخ جانبی عمل می‌کند، اگر هدف نامشخص باشد، مثال httpbin تولید خواهد شد. درغیراین‌صورت، مسئولیت آماده کردن فایل‌های پیکربندی مربوط به استقرار سرویس‌های هدف برعهده شما است.

پارامترها

پارامترها نوع شرح
-c, --config رشته (الزامی) مسیر فایل پیکربندی «سرویس از دور Apigee».
نکته: این پرچم به شما امکان می‌دهد اکثر پارامترهای فرمان دیگر را حذف کنید، زیرا «میانای خط فرمان» می‌تواند آن‌ها را مستقیماً از فایل پیکربندی بکشد. استفاده از گزینه --config را ببینید.
-f, --force فهرست راهنمای موجود را مجبور به رونویسی کنید.
-h, --help راهنمای پارامترهای فرمان را نمایش می‌دهد.
--host میزبان سرویس هدف (پیش‌فرض «httpbin.org»)
-n, --name نام سرویس هدف (پیش‌فرض «httpbin»)
--out دایرکتوری که فایل‌های پیکربندی نمونه در آن ایجاد می‌شود. پیش‌فرض: ./samples
-t, --template

نام الگو. اگر درحال انجام استقرار Istio هستید (فقط ترکیبی)، یکی از گزینه‌های Istio موجود را انتخاب کنید. برای استقرار بومی Envoy، از گزینه بومی استفاده کنید. گزینه‌های دردسترس عبارت‌اند از:

  • ‫istio-1.6 (پیش‌فرض)
  • istio-1.7
  • native
--tls دایرکتوری که فایل‌های کلید و crt در آن ذخیره می‌شود.

مثال

apigee-remote-service-cli samples create -c ./config.yaml

فهرست کردن گزینه‌های الگوی دردسترس

گزینه‌های دردسترس برای استفاده با پارامتر --templates را فهرست می‌کند.

کاربرد

apigee-remote-service-cli samples templates

پارامترها

هیچ‌کدام.

مثال

apigee-remote-service-cli samples templates
Supported templates (native is deprecated):
  envoy-1.14
  envoy-1.15
  envoy-1.16
  istio-1.5
  istio-1.6
  istio-1.7
  istio-1.8
  native

فرمان‌های کد

می‌توانید به‌جای استفاده از کلید میانای برنامه‌سازی کاربردی، از یک کد 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]

پارامترها

پارامترها نوع شرح
-c, --config رشته (الزامی) مسیر فایل پیکربندی «سرویس از دور Apigee».
نکته: این پرچم به شما امکان می‌دهد اکثر پارامترهای فرمان دیگر را حذف کنید، زیرا «میانای خط فرمان» می‌تواند آن‌ها را مستقیماً از فایل پیکربندی بکشد. استفاده از گزینه --config را ببینید.
-e, --env رشته (الزامی) محیطی در سازمانتان.
-h, --help راهنمای پارامترهای فرمان را نمایش می‌دهد.
--insecure هنگام استفاده از SSL، اتصال‌های سرور ناامن مجاز شود.
-o, --org رشته (الزامی) سازمان Apigee. باید سرپرست سازمان باشید.
-r, --runtime رشته (فقط «ابر خصوصی») نشانی وب زمان اجرا را برای نمونه «ابر خصوصی» شما مشخص می‌کند.
-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]

پارامترها

پارامترها نوع شرح
-c, --config رشته (الزامی) مسیر فایل پیکربندی «سرویس از دور Apigee».
نکته: این پرچم به شما امکان می‌دهد اکثر پارامترهای فرمان دیگر را حذف کنید، زیرا «میانای خط فرمان» می‌تواند آن‌ها را مستقیماً از فایل پیکربندی بکشد. استفاده از گزینه --config را ببینید.
-e, --env رشته (الزامی) محیطی در سازمانتان.
-h, --help راهنمای پارامترهای فرمان را نمایش می‌دهد.
--insecure هنگام استفاده از SSL، اتصال‌های سرور ناامن مجاز شود.
-o, --org رشته (الزامی) سازمان Apigee. باید سرپرست سازمان باشید.
-r, --runtime رشته (فقط «ابر خصوصی») نشانی وب زمان اجرا را برای نمونه «ابر خصوصی» شما مشخص می‌کند.
-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 رشته (فقط «ابر خصوصی») نشانی وب زمان اجرا را برای نمونه «ابر خصوصی» شما مشخص می‌کند.
-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: 1m
  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
  jwt_provider_key: https://org-test.apigee.net/remote-service/token