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

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

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

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

این بخش شامل فایل پیکربندی نمونه‌ای برای آماده‌سازی سازمان با 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، اگر ازقبل گزارش «دی‌ان‌اس» دارید که از آن برای دسترسی به میزبان مجازی استفاده می‌کنید، نام مستعار میزبان و درصورت تمایل درگاه را مشخص کنید، برای مثال، «myapi.example.com». اگر هنوز گزارش DNS ندارید، می‌توانید از نشانی IP «مسیریاب» استفاده کنید.
  

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

• برای پیکربندی «امنیت لایه انتقال»/ SSL، برای کسب اطلاعات بیشتر درباره ایجاد فایل JAR و دیگر جنبه‌های پیکربندی «امنیت لایه انتقال»/ SSL، به Keystores و Truststores و پیکربندی دسترسی «امنیت لایه انتقال» به API برای «ابر خصوصی» مراجعه کنید.
• برای اطلاعات بیشتر درباره پیکربندی میزبان‌های مجازی، پیکربندی دسترسی «امنیت لایه انتقال» به «میانای برنامه‌سازی کاربردی» برای «ابر خصوصی» را ببینید.
• نمی‌توانید دو سازمان با نام یکسان ایجاد کنید. در این صورت، ایجاد دوم ناموفق خواهد بود.

اجرای setup-org

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

هنگام آماده‌سازی سازمان، دستورگان 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» را وارد کنید. این نشانی شبیه به نشانی زیر است، که در آن نشانی IP مربوط به «گره ۱» است (همان‌طور که در توپولوژی‌های نصب نشان داده شده است)، یا هر گره‌ای که در آن واسط کاربر را برای پیکربندی‌های جایگزین نصب کرده‌اید:

      http://192.168.56.111:9000/login

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

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

      http://localhost:9000/login

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

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

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

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

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

• فهرست نمونه‌ها
• میاناهای برنامه‌سازی کاربردی RESTful هدف ساختگی که می‌توانید در آزمایش‌های ساختن API خودتان استفاده کنید