প্রাইভেট ক্লাউড কানেক্টরের জন্য Apigee API হাব কনফিগার করা

এই বিভাগে নেটওয়ার্ক, যাচাইকরণ এবং সংস্থা-নির্দিষ্ট সেটিংস সহ প্রাইভেট ক্লাউড কানেক্টরের জন্য Apigee API হাবের কনফিগারেশন ধাপগুলি বিশদে বর্ণনা করা হয়েছে।

প্রয়োজনীয় অনুমতি

পরিবেশ ও প্রক্সি বান্ডেল আপলোড করার বিষয়টি ম্যানেজ করার জন্য Apigee API Hub-এর সাথে একটি নতুন API Hub API ইন্টিগ্রেট করা হয়েছে, এর জন্য একটি নতুন IAM ভূমিকা প্রয়োজন। প্রয়োজনীয় অনুমতি দেওয়ার জন্য এটি একটি ম্যানুয়াল, এককালীন ধাপ।

সঠিক অনুমতি দিতে, নিম্নলিখিত gcloud কমান্ডটি একবার রান করুন:

  gcloud projects add-iam-policy-binding GCP_PROJECT_NAME \
    --member="serviceAccount:SERVICE_ACCOUNT" \
    --role="roles/apihub.admin"

এই কমান্ডটি নির্দিষ্ট পরিষেবা অ্যাকাউন্টের সাথে roles/apihub.admin ভূমিকাটি যুক্ত করে, যার ফলে কানেক্টর প্রয়োজনীয় অ্যাকশন নিতে পারে। প্লাগ-ইন ইনস্ট্যান্স তৈরি করার সময় যে পরিষেবা অ্যাকাউন্ট ব্যবহার করা হয়েছিল, এটি সেই অ্যাকাউন্ট কিনা তা নিশ্চিত করুন।

নেটওয়ার্ক ও যাচাইকরণ সেট-আপ

1. পোর্ট হোয়াইটলিস্ট করা: প্রয়োজনীয় API মেটাডেটা পেতে, Private Cloud কানেক্টরের জন্য Apigee API Hub-কে ম্যানেজমেন্ট সার্ভারের সাথে কানেক্ট করতে হয়, তাই কানেক্টরকে ম্যানেজমেন্ট সার্ভারের পোর্ট ৮০৮০ ও ৪৪৩-এ পৌঁছাতে হবে।
2. Google Cloud Platform পরিষেবার জন্য কী-ভিত্তিক যাচাইকরণ: প্রাইভেট ক্লাউড কানেক্টরের জন্য Apigee API হাব Google Cloud পরিষেবার সাথে যোগাযোগ করে এবং যাচাইকরণের জন্য টোকেন প্রয়োজন হয়। ছদ্মবেশী টোকেন তৈরি করার জন্য পরিষেবা অ্যাকাউন্ট কী ব্যবহার করে এটি অর্জন করা হয়।
   • টোকেন তৈরির জন্য পরিষেবা অ্যাকাউন্ট: টোকেন তৈরির জন্য একটি নতুন পরিষেবা অ্যাকাউন্ট তৈরি করুন। এই পরিষেবা অ্যাকাউন্টের Token Creator ভূমিকা থাকতে হবে।
   • পরিষেবা অ্যাকাউন্টের কী জেনারেট ও ডাউনলোড করা:
     • টোকেন-জেনারেটিং পরিষেবা অ্যাকাউন্টের জন্য JSON কী তৈরি করতে, পরিষেবা অ্যাকাউন্টের কী তৈরি করুন লিঙ্কে দেওয়া ধাপগুলি অনুসরণ করুন।
     • এই কী ফাইলটি ডাউনলোড করুন (যেমন, /opt/apigee/keys/uapim.key-এ Private Cloud কানেক্টর VM-এর জন্য Apigee API Hub-এ)।
   • সেট GOOGLE_APPLICATION_CREDENTIALS: Private Cloud কানেক্টরের জন্য Apigee API হাব চালু করার সময়, এনভায়রনমেন্ট ভেরিয়েবলের মাধ্যমে আপনাকে এই ফাইলের পাথ দিতে হবে:

     export $GOOGLE_APPLICATION_CREDENTIALS=/opt/apigee/keys/uapim.key

3. ম্যানেজমেন্ট API যাচাইকরণ (UAPIM_MGMT_AUTH): Private Cloud কানেক্টরের জন্য Apigee API Hub-কে Apigee ম্যানেজমেন্ট API কল করার জন্য ক্রেডেনশিয়াল প্রয়োজন। নিরাপত্তা ও অটোমেশনের জন্য, Apigee-তে কোনও মেশিন ব্যবহারকারীকে ব্যবহার করুন, কোনও হিউম্যান ব্যবহারকারীকে নয়।

   Apigee-তে মেশিন ব্যবহারকারী তৈরি করুন:

   1. ব্যবহারকারী তৈরি করুন:
      • Apigee কনসোলে, একটি মেশিন ব্যবহারকারী (বা সিস্টেম ব্যবহারকারী) তৈরি করুন। ব্যবহারকারী ও ভূমিকা সম্পর্কে আরও জানতে টোকেন তৈরি করার প্রসেস অটোমেট করুন।
      • একটি ইমেল (শনাক্তকরণের জন্য) ও একটি বর্ণনামূলক নাম (যেমন, uapim-connector-user) অ্যাসাইন করুন।
   2. ভূমিকা অ্যাসাইন করা: মেশিন ব্যবহারকারীকে নিম্নলিখিত ভূমিকা অ্যাসাইন করুন:
      • Apigee API অ্যাডমিন: এই ভূমিকা ম্যানেজমেন্ট API-তে অ্যাক্সেস প্রদান করে, যা Apigee API Hub for Private Cloud কানেক্টরকে Apigee-এর ম্যানেজমেন্ট সিস্টেমের সাথে ইন্টার‍্যাক্ট করতে দেয় (যেমন, মেটাডেটা ফেচ করা বা API কনফিগারেশন ম্যানেজ করা)।

Base64 এনকোড করা ক্রেডেনশিয়াল তৈরি করুন:

1. মেশিন ব্যবহারকারীর জন্য ব্যবহারকারীর নাম:পাসওয়ার্ডের পেয়ার তৈরি করুন।
2. ক্রেডেনশিয়াল Base64 এনকোড করুন: echo -n 'username:password' | base64
3. base64-এনকোড করা ভ্যালু সহ $UAPIM_MGMT_AUTH এনভায়রনমেন্ট ভেরিয়েবল সেট করুন:

   export UAPIM_MGMT_AUTH=USERNAME_PASSWORD

   যেখানে USERNAME_PASSWORD হল ইউজারনেম ও পাসওয়ার্ডের base64-এনকোডেড ভ্যালু।

   প্রাইভেট ক্লাউড কানেক্টরের জন্য Apigee API হাব শুরু করার আগে এই এনভায়রনমেন্ট ভেরিয়েবল সেট করা আছে কিনা তা নিশ্চিত করুন।

প্রাইভেট ক্লাউড কানেক্টরের জন্য Apigee API Hub কনফিগার করা

API Hub-এ ডেটা আপলোড করতে হবে এমন Apigee সংস্থার নাম নির্দিষ্ট করতে, কনফিগারেশন ফাইল /opt/apigee/customer/application/uapim-connector.properties খুলুন। আপনার একাধিক প্লাগ-ইন ইনস্ট্যান্স বা একাধিক API Hub ইনস্ট্যান্স থাকতে পারে।

  conf_uapim_connector.uapim.settings.json={\
    "connectorConfig" : { \
      "org1" : { \
        "runtimeDataPubsub" : "", \
        "metadataPubsub":"", \
        "serviceAccount": "mysa1@in.myfirstProject",\
        "pluginInstanceId":"aaaa" \
      },\
      "org2" : { \
        "runtimeDataPubsub" : "", \
        "metadataPubsub":"",\
        "serviceAccount": "mysa2@in.mySecondProject",\
        "pluginInstanceId":"bbbbb", \
      } 
    },
    "runtimeDataPath":"/the/nfs/mounted/path", \    
    "managementServer": "hostname"
  } 

