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

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

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

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

وتكون الأداة apigee-setup على النحو التالي:

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

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

الشرط الوحيد هو أن يتمكن مستخدم "apigee" من الوصول إلى ملف الإعداد أو قراءته.

على سبيل المثال، يمكنك استخدام الأمر التالي لتثبيت 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. إنّ البوابة الإلكترونية بسيطة ولا تحتاج إلى موارد إضافية لإجراء ذلك.

آسا

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

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

يحتوي ملف الإعداد على جميع المعلومات اللازمة لتثبيت نظام BaaS لواجهة برمجة التطبيقات. يمكنك غالبًا استخدام ملف الإعداد نفسه لتثبيت جميع المكوّنات في عملية تثبيت BaaS.

تعرض كل طوبولوجيا تثبيت الموضّحة أدناه مثالاً على ملف إعداد لذلك المخطط. للحصول على مرجع كامل حول ملف الإعداد، يمكنك الاطّلاع على مرجع ملف إعداد BaaS.

تثبيت BaaS لواجهة برمجة التطبيقات على عقدة واحدة

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

IP1=192.168.56.101   # IP address of single node

# 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=stackAdminPWord

# Because you are installing Cassandra,
# specify Cassandra data center and rack suffix.
# Must use IP addresses for CASS_HOSTS, not DNS names.
CASS_HOSTS="$IP1:1,1"

# Specify the Cassandra region.
REGION=dc-1

# 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 Cassandra data center name.
BAAS_CASS_LOCALDC=dc-1

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST=dc-1

# Replication is in the form "dataCenterName:#CassandraNodes". 
# For dc-1 with one Cassandra node, it is dc-1:1.
BAAS_CASS_REPLICATION=dc-1:1

# Defines the initial contact points for members of the BaaS cluster. 
# For a single node install, specify the IP address of the node. 
BAAS_CLUSTER_SEEDS="dc-1:$IP1"

# Single ElasticSearch IP.
ES_HOSTS="$IP1"

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

# IP/DNS and port 8080 of a single Stack node.
BAAS_USERGRID_URL="http://$IP1:8080"

# URL and port of the BaaS Portal node.  
BAAS_PORTAL_URL="http://$IP1: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

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

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

    يحدد الخيار " -p asa" تثبيت جميع مكونات واجهة برمجة التطبيقات BaaS على عقدة واحدة (Cassandra وElastsearch وAPI BaaS Stack وTomBacatS).
    يجب أن يتمكّن مستخدم "واجهة برمجة التطبيقات" من الوصول إلى ملف الإعداد أو قراءته.
  3. نظرًا لأنك قد ثبّت ElasticSearch على عقدة مستقلة، اضبط خيار الذاكرة التلقائي لزيادة الذاكرة المخصصة لـ 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 إعادة تشغيل
  4. يمكنك إعداد مؤسسة كما هو موضَّح أدناه في قسم إعداد مؤسسة جديدة.

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

تثبيت نظام BaaS لواجهة برمجة التطبيقات على 7 عُقد أو 10 عُقد

هناك تشابه كبير في إجراء تثبيت إصدار مكون من 7 أو 10 عُقد من نظام BaaS لواجهة برمجة التطبيقات. الفرق الوحيد هو أنه بالنسبة إلى:

  • عند تثبيت 10 عُقد، يتم تثبيت مكوّنات ElasticSearch الثلاثة ومكوّنات BaaS Stack الثلاثة لواجهة برمجة التطبيقات على عُقد منفصلة بإجمالي ست عُقد. وهذه هي التكوينات الموصى بها لتحقيق أفضل أداء لأن عملية ElasticSearch تتطلب قدرًا كبيرًا من وحدات الإدخال والإخراج على القرص.
  • عند تثبيت 7 عُقد، يتم تثبيت مكوِّنات ElasticSearch الثلاثة ومكوّنات حزمة BaaS لواجهة برمجة التطبيقات الثلاثة على العُقد نفسها بإجمالي ثلاث عُقد.

