הצטרפות לארגון

כדי להגדיר ארגון, צריך ליצור קובץ תצורה להגדרה ולהעביר אותו לפקודה 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.

חשוב לזכור:

  • בשדה VHOST_ALIAS, אם כבר יש לכם רשומת DNS שתשמש אתכם כדי לגשת למארח הווירטואלי, ציינו את הכינוי של המארח ואת היציאה (אופציונלי), לדוגמה, "myapi.example.com". אם עדיין אין לך רשומת DNS, אפשר להשתמש בכתובת ה-IP של הנתב.

    מידע נוסף על הגדרת המארח הווירטואלי זמין במאמר בנושא הגדרת מארח וירטואלי.

  • כדי להגדיר TLS/SSL, אפשר לעיין במאמרים מאגרי מפתחות ומאגרי אישורים והגדרת גישת TLS ל-API לענן הפרטי לקבלת מידע נוסף על יצירת קובץ ה-JAR והיבטים אחרים של הגדרת TLS/SSL.
  • מידע נוסף על הגדרת מארחים וירטואליים זמין במאמר הגדרת גישת TLS ל-API לענן פרטי.
  • אי אפשר ליצור שני ארגונים עם אותו שם. במקרה כזה, היצירה השנייה תיכשל.

הרצת הפקודה setup-org

אחרי שיוצרים את קובץ התצורה של תהליך ההצטרפות, מעבירים אותו לסקריפט setup-org כדי לבצע את תהליך ההצטרפות. צריך להריץ את הסקריפט בצומת של שרת הניהול.

כשמצטרפים לארגון, הסקריפט setup-org מבצע את הפעולות הבאות:

  • יוצרת ארגון חדש.
  • יוצר סביבה.
  • יוצר מארח וירטואלי לסביבה.
  • מגדיר את המשתמש שצוין כאדמין של הארגון. חשוב לזכור:
    • אתם יכולים להשתמש במשתמש קיים או ליצור משתמש חדש לאדמין של הארגון.
    • אסור שאדמין הארגון יהיה אותו אדם כמו אדמין המערכת.
  • משייך את הארגון ל-pod של השער. (זו ברירת המחדל ואי אפשר לשנות אותה).
  • משייכת את הסביבה לכל מעבדי הבקשות.
  • הפעלת ניתוח הנתונים.

כדי להפעיל את 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 על ידי בקשת כתובת ה-URL הבאה בדפדפן: 
    http://IP_address:3001

    כאשר IP_address היא כתובת ה-IP של השרת שבו התקנתם את ממשק המשתמש החדש של Edge.

    לשלבי אימות נוספים, ראו אימות תהליך ההצטרפות.

  4. יצירת ה-Proxy הראשון

אימות ההצטרפות

בסיום ההצטרפות, מריצים את הפקודות הבאות של 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 על ידי הפעלת הפקודות הבאות בצומת 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 של ממשק המשתמש החדש של Edge. הוא נראה בערך ככה, כאשר כתובת ה-IP היא של צומת 1 (כפי שמוצג בטופולוגיות ההתקנה), או של הצומת שבו התקנתם את ממשק המשתמש החדש של Edge להגדרות חלופיות: 
      http://192.168.56.111:3001

      ‫3001 הוא מספר היציאה שמוגדר כברירת מחדל בממשק המשתמש החדש של Edge.

      אם אתם מפעילים את הדפדפן ישירות בשרת שמארח את ממשק המשתמש החדש של Edge, אתם יכולים להשתמש בכתובת URL מהסוג הבא: 

      http://localhost:3001
    2. בדף ההתחברות למסוף, מציינים את שם המשתמש והסיסמה של מנהל המערכת של Apigee.
  5. נרשמים לחשבון משתמש חדש ב-Apigee ומשתמשים בהרשאת הגישה החדשה כדי להיכנס. בדף הכניסה למסוף, לוחצים על הלחצן Sign In.

    הדפדפן מפנה אל http://192.168.56.111:3001/edge ופותח מרכז בקרה שמאפשר להגדיר את הארגון שיצרתם (אם התחברתם באמצעות פרטי הכניסה של אדמין ב-Apigee).

יצירת השרת הראשון של Proxy

אחרי שהוספתם ארגון חדש ואישרתם שתהליך ההוספה הושלם, אתם יכולים ליצור את שרת ה-proxy הראשון שלכם. מידע נוסף זמין במאמר בניית ה-proxy הראשון ל-API.

מקורות מידע נוספים שיכולים לעזור: