تثبيت BaaS لواجهة برمجة التطبيقات يتألف من 7 مضيفين و10 مضيفين

Edge for Private Cloud - الإصدار 4.16.05

استخدام موازن حمولة البيانات

في عملية تثبيت إنتاج BaaS لواجهة برمجة التطبيقات، يتم استخدام أداة موازنة الحمل بين عقدة بوابة BaaS الخاصة بواجهة برمجة التطبيقات وعُقد BaaS Stack لواجهة برمجة التطبيقات. عند إعداد "البوابة"، عليك تحديد عنوان IP أو اسم نظام أسماء النطاقات لجهاز موازنة الحمل، وليس في عُقد المكدس.

كبديل لموازن التحميل، يمكنك استخدام نظام أسماء النطاقات round-robin. في هذا السيناريو، يمكنك إنشاء إدخال لنظام أسماء النطاقات يتضمّن سجلّات A متعددة تتوافق مع عناوين IP لحزمة BaaS. أثناء بحث نظام أسماء النطاقات، يعرض خادم نظام أسماء النطاقات تلقائيًا قيم سجل A بترتيب دائري.

جارٍ الاتصال بـ "كاساندرا"

عند تثبيت BaaS، يمكنك اختيار ربط BaaS وEdge بمجموعة Cassandra نفسها أو إنشاء مجموعة Cassandra منفصلة لنظام BaaS. غالبًا ما تشارك عمليات تثبيت BaaS الأصغر حجمًا، أي تلك التي لديها كثافة مرورية أقل، مجموعة Cassandra مع Edge.

بالنسبة إلى المعالجة العالية للبيانات ومدى التوفّر، أو لفصل مجموعات Cassandra في مناطق شبكة مختلفة، تنصح Apigee باستخدام مجموعات Cassandra منفصلة. تؤدي المجموعات المنفصلة إلى تحسين الأداء إلى أقصى حد إذا كنت تواجه عبئًا كبيرًا على حركة الزيارات على نظام BaaS.

مزامنة التاريخ

يجب أن يكون لديك التاريخ/الوقت على جميع الخوادم. يمكن أن تخدم الأداة "ntpdate" هذا الغرض إذا لم يتم إعدادها من قبل، والتي تتحقق مما إذا كانت الخوادم متزامنة للوقت. يمكنك استخدام "yum install ntp" لتثبيت الأداة.

أمان Tomcat

إنّ أداة تثبيت BaaS الخاصة بواجهة برمجة التطبيقات تثبِّت أيضًا خادم Apache Tomcat على جميع عُقد BaaS Stack لواجهة برمجة التطبيقات، بما في ذلك واجهة مستخدم مشرف Tomcat. تترك أداة التثبيت بيانات اعتماد المشرف التلقائية بدون تغيير من admin:admin.

يمكنك إذا لزم الأمر تغيير بيانات الاعتماد هذه كجزء من تأمين Tomcat. لمزيد من المعلومات، يُرجى الاطّلاع على:

نظرة عامة على التثبيت

بعد تثبيت الأداة المساعدة apigee-setup على عقدة، استخدِم هذه الأداة لتثبيت واحد أو أكثر من مكوّنات BaaS على العقدة. تكون الأداة المساعدة apigee-setup على النحو التالي:

> sudo /opt/apigee/apigee-setup/bin/setup.sh -p component -f configFile

مرِّر ملف الإعداد إلى الأداة المساعدة apigee-setup التي تحتوي على المعلومات حول عملية التثبيت. إذا كان ملف الإعداد ينقصه أي معلومات مطلوبة، تطلب منك أداة apigee-setup إدخاله في سطر الأوامر.

الشرط الوحيد هو أن يتمكن مستخدم "apigee" من الوصول إلى ملف الإعداد أو قراءته. على سبيل المثال، ضع الملف في الدليل /tmp على العقدة.

على سبيل المثال، يمكنك استخدام الأمر التالي لتثبيت BaaS Stack لواجهة برمجة التطبيقات:

