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

Edge for Private Cloud‏ 4.17.01

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

بعد تثبيت أداة 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)، ولكن يمكنك استخدام خيارات مختلفة استنادًا إلى إعدادات node:

الخيار

الوصف

e

ثبِّت ElasticSearch فقط.

b

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

p

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

c

تثبيت Cassandra فقط

eb

ثبِّت ElasticSearch وAPI BaaS Stack وTomcat على العقدة.

ebp

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

asa

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

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

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

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

تثبيت ميزة "البنية الأساسية لخدمات واجهة برمجة التطبيقات" على عقدة واحدة

في ما يلي ملف الإعداد لتثبيت API 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

لتثبيت API BaaS على عقدته الخاصة:

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

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

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

تثبيت ميزة "البنية الأساسية لخدمات واجهة برمجة التطبيقات" على 7 أو 10 عقد

إنّ إجراءات تثبيت إصدار 7 أو 10 عقد من API BaaS متشابهة جدًا. الفرق الوحيد هو أنّه في:

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

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

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

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

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

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

إعداد وظيفة cron في Cassandra

إذا كان عليك تثبيت 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. ثبِّت أداة إعداد apigee-setup في Edge على العقدة باستخدام الإنترنت أو بدونه الإجراء. اطّلِع على تثبيت أداة apigee-setup في Edge للحصول على مزيد من المعلومات.
  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 على 6g (القيمة التلقائية هي 4g):
      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 Stack على عقدتها الخاصة:

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

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

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

تثبيت بوابة BaaS لـ API: الآلة 7

لتثبيت "بوابة BaaS لواجهة برمجة التطبيقات"، اتّبِع الخطوات التالية:

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

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

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

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

ضبط عقد BaaS لـ API لموازنة الحمولة في "الحزمة" أو "البوابة"

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

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

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

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

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

إذا كنت تستخدم أداة موازنة التحميل أمام عقدة Portal، اضبط السمات التالية في 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 configure
  2. أعِد تشغيل حِزمة BaaS:
    > ‎/opt/apigee/apigee-service/bin/apigee-service baas-usergrid restart

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

  3. إذا عدّلت portal.properties، عليك ضبط عقدة البوابة:
    > /opt/apigee/apigee-service/bin/apigee-service baas-portal configure
  4. أعِد تشغيل بوابة BaaS:
    > /opt/apigee/apigee-service/bin/apigee-service baas- Portal

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

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

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

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

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

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

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

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

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

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

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

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

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