इस पेज का अनुवाद Cloud Translation API से किया गया है.

एक संगठन, एनवायरमेंट, और वर्चुअल होस्ट बनाना

कमांड लाइन पर संगठन, एनवायरमेंट, और वर्चुअल होस्ट को एक साथ बनाया जा सकता है कमांड का इस्तेमाल करें या आप हर एक को अलग-अलग बना सकते हैं. इसके अलावा, आपको Edge एपीआई का इस्तेमाल करें.

वीडियो: Apigee संगठन के सेटअप और कॉन्फ़िगरेशन की खास जानकारी के लिए यह छोटा वीडियो देखें.

संगठन बनाना, और वर्चुअल होस्ट को एक साथ

Apigee Edge पर एपीआई प्रॉक्सी बनाने से पहले, आपको कम से कम एक संगठन बनाना होगा और, एक या एक से ज़्यादा एनवायरमेंट और वर्चुअल होस्ट का इस्तेमाल करता हो.

ध्यान दें: वर्चुअल होस्ट बनाते समय, आपको राऊटर तय करना होगा वर्चुअल होस्ट द्वारा उपयोग किया गया पोर्ट.

उदाहरण के लिए, पोर्ट 9001. डिफ़ॉल्ट रूप से, राऊटर उपयोगकर्ता "apigee" के तौर पर चलता है जिसके पास खास पोर्ट का ऐक्सेस नहीं है. आम तौर पर, ये पोर्ट 1024 और उससे पहले के होते हैं. राऊटर को सुरक्षित पोर्ट से बाइंड करने वाला वर्चुअल होस्ट बनाने के लिए, आपको उपयोगकर्ता के तौर पर इस्तेमाल करने के लिए राऊटर, जिसके पास उन पोर्ट का ऐक्सेस हो.

ज़्यादा जानकारी के लिए, वर्चुअल होस्ट सेट अप करना देखें.

आम तौर पर, संगठन और एनवायरमेंट एक साथ बनाए जाते हैं. इस प्रक्रिया को आसान बनाने के लिए, apigee-provision उपयोगिता. इसे Edge Management पर कमांड लाइन से शुरू करें सर्वर:

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

जहां configFile, उस कॉन्फ़िगरेशन फ़ाइल का पाथ है जो फ़ॉलो किया जा रहा है:

# Set Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=admin_password  # If omitted, you are prompted for it.
NEW_USER="y"
USER_NAME=orgAdmin@myCo.com
FIRST_NAME=foo
LAST_NAME=bar
USER_PWD="userPword"
ORG_NAME=example  # lowercase only, no spaces, underscores, or periods.
ENV_NAME=prod  # lowercase only
VHOST_PORT=9001
VHOST_NAME=default
VHOST_ALIAS="$IP1: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.
# Optionally set the base URL displayed by the Edge UI for an
# API proxy deployed to the virtual host.
# VHOST_BASEURL="http://myCo.com"
# AXGROUP=axgroup-001 # Default value is axgroup-001

अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

किसी संगठन को सेट अप करते समय, setup-org स्क्रिप्ट ये काम करती है:

संगठन बनाता है.
ध्यान दें: संगठन बनाने के बाद, उसका नाम नहीं बदला जा सकता नहीं.
संगठन को "गेटवे" से जोड़ता है पॉड. इसे बदला नहीं जा सकता.
चुने गए उपयोगकर्ता को संगठन के एडमिन के तौर पर जोड़ता है. अगर उपयोगकर्ता मौजूद नहीं है, तो बना सकते हैं.
एक या उससे ज़्यादा एनवायरमेंट बनाता है.
हर एनवायरमेंट के लिए एक या उससे ज़्यादा वर्चुअल होस्ट बनाता है.
एनवायरमेंट को सभी मैसेज प्रोसेसर से जोड़ता है.
आंकड़े सक्षम करता है.

डिफ़ॉल्ट रूप से, संगठन का नाम और एनवायरमेंट का नाम ज़्यादा से ज़्यादा 20 वर्ण का हो सकता है apigee-provision सुविधा का इस्तेमाल करते समय. यह सीमा लागू नहीं होती है, अगर आप सीधे Edge API का इस्तेमाल करके, संगठन या एनवायरमेंट बनाएं. संगठन का नाम और एनवायरमेंट, दोनों नाम अंग्रेज़ी के छोटे अक्षरों में होना चाहिए.

