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

Edge for Private Cloud ‏v4.18.01

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

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

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

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

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

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

على سبيل المثال، استخدِم الأمر التالي لتثبيت حِزمة API BaaS Stack:

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

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

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

    يحدِّد الخيار "-p asa" تثبيت جميع مكوّنات API BaaS على عقدة واحدة (Cassandra وElasticsearch وAPI BaaS Stack وAPI BaaS Portal وTomcat).
    يجب أن يتمكن مستخدم "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. ?إعداد مؤسسة كما هو موضّح أدناه في إعداد مؤسسة جديدة

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

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

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

  • في عملية التثبيت على 10 عقد، يتم تثبيت مكوّنات ElasticSearch الثلاثة وثلاثة مكوّنات من مجموعة أدوات BaaS على عقد مفصّلة، بإجمالي ست عقد. هذه هي الإعدادات المقترَحة للحصول على أفضل أداء لأنّ ElasticSearch يتطلّب قدرًا كبيرًا من عمليات I/O للقرص والذاكرة.
  • في عملية التثبيت على 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
SMTPMAILFROM="My Company <myco@company.com>"

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

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

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

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

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

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

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

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

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

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

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

  • تضمين عنوان 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، عليك ضبط عقدة Portal:؟
    > /opt/apigee/apigee-service/bin/apigee-service baas-بوابة إعداد
  4. أعِد تشغيل بوابة BaaS:
    > ‎/opt/apigee/apigee-service/bin/apigee-service baas-portal restart

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

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

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

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

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

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

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

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

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

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

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

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