إعداد مؤسسة

لإعداد مؤسسة، عليك إنشاء ملف إعداد عملية إعداد ثم تمريره. إلى الأمر setup-org. يتم وصف كل خطوة من هذه الخطوات في الأقسام اتباعها.

للحصول على معلومات عن استخدام واجهة برمجة تطبيقات الإدارة لإعداد المؤسسات، راجع بعد إنشاء مؤسسة، والمضيف الظاهري.

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

يتضمّن هذا القسم نموذج ملف الإعداد لإعداد مؤسسة باستخدام setup-org

انسخ المثال التالي وعدِّله حسب الضرورة لمؤسستك:

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=admin_password  # 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
# Org admin password must be at least 8 characters long and contain one uppercase
# letter, one lowercase letter, and one digit or special character
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  # lowercase only

# 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.

يُرجى ملاحظة ما يلي:

تنفيذ إعداد الإعداد

بعد إنشاء ملف إعداد عملية الإعداد، يمكنك تمريره إلى setup-org. البرنامج النصي لإجراء عملية الإعداد والتأهيل. يجب تشغيل النص البرمجي على خادم الإدارة العقدة.

عند إعداد مؤسسة، ينفّذ النص البرمجي "setup-org" ما يلي:

  • ينشئ مؤسسة جديدة.
  • يخلق بيئة.
  • تنشئ مضيفًا افتراضيًا للبيئة.
  • لضبط المستخدم المحدّد كمشرف في المؤسسة. تجدر الإشارة إلى ما يلي:
    • ويمكنك استخدام حساب حالي أو إنشاء مستخدم جديد لمشرف المؤسسة.
    • يجب ألا يكون مسؤول المؤسسة هو نفسه مشرف النظم.
  • يربط المؤسسة بـ "البوابة" كبل. (هذا هو الإعداد التلقائي ولا يمكن changed.)
  • ربط البيئة بجميع معالجات الرسائل.
  • تفعيل الإحصاءات

لتنفيذ setup-org:

  1. تثبيت apigee-provision على عقدة خادم الإدارة:
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. تشغيل النص البرمجي "setup-org" في عقدة "خادم الإدارة" وتوجيهه إلى ملف تهيئة أنشأته في إنشاء تهيئة إعداد :
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

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

  3. تأكَّد من إعداد مؤسسة بنجاح. تتمثل إحدى طرق القيام بذلك في تسجيل في واجهة المستخدم من خلال طلب عنوان URL التالي في متصفّح:
    http://IP_address:9000/login

    حيث IP_address هو عنوان IP للخادم الذي تم تثبيت Edge عليه واجهة مستخدم

    لمعرفة خطوات التحقّق الإضافية، يُرجى الاطّلاع على مقالة التحقّق من عملية الإعداد.

  4. عليك إنشاء أول خادم وكيل.

التحقّق من الخطوات الإرشادية

بعد اكتمال عملية الإعداد، يمكنك التحقُّق من حالة النظام من خلال إصدار ما يلي: أوامر curl في عقدة خادم الإدارة:

  1. تحقق من حالة المستخدم والمؤسسة على خادم الإدارة من خلال تنفيذ ما يلي الأوامر:
    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/org_name/deployments
  2. تحقَّق من الإحصاءات عن طريق تنفيذ الأمر التالي:
    curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus
  3. تحقَّق من حالة قاعدة بيانات PostgreSQL من خلال تنفيذ الأوامر التالية على العقدة 2. (كما هو موضّح في سياسات التثبيت):
    psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

    في موجه الأوامر، أدخل الأمر التالي لعرض جدول التحليلات الخاص المؤسسة:

    \d analytics."org_name.env_name.fact"

    استخدِم الأمر التالي للخروج من psql:

    \q
  4. الوصول إلى واجهة مستخدم Apigee Edge باستخدام متصفح ويب تذكر أنك لاحظت بالفعل عنوان URL لوحدة التحكم في الإدارة في نهاية عملية التثبيت.
    1. شغِّل متصفّحك المفضَّل وأدخِل عنوان URL لواجهة مستخدم Edge. يبدو مشابهًا لـ حيث يكون عنوان IP للعقدة 1 (كما هو موضح في سياسات التثبيت) العقدة التي تم تثبيت واجهة المستخدم للإعدادات البديلة:
      http://192.168.56.111:9000/login

      9000 هو رقم المنفذ الذي تستخدمه واجهة المستخدم.

      إذا كنت تبدأ تشغيل المتصفح مباشرةً على الخادم الذي يستضيف واجهة مستخدم Edge، يمكنك استخدام عنوان URL بالشكل التالي:

      http://localhost:9000/login
    2. في صفحة تسجيل الدخول إلى وحدة التحكّم، حدِّد اسم المستخدم أو كلمة المرور لمشرف نظام Apigee.
  5. اشترِك للحصول على حساب مستخدم جديد في Apigee واستخدِم بيانات اعتماد المستخدم الجديد لتسجيل الدخول. في صفحة لتسجيل الدخول إلى وحدة التحكم، انقر على زر تسجيل الدخول.

    يعيد المتصفّح التوجيه إلى http://192.168.56.111:9000/platform/#/org_name/. وتفتح لوحة معلومات تتيح لك تهيئة المؤسسة التي أنشأتها (إذا سجلت باستخدام بيانات اعتماد مشرف Apigee).

إنشاء أول خادم وكيل

بعد إعداد مؤسسة جديدة والتأكّد من أنّ عملية الإعداد كانت يمكنك الآن إنشاء الخادم الوكيل الأول. للمزيد من المعلومات، راجِع إنشاء أول خادم وكيل لواجهة برمجة التطبيقات.

في ما يلي مراجع أخرى قد تكون مفيدة: