نمای کلی «هدف‌های میزبانی‌شده»

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

«هدف‌های میزبانی‌شده» به شما امکان می‌دهد برنامه‌های Node.js را در محیط زمان اجرای بومی میزبانی‌شده توسط Apigee اجرا کنید. هدف «هدف‌های میزبانی‌شده» ساده است: به شما امکان می‌دهد برنامه‌ها را در محیطی بومی، ایمن، مقیاس‌پذیر، و مجزا مستقر کنید که در آن کارگزاران Edge API بتوانند آن‌ها را به‌عنوان سرویس‌های هدف فراخوانی کنند.

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

برای اینکه یک پراکسی «میانای برنامه‌سازی کاربردی Edge» با یک برنامه «هدف‌های میزبانی‌شده» که به‌درستی ساخته و مستقر شده است ارتباط برقرار کند، باید پیکربندی ساده‌ای در «نقطه پایانی هدف» پراکسی انجام دهید. برای شروع، به آموزش‌های گام‌به‌گام «هدف‌های میزبانی‌شده» بروید.

«هدف‌های میزبانی‌شده» از کدام زمان‌های اجرای برنامه پشتیبانی می‌کند؟

درحال‌حاضر، فقط می‌توانید برنامه‌های Node.js را در «هدف‌های میزبانی‌شده» مستقر کنید.

درحال نصب هدف‌های میزبانی‌شده

«هدف‌های میزبانی‌شده» در همه سازمان‌های «ابر عمومی Edge» دردسترس است. برای استفاده از «هدف‌های میزبانی‌شده» نیازی به نصب چیزی ندارید.

درحال درستی‌سنجی اینکه «هدف‌های میزبانی‌شده» فعال است

اگر می‌خواهید تأیید کنید که سازمانتان «هدف‌های میزبانی‌شده» را فعال کرده است، جزئیات سازمانتان را دریافت کنید و مطمئن شوید که دارایی features.isEdgeFunctionsEnabled روی درست تنظیم شده است. این دارایی فقط خواندنی است.

برای مثال:

https://api.enterprise.apigee.com/v1/organizations/myorg

  {
     "createdAt":1507572884047,
     "createdBy":"jdoe@apigee.com",
     "displayName":"myorg",
     "environments":[
        "prod",
        "dev",
        "test",
        "portal"
     ],
     "lastModifiedAt":1507578673194,
     "lastModifiedBy":"jdoe@apigee.com",
     "name":"jdoe",
     "properties":{
        "property":[
           {
              "name":"features.isSmbOrganization",
              "value":"false"
           },
           {
              "name":"self.service.virtual.host.enabled",
              "value":"true"
           },
           {
              "name":"features.isCpsEnabled",
              "value":"true"
           },
           {
              "name":"features.isEdgeFunctionsEnabled",
              "value":"true"
           }
        ]
     },
     "type":"paid"
  }
  

آنچه باید درباره «هدف‌های میزبانی‌شده» بدانید

«هدف‌های میزبانی‌شده» به برنامه‌های Node.js اجازه می‌دهد در محیط بومی‌ای اجرا شوند که به هیچ فناوری زمان اجرای مختص Apigee وابسته نیست. می‌توانید برنامه خود را قبل‌از استقرار به‌صورت محلی اشکال‌زدایی و آزمایش کنید و مطمئن باشید که نسخه مستقرشده دقیقاً مانند نسخه محلی کار خواهد کرد. در زمان استقرار، می‌توانید هر نسخه زمان اجرای برنامه‌ای را برای اجرای برنامه‌تان در «هدف‌های میزبانی‌شده» انتخاب کنید. برای مثال، ممکن است به‌طور خاص انتخاب کنید که برنامه Node.js در محیط v8.10.0 اجرا شود.

محدودیت‌ها

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

مراحل اولیه برای دنبال کردن

اگر با توسعه پراکسی Edge آشنا هستید، فقط باید چند مرحله ساده را یاد بگیرید تا بتوانید با موفقیت از «هدف‌های میزبانی‌شده» استفاده کنید. اساساً، شما پراکسی‌های Edge را برای «هدف‌های میزبانی‌شده» همان‌طور که برای هر پراکسی Apigee Edge دیگری انجام می‌دهید ایجاد، پیاده‌سازی، و مدیریت می‌کنید.

برای استفاده از «هدف‌های میزبانی‌شده»، باید کارهای زیر را انجام دهید. آموزش‌های گام‌به‌گام هریک از این تکالیف را به‌طور مفصل توضیح می‌دهند.

• برنامه Node.js خود را به‌صورت محلی توسعه دهید و آزمایش کنید.
• در دایرکتوری ریشه پروژه برنامه، فایل مانیفست ایجاد کنید. مانیفست یک فایل YAML است که اطلاعات موردنیاز برای ساخت و استقرار برنامه را مشخص می‌کند.
• برنامه‌تان را به‌عنوان نوع منبع میزبانی‌شده به پراکسی Edge اضافه کنید.
• در «نقطه پایان هدف» کارگزار وکالتی، برچسب <HostedTarget/> خالی را اضافه کنید. این برچسب به Edge می‌گوید برنامه Node.js را در محیط «هدف‌های میزبانی‌شده» مستقر کند. برای مثال:

<?xml version="1.0" encoding="UTF-8"?>
<TargetEndpoint name="default">
   <PreFlow name="PreFlow">
      <Request />
      <Response />
   </PreFlow>
   <PostFlow name="PostFlow">
      <Request />
      <Response />
   </PostFlow>
   <Flows />
   <HostedTarget />
</TargetEndpoint>

حوزه برنامه‌های «هدف‌های میزبانی‌شده»

برنامه‌های «هدف‌های میزبانی‌شده» در محیط سازمان «لبه» محدود می‌شوند. این محدوده همانند هر پراکسی Edge است.

آیا برنامه‌های «هدف‌های میزبانی‌شده» می‌توانند به داده‌های پراکسی دسترسی داشته باشند؟

برنامه‌های «هدف‌های میزبانی‌شده» درحال‌حاضر به محیط زمان اجرای پراکسی دسترسی ندارند. این یعنی نمی‌توانید مستقیماً از برنامه‌های «هدف‌های میزبانی‌شده» به متغیرهای جاری‌سازی، ذخیره‌های موقت، و نهادهای دیگر دسترسی داشته باشید.

با Node.js جاسازی‌شده (پشتیبانی سنتی و مبتنی بر Trireme از Node.js در Edge)، می‌توانید از apigee-access برای دسترسی به متغیرهای جاری و دیگر نهادها در Edge استفاده کنید. بااین‌حال، «هدف‌های میزبانی‌شده» از واحد apigee-access برای استقرار Node.js پشتیبانی نمی‌کند. همچنین ببینید آیا می‌توان کمبود apigee-access را دور زد؟

انتقال کد برنامه موجود به «هدف‌های میزبانی‌شده»

درحال‌حاضر هیچ مسیر انتقال خودکاری از برنامه Node.js جاسازی‌شده مبتنی بر Trireme سنتی به «هدف‌های میزبانی‌شده» وجود ندارد. بااین‌حال، می‌توانید کد برنامه موجود را به‌طور دستی به «هدف‌های میزبانی‌شده» تبدیل کنید. برای مثال، انتقال کارگزار Node.js موجود به کارگزار «هدف‌های میزبانی‌شده» را ببینید.