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

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

برای کسب اطلاعات درباره استفاده از 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.

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

  • برای 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. تأیید کنید که سازمان را باموفقیت آماده کرده‌اید. یکی از راه‌های انجام این کار این است که با درخواست نشانی وب زیر در مرورگر، وارد «واسط کاربر Edge جدید» شوید: 
    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. با اجرای فرمان زیر، تجزیه‌وتحلیل‌ها را بررسی کنید: 
    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. بااستفاده از مرورگر وب به New Edge UI دسترسی پیدا کنید. به‌خاطر داشته باشید که قبلاً نشانی وب کنسول مدیریت را در پایان نصب یادداشت کرده‌اید.
    1. مرورگر دلخواهتان را راه‌اندازی کنید و نشانی وب «رابط کاربری Edge جدید» را وارد کنید. این دستور شبیه به دستور زیر است که در آن نشانی IP مربوط به «گره ۱» است (همان‌طور که در توپولوژی‌های نصب نشان داده شده است) یا هر گره دیگری که «رابط کاربری Edge جدید» را برای پیکربندی‌های جایگزین روی آن نصب کرده‌اید: 
      http://192.168.56.111:3001

      ‫۳۰۰۱ شماره درگاه پیش‌فرضی است که توسط واسط کاربر New Edge استفاده می‌شود.

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

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

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

ساختن اولین پراکسی

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

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