সেটিংস JSON-এর ব্যাখ্যা

• connectorConfig বিভাগ:
  • এটি এমন একটি ম্যাপ যেখানে প্রতিটি কী হল একটি Apigee সংস্থার নাম (যেমন, org1, org2)।
  • প্রতিটি সংস্থার এন্ট্রিতে নিম্নলিখিত ফিল্ড থাকে, যা আপনি প্লাগ-ইন তৈরি করার ধাপের সময় পেয়েছেন:
    • runtimeDataPubsub: এই সংস্থার রানটাইম (analytics) ডেটার জন্য Pub/Sub বিষয়।
    • metadataPubsub: এই সংস্থার API মেটাডেটার জন্য Pub/Sub টপিক।
    • serviceAccount: এই সংস্থার জন্য Pub/Sub-এ ডেটা লেখার জন্য যাচাই করতে ব্যবহৃত পরিষেবা অ্যাকাউন্ট (যেমন, mysa1@in.myfirstProject.iam.gserviceaccount.com)।
    • pluginInstanceId: এই সংস্থার সাথে যুক্ত প্লাগ-ইনের অনন্য ইনস্ট্যান্স আইডি।
• runtimeDataPath বিভাগ: NFS মাউন্টের পাথ দিন যেখানে মেসেজ প্রসেসর Analytics (AX) ডেটা লিখবে। মেসেজ প্রসেসরে কনফিগার করা পাথ এবং এটি একই হতে হবে।
• managementServer বিভাগ: আপনার Apigee ম্যানেজমেন্ট সার্ভার URL-এর হোস্টনেম বা IP অ্যাড্রেস।
• এনভায়রনমেন্ট ভেরিয়েবল UAPIM_MGMT_AUTH: এই এনভায়রনমেন্ট ভেরিয়েবল, এক্সটার্নালি সেট করা হয়, এতে ম্যানেজমেন্ট সার্ভার অ্যাক্সেস করার জন্য base64 এনকোড করা username:password থাকে।

ফরোয়ার্ড প্রক্সি কনফিগারেশন যোগ করুন

একই ফাইলে ফরওয়ার্ড প্রক্সি কনফিগারেশন যোগ করুন /opt/apigee/customer/application/uapim-connector.properties

1. conf_http_client_service_jetty.proxy.enabled=true

2. conf_http_client_service_jetty.proxy.host=
3. conf_http_client_service_jetty.proxy.port=
4. conf_http_client_service_jetty.proxy.user=
5. conf_http_client_service_jetty.proxy.password=

কানেক্টর যাতে সঠিকভাবে কাজ করতে পারে, তার জন্য নিম্নলিখিত এক্সটার্নাল সোর্সের সাথে কানেক্ট করতে হবে:

• pubsub.googleapis.com:443
• oauth2.googleapis.com:443
• iamcredentials.googleapis.com:443

কানেক্টরকে যদি সরাসরি এক্সটার্নাল সোর্সের সাথে কানেক্ট করার অনুমতি না দেওয়া হয়, তবে ফরওয়ার্ড প্রক্সির মাধ্যমে কানেক্ট করতে হবে। সেক্ষেত্রে, ব্যবহারকারীকে নিম্নলিখিত কনফিগারেশনের মাধ্যমে ফরওয়ার্ড প্রক্সি কনফিগারেশন প্রদান করতে হবে এবং নিশ্চিত করতে হবে যে উপরে উল্লেখ করা এক্সটার্নাল সোর্সগুলি হোয়াইটলিস্ট করা আছে।

Private Cloud Connector-এর জন্য Apigee API Hub শুরু করা

সব কনফিগারেশন সেট করা হয়ে গেলে, Apigee পরিষেবা কমান্ড ব্যবহার করে Private Cloud কানেক্টরের জন্য Apigee API Hub চালু করুন:

apigee-service edge-uapim-connector start