إعداد مؤسسة

Edge for Private Cloud الإصدار 4.19.01

لإتاحة الوصول إلى مؤسسة، يجب إنشاء ملف إعداد إعداد، ثم تمريره إلى الأمر 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 البرمجي ما يلي:

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

لتنفيذ 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).

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

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

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