الإصدار 4.17.05 من Edge for Private Cloud
استخدِم الأمر setup-org لإجراء عملية الإعداد. يجب تشغيل الأمر على عقدة خادم الإدارة.
كجزء من عملية الإعداد، ينفّذ النص البرمجي ما يلي:
- يتم إنشاء المؤسسة.
- يتم ضبط المستخدم المحدّد كمشرف المؤسسة.
- يجب أن يكون هذا المستخدم مختلفًا عن مستخدم مشرف النظام. أي لا تستخدم مستخدم مشرف النظام كمستخدم مشرف مؤسسة.
- يمكنك تحديد مستخدم حالي لمشرف المؤسسة أو ضبط النص البرمجي لإنشاء مستخدم جديد.
- يربط المؤسسة بمجموعة، ويتم ربطها تلقائيًا بمجموعة "المدخل".
- أنشِئ بيئة.
- أنشئ مضيفًا افتراضيًا للبيئة.
- اربط البيئة بجميع معالِجات الرسائل.
- يتيح هذا الإذن تفعيل الإحصاءات.
ملف الإعداد لعملية الإعداد
مرِّر ملف إعداد إلى الأمر setup-org. استدعِ الأمر setup-org وحدِّد الخيار -f، بما في ذلك المسار إلى ملف الإعداد الصامت:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
الشرط الوحيد في عمليات التثبيت التلقائي هو أن يكون ملف الإعداد متاحًا أو قابلاً للقراءة من قِبل مستخدم "apigee".
في ما يلي مثال على ملف إعداد صامت. وعدِّله حسب الضرورة لتلبية متطلباتك:
IP1=192.168.1.1 # Specify the IP or DNS name of the Management Server. MSIP="$IP1" # Specify the Edge sys admin credentials. ADMIN_EMAIL="admin@email.com" APIGEE_ADMINPW=adminPassword # If omitted, you are prompted for it. # Specify organization name. ORG_NAME=myorg # lowercase only, no spaces, underscores, or periods. # Specify the organization administrator user. # Either specify an existing user, or specify the information # necessary to create a new user. # Do not use the sys admin as the organization administrator. # # Create a new user for the organization administrator. NEW_USER="y" # New user information if NEW_USER="y". USER_NAME=new@user.com FIRST_NAME=new LAST_NAME=user USER_PWD="newUserPword" ORG_ADMIN=new@user.com # # Or, specify an existing user as the organization admin, # omit USER_NAME, FIRST_NAME, LAST_NAME, USER_PWD. # NEW_USER="n" # ORG_ADMIN=existing@user.com # Specify environment name. ENV_NAME=prod # Specify virtual host information. VHOST_PORT=9001 VHOST_NAME=default # If you have a DNS entry for the virtual host. VHOST_ALIAS=myorg-test.apigee.net # If you do not have a DNS entry for the virtual host, # specify the IP and port of each router as a space-separated list: # VHOST_ALIAS="firstRouterIP:9001 secondRouterIP:9001" # Optionally configure TLS/SSL for virtual host. # VHOST_SSL=y # Set to "y" to enable TLS/SSL on the virtual host. # KEYSTORE_JAR= # JAR file containing the cert and private key. # KEYSTORE_NAME= # Name of the keystore. # KEYSTORE_ALIAS= # The key alias. # KEY_PASSWORD= # The key password, if it has one. # Specify the analytics group. # AXGROUP=axgroup-001 # Default name is axgroup-001.
ملاحظات:
- بالنسبة إلى VHOST_ALIAS، إذا كان لديك سجلّ نظام أسماء نطاقات ستستخدمه للوصول إلى المضيف الافتراضي، حدِّد الاسم المستعار للمضيف والمنفذ اختياريًا، على سبيل المثال، "myapi.example.com". إذا لم يكن لديك سجلّ نظام أسماء نطاقات، يمكنك استخدام عنوان IP الخاص بجهاز التوجيه.
لمزيد من المعلومات حول كيفية ضبط المضيف الافتراضي، يُرجى الاطّلاع على مقالة إعداد مضيف افتراضي. - للاطّلاع على إعدادات بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL)، يُرجى الاطّلاع على مخازن المفاتيح ومخازن الثقة وضبط وصول بروتوكول أمان طبقة النقل (TLS) إلى واجهة برمجة تطبيقات للسحابة الإلكترونية الخاصة لمزيد من المعلومات حول إنشاء ملف JAR والجوانب الأخرى لإعداد بروتوكول أمان طبقة النقل (TLS)/طبقة المقابس الآمنة (SSL).
- لمزيد من المعلومات حول ضبط المضيفين الافتراضيين، يُرجى الاطّلاع على ضبط وصول بروتوكول أمان طبقة النقل (TLS) إلى واجهة برمجة تطبيقات للسحابة الإلكترونية الخاصة.
إجراءات الإعداد
- ثبِّت apigee-provision على
عقدة خادم الإدارة:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision install - شغِّل الأمر على عقدة خادم الإدارة:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
يجب أن يكون ملف الإعداد متاحًا أو قابلاً للقراءة من قِبل مستخدم "apigee".
التحقّق من عملية الإعداد
عند اكتمال عملية الإعداد، تحقَّق من حالة النظام من خلال إصدار أوامر CURL التالية على عقدة خادم الإدارة.
- تحقَّق من حالة المستخدم والمؤسسة على خادم الإدارة من خلال إصدار أوامر
CURL التالية:
> curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/users
> curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations
> curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/deployments - إذا فعّلت الإحصاءات، استخدِم هذا الأمر:
> curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/provisioning/axstatus - يمكنك أيضًا التحقّق من حالة قاعدة بيانات PostgreSQL من خلال تشغيل الأمر التالي على
"الجهاز 2" لبدء psql:
> psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee
في موجه الأوامر، أدخِل الأمر التالي لعرض جدول الإحصاءات لمؤسستك:
apigee=# : \d analytics."<orgname>.prod.fact"
استخدِم الأمر التالي للخروج من psql:
apigee=# \q - الوصول إلى واجهة مستخدم Apigee Edge باستخدام متصفّح ويب يُرجى العِلم أنّك دوّنت عنوان URL الخاص بوحدة تحكّم الإدارة في نهاية عملية التثبيت.
- افتح المتصفّح المفضّل لديك وأدخِل عنوان URL لواجهة مستخدم Edge. ويشبه ما يلي، حيث يكون عنوان IP للجهاز 1 أو لأي جهاز ثبّتّ واجهة المستخدم عليه للإعدادات البديلة:
http://192.168.56.111:9000/login
9000 هو رقم المنفذ الذي تستخدمه واجهة المستخدم. إذا كنت تبدأ المتصفّح مباشرةً على الخادم الذي يستضيف واجهة مستخدم Edge، يمكنك استخدام عنوان URL بالصيغة:
http://localhost:9000/login
ملاحظة: تأكَّد من أنّ المنفذ 9000 مفتوح. - في صفحة تسجيل الدخول إلى وحدة التحكّم، حدِّد اسم المستخدم وكلمة المرور لمشرف نظام Apigee.
ملاحظة: هذه هي كلمة مرور مشرف النظام العام التي حدّدتها أثناء التثبيت. بدلاً من ذلك، يمكنك:
- افتح المتصفّح المفضّل لديك وأدخِل عنوان URL لواجهة مستخدم Edge. ويشبه ما يلي، حيث يكون عنوان IP للجهاز 1 أو لأي جهاز ثبّتّ واجهة المستخدم عليه للإعدادات البديلة:
- اشترِك في حساب مستخدم جديد على Apigee واستخدِم بيانات اعتماد المستخدم الجديد لتسجيل الدخول.
- انقر على "تسجيل الدخول"، وسيعيد المتصفّح توجيهك إلى:
http://192.168.56.111:9000/platform/#/<orgname>/
وسيفتح لوحة بيانات تتيح لك ضبط المؤسسة التي تم إنشاؤها سابقًا (في حال تسجيل الدخول باستخدام بيانات اعتماد مشرف Apigee). - إذا كنت مستخدمًا جديدًا لـ Edge، يمكنك الآن إنشاء أول خادم وكيل لواجهة برمجة التطبيقات. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء أول خادم وكيل لواجهة برمجة التطبيقات.
يمكنك أيضًا الاطّلاع على الأقسام المتعلّقة بالنماذج، بما في ذلك قائمة النماذج، وواجهات برمجة التطبيقات RESTful المستهدَفة الوهمية التي يمكنك استخدامها في تجارب إنشاء واجهات برمجة التطبيقات الخاصة بك على Mock Target API.
- انقر على "تسجيل الدخول"، وسيعيد المتصفّح توجيهك إلى: