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

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

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

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

برای اینکه یک پروکسی Edge API بتواند با یک برنامه Hosted Targets که به درستی ساخته و مستقر شده است، ارتباط برقرار کند، به یک پیکربندی ساده در Target Endpoint پروکسی نیاز دارد. برای شروع، به آموزش‌های Hosted Targets مراجعه کنید.

Hosted Targets از چه زمان‌های اجرای برنامه‌ای پشتیبانی می‌کند؟

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

نصب اهداف میزبانی شده

Hosted Targets در تمام سازمان‌های Edge Public Cloud موجود است. برای استفاده از Hosted Targets نیازی به نصب هیچ چیز ندارید.

تأیید فعال بودن Hosted Targets

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

برای مثال:

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"
  }
  

آنچه باید در مورد اهداف میزبانی شده بدانید

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

محدودیت‌ها

برای محدودیت‌های استفاده در Hosted Targets، به محدودیت‌های محصول Apigee مراجعه کنید.

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

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

برای استفاده از Hosted Targets، باید کارهای زیر را انجام دهید. این آموزش‌ها هر یک از این کارها را با جزئیات شرح می‌دهند.

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

<?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>

دامنه کاربردهای Hosted Targets

برنامه‌های Hosted Targets به یک محیط سازمانی Edge محدود می‌شوند. این محدوده‌بندی مشابه هر Edge proxy است.

آیا برنامه‌های Hosted Targets می‌توانند به داده‌های پروکسی دسترسی داشته باشند؟

برنامه‌های Hosted Targets در حال حاضر به محیط زمان اجرای پروکسی دسترسی ندارند. این بدان معناست که شما نمی‌توانید مستقیماً از برنامه‌های Hosted Targets به متغیرهای جریان، حافظه‌های پنهان و سایر موجودیت‌ها دسترسی داشته باشید.

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

انتقال کد برنامه موجود به Hosted Targets

در حال حاضر هیچ مسیر مهاجرت خودکاری از یک برنامه Node.js تعبیه‌شده سنتی مبتنی بر Trireme به Hosted Targets وجود ندارد. با این حال، می‌توانید کد برنامه موجود را به صورت دستی به Hosted Targets تبدیل کنید. برای مثال، به مهاجرت یک پروکسی Node.js موجود به یک پروکسی Hosted Targets مراجعه کنید.