روی یک سازمان

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

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

یک فایل پیکربندی onboarding ایجاد کنید

این بخش شامل یک فایل پیکربندی نمونه برای ورود به سازمان با 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، برای اطلاعات بیشتر در مورد ایجاد فایل JAR، و سایر جنبه‌های پیکربندی TLS/SSL، به Keystores و Truststores و پیکربندی دسترسی TLS به API برای Private Cloud مراجعه کنید.
  • برای اطلاعات بیشتر در مورد پیکربندی میزبان های مجازی، به پیکربندی دسترسی TLS به یک API برای Private Cloud مراجعه کنید.
  • شما نمی توانید دو سازمان با یک نام ایجاد کنید. در این صورت ایجاد دوم با شکست مواجه خواهد شد.

اجرای setup-org

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

هنگام ورود به یک سازمان، اسکریپت setup-org کارهای زیر را انجام می دهد:

  • یک سازمان جدید ایجاد می کند.
  • محیطی ایجاد می کند.
  • یک هاست مجازی برای محیط ایجاد می کند.
  • کاربر مشخص شده را به عنوان سرپرست سازمان تنظیم می کند. توجه داشته باشید که:
    • می توانید از یک کاربر موجود استفاده کنید یا یک کاربر جدید برای سرپرست سازمان ایجاد کنید.
    • ادمین سازمان نباید با ادمین سیستم یکی باشد .
  • سازمان را با غلاف "دروازه" مرتبط می کند. (این پیش فرض است و قابل تغییر نیست.)
  • محیط را با تمام پردازنده(های) پیام مرتبط می کند.
  • تجزیه و تحلیل را فعال می کند.

برای اجرای setup-org :

  1. apigee-provision روی گره مدیریت سرور نصب کنید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision install
  2. اسکریپت setup-org را روی گره مدیریت سرور اجرا کنید و آن را روی فایل پیکربندی که در Create an onboarding file configuration ایجاد کرده اید قرار دهید: 
    /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

    فایل پیکربندی باید توسط کاربر "apigee" قابل خواندن باشد.

  3. بررسی کنید که با موفقیت وارد یک سازمان شده اید. یکی از راه های انجام این کار این است که با درخواست URL زیر در مرورگر وارد UI شوید: 
    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 را با اجرای دستورات زیر در Node 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 برای Node 1 است (همانطور که در توپولوژی های نصب نشان داده شده است)، یا هر گرهی که UI را برای پیکربندی های جایگزین روی آن نصب کرده اید: 
      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 وارد سیستم شده باشید).

اولین پروکسی خود را ایجاد کنید

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

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