إنشاء مؤسسة وبيئة ومضيف افتراضي

يمكنك إنشاء مؤسسة وبيئة ومضيف افتراضي باستخدام سطر الأوامر في وحدة أو يمكنك إنشاء كل منها على حدة. بالإضافة إلى ذلك، يمكنك استخدام صفحة Edge API لتنفيذ العديد من هذه الإجراءات.

فيديو: شاهِد فيديو قصيرًا للحصول على نظرة عامة عن عملية إعداد Apigee Organization وإعداده.

إن إنشاء مؤسسة، والمضيف الظاهري في نفس الوقت

قبل إنشاء خادم وكيل لواجهة برمجة التطبيقات على Apigee Edge، يجب إنشاء مؤسسة واحدة على الأقل، داخل كل مؤسسة، وبيئة واحدة أو أكثر ومضيفين افتراضيين.

عادةً ما يتم إنشاء المؤسسات والبيئات معًا. لتبسيط العملية، استخدم الأداة المساعدة apigee-provision. استدعاؤه من سطر الأوامر في إدارة Edge الخادم:

/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

حيث configFile هو المسار إلى ملف إعداد يبدو مشابهًا للملف التالي:

# Set Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=admin_password  # If omitted, you are prompted for it.
NEW_USER="y"
USER_NAME=orgAdmin@myCo.com
FIRST_NAME=foo
LAST_NAME=bar
USER_PWD="userPword"
ORG_NAME=example  # lowercase only, no spaces, underscores, or periods.
ENV_NAME=prod  # lowercase only
VHOST_PORT=9001
VHOST_NAME=default
VHOST_ALIAS="$IP1:9001"
# Optionally configure TLS/SSL for virtual host.
# VHOST_SSL=y     # Set to "y" to enable TLS/SSL on the virtual host.
# KEYSTORE_JAR=   # JAR file containing the cert and private key.
# KEYSTORE_NAME=  # Name of the keystore.
# KEYSTORE_ALIAS= # The key alias.
# KEY_PASSWORD=   # The key password, if it has one.
# Optionally set the base URL displayed by the Edge UI for an
# API proxy deployed to the virtual host.
# VHOST_BASEURL="http://myCo.com"
# AXGROUP=axgroup-001 # Default value is axgroup-001

عند إعداد مؤسسة، ينفّذ النص البرمجي "setup-org" ما يلي:

  • ينشئ المؤسسة.
  • يربط المؤسسة بـ "البوابة" كبل. لا يمكنك تغيير هذا الإعداد.
  • إضافة المستخدم المحدّد كمشرف في المؤسسة إذا لم يكن المستخدم موجودًا، فيمكنك إنشاء واحدة.
  • تنشئ بيئة واحدة أو أكثر.
  • تنشئ مضيفًا افتراضيًا واحدًا أو أكثر لكل بيئة.
  • ربط البيئة بجميع معالجات الرسائل.
  • تفعيل الإحصاءات

يبلغ الحد الأقصى لطول اسم المؤسسة واسم البيئة تلقائيًا 20 حرفًا عند استخدام أداة apigee-provision. لا ينطبق هذا الحد إذا كنت تستخدم Edge API مباشرةً لإنشاء المؤسسة أو البيئة. كل من اسم المؤسسة والبيئة أن يكون الاسم بأحرف صغيرة.

إنشاء مؤسسة

استخدِم الأمر create-org لإنشاء مؤسسة، كما في المثال التالي. :

/opt/apigee/apigee-service/bin/apigee-service apigee-provision create-org -f configFile

ينشئ هذا البرنامج النصي المؤسسة، ولكنه لا يضيف أو يضبط البيئات المضيفات الافتراضية التي تطلبها المؤسسة لمعالجة طلبات البيانات من واجهة برمجة التطبيقات.

يحتوي ملف الإعداد على اسم المؤسسة وعنوان البريد الإلكتروني للمؤسسة. المشرف. يمكن فقط استخدام الأحرف التي يمكنك استخدامها في السمة name a-z0-9\-$% لا تستخدم مسافات أو نقاطًا أو أحرفًا كبيرة في الاسم:

APIGEE_ADMINPW=admin_password    # If omitted, you are prompted for it.
ORG_NAME=example  # lowercase only, no spaces, underscores, or periods.
ORG_ADMIN=orgAdmin@myCo.com

نص create-org:

  • ينشئ المؤسسة.
  • يربط المؤسسة بـ "البوابة" كبل.
  • إضافة المستخدم المحدّد كمشرف في المؤسسة يجب أن يكون المستخدم موجودًا من قبل. وإلا فإن النص البرمجي يُصدر خطأ.

إنشاء مؤسسة باستخدام طلبات بيانات من واجهة برمجة التطبيقات

يمكنك استخدام طلبات البيانات من واجهة برمجة التطبيقات التالية لإنشاء مؤسسة. ينشئ الاستدعاء الأول المؤسسة:

curl -H "Content-Type:application/xml" -u sysAdminEmail:adminPasswd \
  -X POST http://management_server_IP:8080/v1/organizations \
  -d '<Organization name="org_name" type="paid"/>'

تربط المكالمة التالية المؤسسة باللوحة:

curl -H "Content-Type:application/x-www-form-urlencoded" \
  -u sysAdminEmail:adminPasswd -X POST \
  http://management_server_IP:8080/v1/organizations/org_name/pods \
  -d "region=default&pod=gateway"

تتم من خلال المكالمة الأخيرة إضافة مستخدم حالي بصفته مشرف المؤسسة في المؤسسة:

curl -H "Content-Type:application/xml" -u sysAdminEmail:adminPasswd \
  -X POST http://<ms-ip>:8080/v1/organizations/org_name/users/user_email/userroles/ \
  -d '<Roles><Role name="orgadmin"/></Roles>'

إذا لم يكن المستخدم موجودًا، يمكنك استخدام الاستدعاء التالي لإنشاء المستخدم كما هو موضح في إضافة مستخدم.

إنشاء بيئة

استخدام النص البرمجي add-env لإنشاء بيئة في مؤسسة حالية:

/opt/apigee/apigee-service/bin/apigee-service apigee-provision add-env -f configFile

يحتوي ملف التهيئة هذا على المعلومات اللازمة لإنشاء بيئة المضيف:

APIGEE_ADMINPW=admin_password  # If omitted, you are prompted for it.
ORG_NAME=example  # lowercase only, no spaces, underscores, or periods.
ENV_NAME=prod  # lowercase only
VHOST_PORT=9001
VHOST_NAME=default
VHOST_ALIAS="$IP1:9001"
# Optionally configure TLS/SSL for virtual host.
# VHOST_SSL=y     # Set to "y" to enable TLS/SSL on the virtual host.
# KEYSTORE_JAR=   # JAR file containing the cert and private key.
# KEYSTORE_NAME=  # Name of the keystore. 
# KEYSTORE_ALIAS= # The key alias.
# KEY_PASSWORD=   # The key password, if it has one. 
# Optionally set the base URL displayed by the Edge UI for an
# API proxy deployed to the virtual host.
# VHOST_BASEURL="http://myCo.com"
# AXGROUP=axgroup-001 # Default value is axgroup-001

الأمر add-env:

  • يخلق البيئة.
  • تنشئ مضيفًا افتراضيًا واحدًا للبيئة.
  • تربط البيئة بجميع معالِجات الرسائل في المجموعة المرتبطة مؤسسة تحتوي على البيئة.
  • تفعيل الإحصاءات

يمكنك إنشاء بيئة باستخدام طلبات بيانات من واجهة برمجة التطبيقات

بدلاً من ذلك، يمكنك استخدام طلبات البيانات من واجهة برمجة التطبيقات التالية لإنشاء بيئة. المكالمة الأولى إلى إنشاء البيئة:

curl -H "Content-Type:application/xml" -u sysAdminEmail:adminPasswd \
  -X POST http://management_server_IP:8080/v1/organizations/org_name/environments \
  -d '<Environment name="env_name"/>'

تربط المكالمة التالية البيئة بمعالج الرسائل. إجراء هذه المكالمة لكل معالج الرسائل الذي تريد ربطه بالبيئة:

curl -H "Content-Type:application/x-www-form-urlencoded" \
  -u sysAdminEmail:adminPasswd -X POST \
  http://management_server_IP:8080/v1/organizations/org_name/environments/env_name/servers \
  -d "action=add&uuid=uuid"

يشير uuid إلى المعرّف الفريد العالمي (UUID) الخاص بمعالج الرسائل. يمكنك الحصول على المعرّف الفريد العالمي (UUID) من خلال استخدام :

curl http://Message_Processor_IP:8082/v1/servers/self

حيث يكون Message_Processor_IP هو عنوان IP لمعالج الرسائل.

يعمل طلب البيانات التالي من واجهة برمجة التطبيقات على تفعيل "إحصاءات Google" في بيئة معيّنة. فهو يتحقق من وجود Qpid وPostgres Servers في المجموعات المدرَجة ضمن جميع مراكز البيانات. تبدأ بعد ذلك عملية إعداد "إحصاءات Google" للمؤسسة والبيئة المعينين.

يحتوي ملف الإعداد هذا على:

ORG_NAME=orgName  # lowercase only, no spaces, underscores, or periods.
ENV_NAME=envName  # lowercase only

حيث يحتوي sample.json على ما يلي:

{
  "properties" : {
    "samplingAlgo" : "reservoir_sampler",
    "samplingTables" : "10=ten;1=one;",
    "aggregationinterval" : "300000",
    "samplingInterval" : "300000",
    "useSampling" : "100",
    "samplingThreshold" : "100000"
  },
  "servers" : {
    "postgres-server" : [ "1acff3a5-8a6a-4097-8d26-d0886853239c", "f93367f7-edc8-4d55-92c1-2fba61ccc4ab" ],  
    "qpid-server" : [ "d3c5acf0-f88a-478e-948d-6f3094f12e3b", "74f67bf2-86b2-44b7-a3d9-41ff117475dd"] 
  }
}

السمة postgres-servers يحتوي على قائمة مفصولة بفواصل من معرّفات UUID لـ Postgres، وتحتوي السمة qpid-server على معرّفات UUID لـ Qpid. في حال احتجت إلى الحصول على أرقام التعريف الفريدة العالمية هذه، استخدِم الأوامر التالية.

بالنسبة إلى Qpid، شغِّل الأمر التالي:

curl -u sysAdminEmail:password http://management_server_IP/v1/servers?pod=central

ناتج هذا الأمر هو كائن JSON. لكل خادم Qpid، سترى ناتجًا في النموذج:

"type" : [ "qpid-server" ],
"uUID" : "d3c5acf0-f88a-478e-948d-6f3094f12e3b"

بالنسبة إلى Postgres، شغِّل الأمر التالي:

curl -u sysAdminEmail:admin_password http://management_server_IP/v1/servers?pod=analytics

بالنسبة إلى كل خادم من خوادم Postgres، ستظهر لك النتائج على النحو التالي:

"type" : [ "postgres-server" ],
"uUID" : "d3c5acf0-f88a-478e-948d-6f3094f12e3b"

إنشاء مضيف افتراضي

يمكنك إنشاء مضيف افتراضي في بيئة حالية في مؤسسة. غالبًا عدة مضيفين افتراضيين. على سبيل المثال، قد يتيح مضيف افتراضي واحد استخدام بروتوكول HTTP بروتوكول، بينما يدعم مضيف افتراضي آخر في نفس البيئة بروتوكول HTTPS المشفر والبروتوكول.

استخدم طلب البيانات من واجهة برمجة التطبيقات التالي لإنشاء مضيفات افتراضية إضافية، أو لإنشاء مضيف افتراضي بيئة بدون مضيف ظاهري:

curl -H "Content-Type:application/xml" -u sysAdminEmail:adminPasswd \
  -X POST http://management_server_IP:8080/v1/organizations/org_name/environments/env_name/virtualhosts \
  -d '<VirtualHost name="default"> \
    <HostAliases> \
      <HostAlias>myorg-test.apigee.net</HostAlias> \
    </HostAliases> \
    <Interfaces/> \
    <Port>443</Port> \
  </VirtualHost>'

للحصول على وصف كامل لإنشاء مضيف افتراضي، بما في ذلك إنشاء مضيف افتراضي آمن يستخدم بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة عبر HTTPS، راجع تهيئة الدخول إلى بروتوكول أمان طبقة النقل (TLS) إلى واجهة برمجة تطبيقات للسحابة الإلكترونية الخاصة