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

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

במאמר יצירת ארגון, סביבה ומארח וירטואלי מוסבר איך משתמשים ב-Management 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 של הנתב.

    למידע נוסף על הגדרת המארח הווירטואלי, אפשר לקרוא את המאמר הגדרת מארח וירטואלי.

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

ביצוע ארגון ההגדרה

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

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

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

כדי לבצע 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. עליך לוודא שהשלמת את ההגדרה של ארגון. אחת הדרכים לעשות זאת היא להתחבר לממשק המשתמש באמצעות בקשת כתובת ה-URL הבאה בדפדפן: 
    http://IP_address:9000/login

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

      9000 הוא מספר היציאה המשמש את ממשק המשתמש.

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

      http://localhost:9000/login

    2. בדף ההתחברות למסוף, מציינים את שם המשתמש/הסיסמה של מנהל המערכת ב-Apigee.
  5. נרשמים לחשבון משתמש חדש ב-Apigee ומשתמשים בפרטי הכניסה החדשים של המשתמש כדי להתחבר. בדף הכניסה למסוף, לוחצים על הלחצן Sign In [כניסה].

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

יצירת שרת ה-proxy הראשון

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

מקורות מידע נוספים שעשויים להועיל לך: