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

الإصدار 4.18.01 من Edge for Private Cloud

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

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

الخيار

الوصف

e

يُرجى تثبيت تطبيق ElasticSearch فقط.

b

تثبيت واجهة برمجة التطبيقات BaaS Stack فقط التي تثبِّت أيضًا Tomcat

p

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

c

يجب تثبيت تطبيق Cassandra فقط.

الفترة الزمنية الممتدة

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

ebp

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

Asa

تثبيت جميع مكونات BaaS لواجهة برمجة التطبيقات على عقدة واحدة (Cassandra وElasticsearch وواجهة برمجة التطبيقات BaaS) Stack وAPI BaaS Portal و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. تثبيت الأداة المساعدة apigee-setup على Edge على العقدة باستخدام الإنترنت أو عدم الاتصال بالإنترنت. راجع تثبيت أداة Edge apigee-setup للحصول على أخرى.
  2. في موجِّه الأوامر، شغِّل النص البرمجي للإعداد:
    &gt; /opt/apigee/apigee-setup/bin/setup.sh -p asa -f configFile

    يحدد الخيار "-p asa" تثبيت جميع مكونات BaaS لواجهة برمجة التطبيقات على عقدة واحدة (Cassandra وElasticsearch وAPI BaaS Stack وواجهة برمجة التطبيقات BaaS Portal وTomcat).
    يجب أن يكون ملف الإعداد قابلاً للوصول أو القراءة بواسطة "apigee" المستخدم.
  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. نفِّذ الطلب التالي:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-elasticsearch إعادة تشغيل
  4. ؟إعداد مؤسسة على النحو الموضَّح أدناه في قسم إعداد مؤسسة جديدة

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

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

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

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

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

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

اختياري - تثبيت كاساندرا: الآلة 8 و9 و10

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

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

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

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

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

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

إعداد مهمة Cassandra cron

في حال كان عليك تثبيت Cassandra، يمكنك إعداد مهمة 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. في موجِّه الأوامر، شغِّل النص البرمجي للإعداد:
    &gt; /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. نفِّذ الطلب التالي:
      &gt; /opt/apigee/apigee-service/bin/apigee-service apigee-elasticsearch إعادة تشغيل

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

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

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

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

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

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

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

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

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

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

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

في حال استخدام جهاز موازنة الحمل أمام عقدة "بوابة"، يجب ضبط المواقع التالية في usergrid.properties:

usergrid-deployment_portal.url=http://localhost:9000

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

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

  1. إعداد عقدة التكديس:
    &gt; /opt/apigee/apigee-service/bin/apigee-service baas-usergrid مسبقًا
  2. أعِد تشغيل حزمة BaaS:
    &gt; /opt/apigee/apigee-service/bin/apigee-service baas-usergrid إعادة التشغيل

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

  3. في حال عدَّلت portal.properties، اضبط عقدة البوابة:؟
    &gt; /opt/apigee/apigee-service/bin/apigee-service baas-portal Configuration
  4. إعادة تشغيل بوابة BaaS:
    &gt; /opt/apigee/apigee-service/bin/apigee-service baas- Portal

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

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