כדי להצטרף לארגון, צריך ליצור קובץ תצורה לתהליך קליטת שותף ולאחר מכן להעביר אותו
לפקודה 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
:
- התקנה של
apigee-provision
בצומת של שרת הניהול:/opt/apigee/apigee-service/bin/apigee-service apigee-provision install
- מריצים את הסקריפט
setup-org
בצומת של שרת הניהול ומכוונים אותו לקובץ התצורה שיצרתם ביצירת קובץ תצורה לתחילת השימוש:/opt/apigee/apigee-service/bin/apigee-service apigee-provision setup-org -f configFile
קובץ התצורה חייב להיות קריא למשתמש "apigee".
- עליך לוודא שהשלמת את ההגדרה של ארגון. אחת הדרכים לעשות זאת היא להתחבר
לממשק המשתמש באמצעות בקשת כתובת ה-URL הבאה בדפדפן:
http://IP_address:9000/login
IP_address היא כתובת ה-IP של השרת שבו התקנת את ממשק המשתמש של Edge.
שלבי אימות נוספים זמינים במאמר אימות תהליך ההצטרפות.
- רוצים ליצור את שרת ה-Proxy הראשון שלכם?
אימות תהליך ההצטרפות
בסיום תהליך ההצטרפות, מאמתים את סטטוס המערכת על ידי הנפקת הפקודות הבאות של 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/org_name/deployments
- כדי לבדוק את ניתוח הנתונים, מריצים את הפקודה הבאה:
curl -u adminEmail:admin_password http://localhost:8080/v1/organizations/org_name/environments/env_name/provisioning/axstatus
- בודקים את הסטטוס של מסד הנתונים PostgreSQL על ידי הרצת הפקודות הבאות בצומת 2
(כפי שמוצג בטופולוגיות ההתקנה):
psql -h /opt/apigee/var/run/apigee-postgresql -U apigee apigee
בשורת הפקודה, מזינים את הפקודה הבאה כדי להציג את טבלת ניתוח הנתונים של הארגון:
\d analytics."org_name.env_name.fact"
כדי לצאת מ-psql, משתמשים בפקודה הבאה:
\q
- גישה לממשק המשתמש של Apigee Edge באמצעות דפדפן אינטרנט. חשוב לזכור שכבר ציינת את
כתובת ה-URL של מסוף הניהול בסוף ההתקנה.
- מפעילים את הדפדפן המועדף ומזינים את כתובת ה-URL של ממשק המשתמש של Edge. היא נראית כך
בדוגמה הבאה, שבה כתובת ה-IP היא של צומת 1 (כפי שמוצג
בטופולוגיות ההתקנה), או
הצומת שבו התקנת את ממשק המשתמש לתצורות חלופיות:
http://192.168.56.111:9000/login
9000 הוא מספר היציאה המשמש את ממשק המשתמש.
אם מפעילים את הדפדפן ישירות בשרת שמארח את ממשק המשתמש של Edge, אפשר להשתמש בכתובת URL בפורמט הבא:
http://localhost:9000/login
- בדף ההתחברות למסוף, מציינים את שם המשתמש/הסיסמה של מנהל המערכת ב-Apigee.
- מפעילים את הדפדפן המועדף ומזינים את כתובת ה-URL של ממשק המשתמש של Edge. היא נראית כך
בדוגמה הבאה, שבה כתובת ה-IP היא של צומת 1 (כפי שמוצג
בטופולוגיות ההתקנה), או
הצומת שבו התקנת את ממשק המשתמש לתצורות חלופיות:
- נרשמים לחשבון משתמש חדש ב-Apigee ומשתמשים בפרטי הכניסה החדשים של המשתמש כדי להתחבר. בדף הכניסה למסוף, לוחצים על הלחצן Sign In [כניסה].
הדפדפן מפנה לכתובת
http://192.168.56.111:9000/platform/#/org_name/
ופותח מרכז בקרה שמאפשר לך להגדיר את הארגון שיצרת (אם התחברת באמצעות פרטי כניסה של אדמין ב-Apigee).
יצירת שרת ה-proxy הראשון
אחרי שמצטרפים לארגון חדש ומאמתים שתהליך ההצטרפות הסתיים בהצלחה, אפשר ליצור את שרת ה-proxy הראשון. למידע נוסף, ניתן לעיין במאמר בניית שרת ה-API הראשון שלכם ל-API.
מקורות מידע נוספים שעשויים להועיל לך: