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

Edge for Private Cloud גרסה 4.16.05

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

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

אפשר ליצור משתמש חדש שישמש כמנהל החשבון הארגוני.

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

קובץ תצורה שקט להצטרפות

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

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

הדרישה היחידה בהתקנות שקטות היא שקובץ התצורה יהיה נגיש או קריא למשתמש "apigee". לדוגמה, אפשר לשים את הקובץ בספרייה ‎ /tmp בצומת.

בהמשך מוצגת דוגמה לקובץ תצורה שקט. עורכים אותו לפי הצורך:

IP1=192.168.1.1

# Specify the IP or DNS name of the Management Server.
MSIP="$IP1"

# Specify the Edge admin credentials.
ADMIN_EMAIL="admin@email.com"
APIGEE_ADMINPW=adminPassword     # If omitted, you are prompted for it.

# Specify organization name and administrator.
ORG_NAME=myorg  # lowercase only, no spaces, underscores, or periods.

#
# Set the organization administrator.
# Do not use sys admin as 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

# 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, עיינו במאמר הגדרת מארח וירטואלי לקבלת מידע נוסף.
• כדי להגדיר TLS/SSL, קראו את המאמרים Keystores and Truststores ו-Configuring TLS/SSL for Edge On Premises. במאמרים האלה מוסבר איך ליצור את קובץ ה-JAR ואיך להגדיר את TLS/SSL.

תהליך הגדרה

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". לדוגמה, אפשר לשים את הקובץ בספרייה ‎ /tmp בצומת.

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

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