একটি সংস্থা, পরিবেশ এবং ভার্চুয়াল হোস্ট তৈরি করা

ব্যক্তিগত ক্লাউডের জন্য প্রান্ত v. 4.17.09

একই সময়ে একটি সংস্থা, পরিবেশ এবং ভার্চুয়াল হোস্ট তৈরি করা

আপনি Apigee Edge-এ একটি API প্রক্সি তৈরি করার আগে, আপনাকে অবশ্যই কমপক্ষে একটি সংস্থা তৈরি করতে হবে এবং প্রতিটি সংস্থার মধ্যে, এক বা একাধিক পরিবেশ এবং ভার্চুয়াল হোস্ট তৈরি করতে হবে৷

সাধারণত, সংগঠন এবং পরিবেশ একসাথে তৈরি করা হয়। প্রক্রিয়াটি সহজ করতে, অ্যাপিজি-প্রভিশন ইউটিলিটি ব্যবহার করুন। এজ ম্যানেজমেন্ট সার্ভারের কমান্ড লাইন থেকে এটিকে আহ্বান করুন:

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

কনফিগারেশন ফাইলটিতে রয়েছে:

# Set Edge sys admin credentials.
ADMIN_EMAIL=your@email.com
APIGEE_ADMINPW=adminPword     # If omitted, you are prompted for it.
NEW_USER="y"
USER_NAME=orgAdmin@myCo.com
FIRST_NAME=foo
LAST_NAME=bar
USER_PWD="userPwrod"
ORG_NAME=example  # lowercase only, no spaces, underscores, or periods.
ENV_NAME=prod
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 

তারপর আদেশ:

  • সংগঠন তৈরি করুন
    দ্রষ্টব্য : আপনি এটি তৈরি করার পরে আপনি একটি সংস্থার নাম পরিবর্তন করতে পারবেন না।
  • প্রতিষ্ঠানটিকে একটি পডের সাথে সংযুক্ত করুন, ডিফল্টরূপে এটিকে "গেটওয়ে" পডের সাথে সংযুক্ত করে৷
  • org অ্যাডমিন হিসাবে নির্দিষ্ট ব্যবহারকারী যোগ করুন. ব্যবহারকারীর অস্তিত্ব না থাকলে, আপনি একটি তৈরি করতে পারেন।
  • এক বা একাধিক পরিবেশ তৈরি করুন
  • প্রতিটি পরিবেশের জন্য এক বা একাধিক ভার্চুয়াল হোস্ট তৈরি করুন
  • সমস্ত বার্তা প্রসেসরের সাথে পরিবেশকে সংযুক্ত করুন
  • বিশ্লেষণ সক্রিয় করুন

একটি সম্পূর্ণ নীরব কনফিগার ফাইলের জন্য, অনবোর্ড একটি সংস্থা দেখুন।

ডিফল্টরূপে, apigee-provision ইউটিলিটি ব্যবহার করার সময় প্রতিষ্ঠানের নাম এবং পরিবেশের নামের সর্বোচ্চ দৈর্ঘ্য 20 অক্ষর। যদি আপনি সংস্থা বা পরিবেশ তৈরি করতে সরাসরি এজ এপিআই ব্যবহার করেন তবে এই সীমা প্রযোজ্য নয়।

একটি সংস্থা তৈরি করুন

একটি প্রতিষ্ঠান তৈরি করতে create-org কমান্ড ব্যবহার করুন:

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

এই স্ক্রিপ্টটি সংস্থা তৈরি করে, কিন্তু API কলগুলি পরিচালনা করার জন্য সংস্থার প্রয়োজনীয় পরিবেশ এবং ভার্চুয়াল হোস্টগুলি যোগ বা কনফিগার করে না।