> sudo /opt/apigee/apigee-setup/bin/setup.sh -p b -f myConfig

تتيح أداة Apigee setup.sh عدة خيارات لتثبيت مكوّنات BaaS لواجهة برمجة التطبيقات. تستخدم التعليمات أدناه الخيارات المستقلة (c وe وb وp) ولكن يمكنك استخدام خيارات مختلفة استنادًا إلى إعداد العقدة:

الخيار

الوصف

e

تثبيت ElasticSearch فقط.

b

ثبِّت واجهة برمجة التطبيقات BaaS Stack فقط، والتي تؤدي أيضًا إلى تثبيت Tomcat.

p

يجب تثبيت "بوابة BaaS" لواجهة برمجة التطبيقات فقط، التي تثبِّت أيضًا جهاز التوجيه Nginx لاستخدامه كخادم ويب.

c

يجب تثبيت تطبيق Cassandra فقط.

eb

ثبّت ElasticSearch وواجهة برمجة التطبيقات BaaS Stack وTomcat على العقدة.

eBp

تثبيت ElasticSearch وبوابة BaaS وواجهة برمجة التطبيقات وحزمة BaaS Stack وTomcat. ولا تحتاج المنصة إلى استخدام أي موارد إضافية لإجراء ذلك.

آسا

تثبيت جميع مكونات واجهة برمجة التطبيقات في عقدة واحدة (Cassandra وElasticsearch وAPI BaaS Stack وبوابة BaaS لواجهة برمجة التطبيقات). يمكنك استخدام هذا الخيار للتطوير والاختبار فقط، وليس للإنتاج.

جارٍ إنشاء ملف إعداد صامت

في ما يلي مثال على ملف إعداد صامت لتثبيت BaaS لواجهة برمجة التطبيقات ذات العُقد العشرة. عدِّل هذا الملف حسب الضرورة في عملية الضبط. استخدِم الخيار -f من أجل setup.sh لتضمين هذا الملف.

# Specify IP address or DNS name of node.
IP1=192.168.1.1   # ElasticSearch
IP2=192.168.1.2   # ElasticSearch
IP3=192.168.1.3   # ElasticSearch
IP4=192.168.1.4   # API BaaS Stack
IP5=192.168.1.5   # API BaaS Stack
IP6=192.168.1.6   # API BaaS Stack
IP7=192.168.1.7   # API BaaS Portal
IP8=192.168.1.8   # Cassandra (shared with Edge or standalone)
IP9=192.168.1.9   # Cassandra (shared with Edge or standalone)
IP10=192.168.1.10  # Cassandra (shared with Edge or standalone)

# Must resolve to IP address or DNS name of host - not to 127.0.0.1 or localhost.
HOSTIP=$(hostname -i)

# Define the API BaaS administrator account.  
AS_ADMIN="superuser"    # User name - default is "superuser".
AS_ADMIN_EMAIL=stackAdmin@email.com
AS_PASSWD=stackAdminPWrod

# Only if you are installing Cassandra.
# Specify Cassandra configuration information.
# Must use IP addresses for CASS_HOSTS, not DNS names.
# CASS_HOSTS="$IP8:1,1 $IP9:1,1 $IP10:1,1"

# If connecting to existing Cassandra nodes, 
# specify Cassandra IPs.
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP8 $IP9 $IP10"

# Cassandra uname/pword.
# Even if Cassandra authentication is disabled,
# you must still pass values for these properties.
CASS_USERNAME=cassandra    # Default value
CASS_PASSWORD=cassandra    # Default value

# Specify BaaS Cassandra connection information.
# Specify the data center name.
BAAS_CASS_LOCALDC=dc-1    # Default is dc-1.

# Replication is in the form "dataCenterName:#CassandraNodes". 
# For example, for dc-1 with three Cassandra nodes, it is dc-1:3.
BAAS_CASS_REPLICATION=dc-1:3

# ElasticSearch IPs or DNS names, separated by spaces.
ES_HOSTS="$IP1 $IP2 $IP3"

# API BaaS Stack information.
# Default cluster name is "apigee_baas"
BAAS_USERGRID_CLUSTERNAME="apigee_baas" 

# URL and port of the load balancer for the API BaaS Stack nodes, 
# or IP/DNS and port 8080 of a single Stack node with no load balancer.
BAAS_USERGRID_URL=http://myloadbalancer:8443

# API BaaS Portal information.
# URL and port number of load balancer, if there is one in front of the Portal,
# or the URL and port of the Portal node.  
BAAS_PORTAL_URL="http://$IP7:9000"

# Portal port. Default value is 9000.
BAAS_PORTAL_LISTEN_PORT=9000 

# SMTP information. BaaS requires an SMTP server.
SMTPHOST=smtp.gmail.com
SMTPPORT=465
SMTPUSER=your@email.com
SMTPPASSWORD=yourEmailPassword
SMTPSSL=y

يحتوي الجدول التالي على معلومات إضافية حول هذه الخصائص:

الموقع الإلكتروني

ملاحظة

CASS_HOSTS

إذا كنت تريد تثبيت Cassandra، حدِّد عناوين IP لعقدة Cassandra (وليس أسماء نظام أسماء النطاقات) وضمِّن معدِّل ":dc,ra" الذي يحدّد مركز البيانات ورف عقدة Cassandra.

على سبيل المثال، "192.168.124.201:1,1 = مركز البيانات 1 والرف/منطقة التوفّر 1، و"192.168.124.204:2,1 = مركز البيانات 2 ومنطقة الرفّ/منطقة التوفُّر 1.

CASS_اسم المستخدم
CASS_password

اسم مستخدم Cassandra وكلمة المرور

إذا تم تعطيل مصادقة Cassandra، فلا يزال يتعين عليك تمرير هذه القيم. ومع ذلك، يتم تجاهل القيم.

BAAS_CASS_LOCALDC

يجب أن تكون أسماء المناطق بالصيغة dc-# حيث يتجاوب # مع قيمة عدد صحيح.

على سبيل المثال، dc-1 وdc-2 وما إلى ذلك. إذا كنت تتصل بمجموعة Cassandra تم تثبيتها من خلال Edge، فيمكنك طلب هذه القيمة من مشرف نظام Edge. في عملية تثبيت مركز بيانات واحد لبرنامج Edge، تكون القيمة التلقائية هي dc-1.

في حال تثبيت Cassandra كجزء من تثبيت واجهة برمجة التطبيقات BaaS، عليك إضافة مفتاح التعديل " :dc,ra" إلى عناوين IP لـ Cassandra. القيمة الأولى "dc" هي رقم مركز البيانات. اسم مركز البيانات هو السلسلة "-dc" مع رقم مركز البيانات كلاحقة.

BAAS_CASS_REPLICATION

يكون التنسيق على النحو التالي: "dataCenterName:#CassandraNodes". فعلى سبيل المثال، بالنسبة لـ dc-1 التي تحتوي على ثلاث عُقد Cassandra، فهي dc-1:3.

BAAS_USERGRID_URL

في بيئة الإنتاج، هذا هو عنوان URL ومنفذ جهاز موازنة التحميل الذي يقع أمام عُقد BaaS Stack لواجهة برمجة التطبيقات، على النحو التالي:

http://myStackLoadBalancer:8443

في بيئة الاختبار أو التطوير، حيث يكون لديك عقدة BaaS Stack واحدة فقط لواجهة برمجة التطبيقات، يمكن أن يكون ذلك في شكل عنوان URL ورقم المنفذ لعقدة BaaS Stack لواجهة برمجة التطبيقات، على النحو التالي:

http://stackIPorDNS:8080

رقم المنفذ لخادم حزمة BaaS لواجهة برمجة التطبيقات هو 8080.

BAAS_PORTAL_URL

عنوان URL ورقم المنفذ لجهاز موازنة الحمل، إذا كان هناك رقم أمام البوابة، على النحو التالي:

http://myPortalLoadBalancer:8443

في حال عدم توفّر جهاز لموازنة التحميل، سيظهر عنوان URL ورقم المنفذ لعقدة البوابة على النحو التالي:

http://مدخلIPorDNS:port9000
رقم واجهة برمجة التطبيقات التلقائي هو
.

BAAS_PORTAL_LISTEN_PORT

رقم المنفذ لخادم بوابة BaaS الخاصة بواجهة برمجة التطبيقات هو 9000. إذا لم يكن هذا المنفذ متاحًا، حدِّد منفذًا مختلفًا.

في حال ضبط BAAS_PORTAL_URL على عنوان URL لعقدة "البوابة"، يجب أن تكون أرقام المنفذ هي نفسها في كلا الموقعَين.

اختياري - تثبيت Cassandra: الجهاز 8 و9 و10

ومع أنّه يمكنك ربط BaaS لواجهة برمجة التطبيقات بمجموعة Cassandra نفسها التي يستخدمها Edge، تنصح Apigee باستخدام مجموعات منفصلة.

يمكن لمجموعة Cassandra استخدام المصادقة أو يمكن إيقاف مصادقة Cassandra. يمكنك الاطّلاع على تفعيل مصادقة Cassandra لمعرفة المزيد من المعلومات.

  1. ثبِّت أداة Edge apigee-setup على العقدة باستخدام أي إجراء متصل بالإنترنت أو غير متصل بالإنترنت. راجِع تثبيت أداة إعداد واجهة برمجة التطبيقات Edge لمعرفة المزيد.
  2. في موجّه الأوامر، شغِّل النص البرمجي للإعداد:
    > /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile

    يحدد الخيار " -p c" لتثبيت Cassandra.
    يجب أن يتمكّن مستخدم "واجهة برمجة التطبيقات" من الوصول إلى ملف الإعداد أو قراءته. على سبيل المثال، ضَع الملف في دليل /tmp على العقدة.

تكمل التهيئة إعداد مخزن البيانات في العقدة بنجاح.

لاحظ أن JMX تكون مفعّلة تلقائيًا لـ Cassandra. لا يتطلب وصول JMX عن بُعد إلى Cassandra كلمة مرور. يمكنك تهيئة Cassandra لاستخدام المصادقة لـ JMX. لمزيد من المعلومات، يُرجى الاطّلاع على كيفية المراقبة.

إعداد مهمة Cassandra cron

يمكنك إعداد مهمة cron تستخدم nodetool لضبط إعدادات الأقفال لتشغيلها كل ساعة في كل عقدة Cassandra.

إذا كانت لديك عُقد Cassandra متعددة، يجب تعويض مهمة cron على كل خادم بمقدار خمس دقائق حتى لا يتم مسح جميع العُقد في الوقت نفسه.

يجب أن تنفذ مهمة cron الأمر التالي:

/opt/apigee/apigee-cassandra/bin/nodetool -h IP_address flush Apigee_Baas_Locks

حيث IP_address هو عنوان IP لعقدة Cassandra.

تثبيت ElasticSearch: الجهاز 1 و2 و3

لتثبيت ElasticSearch:

  1. ثبِّت أداة إعداد واجهة برمجة تطبيقات Edge على العقدة باستخدام إجراء الإنترنت أو إجراء غير متصل بالإنترنت. راجِع تثبيت الأداة المساعدة لإعداد واجهة Edge في Edge لمزيد من المعلومات.
  2. في موجّه الأوامر، شغِّل النص البرمجي للإعداد:
    > /opt/apigee/apigee-setup/bin/setup.sh -p e -f configFile

    يحدد الخيار " -p e" لتثبيت ElasticSearch.
    يجب أن يتمكّن مستخدم "واجهة برمجة التطبيقات" من الوصول إلى ملف الإعداد أو قراءته. على سبيل المثال، ضَع الملف في دليل /tmp على العقدة.
  3. (اختياري) في حال تثبيت ElasticSearch على عقدة مستقلة، أي أنّه غير مثبّت باستخدام حزمة BaaS Stack لواجهة برمجة التطبيقات، اضبط خيار الذاكرة التلقائي لزيادة الذاكرة المخصّصة لـ ElasticSearch من 4 غيغابايت إلى 6 غيغابايت:
    1. افتح /opt/apigee/customer/application/elasticsearch.properties في محرِّر. إذا لم يكن هذا الملف موجودًا، فأنشئه.
    2. اضبط سمة setenv_elasticsearch_max_mem_size على 6 غرام (السمة التلقائية هي 4 غرام):
      setenv_elasticsearch_max_mem_size=6g
    3. احفظ الملف.
    4. نفِّذ الأمر التالي:
      > /opt/apigee/apigee-service/bin/apigee-service apigee-elasticsearch إعادة تشغيل

