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

Edge for Private Cloud v4.18.05

משתמשים בסקריפט 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 הראשון

קובץ תצורה להכשרת עובדים חדשים

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

/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile

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

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

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

כדי להוסיף את הארגון שלכם, אתם יכולים להעתיק את הדוגמה הבאה ולערוך אותה לפי הצורך:

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

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

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

בסיום תהליך ההצטרפות, מאמתים את סטטוס המערכת על ידי הפעלת פקודות ה-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 הראשון שלכם. מידע נוסף זמין במאמר בניית ה-proxy הראשון ל-API.

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