Edge for Private Cloud גרסה 4.18.01
משתמשים בפקודה setup-org כדי לבצע את תהליך ההצטרפות. צריך להריץ את הפקודה בצומת של שרת הניהול.
במסגרת תהליך ההצטרפות, הסקריפט:
- יצירת הארגון.
- מגדיר את המשתמש שצוין כאדמין הארגון.
- המשתמש הזה חייב להיות שונה מהמשתמש עם הרשאת אדמין במערכת sys. כלומר, אין להשתמש במשתמש עם הרשאת אדמין ב-Sys כמשתמש עם הרשאת אדמין בארגון.
- אפשר לציין משתמש קיים לאדמין בארגון, או להגדיר את הסקריפט ליצירת משתמש חדש.
- משייכת את הארגון ל-pod, כברירת מחדל, משייך אותו ל-pod "gateway".
- יוצרים סביבה.
- יצירת מארח וירטואלי עבור הסביבה.
- שיוך הסביבה לכל מעבדי ההודעות.
- הפעלת ניתוח נתונים.
קובץ תצורה למשתמשים חדשים
מעבירים קובץ תצורה אל הפקודה setup-org. מפעילים את הפקודה setup-org ומציינים את האפשרות -f, כולל הנתיב לקובץ התצורה השקט:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
הדרישה היחידה בהתקנות שקטות היא שקובץ התצורה יהיה נגיש או קריא למשתמש ה-API.
לפניכם דוגמה לקובץ תצורה שקט. עורכים אותה לפי הצורך:
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 של הנתב.
למידע נוסף על הגדרת המארח הווירטואלי, אפשר לעיין בהגדרת מארח וירטואלי. - למידע נוסף על יצירת קובץ JAR ועל היבטים אחרים של הגדרת TLS/SSL, תוכלו לקרוא את ההגדרות של TLS/SSL במאמרים Keystores ו-Truststores והגדרת הגישה ל-TLS ל-API עבור הענן הפרטי.
- למידע נוסף על הגדרת מארחים וירטואליים, קראו את המאמר הגדרת גישה באמצעות TLS לממשק API בענן הפרטי.
תהליך ההצטרפות
- מתקינים את apigee-provision בצומת של שרת הניהול:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision התקנה - מריצים את הפקודה על הצומת של שרת הניהול:
> /opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
קובץ התצורה צריך להיות נגיש או קריא למשתמש "apigee".
אימות ההצטרפות
בסיום תהליך הקליטה, צריך לאמת את סטטוס המערכת על ידי הנפקת פקודות ה-CURL הבאות בצומת של שרת הניהול.
- בודקים את סטטוס המשתמש והארגון בשרת הניהול על ידי הנפקת פקודות ה-CURL הבאות:
> curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/users
> curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizationsploy>http://localhost:8080/v1/organizationsploy> - אם הפעלתם את ניתוח הנתונים, משתמשים בפקודה הבאה:
> curl -u <adminEmail>:<admin passwd> http://localhost:8080/v1/organizations/<orgname>/environments/<envname>/provider/axstatus - אפשר גם לבדוק את הסטטוס של מסד הנתונים PostgreSQL על ידי הרצת הפקודה הבאה ב-Machine 2 כדי להפעיל את psql:
> psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee
בשורת הפקודה, מזינים את הפקודה הבאה כדי להציג את טבלת analytics.org.
עבור הארגון
.org .org API : - גישה לממשק המשתמש של Apigee Edge באמצעות דפדפן אינטרנט. חשוב לזכור שכבר ציינת
את כתובת ה-URL של מסוף הניהול בסוף ההתקנה.
- מפעילים את הדפדפן המועדף ומזינים את כתובת ה-URL של ממשק המשתמש של Edge. היא נראית כך
בדוגמה הבאה, שבה כתובת ה-IP היא של מחשב 1, או של המחשב שבו התקנת את ממשק המשתמש עבור הגדרות חלופיות:
http://192.168.56.111:9000/login
9000 הוא מספר היציאה המשמש את ממשק המשתמש. אם מפעילים את הדפדפן ישירות בשרת שמארח את ממשק המשתמש של Edge, אפשר להשתמש בכתובת URL בטופס:
http://localhost:9000/login
הערה: יש לוודא שיציאה 9000 פתוחה. - בדף ההתחברות למסוף, מציינים את שם המשתמש/הסיסמה של מנהל המערכת ב-Apigee.
הערה: זוהי הסיסמה של מנהל המערכת הגלובלי שהגדרתם במהלך ההתקנה. אפשרות נוספת:
- מפעילים את הדפדפן המועדף ומזינים את כתובת ה-URL של ממשק המשתמש של Edge. היא נראית כך
בדוגמה הבאה, שבה כתובת ה-IP היא של מחשב 1, או של המחשב שבו התקנת את ממשק המשתמש עבור הגדרות חלופיות:
- נרשמים לחשבון משתמש חדש ב-Apigee ומשתמשים בפרטי הכניסה החדשים של המשתמש כדי להתחבר.
- לוחצים על 'כניסה' בדפדפן מפנה לכתובת:
http://192.168.56.111:9000/platform/#/<orgname>/
ונפתח מרכז בקרה שמאפשר להגדיר את הארגון שנוצר לפני כן (אם מחוברים באמצעות פרטי כניסה של אדמין ב-Apigee). - משתמשים חדשים ב-Edge יכולים ליצור עכשיו את שרת ה-API הראשון של proxy. מידע נוסף זמין במאמר יצירת שרת proxy ראשון ל-API.
בנוסף, עיינו בקטעים בנושא דוגמאות, כולל רשימת הדוגמאות וממשקי ה-API הדמייים ל-RESTful שבהם תוכלו להשתמש בניסויים משלכם לבניית API ב-Mock Target API.
- לוחצים על 'כניסה' בדפדפן מפנה לכתובת: