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

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

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

بعد تثبيت أداة Edge 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
SMTPMAILFROM="My Company <myco@company.com>"

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

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

    يحدد الخيار " -p asa" تثبيت جميع مكونات BaaS لواجهة برمجة التطبيقات على عقدة واحدة (Cassandra وElastsearch وAPI BaaS Stack وواجهة برمجة التطبيقات BaaS وTomcat).

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

  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 restart
  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
SMTPMAILFROM="My Company <myco@company.com>"

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

يمكنك ربط واجهة برمجة التطبيقات BaaS بمجموعة Cassandra نفسها التي يستخدمها Edge. إذا لم يسبق لك تثبيت Edge، يمكنك اختياريًا تثبيت Cassandra لاستخدام واجهة برمجة التطبيقات BaaS.

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

  1. ثبِّت الأداة apigee-setup Edge على العقدة باستخدام أي إجراء خاص بالإنترنت أو غير متصل بالإنترنت. راجِع تثبيت أداة إعداد واجهة برمجة التطبيقات 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
      
    The "-p e" option specifies to install ElasticSearch. The configuration file must be
      accessible or readable by the "apigee" user.
  3. (Optional) If you install ElasticSearch on a standalone node, meaning it is not installed with API BaaS Stack, then adjust the default memory option to increase the memory allocated for ElasticSearch from 4GB to 6GB:
    1. Open /opt/apigee/customer/application/elasticsearch.properties in an editor. If this file does not exist, create it.
    2. Set the setenv_elasticsearch_max_mem_size property to 6g (the default is 4g): 
      setenv_elasticsearch_max_mem_size=6g
    3. احفظ الملف.
    4. نفِّذ الأمر التالي: 
      /opt/apigee/apigee-service/bin/apigee-service apigee-elasticsearch restart

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

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

    بعد أن تجلب أداة التثبيت بيانات اعتماد المشرف الصحيحة، تعمل على تثبيت 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/portal.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. اضبط عقدة تسلسل استدعاء الدوال البرمجية: 
      /opt/apigee/apigee-service/bin/apigee-service baas-usergrid configure
    2. أعِد تشغيل حزمة BaaS Stack: 
      /opt/apigee/apigee-service/bin/apigee-service baas-usergrid restart
    3. إذا عدّلت portal.properties، اضبط عقدة البوابة: 
      /opt/apigee/apigee-service/bin/apigee-service baas-portal configure
    4. أعِد تشغيل بوابة BaaS: 
      /opt/apigee/apigee-service/bin/apigee-service baas-portal restart

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

    عملية الإعداد هي عملية إنشاء مشرف في مؤسسة ومؤسسة. بعد إنشاء مشرف المؤسسة والمؤسسة، يمكنك تسجيل الدخول إلى واجهة مستخدم بوابة 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/
    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.