تكمل التهيئة الإعداد على العقدة بنجاح.

تثبيت حزمة BaaS Stack لواجهة برمجة التطبيقات: الأجهزة 4 و5 و6

لتثبيت حزمة BaaS Stack لواجهة برمجة التطبيقات:

  1. ثبِّت أداة إعداد واجهة برمجة تطبيقات Edge على العقدة باستخدام إجراء الإنترنت أو إجراء غير متصل بالإنترنت. راجِع تثبيت الأداة المساعدة لإعداد واجهة Edge في Edge لمزيد من المعلومات.
  2. في موجّه الأوامر، شغِّل النص البرمجي للإعداد:
    > /opt/apigee/apigee-setup/bin/setup.sh -p b -f configFile

    يحدد الخيار " -p b" لتثبيت واجهة برمجة التطبيقات BaaS Stack.
    يجب أن يتمكّن مستخدم "واجهة برمجة التطبيقات" من الوصول إلى ملف الإعداد أو قراءته. على سبيل المثال، ضَع الملف في دليل /tmp على العقدة.

بعد أن تجلب أداة التثبيت بيانات اعتماد المشرف الصحيحة، تعمل على تثبيت Tomcat وإنشاء مساحات مفاتيح BaaS لواجهة برمجة التطبيقات وإعداد حزمة BaaS Stack لواجهة برمجة التطبيقات على الخادم. تم ضبط SMTP أيضًا للسماح لواجهة المستخدم بإرسال رسائل إلكترونية لتأكيد كلمة المرور.

تثبيت بوابة BaaS لواجهة برمجة التطبيقات: الجهاز 7

لتثبيت بوابة BaaS الخاصة بواجهة برمجة التطبيقات:

  1. ثبِّت أداة إعداد واجهة برمجة تطبيقات Edge على العقدة باستخدام إجراء الإنترنت أو إجراء غير متصل بالإنترنت. راجِع تثبيت الأداة المساعدة لإعداد واجهة Edge في Edge لمزيد من المعلومات.
  2. في موجّه الأوامر، شغِّل النص البرمجي للإعداد:
    > /opt/apigee/setup/bin/setup.sh -p p -f configFile

    يحدد الخيار "-p p" لتثبيت بوابة BaaS الخاصة بواجهة برمجة التطبيقات.
    يجب أن يتمكّن مستخدم "واجهة برمجة التطبيقات" من الوصول إلى ملف الإعداد أو قراءته. على سبيل المثال، ضَع الملف في دليل /tmp على العقدة.

تبدأ أداة التثبيت تشغيل خادم الويب Nginx ثم تُنهي إعدادات بوابة BaaS الخاصة بواجهة برمجة التطبيقات.

دوِّن عنوان URL لبوابة BaaS الخاصة بواجهة برمجة التطبيقات. هذا هو عنوان URL الذي تُدخله في متصفّح للوصول إلى واجهة مستخدم بوابة BaaS الخاصة بواجهة برمجة التطبيقات.

ضبط عُقد BaaS لواجهة برمجة التطبيقات لموازن حمولة Stack أو البوابة

في حال تضمين جهاز لموازنة التحميل أمام عُقد المكدس أو البوابة، عليك إعداد العُقد باستخدام عنوان URL الصحيح لجهاز موازنة التحميل. على سبيل المثال، تتطلب عُقد حزمة Stack هذه المعلومات في الحالات التالية:

  • تضمين عنوان URL في الردود في طلبات واجهة برمجة التطبيقات BaaS API
  • إضافة روابط في نماذج الرسائل الإلكترونية عند إعادة ضبط كلمة مرور أو إرسال إشعارات أخرى
  • إعادة توجيه المستخدمين إلى صفحات بوابة محددة.

إذا كنت تستخدم موازن تحميل أمام عُقد حزمة Stack، اضبط السمات التالية في /opt/apigee/customer/application/usergrid.properties: 

usergrid-deployment_swagger.basepath=http://localhost:8080
usergrid-deployment_usergrid.organization.activation.url=http://localhost:8080/management/organizations/%s/activate
usergrid-deployment_usergrid.admin.activation.url=http://localhost:8080/management/users/%s/activate
usergrid-deployment_usergrid.admin.resetpw.url=http://localhost:8080/management/users/%s/resetpw
usergrid-deployment_usergrid.admin.confirmation.url=http://localhost:8080/management/users/%s/confirm
usergrid-deployment_usergrid.user.activation.url=http://localhost:8080/%s/%s/users/%s/activate
usergrid-deployment_usergrid.user.confirmation.url=http://localhost:8080/%s/%s/users/%s/confirm
usergrid-deployment_usergrid.user.resetpw.url=http://localhost:8080/%s/%s/users/%s/resetpw

استبدِل http://localhost:8080 بعنوان URL لجهاز موازنة الحمل. في حال ضبط جهاز موازنة الحمل لاستخدام بروتوكول أمان طبقة النقل (TLS)، استخدِم بروتوكول HTTPS. ويجب تضمين المنفذ فقط إذا كنت تستخدم منفذًا غير عادي، ما يعني أنه ليس المنفذ 80 لبروتوكول HTTP والمنفذ 443 لبروتوكول HTTPS.

عليك أيضًا ضبط السمة التالية في /opt/apigee/customer/application/دخل.properties إذا كنت تستخدم موازن حمولة أمام عُقد تكديس:

baas.portal.config.overrideUrl=http://localhost:8080

استبدِل http://localhost:8080 بعنوان URL لموازن حمولة البيانات في حزمة Stack.

في حال استخدام موازن تحميل أمام عقدة "البوابة"، اضبط السمات التالية في usergrid.properties: 

usergrid-deployment_usergrid.view.management.organizations.organization.activate=http://localhost:9000
usergrid-deployment_usergrid.view.management.organizations.organization.confirm=http://localhost:9000
usergrid-deployment_usergrid.view.management.users.user.activate=http://localhost:9000
usergrid-deployment_usergrid.view.management.users.user.confirm=http://localhost:9000

استبدِل http://localhost:9000 بعنوان URL لجهاز موازنة الحمل. في حال ضبط جهاز موازنة الحمل لاستخدام بروتوكول أمان طبقة النقل (TLS)، استخدِم بروتوكول HTTPS. ويجب تضمين المنفذ فقط إذا كنت تستخدم منفذًا غير عادي، ما يعني أنه ليس المنفذ 80 لبروتوكول HTTP والمنفذ 443 لبروتوكول HTTPS.

بعد تعديل usergrid.properties و portal.properties:

  1. اضبُط عقدة Stack:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid Configuration
  2. انشر التغييرات على Tomcat:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid publish
  3. أعِد تشغيل حزمة BaaS Stack:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid إعادة تشغيل
  4. إذا عدّلت portal.properties، اضبط عقدة البوابة:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-pos Configuration
  5. انشر التغييرات:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-مدخل نشر
  6. أعِد تشغيل بوابة BaaS:
    > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-مدخل إعادة تشغيل

إعداد مؤسسة جديدة

عملية الإعداد هي عملية إنشاء مشرف في مؤسسة ومؤسسة. بعد إنشاء مشرف المؤسسة والمؤسسة، يمكنك تسجيل الدخول إلى واجهة مستخدم بوابة BaaS الخاصة بواجهة برمجة التطبيقات وإرسال طلبات إلى واجهة برمجة التطبيقات BaaS REST API.

عند إنشاء مؤسسة، يكون عنوان البريد الإلكتروني لمشرف المؤسسة:

  • يجب أن يكون مختلفًا عن عنوان البريد الإلكتروني لمشرف النظام.
  • يجب أن يكون فريدًا بين جميع المؤسسات الأخرى. ويعني ذلك أنّه لا يمكنك إنشاء مؤسستَين بعنوان البريد الإلكتروني نفسه لمشرف المؤسسة. ومع ذلك، بعد إنشاء المؤسسة، يمكنك إضافة مشرفين إضافيين يمكن تكرارهما في مؤسسات متعددة.

لإجراء الإعداد، استخدم نص Python البرمجي create_org_and_user.py. يؤدي استدعاء هذا النص البرمجي بدون وسيطات سطر الأوامر إلى مطالبتك بجميع المعلومات:

> python create_org_and_user.py

بدلاً من ذلك، يمكنك تمرير أي من الخيارات أو جميعها كوسيطة سطر أوامر. سيُطلب منك أي معلومات تحذفها من سطر الأوامر:

> python create_org_and_user.py -o '<org name>'
> python create_org_and_user.py -o '<org name>' -a '<new admin email>' -p '<new admin password>'

لإنشاء مؤسسة:

  1. غيِّر الدليل إلى /opt/apigee/baas-usergrid/bin.
  2. استدعِ النص البرمجي create_org_and_user.py في Python.
    سيُطلب منك إدخال اسم المستخدم وكلمة المرور الخاص بمشرف نظام BaaS لكي لا يتمكّن أحد من تشغيله سوى مشرف النظام.
  3. سجِّل الدخول إلى "بوابة BaaS الخاصة بواجهة برمجة التطبيقات" في متصفّح ويب باستخدام عنوان URL الذي ذكرته في نهاية تثبيت عنوان URL لبوابة BaaS الخاصة بواجهة برمجة التطبيقات. للوصول إلى البوابة، أدخِل عنوان URL لبوابة BaaS الخاصة بواجهة برمجة التطبيقات على النحو التالي:
    http://{portalExternalIP}:9000/

    ملاحظة: عنوان IP هو اسم المضيف أو عنوان IP الخارجي لجهاز البوابة. تأكَّد من أنّ المنفذ مفتوح.
  4. عندما تظهر شاشة تسجيل الدخول إلى البوابة، يمكنك إجراء أي مما يلي:
    • سجِّل الدخول باستخدام اسم المستخدم وكلمة المرور لمشرف المؤسسة.
    • سجِّل الدخول باستخدام اسم المستخدم وكلمة المرور لمشرف النظام.

الوصول إلى واجهة برمجة التطبيقات BaaS REST API

للوصول إلى واجهة برمجة التطبيقات BaaS REST API، استخدِم عنوان URL بالتنسيق التالي:

https://{loadBalancerIP}:8080/{your-org}/{your-app}

في بيئة التطوير، يمكنك تثبيت جميع مكوّنات BaaS لواجهة برمجة التطبيقات على عقدة واحدة، ما يعني أنّ لديك حزمة BaaS Stack في واجهة برمجة التطبيقات. أو قد تكون لديك بيئة صغيرة بها عقدة BaaS Stack واحدة لواجهة برمجة التطبيقات وبدون جهاز موازنة التحميل. في هذه الأنواع من البيئات، يمكنك إجراء طلبات بيانات من واجهة برمجة التطبيقات مباشرةً إلى عقدة BaaS Stack لواجهة برمجة التطبيقات:

curl -v "http://portalExternalIP:8080/status"

لمزيد من المعلومات حول بدء استخدام بوابة BaaS الخاصة بواجهة برمجة التطبيقات، يمكنك الاطّلاع على مستندات Apigee على الرابط: http://apigee.com/docs/content/build-apps-home.