بالنسبة إلى الإصدارين المكوَّنين من 7 و10 عُقد لواجهة برمجة التطبيقات BaaS، يجب الاتصال بمجموعة Cassandra. إذا سبق لك تثبيت Edge، يمكنك الاتصال بمجموعة Cassandra الخاصة به، ما يعني أنّه لن يكون عليك تثبيت Cassandra كجزء من تثبيت واجهة برمجة التطبيقات BaaS.

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

  • تم ضبط IP1 وIP4 على عنوان IP نفسه.
  • تم ضبط IP2 وIP5 على عنوان IP نفسه.
  • تم ضبط IP3 وIP6 على عنوان IP نفسه.

عدِّل هذا الملف حسب الضرورة من أجل الضبط. للحصول على مرجع كامل حول ملف الإعداد، يُرجى الاطّلاع على مرجع ملف إعداد BaaS.

# 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=stackAdminPWord

# Only if you are installing Cassandra.
# Specify Cassandra data center and rack suffix.
# 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"

# Specify the Cassandra region.
REGION=dc-1

# 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.

# For a single data center, specify the same value as BAAS_CASS_LOCALDC.
BAAS_CASS_DC_LIST=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

# Defines the initial contact points for members of the BaaS cluster. 
# Specify the IP address of no more than two Stack nodes. 
BAAS_CLUSTER_SEEDS="dc-1:$IP4,dc-1:$IP5"

# 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. إذا لم يسبق لك تثبيت Edge، يمكنك اختياريًا تثبيت Cassandra لاستخدام واجهة برمجة التطبيقات BaaS.

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

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

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

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

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

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

    يحدد الخيار " -p e" لتثبيت ElasticSearch.
    يجب أن يتمكّن مستخدم "واجهة برمجة التطبيقات" من الوصول إلى ملف الإعداد أو قراءته.
  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" لتثبيت API BaaS Stack.
    يجب أن يتمكّن مستخدم "واجهة برمجة التطبيقات" من الوصول إلى ملف الإعداد أو قراءته.

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

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

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

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

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

    تبدأ أداة التثبيت خادم الويب Nginx، ثم تُنهي إعدادات بوابة BaaS الخاصة بواجهة برمجة التطبيقات.
  3. تعتمد خطوتك التالية على عملية التثبيت التي قمت بها.
    1. إذا كان لديك جهاز لموازنة التحميل أمام عُقد حاوية البوابة، سيشرح القسم التالي كيفية ضبط نظام BaaS لواجهة برمجة التطبيقات لأجهزة موازنة التحميل.
    2. إذا لم يكن لديك جهاز موازنة حمولة البيانات أمام عُقد PowerShell Stack، يمكنك إضافة مؤسسة كما هو موضّح أدناه في القسم إعداد مؤسسة جديدة.

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

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

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

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

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

usergrid-deployment_usergrid.api.url.base=http://localhost:8080

استبدِل 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_portal.url=http://localhost:9000

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

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

  1. اضبُط عقدة Stack:
    > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid Configuration
  2. أعِد تشغيل حزمة BaaS Stack:
    > /opt/apigee/apigee-service/bin/apigee-service baas-usergrid إعادة تشغيل

    ملاحظة: عند إعادة تشغيل عُقد BaaS Stack، يُرجى إعادة تشغيلها بالترتيب نفسه الذي تم إدراجها في BAAS_CLUSTER_SEEDS. تسرد BAAS_CLUSTER_SEEDS عُقدتين على الأكثر من عُقد المكدس. بعد إعادة تشغيل هاتين العُقدتين بالترتيب، يمكنك إعادة تشغيل العُقد المتبقية بأي ترتيب.

  3. إذا عدّلت portal.properties، اضبط عقدة البوابة:
    > /opt/apigee/apigee-service/bin/apigee-service baas-مدخل ضبط
  4. أعِد تشغيل بوابة BaaS:
    > /opt/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.