Edge for Private Cloud، الإصدار 4.16.09
إنشاء مؤسسة، البيئة والمضيف الافتراضي في الوقت نفسه
قبل إنشاء وكيل واجهة برمجة التطبيقات على Apigee Edge، يجب إنشاء مؤسسة واحدة على الأقل، وبيئة واحدة أو أكثر وخوادم افتراضية واحدة أو أكثر في كل مؤسسة.
عادةً ما يتم إنشاء المؤسسات والبيئات معًا. لتسهيل العملية، استخدِم الأداة apigee-provision. يمكنك استدعاؤه من سطر الأوامر على Edge Management Server:
> /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
يحتوي ملف الإعداد على:
APIGEE_ADMINPW=adminPword # If omitted, you are prompted for it. NEW_USER="y" USER_NAME=orgAdmin@myCo.com FIRST_NAME=foo LAST_NAME=bar USER_PWD="userPwrod" ORG_NAME=example # lowercase only, no spaces, underscores, or periods. ENV_NAME=prod 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. # AXGROUP=axgroup-001 # Default value is axgroup-001
بعد ذلك، ينفِّذ الأمر ما يلي:
- إنشاء المؤسسة
ملاحظة: لا يمكنك إعادة تسمية المؤسسة بعد إنشائها. - يمكنك ربط المؤسسة باللوحة، ويتم ربطها تلقائيًا بـ "المدخل". فريق
- أضِف المستخدم المحدّد كمشرف المؤسسة. إذا لم يكن المستخدم موجودًا، فيمكنك إنشاء واحد.
- إنشاء بيئة واحدة أو أكثر
- أنشئ مضيفًا افتراضيًا واحدًا أو أكثر لكل بيئة.
- ربط البيئة بجميع معالجات الرسائل
- تفعيل الإحصاءات
للحصول على ملف إعداد صامت كامل، راجِع مقالة إعداد والمؤسسة.
يبلغ الحد الأقصى لطول اسم المؤسسة واسم البيئة تلقائيًا 20 حرفًا عند استخدام apigee-provision الأخرى. لا ينطبق هذا الحد إذا كنت تستخدم Edge API مباشرةً لإنشاء المؤسسة أو محددة.
إنشاء مؤسسة
استخدِم الأمر create-org لإنشاء مؤسسة:
> /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-provision create-org -f configFile
ينشئ هذا النص البرمجي المؤسسة، ولكنه لا يضيف أو يضبط البيئات والخوادم الافتراضية المطلوبة من المؤسسة لمعالجة طلبات البيانات من واجهة برمجة التطبيقات.
يحتوي ملف الإعداد على اسم المؤسسة وعنوان البريد الإلكتروني لمشرف المؤسسة. يقتصر استخدام الأحرف في سمة الاسم على: a-z0-9\-$%. لا تستخدِم مسافات أو نقاطًا أو أحرفًا لاتينية كبيرة في الاسم:
APIGEE_ADMINPW=adminPword # If omitted, you are prompted for it. ORG_NAME=example # lowercase only, no spaces, underscores, or periods. ORG_ADMIN=orgAdmin@myCo.com
الأمر بعد ذلك:
- ينشئ المؤسسة
- ربط المؤسسة بمجموعة وحدات، ويكون الربط تلقائيًا بمجموعة وحدات "البوابة"
- تُضيف المستخدم المحدّد كمشرف المؤسسة. يجب أن يكون المستخدم موجودًا من قبل. وإلا فإن النص إلى حدوث خطأ.
<Error>
<Code>organizations.OrganizationAlreadyExists</Code>
<Message>Organization : test already exists</Message>
<Contexts/>
</Error>
إنشاء مؤسسة باستخدام طلبات البيانات من واجهة برمجة التطبيقات
بدلاً من ذلك، يمكنك استخدام طلبات البيانات من واجهة برمجة التطبيقات التالية لإنشاء مؤسسة. تنشئ المكالمة الأولى المؤسسة:
curl -H "Content-Type:application/xml" -u <sysAdminEmail>:<adminPasswd> \ -X POST http://<ms-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://<ms-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 من أجل: لإنشاء بيئة في مؤسسة موجودة:
> /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-provision add-env -f configFile
يحتوي ملف الإعدادات هذا على المعلومات اللازمة لإنشاء البيئة والملف الشخصي للخادم الافتراضي:
APIGEE_ADMINPW=adminPword # If omitted, you are prompted for it. ORG_NAME=example # lowercase only, no spaces, underscores, or periods. ENV_NAME=prod 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. # AXGROUP=axgroup-001 # Default value is axgroup-001
الأمر:
- إنشاء البيئة
- تنشئ مضيفًا افتراضيًا واحدًا للبيئة
- ربط البيئة بجميع معالجات الرسائل في المجموعة المرتبطة بالمؤسسة التي تحتوي على البيئة
- تفعيل الإحصاءات
ملاحظة: في حال تفعيل الإحصاءات لبيئة واحدة في مؤسسة، يجب: لتمكين التحليلات لجميع البيئات في المؤسسة.
إنشاء بيئة باستخدام طلبات بيانات واجهة برمجة التطبيقات
بدلاً من ذلك، يمكنك استخدام طلبات بيانات واجهة برمجة التطبيقات التالية لإنشاء بيئة. تنشئ المكالمة الأولى البيئة:
curl -H "Content-Type:application/xml" -u <sysAdminEmail>:<adminPasswd> \ -X POST http://<ms-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://<ms-ip>:8080/v1/organizations/<org-name>/environments/<env-name>/servers \ -d "action=add&uuid=<uuid>"
حيث يكون "<uuid>" هو معرّف UUID لمعالج الرسائل. يمكنك الحصول على معرّف UUID باستخدام الأمر التالي:
> curl http://<mp-ip>:8082/v1/servers/self
حيث "<mp-ip>" هل عنوان IP لمعالج الرسائل.
تفعِّل طلب البيانات التالي من واجهة برمجة التطبيقات "إحصاءات Google" لبيئة معيّنة. يتحقق من توفّر خوادم Qpid وPostgres في وحدات POD في جميع مراكز البيانات. بعد ذلك، تبدأ عملية إعداد "إحصاءات Google" للمؤسسة والبيئة المحدّدتين.
> /<inst_root>/apigee/apigee-service/bin/apigee-service apigee-provision enable-ax -f configFile
يحتوي ملف الإعداد هذا على:
ORG_NAME=orgName # lowercase only, no spaces, underscores, or periods. ENV_NAME=envName
curl -H "Content-Type:application/json" -u <sysAdminEmail>:<adminPasswd> -X POST http://<ms-ip>:8080/v1/organizations/<org-name>/environments/<env-name>/analytics/admin -d "@sample.json"
حيث يحتوي ملف 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 على قائمة مفصولة بفواصل بالمعرّفات الفريدة العامة لـ Postgres، وتحتوي السمة qpid-server على المعرّفات الفريدة العامة لـ Qpid. إذا كنت بحاجة إلى الحصول على معرّفات UUID هذه، استخدِم الأوامر التالية.
بالنسبة إلى Qpid، نفِّذ الأمر التالي:
curl -u <sysAdminEmail>:<passwd> http://<ms-ip>/v1/servers?pod=central
ناتج هذا الأمر هو كائن JSON. لكل خادم Qpid، سترى ناتجًا في النموذج:
"type" : [ "qpid-server" ], "uUID" : "d3c5acf0-f88a-478e-948d-6f3094f12e3b"
بالنسبة إلى Postgres، شغّل الأمر:
curl -u <sysAdminEmail>:<passwd> http://<ms-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://<ms-ip>:8080/v1/organizations/<org-name>/environments/<env-name>/virtualhosts \
-d '<VirtualHost name="default"> \
<HostAliases> \
<HostAlias>myorg-test.apigee.net</HostAlias> \
</HostAliases> \
<Interfaces/> \
<Port>9443</Port> \
</VirtualHost>'
للحصول على وصف كامل لإنشاء مضيف افتراضي، بما في ذلك إنشاء مضيف افتراضي آمن يستخدم TLS/SSL عبر HTTPS، راجع http://apigee.com/docs/api-services/content/creating-virtual-host.