דף זה תורגם על ידי Cloud Translation API.

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

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

למידע נוסף על אופן ההגדרה של המארח הווירטואלי, ראה הגדרת מארח וירטואלי.
להגדרת TLS/SSL, ראו Keystores ו Truststores והגדרה מידע נוסף על יצירת קובץ ה-JAR זמין ב-TLS (אבטחת שכבת התעבורה) ל-API של הענן הפרטי. והיבטים אחרים של הגדרת TLS/SSL.
למידע נוסף על הגדרת מארחים וירטואליים, ראו הגדרת גישת TLS API לענן הפרטי.
אי אפשר ליצור שני ארגונים עם אותו שם. במקרה כזה, פעולת היצירה השנייה נכשל.

ביצוע ההגדרה של הארגון

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

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

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

כדי להפעיל את setup-org:

התקנת apigee-provision בצומת שרת הניהול:

/opt/apigee/apigee-service/bin/apigee-service apigee-provision install

מריצים את הסקריפט setup-org בצומת של שרת הניהול ומכוונים אותו אל קובץ התצורה שיצרת ביצירת מערך הגדרות אישיות. file:
```
/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 של מסוף הניהול, בסוף ההתקנה.
1. מפעילים את הדפדפן המועדף ומזינים את כתובת ה-URL של ממשק המשתמש של Edge. נראה דומה ל- שבה כתובת ה-IP היא של צומת 1 (כפי שמוצג טופולוגיות של התקנה), או בכל צומת שבו אתם התקין את ממשק המשתמש להגדרות חלופיות:
```
http://192.168.56.111:9000/login
```
  9000 הוא מספר היציאה שמשמש את ממשק המשתמש.
  
  אם מפעילים את הדפדפן ישירות בשרת שמארח את ממשק המשתמש של Edge, יכול להשתמש בכתובת URL בתבנית:
```
http://localhost:9000/login
```
  הערה: חשוב לוודא שהיציאה 9000 פתוחה. אם אתם באמצעות שירות כמו Google Cloud Engine, יכול להיות שתצטרכו לשנות את כללי חומת האש, שניתן לגשת לשירותי Apigee דרך דפדפן.
2. בדף ההתחברות של המסוף, מציינים את שם המשתמש/הסיסמה של מנהל המערכת של Apigee.
  הערה: זהו אדמין המערכת הגלובלי הסיסמה שהגדרתם במהלך ההתקנה.
נרשמים לחשבון משתמש חדש ב-Apigee ומשתמשים בפרטי הכניסה של המשתמש החדש כדי להתחבר. ב דף הכניסה למסוף, לוחצים על הלחצן Sign In (כניסה).

הדפדפן מפנה מחדש לכתובת http://192.168.56.111:9000/platform/#/org_name/ ונפתח מרכז בקרה שמאפשר לכם להגדיר את הארגון שיצרתם (אם רשמתם באמצעות פרטי כניסה של אדמין ב-Apigee).

יצירת שרת ה-proxy הראשון

לאחר הקליטה של ארגון חדש ותוודאו שתהליך ההצטרפות עכשיו אפשר ליצור את שרת ה-Proxy הראשון. מידע נוסף זמין במאמר בניית שרת ה-proxy הראשון ל-API.

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