إعداد مؤسسة

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

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

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

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

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

# Specify the IP or DNS name of the Management Server.
IP1=MANAGEMENT_SERVER_IP_ADDRESS

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 ما يلي:

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

لتنفيذ 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. تأكَّد من أنّك أعددت مؤسسة بنجاح. إحدى الطرق المتاحة لتنفيذ ذلك هي تسجيل الدخول إلى واجهة مستخدم New Edge من خلال طلب عنوان URL التالي في متصفّح: 
    http://IP_address:3001

    حيث IP_address هو عنوان IP للخادم الذي ثبَّت عليه واجهة مستخدم New 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. تحقَّق من "إحصاءات Google" من خلال تنفيذ الأمر التالي: 
    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. يمكنك الوصول إلى واجهة مستخدم New Edge باستخدام متصفّح ويب. يُرجى العِلم أنّك سبق أن دوّنت عنوان URL لوحدة تحكّم الإدارة في نهاية عملية التثبيت.
    1. شغِّل المتصفّح المفضّل لديك وأدخِل عنوان URL لواجهة مستخدم New Edge. يبدو عنوان URL مشابهًا لما يلي، حيث يكون عنوان IP للعُقدة 1 (كما هو موضّح فيطُرق التثبيت)، أو أي عُقدة ثبَّت عليها واجهة مستخدم New Edge للإعدادات البديلة: 
      http://192.168.56.111:3001

      ‫3001 هو رقم المنفذ التلقائي الذي تستخدمه واجهة مستخدم New Edge.

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

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

    يعيد المتصفّح توجيهك إلى http://192.168.56.111:3001/edge ويفتح لوحة بيانات تتيح لك ضبط المؤسسة التي أنشأتها (إذا سجّلت الدخول باستخدام بيانات اعتماد مشرف Apigee).

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

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

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