ध्यान दें: apigee-provision का इस्तेमाल करने के बजाय यूटिलिटी बनाने के लिए, अतिरिक्त स्क्रिप्ट के सेट का या खुद Edge API का इस्तेमाल किया जा सकता है एक संगठन. उदाहरण के लिए, किसी संगठन को जोड़ने और उसे एक से ज़्यादा पॉड चुनें. इन सेक्शन में, उन स्क्रिप्ट और एपीआई के बारे में ज़्यादा जानकारी दी गई है.

संगठन बनाना

संगठन बनाने के लिए, create-org कमांड का इस्तेमाल करें. इसका उदाहरण यहां दिया गया है दिखाता है:

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

यह स्क्रिप्ट संगठन बनाती है, लेकिन एनवायरमेंट को जोड़ती या कॉन्फ़िगर नहीं करती और एपीआई कॉल हैंडल करने के लिए संगठन के लिए ज़रूरी वर्चुअल होस्ट.

कॉन्फ़िगरेशन फ़ाइल में संगठन का नाम और संगठन का ईमेल पता शामिल होता है एडमिन. name एट्रिब्यूट में इस्तेमाल किए जा सकने वाले वर्णों का इस्तेमाल सिर्फ़ इन वर्णों तक किया जा सकता है a-z0-9\-$%. नाम में स्पेस, फ़ुल स्टॉप या अंग्रेज़ी के बड़े अक्षरों का इस्तेमाल न करें:

APIGEE_ADMINPW=admin_password    # If omitted, you are prompted for it.
ORG_NAME=example  # lowercase only, no spaces, underscores, or periods.
ORG_ADMIN=orgAdmin@myCo.com

create-org स्क्रिप्ट:

संगठन बनाता है.
संगठन को "गेटवे" से जोड़ता है पॉड.
चुने गए उपयोगकर्ता को संगठन के एडमिन के तौर पर जोड़ता है. उपयोगकर्ता पहले से मौजूद होना चाहिए; ऐसा नहीं करने पर, स्क्रिप्ट में कोई गड़बड़ी हो जाती है.

ध्यान दें: एक ही नाम से दो संगठन नहीं बनाए जा सकते. उस स्थिति में, दूसरा बनाना विफल हो जाएगा, जैसे:

<Error>
  <Code>organizations.OrganizationAlreadyExists</Code>
  <Message>Organization : test already exists</Message>
  <Contexts/>
</Error>

संगठन बनाने के लिए, एपीआई कॉल

संगठन बनाने के लिए, इन एपीआई कॉल का इस्तेमाल किया जा सकता है. पहले कॉल से संगठन:

curl -H "Content-Type:application/xml" -u sysAdminEmail:adminPasswd \
  -X POST http://management_server_IP:8080/v1/organizations \
  -d '<Organization name="org_name" type="paid"/>'

अगला कॉल, संगठन को पॉड से जोड़ता है:

curl -H "Content-Type:application/x-www-form-urlencoded" \
  -u sysAdminEmail:adminPasswd -X POST \
  http://management_server_IP:8080/v1/organizations/org_name/pods \
  -d "region=default&pod=gateway"

आखिरी कॉल में किसी मौजूदा उपयोगकर्ता को संगठन के एडमिन के तौर पर जोड़ा जाता है:

curl -H "Content-Type:application/xml" -u sysAdminEmail:adminPasswd \
  -X POST http://<ms-ip>:8080/v1/organizations/org_name/users/user_email/userroles/ \
  -d '<Roles><Role name="orgadmin"/></Roles>'

अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

ध्यान दें: फ़िलहाल, Private Cloud के लिए Apigee Edge में ये भूमिकाएं असाइन की जा सकती हैं: संगठन, opsadmin, उपयोगकर्ता, और Businessuser, सभी के पास इकाइयों के पूरे ऐक्सेस की डिफ़ॉल्ट अनुमति होती है Apigee संगठन में एपीआई, एपीआई प्रॉडक्ट, ऐप्लिकेशन, डेवलपर, और रिपोर्ट. इसके आधार पर ग्राहक की ज़रूरतों के लिए, आप पहले से तय की गई भूमिकाओं को कस्टमाइज़ कर सकते हैं या ज़्यादा जटिल भूमिकाओं को कॉन्फ़िगर कर सकते हैं और अनुमतियां मिलती हैं जो RBAC API का इस्तेमाल करते हैं. यहां जाएं: http://apigee.com/docs/api/user-roles.

ध्यान दें कि readonlyadmin की भूमिका सिर्फ़ क्लाउड में उपलब्ध है.

अगर उपयोगकर्ता मौजूद नहीं है, तो नीचे दिए गए कॉल का इस्तेमाल करके, उपयोगकर्ता खाता बनाएं. इसके बारे में यहां बताया गया है उपयोगकर्ता जोड़ना.

एक एनवायरमेंट बनाएं

किसी मौजूदा संगठन में एनवायरमेंट बनाने के लिए, add-env स्क्रिप्ट का इस्तेमाल करें:

/opt/apigee/apigee-service/bin/apigee-service apigee-provision add-env -f configFile

इस कॉन्फ़िगरेशन फ़ाइल में, एनवायरमेंट और वर्चुअल इवेंट बनाने के लिए ज़रूरी जानकारी शामिल है होस्ट:

APIGEE_ADMINPW=admin_password  # If omitted, you are prompted for it.
ORG_NAME=example  # lowercase only, no spaces, underscores, or periods.
ENV_NAME=prod  # lowercase only
VHOST_PORT=9001
VHOST_NAME=default
VHOST_ALIAS="$IP1: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. 
# Optionally set the base URL displayed by the Edge UI for an
# API proxy deployed to the virtual host.
# VHOST_BASEURL="http://myCo.com"
# AXGROUP=axgroup-001 # Default value is axgroup-001

अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

add-env निर्देश:

एनवायरमेंट बनाता है.
यह एनवायरमेंट के लिए एक वर्चुअल होस्ट बनाता है.
एनवायरमेंट को, मैसेज प्रोसेसर के पॉड में मौजूद सभी मैसेज प्रोसेसर के साथ जोड़ता है: संगठन की स्थिति में शामिल है.
आंकड़े चालू करता है
ध्यान दें: अगर आपने किसी एक एनवायरमेंट के लिए आंकड़े देखने की सुविधा चालू की है, तो आपको संगठन के सभी एनवायरमेंट के लिए आंकड़े देखने की सुविधा चालू करनी होगी.

एनवायरमेंट बनाने के लिए, एपीआई कॉल

इसके अलावा, एनवायरमेंट बनाने के लिए इन एपीआई कॉल का इस्तेमाल किया जा सकता है. पहला कॉल वातावरण बनाता है:

curl -H "Content-Type:application/xml" -u sysAdminEmail:adminPasswd \
  -X POST http://management_server_IP:8080/v1/organizations/org_name/environments \
  -d '<Environment name="env_name"/>'

अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

अगला कॉल, एनवायरमेंट को मैसेज प्रोसेसर से जोड़ता है. हर एक के लिए यह कॉल करें मैसेज प्रोसेसर, जिसे आपको एनवायरमेंट के साथ जोड़ना है:

curl -H "Content-Type:application/x-www-form-urlencoded" \
  -u sysAdminEmail:adminPasswd -X POST \
  http://management_server_IP:8080/v1/organizations/org_name/environments/env_name/servers \
  -d "action=add&uuid=uuid"

जहां uuid, मैसेज प्रोसेसर का यूयूआईडी है. यूयूआईडी पाने के लिए, आदेश:

curl http://Message_Processor_IP:8082/v1/servers/self

जहां Message_Processor_IP, मैसेज प्रोसेसर का आईपी पता होता है.

अगला एपीआई कॉल, किसी दिए गए एनवायरमेंट के लिए Analytics को चालू करता है. यह टूल, Google News सभी डेटासेंटर के POD में Qpid और Postgres सर्वर. इसके बाद, Analytics में शामिल होना शुरू होता है का इस्तेमाल किया जा सकता है.

ध्यान दें: नीचे दिए गए एपीआई कॉल का इस्तेमाल करने के बजाय, Analytics को सक्षम करने के लिए इस निर्देश का पालन करें:

/opt/apigee/apigee-service/bin/apigee-service apigee-provision enable-ax -f configFile

इस कॉन्फ़िगरेशन फ़ाइल में यह शामिल है:

ORG_NAME=orgName  # lowercase only, no spaces, underscores, or periods.
ENV_NAME=envName  # lowercase only

अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

ध्यान दें: अगर आपने किसी एक एनवायरमेंट के लिए आंकड़े देखने की सुविधा चालू की है, तो तो आपको संगठन के सभी एनवायरमेंट के लिए आंकड़े देखने की सुविधा चालू करनी होगी:

curl -H "Content-Type:application/json" -u sysAdminEmail:adminPasswd \
  -X POST http://management_server_IP:8080/v1/organizations/org_name/environments/env_name/analytics/admin -d "@sample.json"

जहां sample.json में ये शामिल हैं:

{
  "properties" : {
    "samplingAlgo" : "reservoir_sampler",
    "samplingTables" : "10=ten;1=one;",
    "aggregationinterval" : "300000",
    "samplingInterval" : "300000",
    "useSampling" : "100",
    "samplingThreshold" : "100000"
  },
  "servers" : {
    "postgres-server" : [ "1acff3a5-8a6a-4097-8d26-d0886853239c", "f93367f7-edc8-4d55-92c1-2fba61ccc4ab" ],  
    "qpid-server" : [ "d3c5acf0-f88a-478e-948d-6f3094f12e3b", "74f67bf2-86b2-44b7-a3d9-41ff117475dd"] 
  }
}

postgres-servers प्रॉपर्टी इसमें Postgres UUID की ऐसी सूची मौजूद है जिसे कॉमा लगाकर अलग किया गया है. साथ ही, qpid-server प्रॉपर्टी में Qpid UUID शामिल हैं. अगर आपको ये यूयूआईडी चाहिए, तो इन निर्देशों का इस्तेमाल करें.

Qpid के लिए, नीचे दिया गया निर्देश चलाएं:

curl -u sysAdminEmail:password http://management_server_IP/v1/servers?pod=central

इस निर्देश का आउटपुट एक JSON ऑब्जेक्ट है. हर Qpid सर्वर के लिए, आपको फ़ॉर्म:

"type" : [ "qpid-server" ],
"uUID" : "d3c5acf0-f88a-478e-948d-6f3094f12e3b"

Postgres के लिए, नीचे दिया गया कमांड चलाएं:

curl -u sysAdminEmail:admin_password http://management_server_IP/v1/servers?pod=analytics

हर Postgres सर्वर का आउटपुट, आपको इस फ़ॉर्मैट में दिखेगा:

"type" : [ "postgres-server" ],
"uUID" : "d3c5acf0-f88a-478e-948d-6f3094f12e3b"

वर्चुअल होस्ट बनाएं

किसी संगठन में मौजूदा एनवायरमेंट में वर्चुअल होस्ट बनाया जा सकता है. अक्सर एनवायरमेंट में कई वर्चुअल होस्ट काम करते हैं. उदाहरण के लिए, एक वर्चुअल होस्ट, एचटीटीपी प्रोटोकॉल, जबकि उसी एनवायरमेंट में कोई दूसरा वर्चुअल होस्ट एन्क्रिप्ट (सुरक्षित) किए गए एचटीटीपीएस पर काम करता है प्रोटोकॉल का इस्तेमाल करना चाहिए.

अतिरिक्त वर्चुअल होस्ट बनाने या वर्चुअल होस्ट बनाने के लिए, नीचे दिए गए एपीआई कॉल का इस्तेमाल करें बिना वर्चुअल होस्ट वाला वातावरण:

curl -H "Content-Type:application/xml" -u sysAdminEmail:adminPasswd \
  -X POST http://management_server_IP:8080/v1/organizations/org_name/environments/env_name/virtualhosts \
  -d '<VirtualHost name="default"> \
    <HostAliases> \
      <HostAlias>myorg-test.apigee.net</HostAlias> \
    </HostAliases> \
    <Interfaces/> \
    <Port>443</Port> \
  </VirtualHost>'

अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है

ध्यान दें: नाम एट्रिब्यूट में, ये वर्ण इस्तेमाल किए जा सकते हैं a-zA-Z0-9._\-$% तक सीमित.

वर्चुअल होस्ट बनाने के बारे में पूरी जानकारी. इसमें सुरक्षित वर्चुअल होस्ट बनाना भी शामिल है एचटीटीपीएस पर TLS/एसएसएल का इस्तेमाल करने वाला होस्ट. इसके लिए, एपीआई के लिए TLS ऐक्सेस कॉन्फ़िगर करना प्राइवेट क्लाउड के लिए.