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

Edge for Private Cloud، الإصدار 4.16.09

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

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

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

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

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

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

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

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

أمان Tomcat

تعمل أداة تثبيت واجهة برمجة التطبيقات BaaS أيضًا على تثبيت خادم Apache Tomcat على جميع عُقد واجهة برمجة التطبيقات BaaS Stack، بما في ذلك واجهة مستخدم مشرف 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" المستخدم.

على سبيل المثال، استخدِم الأمر التالي لتثبيت حزمة BaaS الخاصة بواجهة برمجة التطبيقات:

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

أداة Apigee setup.sh يتيح العديد من الخيارات لتثبيت مكونات واجهة برمجة التطبيقات 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 على العقدة باستخدام إجراءً عبر الإنترنت أو غير متصل بالإنترنت. راجع تثبيت أداة Edge apigee-setup للحصول على أخرى.
2. في موجِّه الأوامر، شغِّل النص البرمجي للإعداد:
   > /opt/apigee/apigee-setup/bin/setup.sh -p c -f configFile
   
   يحدد الخيار "-p c" تثبيت كاساندرا.
   يجب أن يكون ملف الإعداد قابلاً للوصول أو القراءة بواسطة "apigee" المستخدم.

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

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

إعداد مهمة Cassandra cron

إعداد مهمة cron تستخدم nodetool للمسح لإيقاف الأقفال كل ساعة في كل عقدة كاساندرا.

وإذا كان لديك عُقد 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 apigee-setup للمزيد.
2. في موجِّه الأوامر، شغِّل النص البرمجي للإعداد:
   > /opt/apigee/apigee-setup/bin/setup.sh -p e -f configFile
   
   يحدد الخيار "-p e" كيفية تثبيت ElasticSearch.
   يجب أن يكون ملف الإعداد قابلاً للوصول أو القراءة بواسطة "apigee" المستخدم.
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 من واجهة برمجة التطبيقات: الجهاز 4 و5 و6

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

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

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

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

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

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

تبدأ أداة التثبيت خادم ويب Nginx، ثم تُنهي بوابة BaaS الخاصة بواجهة برمجة التطبيقات. التكوين.

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

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

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

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

في حال استخدام جهاز موازنة الحمل أمام عُقد التجميع، يجب ضبط السمات التالية في /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 إذا تستخدم جهاز موازنة الحمل أمام عُقد الحزمة:

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

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

في حال استخدام جهاز موازنة الحمل أمام عقدة "بوابة"، يجب ضبط المواقع التالية في 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. إعداد عقدة التكديس:
   &gt; /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid setup
2. نشر التغييرات على Tomcat:
   &gt; /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergridpublish
3. أعِد تشغيل حزمة BaaS:
   &gt; /<inst_root>/apigee/apigee-service/bin/apigee-service baas-usergrid إعادة التشغيل
4. في حال عدَّلت portal.properties، اضبط عقدة البوابة:
   > /<inst_root>/apigee/apigee-service/bin/apigee-service baas- PortalConfigure
5. انشر التغييرات:
   &gt; /<inst_root>/apigee/apigee-service/bin/apigee-service baas- Portal Publishing
6. إعادة تشغيل بوابة BaaS:
   &gt; /<inst_root>/apigee/apigee-service/bin/apigee-service baas- Portal off

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

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

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

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

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

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

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

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