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

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

Edge for Private Cloud גרסה 4.18.05

צריך להשתמש בסקריפט 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 הראשון שלכם?

קובץ תצורה של תהליך קליטת שותף

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

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

הקטע הזה כולל קובץ תצורה לדוגמה לתחילת השימוש בארגון באמצעות setup-org.

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

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

מעתיקים את הדוגמה הבאה ועורכים אותה לפי הצורך כדי לצרף את הארגון:

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

במאמר יצירת ארגון, סביבה ומארח וירטואלי מוסבר איך משתמשים ב-Management API כדי להצטרף לארגון.

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

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

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