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

Edge for Private Cloud גרסה 4.17.05

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

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

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

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

מעבירים קובץ תצורה לפקודה 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, אתם יכולים להשתמש בכתובת ה-IP של הנתב.

    במאמר הגדרת מארח וירטואלי מוסבר איך מגדירים את המארח הווירטואלי.
  • כדי להגדיר TLS/SSL, אפשר לעיין במאמרים Keystores and Truststores ו-Configuring TLS access to an API for the Private Cloud, שבהם מוסבר איך ליצור את קובץ ה-JAR ואיך להגדיר TLS/SSL.
  • מידע נוסף על הגדרת מארחים וירטואליים זמין במאמר הגדרת גישת TLS ל-API לענן פרטי.

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

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

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

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

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

  1. בודקים את הסטטוס של המשתמש והארגון בשרת הניהול באמצעות פקודות ה-CURL הבאות:
    > 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/<orgname>/deployments
  2. אם הפעלתם את ניתוח הנתונים, השתמשו בפקודה הזו:
    > curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/provisioning/axstatus
  3. אפשר גם לבדוק את הסטטוס של מסד הנתונים של PostgreSQL על ידי הפעלת הפקודה הבאה במכונה 2 כדי להפעיל את psql:
    > 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. לוחצים על Sign In (כניסה). הדפדפן מפנה אל:
      http://192.168.56.111:9000/platform/#/<orgname>/

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

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