پیوستن سازمان

برای آماده‌سازی سازمان، باید فایل پیکربندی آماده‌سازی ایجاد کنید و سپس آن را به فرمان setup-org ارسال کنید. هرکدام از این مراحل در بخش‌های زیر توضیح داده شده است.

برای کسب اطلاعات درباره استفاده از API مدیریت برای آماده‌سازی سازمان، به ایجاد سازمان، محیط، و میزبان مجازی مراجعه کنید.

ایجاد فایل پیکربندی آماده‌سازی

این بخش شامل یک فایل پیکربندی نمونه برای آماده‌سازی سازمان با 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.

توجه داشته باشید که:

  • برای VHOST_ALIAS، اگر ازقبل سابقه DNS دارید که از آن برای دسترسی به میزبان مجازی استفاده خواهید کرد، نام مستعار میزبان و درصورت تمایل درگاه را مشخص کنید، برای مثال، «myapi.example.com». اگر هنوز رکورد DNS ندارید، می‌توانید از نشانی IP «رهیاب» استفاده کنید.

    برای اطلاعات بیشتر درباره نحوه پیکربندی میزبان مجازی، به راه‌اندازی میزبان مجازی مراجعه کنید.

  • برای پیکربندی TLS/SSL، به Keystores and Truststores و Configuring TLS access to an API for the Private Cloud مراجعه کنید تا اطلاعات بیشتری درباره ایجاد فایل JAR و دیگر جنبه‌های پیکربندی TLS/SSL کسب کنید.
  • برای اطلاعات بیشتر درباره پیکربندی میزبان‌های مجازی، به پیکربندی دسترسی TLS به API برای Private Cloud مراجعه کنید.
  • نمی‌توانید دو سازمان با نام یکسان ایجاد کنید. در این صورت، ایجاد دوم ناموفق خواهد بود.

اجرای setup-org

پس‌از ایجاد فایل پیکربندی آماده‌سازی، آن را به دستورگان 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. تأیید کنید که سازمانی را با موفقیت آماده‌سازی کرده‌اید. یک راه برای انجام این کار، ورود به سیستم واسط کاربر با درخواست نشانی وب زیر در مرورگر است: 
    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 را بررسی کنید: 
    psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

    در پیام‌واره فرمان، فرمان زیر را وارد کنید تا جدول تجزیه‌وتحلیل سازمانتان را مشاهده کنید:

    \d analytics."org_name.env_name.fact"

    برای خروج از psql، از فرمان زیر استفاده کنید:

    \q
  4. بااستفاده از مرورگر وب به میانای کاربر Apigee Edge دسترسی پیدا کنید. به‌خاطر داشته باشید که قبلاً نشانی وب کنسول مدیریت را در پایان نصب یادداشت کرده‌اید.
    1. مرورگر ترجیحی‌تان را راه‌اندازی کنید و نشانی وب Edge UI را وارد کنید. این فایل شبیه به فایل زیر است که در آن نشانی IP مربوط به «گره ۱» است (همان‌طور که در توپولوژی‌های نصب نشان داده شده است) یا هر گره دیگری که واسط کاربر را برای پیکربندی‌های جایگزین روی آن نصب کرده‌اید: 
      http://192.168.56.111:9000/login

      ‫۹۰۰۰ شماره درگاهی است که میانای کاربر از آن استفاده می‌کند.

      اگر مرورگر را مستقیماً در سرور میزبان Edge UI راه‌اندازی می‌کنید، می‌توانید از نشانی وب در این فرم استفاده کنید: 

      http://localhost:9000/login
    2. در صفحه ورود به سیستم کنسول، نام کاربری/گذرواژه سرپرست سیستم Apigee را مشخص کنید.
  5. برای حساب کاربری Apigee جدیدی ثبت‌نام کنید و از اطلاعات کاربری کاربر جدید برای ورود به سیستم استفاده کنید. در صفحه ورود به سیستم کنسول، روی دکمه ورود به سیستم کلیک کنید.

    مرورگر به http://192.168.56.111:9000/platform/#/org_name/ هدایت می‌شود و داشبوردی را باز می‌کند که به شما امکان می‌دهد سازمانی را که ایجاد کرده‌اید پیکربندی کنید (اگر بااستفاده از اطلاعات کاربری سرپرست Apigee به سیستم وارد شده باشید).

اولین پراکسی‌تان را ایجاد کنید

پس‌از اینکه سازمان جدیدی را ملحق کردید و تأیید کردید که فرایند الحاق موفقیت‌آمیز بوده است، اکنون می‌توانید اولین پراکسی خود را ایجاد کنید. برای اطلاعات بیشتر، ساختن اولین میانای برنامه‌سازی کاربردی پراکسی را ببینید.

منابع دیگری که ممکن است برایتان مفید باشد عبارت‌اند از: