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

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

استخدام جهاز موازنة الحمل

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

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

جارٍ الاتصال بـ Cassandra

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

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

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

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

أمان Tomcat

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

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

• https://tomcat.apache.org/tomcat-7.0-doc/manager-howto.html
• https://www.owasp.org/index.php/Securing_tomcat

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

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

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

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

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

على سبيل المثال، استخدِم الأمر التالي لتثبيت حزمة API BaaS:

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

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

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

يظهر أدناه مثال على ملف إعداد صامت لتثبيت واجهة برمجة تطبيقات BaaS من 10 عُقد. عدِّل هذا الملف حسب الضرورة لضبط الإعدادات. استخدِم الخيار ‎-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

يتضمّن الجدول التالي معلومات إضافية عن هذه السمات:

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

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

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

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

تُكمل عملية الضبط إعداد مخزن البيانات على العقدة بنجاح.

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

إعداد مهمة cron في Cassandra

إعداد مهمة 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 apigee-setup على العقدة باستخدام إجراء الإنترنت أو إجراء غير الإنترنت. لمزيد من المعلومات، يُرجى الاطّلاع على تثبيت أداة apigee-setup في Edge.
2. في موجّه الأوامر، شغِّل نص التهيئة البرمجي:
   > /opt/apigee/apigee-setup/bin/setup.sh -p e -f configFile
   
   يحدّد الخيار "-p e" تثبيت ElasticSearch.
   يجب أن يكون ملف الإعداد متاحًا أو قابلاً للقراءة من قِبل مستخدم "apigee". على سبيل المثال، يمكنك وضع الملف في الدليل ‎ /tmp على العقدة.
3. (اختياري) في حال تثبيت ElasticSearch على عقدة مستقلة، أي أنّه لم يتم تثبيته مع حزمة API BaaS، اضبط خيار الذاكرة التلقائي لزيادة الذاكرة المخصّصة لـ 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 restart

تُكمل عملية الضبط عملية الإعداد على العقدة بنجاح.

تثبيت حزمة API BaaS: الأجهزة 4 و5 و6

لتثبيت حزمة API BaaS:

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

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

تثبيت بوابة API BaaS: الجهاز 7

لتثبيت بوابة API BaaS:

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

يبدأ المثبِّت خادم الويب Nginx ثم ينهي إعداد بوابة API BaaS.

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

إعداد عُقد API BaaS لموازنة حمل Stack أو Portal

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

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

إذا كنت تستخدم جهاز موازنة الحمل أمام عُقد 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/portal.properties إذا كنت تستخدم جهاز موازنة الحمل أمام عُقد Stack:

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 configure
2. انشر التغييرات على Tomcat:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid deploy
3. أعِد تشغيل حزمة BaaS:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid restart
4. إذا عدّلت portal.properties، اضبط عقدة البوابة:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-portal configure
5. انشر التغييرات:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-portal deploy
6. أعِد تشغيل بوابة BaaS:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service baas-portal restart

إعداد مؤسسة إخبارية جديدة

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

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

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

لإجراء عملية الإعداد، استخدِم نص 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. سجِّل الدخول إلى بوابة API BaaS في متصفّح ويب باستخدام عنوان URL الذي سجّلته في نهاية تثبيت عنوان URL لبوابة API BaaS. للوصول إلى البوابة، أدخِل عنوان URL لبوابة BaaS لواجهة برمجة التطبيقات بالصيغة:
   http://{portalExternalIP}:9000/
   
   ملاحظة: عنوان IP هو عنوان IP الخارجي أو اسم المضيف لجهاز البوابة. تأكَّد من أنّ المنفذ مفتوح.
4. عندما تظهر شاشة تسجيل الدخول إلى البوابة، يمكنك تنفيذ أحد الإجراءَين التاليَين:
   • سجِّل الدخول باستخدام اسم المستخدم وكلمة المرور الخاصَّين بمشرف المؤسسة.
   • سجِّل الدخول باستخدام اسم المستخدم وكلمة المرور الخاصَين بمشرف النظام.

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

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

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

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

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

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