কনফিগার ফাইলটিতে org এর নাম এবং org অ্যাডমিনের ইমেল ঠিকানা রয়েছে। নামের বৈশিষ্ট্যে আপনি যে অক্ষরগুলি ব্যবহার করতে পারেন তা সীমাবদ্ধ: a-z0-9\-$%৷ নামের মধ্যে স্পেস, পিরিয়ড বা বড় হাতের অক্ষর ব্যবহার করবেন না:

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

তারপর আদেশ:

  • সংগঠন তৈরি করে
  • সংস্থাটিকে একটি পডের সাথে সংযুক্ত করে, ডিফল্টরূপে এটিকে "গেটওয়ে" পডের সাথে সংযুক্ত করে৷
  • নির্দিষ্ট ব্যবহারকারীকে org অ্যাডমিন হিসেবে যোগ করে। ব্যবহারকারী অবশ্যই বিদ্যমান থাকতে হবে; অন্যথায় স্ক্রিপ্ট একটি ত্রুটি ইস্যু করে।
<Error>
    <Code>organizations.OrganizationAlreadyExists</Code>
    <Message>Organization : test already exists</Message>
    <Contexts/>
</Error>

API কল ব্যবহার করে একটি সংস্থা তৈরি করুন

বিকল্পভাবে, আপনি একটি org তৈরি করতে নিম্নলিখিত API কলগুলি ব্যবহার করতে পারেন৷ প্রথম কলটি org তৈরি করে:

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

পরবর্তী কলটি একটি পডের সাথে org-কে যুক্ত করে:

curl -H "Content-Type:application/x-www-form-urlencoded" \
-u <sysAdminEmail>:<adminPasswd> -X POST \
http://<ms-ip>:8080/v1/organizations/<org-name>/pods \
-d "region=default&pod=gateway" 

আপনি একাধিক পডের সাথে সংগঠনটিকে সংযুক্ত করতে একাধিকবার এই কল করতে পারেন৷

চূড়ান্ত কলটি org-এর জন্য org অ্যাডমিন হিসাবে একজন বিদ্যমান ব্যবহারকারীকে যুক্ত করে:

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>'

যদি ব্যবহারকারীর অস্তিত্ব না থাকে, তাহলে আপনি ব্যবহারকারীকে যুক্ত করতে বর্ণিত ব্যবহারকারী তৈরি করতে নিম্নলিখিত কলটি ব্যবহার করতে পারেন।

একটি পরিবেশ তৈরি করুন

একটি বিদ্যমান প্রতিষ্ঠানে একটি পরিবেশ তৈরি করতে add-env কমান্ড ব্যবহার করুন:

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

এই কনফিগারেশন ফাইলটিতে পরিবেশ এবং ভার্চুয়াল হোস্ট তৈরি করার জন্য প্রয়োজনীয় তথ্য রয়েছে:

APIGEE_ADMINPW=adminPword    # If omitted, you are prompted for it.
ORG_NAME=example  # lowercase only, no spaces, underscores, or periods.
ENV_NAME=prod
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

আদেশ:

  • পরিবেশ তৈরি করে
  • পরিবেশের জন্য একটি একক ভার্চুয়াল হোস্ট তৈরি করে
  • পডের সমস্ত মেসেজ প্রসেসরের সাথে পরিবেশকে সংযুক্ত করে যে সংস্থার সাথে পরিবেশ রয়েছে।
  • বিশ্লেষণ সক্ষম করে
    দ্রষ্টব্য : আপনি যদি একটি প্রতিষ্ঠানের একটি পরিবেশের জন্য বিশ্লেষণ সক্ষম করেন, তাহলে আপনাকে অবশ্যই প্রতিষ্ঠানের সমস্ত পরিবেশের জন্য বিশ্লেষণ সক্রিয় করতে হবে।

API কল ব্যবহার করে একটি পরিবেশ তৈরি করুন

বিকল্পভাবে, আপনি একটি পরিবেশ তৈরি করতে নিম্নলিখিত API কলগুলি ব্যবহার করতে পারেন৷ প্রথম কল পরিবেশ তৈরি করে:

