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

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

ভিডিও: Apigee অর্গানাইজেশন সেটআপ এবং কনফিগারেশনের একটি সংক্ষিপ্ত বিবরণের জন্য একটি ছোট ভিডিও দেখুন।

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

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

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

/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 স্ক্রিপ্ট নিম্নলিখিত কাজ করে:

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

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

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

একটি সংগঠন তৈরি করতে create-org কমান্ড ব্যবহার করুন, যেমনটি নিম্নলিখিত উদাহরণটি দেখায়:

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

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

কনফিগারেশন ফাইলটিতে প্রতিষ্ঠানের নাম এবং প্রতিষ্ঠানের প্রশাসকের ইমেল ঠিকানা রয়েছে। 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 স্ক্রিপ্ট:

  • সংগঠন তৈরি করে।
  • সংগঠনটিকে "গেটওয়ে" পডের সাথে যুক্ত করে।
  • সংস্থার প্রশাসক হিসাবে নির্দিষ্ট ব্যবহারকারীকে যুক্ত করে৷ ব্যবহারকারী অবশ্যই বিদ্যমান থাকতে হবে; অন্যথায় স্ক্রিপ্ট একটি ত্রুটি ইস্যু করে।

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

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

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"

চূড়ান্ত কলটি 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=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 কমান্ড:

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

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

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

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 হল মেসেজ প্রসেসরের UUID। আপনি কমান্ড ব্যবহার করে UUID পেতে পারেন:

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

যেখানে Message_Processor_IP হল মেসেজ প্রসেসরের IP ঠিকানা।

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

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

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

যেখানে 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 সম্পত্তিতে পোস্টগ্রেস UUID-এর একটি কমা-বিচ্ছিন্ন তালিকা রয়েছে এবং qpid-server সম্পত্তিতে Qpid UUID গুলি রয়েছে। আপনি যদি এই 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"

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

curl -u sysAdminEmail:admin_password http://management_server_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://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>'

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