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

Edge for Private Cloud גרסה 4.16.09

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

כחלק מתהליך ההצטרפות, הסקריפט:

  • יצירת הארגון.
  • מגדיר את המשתמש שצוין כאדמין בארגון.
    • המשתמש הזה חייב להיות שונה ממשתמש ה-sys Admin. כלומר, לא להשתמש ב-sys Admin כמשתמש של מנהל חשבון ארגוני.
    • אפשר לציין משתמש קיים לאדמין בארגון, או להגדיר את הסקריפט יוצרים משתמש חדש.
  • משייך את הארגון לתא נתונים, כברירת מחדל משייך אותו ל'שער' צוות
  • יוצרים סביבה.
  • יוצרים מארח וירטואלי לסביבה.
  • שיוך הסביבה לכל מעבדי ההודעות.
  • הפעלת ניתוח נתונים.

קובץ תצורה לתחילת השימוש

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

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

הדרישה היחידה בהתקנות שקטות היא שקובץ התצורה נגיש או קריא לפי "apigee" משתמש.

למטה מוצג קובץ תצורה שקט לדוגמה. עורכים לפי הצורך דרישות:

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=adminPassword     # 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
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

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

הדרכה למשתמשים חדשים

  1. התקנה של apigee-provision ב- הצומת של שרת הניהול:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-permission installation
  2. מריצים את הפקודה בצומת של שרת הניהול:
    > /opt/apigee/apigee-service/bin/apigee-service apigee-referral setup-org -f configFile

    קובץ התצורה חייב להיות נגיש או קריא לפי "apigee" משתמש.

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

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

  1. לבדוק את הסטטוס של משתמשים וארגון בשרת הניהול על ידי ביצוע הפעולות הבאות פקודות CURL:
    &gt; curl -u <adminEmail>:<admin Passwd> http://localhost:8080/v1/users
    &gt; curl -u <adminEmail>:<admin Passwd> http://localhost:8080/v1/organizations
    &gt; curl -u <adminEmail>:<admin Passwd> http://localhost:8080/v1/organizations/&lt;orgname&gt;/deployments
  2. אם מפעילים את ניתוח הנתונים, צריך להשתמש בפקודה הבאה:
    &gt; curl -u <adminEmail>:<admin Passwd> http://localhost:8080/v1/organizations/&lt;orgname&gt;/environments/&lt;envname&gt;/provisioning/axstatus
  3. אפשר גם לבדוק את הסטטוס של מסד הנתונים של PostgreSQL על ידי הרצת הפקודה הבאה על מכונה 2 כדי להפעיל את psql:
    &gt; psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee

    בשורת הפקודה, מזינים את הפקודה הבאה כדי להציג את טבלת ניתוח הנתונים של ארגון:
    apigee=# : \d analytics."<orgname>.prod.fact"

    כדי לצאת מ-psql, משתמשים בפקודה הבאה:
    apigee=# \q
  4. לגשת לממשק המשתמש של Apigee Edge באמצעות דפדפן אינטרנט. חשוב לזכור שכבר ציינתם את כתובת ה-URL של מסוף הניהול בסוף ההתקנה.
    1. מפעילים את הדפדפן המועדף ומזינים את כתובת ה-URL של ממשק המשתמש של Edge. נראה דומה ל- כתובת ה-IP היא של מכשיר 1 או של כל מכונה שהתקנתם. ממשק המשתמש מופעל להגדרות חלופיות:
      http://192.168.56.111:9000/login

      9000 הוא מספר היציאה שמשמש את ממשק המשתמש. אם אתם מפעילים את הדפדפן ישירות השרת שמארח את ממשק המשתמש של Edge, אפשר להשתמש בכתובת URL בתבנית:
      http://localhost:9000/login

      הערה: חשוב לוודא שהיציאה 9000 פתוחה.
    2. בדף ההתחברות של המסוף, מציינים את שם המשתמש/הסיסמה של מנהל המערכת של Apigee.
      הערה: זוהי הסיסמה הגלובלית לאדמין שהגדרת במהלך ההתקנה. אפשרות נוספת:
  5. נרשמים לחשבון משתמש חדש ב-Apigee ומשתמשים בפרטי הכניסה של המשתמש החדש כדי להתחבר.
    1. לוחצים על 'כניסה', הדפדפן מפנה לכתובת הבאה:
      http://192.168.56.111:9000/platform/#/<orgname>/

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

      אפשר גם לעיין בקטעים בנושא 'טעימות', כולל רשימת טעימות והיעד לדוגמה ממשקי API מסוג RESTful שבהם אפשר להשתמש בניסויים משלכם לפיתוח ממשקי API ב-Mock Target API.