curl -H "Content-Type:application/xml" -u <sysAdminEmail>:<adminPasswd> \
-X POST http://<ms-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://<ms-ip>:8080/v1/organizations/<org-name>/environments/<env-name>/servers \
-d "action=add&uuid=<uuid>"

যেখানে " <uuid> " হল মেসেজ প্রসেসরের UUID। আপনি কমান্ড ব্যবহার করে UUID পেতে পারেন:

> curl http://<mp-ip>:8082/v1/servers/self

যেখানে " <mp-ip> " হল মেসেজ প্রসেসরের IP ঠিকানা।

পরবর্তী API কল একটি প্রদত্ত পরিবেশের জন্য Analytics সক্ষম করে। এটি সমস্ত ডেটাসেন্টারের POD-এ Qpid এবং Postgres সার্ভারের অস্তিত্বকে যাচাই করে। তারপরে এটি প্রদত্ত সংস্থা এবং পরিবেশের জন্য অ্যানালিটিক্স অনবোর্ডিং শুরু করে।

> /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
curl -H "Content-Type:application/json" -u <sysAdminEmail>:<adminPasswd> 
-X POST http://<ms-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"] 
  }
}

পোস্টগ্রেস-সার্ভার সম্পত্তিতে পোস্টগ্রেস UUID-এর একটি কমা-বিচ্ছিন্ন তালিকা রয়েছে এবং qpid-সার্ভার সম্পত্তিতে Qpid UUID গুলি রয়েছে। আপনি যদি এই UUID গুলি পেতে চান তবে নিম্নলিখিত কমান্ডগুলি ব্যবহার করুন৷

Qpid এর জন্য, কমান্ডটি চালান:

curl -u <sysAdminEmail>:<passwd> http://<ms-ip>/v1/servers?pod=central

এই কমান্ডের আউটপুট হল একটি JSON অবজেক্ট। প্রতিটি Qpid সার্ভারের জন্য, আপনি ফর্মটিতে আউটপুট দেখতে পাবেন:

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

পোস্টগ্রেসের জন্য, কমান্ডটি চালান:

curl -u <sysAdminEmail>:<passwd> http://<ms-ip>/v1/servers?pod=analytics

প্রতিটি পোস্টগ্রেস সার্ভারের জন্য, আপনি ফর্মটিতে আউটপুট দেখতে পাবেন:

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

একটি ভার্চুয়াল হোস্ট তৈরি করুন

আপনি একটি প্রতিষ্ঠানে বিদ্যমান পরিবেশে একটি ভার্চুয়াল হোস্ট তৈরি করতে পারেন। প্রায়শই একটি পরিবেশ একাধিক ভার্চুয়াল হোস্ট সমর্থন করে। উদাহরণস্বরূপ, একটি ভার্চুয়াল হোস্ট HTTP প্রোটোকল সমর্থন করতে পারে, যখন একই পরিবেশে অন্য একটি ভার্চুয়াল হোস্ট এনক্রিপ্ট করা HTTPS প্রোটোকল সমর্থন করে।

অতিরিক্ত ভার্চুয়াল হোস্ট তৈরি করতে বা ভার্চুয়াল হোস্ট ছাড়া পরিবেশের জন্য একটি ভার্চুয়াল হোস্ট তৈরি করতে নিম্নলিখিত API কলটি ব্যবহার করুন:

curl -H "Content-Type:application/xml" -u <sysAdminEmail>:<adminPasswd> \
-X POST \
http://<ms-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>' 

একটি ভার্চুয়াল হোস্ট তৈরির সম্পূর্ণ বিবরণের জন্য, HTTPS-এ TLS/SSL ব্যবহার করে এমন একটি সুরক্ষিত ভার্চুয়াল হোস্ট তৈরি করা সহ, ব্যক্তিগত ক্লাউডের জন্য একটি API-তে TLS অ্যাক্সেস কনফিগার করা দেখুন।