MCP টুলবক্স সহ AlloyDB Agentic RAG অ্যাপ্লিকেশন

1. ভূমিকা

এই কোডল্যাবে, আপনি শিখবেন কিভাবে একটি AlloyDB ক্লাস্টার তৈরি করতে হয়, MCP টুলবক্সটি স্থাপন করতে হয় এবং এটিকে একটি ডেটা উৎস হিসাবে AlloyDB ব্যবহার করার জন্য কনফিগার করতে হয়। তারপরে আপনি একটি নমুনা ইন্টারেক্টিভ RAG অ্যাপ্লিকেশন তৈরি করবেন যা তার অনুরোধগুলিকে গ্রাউন্ড করতে স্থাপন করা টুলবক্স ব্যবহার করে।

আপনি ডকুমেন্টেশন পৃষ্ঠায় MCP টুলবক্স এবং এখানে সিম্বল এয়ার অ্যাপ্লিকেশনের নমুনা সম্পর্কে আরও তথ্য পেতে পারেন।

এই ল্যাবটি অ্যালোয়ডিবি এআই বৈশিষ্ট্যের জন্য নিবেদিত একটি ল্যাব সংগ্রহের অংশ। আপনি ডকুমেন্টেশনে AlloyDB AI পৃষ্ঠায় আরও পড়তে পারেন এবং অন্যান্য ল্যাবগুলি দেখতে পারেন।

পূর্বশর্ত

• Google ক্লাউড কনসোলের একটি প্রাথমিক ধারণা
• কমান্ড লাইন ইন্টারফেস এবং গুগল ক্লাউড শেলের প্রাথমিক দক্ষতা

আপনি কি শিখবেন

• Vertex AI ইন্টিগ্রেশন সহ AlloyDB ক্লাস্টার কিভাবে স্থাপন করবেন
• কিভাবে AlloyDB এর সাথে সংযোগ করতে হয়
• এমসিপি টুলবক্স পরিষেবা কীভাবে কনফিগার এবং স্থাপন করবেন
• স্থাপন করা পরিষেবা ব্যবহার করে একটি নমুনা অ্যাপ্লিকেশন কীভাবে স্থাপন করবেন

আপনি কি প্রয়োজন হবে

• একটি Google ক্লাউড অ্যাকাউন্ট এবং Google ক্লাউড প্রকল্প
• একটি ওয়েব ব্রাউজার যেমন ক্রোম

2. সেটআপ এবং প্রয়োজনীয়তা

স্ব-গতিসম্পন্ন পরিবেশ সেটআপ

1. Google ক্লাউড কনসোলে সাইন-ইন করুন এবং একটি নতুন প্রকল্প তৈরি করুন বা বিদ্যমান একটি পুনরায় ব্যবহার করুন৷ আপনার যদি ইতিমধ্যেই একটি Gmail বা Google Workspace অ্যাকাউন্ট না থাকে, তাহলে আপনাকে অবশ্যই একটি তৈরি করতে হবে।

• প্রকল্পের নাম এই প্রকল্পের অংশগ্রহণকারীদের জন্য প্রদর্শনের নাম। এটি একটি অক্ষর স্ট্রিং যা Google API দ্বারা ব্যবহৃত হয় না। আপনি সবসময় এটি আপডেট করতে পারেন.
• প্রোজেক্ট আইডি সমস্ত Google ক্লাউড প্রোজেক্ট জুড়ে অনন্য এবং অপরিবর্তনীয় (সেট করার পরে পরিবর্তন করা যাবে না)। ক্লাউড কনসোল স্বয়ংক্রিয়ভাবে একটি অনন্য স্ট্রিং তৈরি করে; সাধারণত আপনি এটা কি যত্ন না. বেশিরভাগ কোডল্যাবে, আপনাকে আপনার প্রকল্প আইডি উল্লেখ করতে হবে (সাধারণত PROJECT_ID হিসাবে চিহ্নিত)। আপনি যদি জেনারেট করা আইডি পছন্দ না করেন, তাহলে আপনি অন্য একটি এলোমেলো আইডি তৈরি করতে পারেন। বিকল্পভাবে, আপনি নিজের চেষ্টা করতে পারেন, এবং এটি উপলব্ধ কিনা দেখতে পারেন। এই ধাপের পরে এটি পরিবর্তন করা যাবে না এবং প্রকল্পের সময়কালের জন্য থাকে।
• আপনার তথ্যের জন্য, একটি তৃতীয় মান আছে, একটি প্রকল্প নম্বর , যা কিছু API ব্যবহার করে। ডকুমেন্টেশনে এই তিনটি মান সম্পর্কে আরও জানুন।

সতর্কতা: একটি প্রকল্প আইডি বিশ্বব্যাপী অনন্য এবং আপনি এটি নির্বাচন করার পরে অন্য কেউ ব্যবহার করতে পারবেন না। আপনি সেই আইডির একমাত্র ব্যবহারকারী। এমনকি একটি প্রকল্প মুছে ফেলা হলেও, আইডিটি আবার ব্যবহার করা যাবে না

দ্রষ্টব্য: আপনি যদি একটি Gmail অ্যাকাউন্ট ব্যবহার করেন, আপনি ডিফল্ট অবস্থানটি কোন প্রতিষ্ঠানে সেট করতে পারেন। আপনি যদি একটি Google Workspace অ্যাকাউন্ট ব্যবহার করেন, তাহলে এমন একটি লোকেশন বেছে নিন যা আপনার প্রতিষ্ঠানের জন্য উপযুক্ত।

2. এরপরে, ক্লাউড রিসোর্স/এপিআই ব্যবহার করতে আপনাকে ক্লাউড কনসোলে বিলিং সক্ষম করতে হবে। এই কোডল্যাবের মাধ্যমে চালানোর জন্য খুব বেশি খরচ হবে না, যদি কিছু হয়। এই টিউটোরিয়ালের বাইরে বিলিং এড়াতে সংস্থানগুলি বন্ধ করতে, আপনি আপনার তৈরি করা সংস্থানগুলি মুছতে বা প্রকল্প মুছতে পারেন। নতুন Google ক্লাউড ব্যবহারকারীরা $300 USD বিনামূল্যের ট্রায়াল প্রোগ্রামের জন্য যোগ্য৷

ক্লাউড শেল শুরু করুন

যদিও Google ক্লাউড আপনার ল্যাপটপ থেকে দূরবর্তীভাবে পরিচালিত হতে পারে, এই কোডল্যাবে আপনি Google ক্লাউড শেল ব্যবহার করবেন, একটি কমান্ড লাইন পরিবেশ যা ক্লাউডে চলছে।

Google ক্লাউড কনসোল থেকে, উপরের ডানদিকে টুলবারে ক্লাউড শেল আইকনে ক্লিক করুন:

পরিবেশের ব্যবস্থা করতে এবং সংযোগ করতে এটি শুধুমাত্র কয়েক মুহূর্ত নিতে হবে। এটি সমাপ্ত হলে, আপনি এই মত কিছু দেখতে হবে:

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

3. আপনি শুরু করার আগে

API সক্ষম করুন

আউটপুট:

আপনি যদি প্রচারমূলক স্তর ব্যবহার না করেন তাহলে অনুগ্রহ করে সচেতন থাকুন যে কিছু সম্পদ আপনার সক্ষম করার জন্য কিছু খরচ করতে হবে। স্বাভাবিক পরিস্থিতিতে যদি ল্যাব শেষ হওয়ার পরে সমস্ত সংস্থান ধ্বংস হয়ে যায় তবে সমস্ত সংস্থানের খরচ $5-এর বেশি হবে না। আমরা আপনার বিলিং পরীক্ষা করার এবং অনুশীলনটি আপনার জন্য গ্রহণযোগ্য কিনা তা নিশ্চিত করার পরামর্শ দিই।

ক্লাউড শেলের ভিতরে, নিশ্চিত করুন যে আপনার প্রকল্প আইডি সেটআপ করা আছে:

সাধারণত প্রজেক্ট আইডিটি ক্লাউড শেলের কমান্ড প্রম্পটে বন্ধনীতে দেখানো হয় যেমনটি ছবিতে দেখানো হয়েছে:

gcloud config set project [YOUR-PROJECT-ID]

তারপর আপনার Google ক্লাউড প্রকল্প আইডিতে PROJECT_ID পরিবেশ পরিবর্তনশীল সেট করুন:

PROJECT_ID=$(gcloud config get-value project)

সমস্ত প্রয়োজনীয় পরিষেবাগুলি সক্ষম করুন:

gcloud services enable alloydb.googleapis.com \
                       compute.googleapis.com \
                       cloudresourcemanager.googleapis.com \
                       servicenetworking.googleapis.com \
                       vpcaccess.googleapis.com \
                       aiplatform.googleapis.com \
                       cloudbuild.googleapis.com \
                       artifactregistry.googleapis.com \
                       run.googleapis.com \
                       iam.googleapis.com \
                       secretmanager.googleapis.com

প্রত্যাশিত আউটপুট

student@cloudshell:~ (gleb-test-short-004)$ gcloud services enable alloydb.googleapis.com \
                       compute.googleapis.com \
                       cloudresourcemanager.googleapis.com \
                       servicenetworking.googleapis.com \
                       vpcaccess.googleapis.com \
                       aiplatform.googleapis.com \
                       cloudbuild.googleapis.com \
                       artifactregistry.googleapis.com \
                       run.googleapis.com \
                       iam.googleapis.com \
                       secretmanager.googleapis.com
Operation "operations/acf.p2-404051529011-664c71ad-cb2b-4ab4-86c1-1f3157d70ba1" finished successfully.

4. AlloyDB ক্লাস্টার স্থাপন করুন

AlloyDB ক্লাস্টার এবং প্রাথমিক উদাহরণ তৈরি করুন। Google ক্লাউড SDK ব্যবহার করে কীভাবে একটি AlloyDB ক্লাস্টার এবং উদাহরণ তৈরি করা যায় তা নিম্নলিখিত পদ্ধতিটি বর্ণনা করে। আপনি যদি কনসোল পদ্ধতি পছন্দ করেন তবে আপনি এখানে ডকুমেন্টেশন অনুসরণ করতে পারেন।

একটি AlloyDB ক্লাস্টার তৈরি করার আগে আমাদের VPC-তে একটি উপলব্ধ প্রাইভেট আইপি পরিসর প্রয়োজন যাতে ভবিষ্যতে AlloyDB দৃষ্টান্ত ব্যবহার করা যায়। যদি আমাদের কাছে এটি না থাকে তবে আমাদের এটি তৈরি করতে হবে, এটিকে অভ্যন্তরীণ Google পরিষেবাগুলির দ্বারা ব্যবহার করার জন্য বরাদ্দ করতে হবে এবং তারপরে আমরা ক্লাস্টার এবং উদাহরণ তৈরি করতে সক্ষম হব।

ব্যক্তিগত আইপি পরিসীমা তৈরি করুন

দ্রষ্টব্য: Google অভ্যন্তরীণ পরিষেবাগুলির সাথে কাজ করার জন্য আপনার কাছে ইতিমধ্যেই একটি অব্যবহৃত ব্যক্তিগত IP পরিসর বরাদ্দ না থাকলেই এই পদক্ষেপটি প্রয়োজনীয়৷

AlloyDB-এর জন্য আমাদের VPC-তে আমাদের ব্যক্তিগত পরিষেবা অ্যাক্সেস কনফিগারেশন কনফিগার করতে হবে। এখানে অনুমান হল যে আমাদের প্রকল্পে "ডিফল্ট" VPC নেটওয়ার্ক আছে এবং এটি সমস্ত কর্মের জন্য ব্যবহার করা হবে।

ব্যক্তিগত আইপি পরিসীমা তৈরি করুন:

gcloud compute addresses create psa-range \
    --global \
    --purpose=VPC_PEERING \
    --prefix-length=24 \
    --description="VPC private service access" \
    --network=default

বরাদ্দকৃত আইপি পরিসর ব্যবহার করে ব্যক্তিগত সংযোগ তৈরি করুন:

gcloud services vpc-peerings connect \
    --service=servicenetworking.googleapis.com \
    --ranges=psa-range \
    --network=default

দ্রষ্টব্য: দ্বিতীয় কমান্ডটি কার্যকর হতে কয়েক মিনিট সময় নেয়

প্রত্যাশিত কনসোল আউটপুট:

student@cloudshell:~ (test-project-402417)$ gcloud compute addresses create psa-range \
    --global \
    --purpose=VPC_PEERING \
    --prefix-length=24 \
    --description="VPC private service access" \
    --network=default
Created [https://www.googleapis.com/compute/v1/projects/test-project-402417/global/addresses/psa-range].

student@cloudshell:~ (test-project-402417)$ gcloud services vpc-peerings connect \
    --service=servicenetworking.googleapis.com \
    --ranges=psa-range \
    --network=default
Operation "operations/pssn.p24-4470404856-595e209f-19b7-4669-8a71-cbd45de8ba66" finished successfully.

student@cloudshell:~ (test-project-402417)$

AlloyDB ক্লাস্টার তৈরি করুন

এই বিভাগে আমরা us-central1 অঞ্চলে একটি AlloyDB ক্লাস্টার তৈরি করছি।

পোস্টগ্রেস ব্যবহারকারীর জন্য পাসওয়ার্ড নির্ধারণ করুন। আপনি আপনার নিজের পাসওয়ার্ড সংজ্ঞায়িত করতে পারেন বা একটি তৈরি করতে একটি র্যান্ডম ফাংশন ব্যবহার করতে পারেন

export PGPASSWORD=`openssl rand -hex 12`

প্রত্যাশিত কনসোল আউটপুট:

student@cloudshell:~ (test-project-402417)$ export PGPASSWORD=`openssl rand -hex 12`

ভবিষ্যতে ব্যবহারের জন্য PostgreSQL পাসওয়ার্ডটি নোট করুন।

echo $PGPASSWORD

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

প্রত্যাশিত কনসোল আউটপুট:

student@cloudshell:~ (test-project-402417)$ echo $PGPASSWORD
bbefbfde7601985b0dee5723

একটি বিনামূল্যে ট্রায়াল ক্লাস্টার তৈরি করুন

আপনি একটি বিনামূল্যে ট্রায়াল ক্লাস্টার তৈরি করার আগে AlloyDB ব্যবহার না করে থাকলে:

অঞ্চল এবং AlloyDB ক্লাস্টার নাম সংজ্ঞায়িত করুন। আমরা একটি ক্লাস্টার নাম হিসাবে us-central1 অঞ্চল এবং alloydb-aip-01 ব্যবহার করতে যাচ্ছি:

export REGION=us-central1
export ADBCLUSTER=alloydb-aip-01

ক্লাস্টার তৈরি করতে কমান্ড চালান:

gcloud alloydb clusters create $ADBCLUSTER \
    --password=$PGPASSWORD \
    --network=default \
    --region=$REGION \
    --subscription-type=TRIAL

প্রত্যাশিত কনসোল আউটপুট:

export REGION=us-central1
export ADBCLUSTER=alloydb-aip-01
gcloud alloydb clusters create $ADBCLUSTER \
    --password=$PGPASSWORD \
    --network=default \
    --region=$REGION \
    --subscription-type=TRIAL
Operation ID: operation-1697655441138-6080235852277-9e7f04f5-2012fce4
Creating cluster...done.                                                                                                                                                                                                                                                           

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

দ্রষ্টব্য: উদাহরণ তৈরি করতে সাধারণত 6-10 মিনিট সময় লাগে

gcloud alloydb instances create $ADBCLUSTER-pr \
    --instance-type=PRIMARY \
    --cpu-count=8 \
    --region=$REGION \
    --cluster=$ADBCLUSTER

প্রত্যাশিত কনসোল আউটপুট:

student@cloudshell:~ (test-project-402417)$ gcloud alloydb instances create $ADBCLUSTER-pr \
    --instance-type=PRIMARY \
    --cpu-count=8 \
    --region=$REGION \
    --availability-type ZONAL \
    --cluster=$ADBCLUSTER
Operation ID: operation-1697659203545-6080315c6e8ee-391805db-25852721
Creating instance...done.                                                                                                                                                                                                                                                     

AlloyDB স্ট্যান্ডার্ড ক্লাস্টার তৈরি করুন

যদি এটি প্রকল্পে আপনার প্রথম AlloyDB ক্লাস্টার না হয় তবে একটি স্ট্যান্ডার্ড ক্লাস্টার তৈরির সাথে এগিয়ে যান।

অঞ্চল এবং AlloyDB ক্লাস্টার নাম সংজ্ঞায়িত করুন। আমরা একটি ক্লাস্টার নাম হিসাবে us-central1 অঞ্চল এবং alloydb-aip-01 ব্যবহার করতে যাচ্ছি:

export REGION=us-central1
export ADBCLUSTER=alloydb-aip-01

ক্লাস্টার তৈরি করতে কমান্ড চালান:

gcloud alloydb clusters create $ADBCLUSTER \
    --password=$PGPASSWORD \
    --network=default \
    --region=$REGION

প্রত্যাশিত কনসোল আউটপুট:

export REGION=us-central1
export ADBCLUSTER=alloydb-aip-01
gcloud alloydb clusters create $ADBCLUSTER \
    --password=$PGPASSWORD \
    --network=default \
    --region=$REGION 
Operation ID: operation-1697655441138-6080235852277-9e7f04f5-2012fce4
Creating cluster...done.                                                                                                                                                                                                                                                           

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

দ্রষ্টব্য: উদাহরণ তৈরি করতে সাধারণত 6-10 মিনিট সময় লাগে

gcloud alloydb instances create $ADBCLUSTER-pr \
    --instance-type=PRIMARY \
    --cpu-count=2 \
    --region=$REGION \
    --cluster=$ADBCLUSTER

প্রত্যাশিত কনসোল আউটপুট:

student@cloudshell:~ (test-project-402417)$ gcloud alloydb instances create $ADBCLUSTER-pr \
    --instance-type=PRIMARY \
    --cpu-count=2 \
    --region=$REGION \
    --availability-type ZONAL \
    --cluster=$ADBCLUSTER
Operation ID: operation-1697659203545-6080315c6e8ee-391805db-25852721
Creating instance...done.                                                                                                                                                                                                                                                     

AlloyDB কে প্রয়োজনীয় অনুমতি দিন

AlloyDB পরিষেবা এজেন্টে Vertex AI অনুমতি যোগ করুন।

উপরের "+" চিহ্নটি ব্যবহার করে আরেকটি ক্লাউড শেল ট্যাব খুলুন।

নতুন ক্লাউড শেল ট্যাবে কার্যকর করুন:

PROJECT_ID=$(gcloud config get-value project)
gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:service-$(gcloud projects describe $PROJECT_ID --format="value(projectNumber)")@gcp-sa-alloydb.iam.gserviceaccount.com" \
  --role="roles/aiplatform.user"

প্রত্যাশিত কনসোল আউটপুট:

student@cloudshell:~ (test-project-001-402417)$ PROJECT_ID=$(gcloud config get-value project)
Your active configuration is: [cloudshell-11039]
student@cloudshell:~ (test-project-001-402417)$ gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:service-$(gcloud projects describe $PROJECT_ID --format="value(projectNumber)")@gcp-sa-alloydb.iam.gserviceaccount.com" \
  --role="roles/aiplatform.user"
Updated IAM policy for project [test-project-001-402417].
bindings:
- members:
  - serviceAccount:[e-mail]
  role: roles/aiplatform.user
- members:
...
etag: BwYIEbe_Z3U=
version: 1
 

ট্যাবে "প্রস্থান" কমান্ড দ্বারা ট্যাবটি বন্ধ করুন:

exit

5. GCE ভার্চুয়াল মেশিন প্রস্তুত করুন

আমরা ডাটাবেসের সাথে কাজ করতে এবং নমুনা অ্যাপ্লিকেশনের বিভিন্ন অংশ স্থাপন করতে আমাদের প্ল্যাটফর্ম হিসাবে একটি Google Compute Engine (GCE) VM ব্যবহার করতে যাচ্ছি। একটি VM ব্যবহার করা আমাদের ইনস্টল করা উপাদানগুলিতে আরও নমনীয়তা দেয় এবং ডেটা প্রস্তুতির পদক্ষেপগুলির জন্য ব্যক্তিগত AlloyDB আইপিতে সরাসরি অ্যাক্সেস দেয়।

সার্ভিস অ্যাকাউন্ট তৈরি করুন

যেহেতু আমরা MCP টুলবক্সকে একটি পরিষেবা হিসাবে স্থাপন করতে এবং নমুনা অ্যাপ্লিকেশনটি স্থাপন বা হোস্ট করতে আমাদের VM ব্যবহার করব, তাই প্রথম পদক্ষেপটি হল একটি Google পরিষেবা অ্যাকাউন্ট (GSA) তৈরি করা। GSA GCE VM ব্যবহার করবে এবং অন্যান্য পরিষেবার সাথে কাজ করার জন্য আমাদের এটিকে প্রয়োজনীয় সুযোগ-সুবিধা দিতে হবে।

ক্লাউড শেল কার্যকর করুন:

PROJECT_ID=$(gcloud config get-value project)
gcloud iam service-accounts create compute-aip --project $PROJECT_ID

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:compute-aip@$PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/cloudbuild.builds.editor"

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:compute-aip@$PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/artifactregistry.admin"

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:compute-aip@$PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/storage.admin"

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:compute-aip@$PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/run.admin"

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:compute-aip@$PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/iam.serviceAccountUser"

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:compute-aip@$PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/alloydb.viewer"

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:compute-aip@$PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/alloydb.client"

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:compute-aip@$PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/aiplatform.user"

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:compute-aip@$PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/serviceusage.serviceUsageConsumer"

gcloud projects add-iam-policy-binding $PROJECT_ID \
    --member serviceAccount:compute-aip@$PROJECT_ID.iam.gserviceaccount.com \
    --role roles/secretmanager.admin

GCE VM স্থাপন করুন

একই অঞ্চলে একটি GCE VM তৈরি করুন এবং AlloyDB ক্লাস্টার হিসাবে VPC তৈরি করুন৷

ক্লাউড শেল চালান:

ZONE=us-central1-a
PROJECT_ID=$(gcloud config get-value project)
gcloud compute instances create instance-1 \
    --zone=$ZONE \
    --create-disk=auto-delete=yes,boot=yes,image=projects/debian-cloud/global/images/$(gcloud compute images list --filter="family=debian-12 AND family!=debian-12-arm64" --format="value(name)") \
    --scopes=https://www.googleapis.com/auth/cloud-platform \
    --service-account=compute-aip@$PROJECT_ID.iam.gserviceaccount.com

প্রত্যাশিত কনসোল আউটপুট:

student@cloudshell:~ (test-project-402417)$ ZONE=us-central1-a
PROJECT_ID=$(gcloud config get-value project)
gcloud compute instances create instance-1 \
    --zone=$ZONE \
    --create-disk=auto-delete=yes,boot=yes,image=projects/debian-cloud/global/images/$(gcloud compute images list --filter="family=debian-12 AND family!=debian-12-arm64" --format="value(name)") \
    --scopes=https://www.googleapis.com/auth/cloud-platform \
    --service-account=compute-aip@$PROJECT_ID.iam.gserviceaccount.com
Your active configuration is: [cloudshell-10282]
Created [https://www.googleapis.com/compute/v1/projects/gleb-test-short-002-470613/zones/us-central1-a/instances/instance-1].
NAME: instance-1
ZONE: us-central1-a
MACHINE_TYPE: n1-standard-1
PREEMPTIBLE: 
INTERNAL_IP: 10.128.0.2
EXTERNAL_IP: 34.28.55.32
STATUS: RUNNING

পোস্টগ্রেস ক্লায়েন্ট ইনস্টল করুন

স্থাপন করা VM-এ PostgreSQL ক্লায়েন্ট সফ্টওয়্যার ইনস্টল করুন

VM এর সাথে সংযোগ করুন:

দ্রষ্টব্য: প্রথমবার VM-এর সাথে SSH সংযোগে বেশি সময় লাগতে পারে কারণ প্রক্রিয়াটির মধ্যে সুরক্ষিত সংযোগের জন্য RSA কী তৈরি করা এবং প্রকল্পের কীটির সর্বজনীন অংশ প্রচার করা অন্তর্ভুক্ত।

gcloud compute ssh instance-1 --zone=us-central1-a

প্রত্যাশিত কনসোল আউটপুট:

student@cloudshell:~ (test-project-402417)$ gcloud compute ssh instance-1 --zone=us-central1-a
Updating project ssh metadata...working..Updated [https://www.googleapis.com/compute/v1/projects/test-project-402417].                                                                                                                                                         
Updating project ssh metadata...done.                                                                                                                                                                                                                                              
Waiting for SSH key to propagate.
Warning: Permanently added 'compute.5110295539541121102' (ECDSA) to the list of known hosts.
Linux instance-1 5.10.0-26-cloud-amd64 #1 SMP Debian 5.10.197-1 (2023-09-29) x86_64

The programs included with the Debian GNU/Linux system are free software;
the exact distribution terms for each program are described in the
individual files in /usr/share/doc/*/copyright.

Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
permitted by applicable law.
student@instance-1:~$ 

VM এর ভিতরে সফ্টওয়্যার চলমান কমান্ড ইনস্টল করুন:

sudo apt-get update
sudo apt-get install --yes postgresql-client

প্রত্যাশিত কনসোল আউটপুট:

student@instance-1:~$ sudo apt-get update
sudo apt-get install --yes postgresql-client
Get:1 file:/etc/apt/mirrors/debian.list Mirrorlist [30 B]
Get:4 file:/etc/apt/mirrors/debian-security.list Mirrorlist [39 B]
Hit:7 https://packages.cloud.google.com/apt google-compute-engine-bookworm-stable InRelease
Get:8 https://packages.cloud.google.com/apt cloud-sdk-bookworm InRelease [1652 B]
Get:2 https://deb.debian.org/debian bookworm InRelease [151 kB]
Get:3 https://deb.debian.org/debian bookworm-updates InRelease [55.4 kB]
...redacted...
update-alternatives: using /usr/share/postgresql/15/man/man1/psql.1.gz to provide /usr/share/man/man1/psql.1.gz (psql.1.gz) in auto mode
Setting up postgresql-client (15+248) ...
Processing triggers for man-db (2.11.2-2) ...
Processing triggers for libc-bin (2.36-9+deb12u7) ...

AlloyDB ইনস্ট্যান্সের সাথে সংযোগ করুন

psql ব্যবহার করে VM থেকে প্রাথমিক দৃষ্টান্তের সাথে সংযোগ করুন।

আপনার VM-এ খোলা SSH সেশনটি চালিয়ে যান। আপনি যদি সংযোগ বিচ্ছিন্ন হয়ে থাকেন তবে উপরের মতো একই কমান্ড ব্যবহার করে আবার সংযোগ করুন।

GCE VM থেকে AlloyDB এর সাথে সংযোগ করতে পূর্বে উল্লেখিত $PGASSWORD এবং ক্লাস্টার নাম ব্যবহার করুন:

export PGPASSWORD=<Noted password>

PROJECT_ID=$(gcloud config get-value project)
REGION=us-central1
ADBCLUSTER=alloydb-aip-01
INSTANCE_IP=$(gcloud alloydb instances describe $ADBCLUSTER-pr --cluster=$ADBCLUSTER --region=$REGION --format="value(ipAddress)")
psql "host=$INSTANCE_IP user=postgres sslmode=require"

প্রত্যাশিত কনসোল আউটপুট:

student@instance-1:~$ PROJECT_ID=$(gcloud config get-value project)
REGION=us-central1
ADBCLUSTER=alloydb-aip-01
INSTANCE_IP=$(gcloud alloydb instances describe $ADBCLUSTER-pr --cluster=$ADBCLUSTER --region=$REGION --format="value(ipAddress)")
psql "host=$INSTANCE_IP user=postgres sslmode=require"
psql (15.13 (Debian 15.13-0+deb12u1), server 16.8)
WARNING: psql major version 15, server major version 16.
         Some psql features might not work.
SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, compression: off)
Type "help" for help.

postgres=>

SSH সংযোগ বজায় রেখে psql সেশন থেকে প্রস্থান করুন:

exit

প্রত্যাশিত কনসোল আউটপুট:

postgres=> exit
student@instance-1:~$ 

6. ডাটাবেস শুরু করুন

আমরা আমাদের ক্লায়েন্ট ভিএমকে একটি প্ল্যাটফর্ম হিসাবে ব্যবহার করতে যাচ্ছি যাতে ডেটা দিয়ে আমাদের ডাটাবেস তৈরি করা যায় এবং আমাদের অ্যাপ্লিকেশন হোস্ট করা যায়। প্রথম ধাপ হল একটি ডাটাবেস তৈরি করা এবং ডেটা দিয়ে তা পপুলেট করা।

ডাটাবেস তৈরি করুন

"সহকারী ডেমো" নামে একটি ডাটাবেস তৈরি করুন।

GCE VM সেশন এক্সিকিউটে:

দ্রষ্টব্য: যদি আপনার SSH সেশনটি বন্ধ হয়ে যায় তবে আপনাকে আপনার পরিবেশের ভেরিয়েবলগুলি পুনরায় সেট করতে হবে যেমন:

export PGPASSWORD=<The noted AlloyDB password>

export REGION=us-central1

export ADBCLUSTER=alloydb-aip-01

export INSTANCE_IP=$(gcloud alloydb instances describe $ADBCLUSTER-pr --cluster=$ADBCLUSTER --region=$REGION --format="value(ipAddress)")

psql "host=$INSTANCE_IP user=postgres" -c "CREATE DATABASE assistantdemo"  

প্রত্যাশিত কনসোল আউটপুট:

student@instance-1:~$ psql "host=$INSTANCE_IP user=postgres" -c "CREATE DATABASE assistantdemo"
CREATE DATABASE
student@instance-1:~$  

পাইথন পরিবেশ প্রস্তুত করুন

চালিয়ে যাওয়ার জন্য আমরা গিটহাব রিপোজিটরি থেকে প্রস্তুত পাইথন স্ক্রিপ্টগুলি ব্যবহার করতে যাচ্ছি তবে এটি করার আগে আমাদের প্রয়োজনীয় সফ্টওয়্যারটি ইনস্টল করতে হবে।

GCE VM এক্সিকিউটে:

sudo apt install -y python3.11-venv git
python3 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip

প্রত্যাশিত কনসোল আউটপুট:

student@instance-1:~$ sudo apt install -y python3.11-venv git
python3 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
The following additional packages will be installed:
  git-man liberror-perl patch python3-distutils python3-lib2to3 python3-pip-whl python3-setuptools-whl
Suggested packages:
  git-daemon-run | git-daemon-sysvinit git-doc git-email git-gui gitk gitweb git-cvs git-mediawiki git-svn ed diffutils-doc
The following NEW packages will be installed:
  git git-man liberror-perl patch python3-distutils python3-lib2to3 python3-pip-whl python3-setuptools-whl python3.11-venv
0 upgraded, 9 newly installed, 0 to remove and 2 not upgraded.
Need to get 12.4 MB of archives.
After this operation, 52.2 MB of additional disk space will be used.
Get:1 file:/etc/apt/mirrors/debian.list Mirrorlist [30 B]
...redacted...
Installing collected packages: pip
  Attempting uninstall: pip
    Found existing installation: pip 23.0.1
    Uninstalling pip-23.0.1:
      Successfully uninstalled pip-23.0.1
Successfully installed pip-24.0
(.venv) student@instance-1:~$

পাইথন সংস্করণ যাচাই করুন।

GCE VM এক্সিকিউটে:

python -V

প্রত্যাশিত কনসোল আউটপুট:

(.venv) student@instance-1:~$ python -V
Python 3.11.2
(.venv) student@instance-1:~$ 

স্থানীয়ভাবে MCP টুলবক্স ইনস্টল করুন

ডাটাবেসের জন্য MCP টুলবক্স (পরে পাঠ্য MCP টুলবক্স বা টুলবক্স) হল একটি ওপেন সোর্স MCP সার্ভার যা বিভিন্ন ডেটা উৎসের সাথে কাজ করে। এটি আপনাকে বিভিন্ন ডেটা উত্সের জন্য বিমূর্ততার স্তর প্রদান করে এবং প্রমাণীকরণ এবং সংযোগ পুলিংয়ের মতো বৈশিষ্ট্যগুলি যোগ করে দ্রুত সরঞ্জামগুলি বিকাশ করতে সহায়তা করে। আপনি অফিসিয়াল পেজে সমস্ত বৈশিষ্ট্য সম্পর্কে পড়তে পারেন।

আমরা আমাদের নমুনা ডেটাসেট শুরু করতে MCP টুলবক্স ব্যবহার করতে যাচ্ছি এবং পরে পুনরুদ্ধার অগমেন্টেড জেনারেশন (RAG) প্রবাহের সময় আমাদের অ্যাপ্লিকেশন থেকে ডেটা উত্স অনুরোধগুলি পরিচালনা করতে MCP সার্ভার হিসাবে ব্যবহার করতে যাচ্ছি।

সহকারী ডেমো ডাটাবেস তৈরি করতে স্থানীয়ভাবে MCP টুলবক্স ইনস্টল করা যাক।

GCE VM এক্সিকিউটে:

export VERSION=0.16.0
curl -O https://storage.googleapis.com/genai-toolbox/v$VERSION/linux/amd64/toolbox
chmod +x toolbox

প্রত্যাশিত কনসোল আউটপুট:

(.venv) student@instance-1:~$ export VERSION=0.16.0
curl -O https://storage.googleapis.com/genai-toolbox/v$VERSION/linux/amd64/toolbox
chmod +x toolbox
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100  133M  100  133M    0     0   158M      0 --:--:-- --:--:-- --:--:--  158M

ডেটা ইনিশিয়ালাইজেশনের জন্য টুলবক্স চালান

GCE VM এক্সিকিউটে:

দ্রষ্টব্য: যদি আপনার SSH সেশন নিষ্ক্রিয়তা বা অন্য কোনো কারণে বন্ধ হয়ে থাকে তাহলে আপনাকে আপনার পরিবেশের ভেরিয়েবল সেট করতে হবে যেমন:

export PGPASSWORD=<Noted password>

REGION=us-central1

ADBCLUSTER=alloydb-aip-01

INSTANCE_IP=$(gcloud alloydb instances describe $ADBCLUSTER-pr --cluster=$ADBCLUSTER --region=$REGION --format="value(ipAddress)")

ডাটাবেস জনসংখ্যার জন্য পরিবেশ পরিবর্তনশীল রপ্তানি করুন:

export ALLOYDB_POSTGRES_PROJECT=$(gcloud config get-value project)
export ALLOYDB_POSTGRES_REGION="us-central1"
export ALLOYDB_POSTGRES_CLUSTER="alloydb-aip-01"
export ALLOYDB_POSTGRES_INSTANCE="alloydb-aip-01-pr"
export ALLOYDB_POSTGRES_DATABASE="assistantdemo"
export ALLOYDB_POSTGRES_USER="postgres"
export ALLOYDB_POSTGRES_PASSWORD=$PGPASSWORD
export ALLOYDB_POSTGRES_IP_TYPE="private"

ডাটাবেস সূচনার জন্য টুলবক্স শুরু করুন। এটি স্থানীয়ভাবে প্রক্রিয়াটি শুরু করবে যা আপনাকে নমুনা ডেটা দিয়ে পূরণ করতে AlloyDB-তে গন্তব্য ডেটাবেসের সাথে নির্বিঘ্নে সংযোগ করতে সাহায্য করবে।

./toolbox --prebuilt alloydb-postgres

প্রত্যাশিত কনসোল আউটপুট। আপনার আউটপুটের শেষ লাইনে দেখতে হবে - "সার্ভার পরিবেশনের জন্য প্রস্তুত!":

student@instance-1:~$ cexport ALLOYDB_POSTGRES_PROJECT=$PROJECT_ID
export ALLOYDB_POSTGRES_REGION="us-central1"
export ALLOYDB_POSTGRES_CLUSTER="alloydb-aip-01"
export ALLOYDB_POSTGRES_INSTANCE="alloydb-aip-01-pr"
export ALLOYDB_POSTGRES_DATABASE="assistantdemo"
export ALLOYDB_POSTGRES_USER="postgres"
export ALLOYDB_POSTGRES_PASSWORD=$PGPASSWORD
export ALLOYDB_POSTGRES_IP_TYPE="private"
student@instance-1:~$ ./toolbox --prebuilt alloydb-postgres
2025-09-02T18:30:58.957655886Z INFO "Using prebuilt tool configuration for alloydb-postgres" 
2025-09-02T18:30:59.507306664Z INFO "Initialized 1 sources." 
2025-09-02T18:30:59.50748379Z INFO "Initialized 0 authServices." 
2025-09-02T18:30:59.507618807Z INFO "Initialized 2 tools." 
2025-09-02T18:30:59.507726704Z INFO "Initialized 2 toolsets." 
2025-09-02T18:30:59.508258894Z INFO "Server ready to serve!" 

ডেটা জনসংখ্যা সম্পূর্ণ না হওয়া পর্যন্ত ক্লাউড শেলের এই ট্যাব থেকে প্রস্থান বা বন্ধ করবেন না।

ডাটাবেস পপুলেট করুন

উপরের "+" চিহ্নটি ব্যবহার করে আরেকটি ক্লাউড শেল ট্যাব খুলুন।

এবং ইনস্ট্যান্স-1 ভিএম-এর সাথে সংযোগ করুন:

gcloud compute ssh instance-1 --zone=us-central1-a

প্রত্যাশিত কনসোল আউটপুট:

student@cloudshell:~ (test-project-402417)$ gcloud compute ssh instance-1 --zone=us-central1-a
Linux instance-1 6.1.0-37-cloud-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.1.140-1 (2025-05-22) x86_64

The programs included with the Debian GNU/Linux system are free software;
the exact distribution terms for each program are described in the
individual files in /usr/share/doc/*/copyright.

Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
permitted by applicable law.
Last login: Tue Sep  2 21:44:07 2025 from 35.229.111.9
student@instance-1:~$ 

পুনরুদ্ধার পরিষেবা এবং নমুনা অ্যাপ্লিকেশনের জন্য কোড সহ GitHub সংগ্রহস্থল ক্লোন করুন।

GCE VM এক্সিকিউটে:

git clone  https://github.com/GoogleCloudPlatform/cymbal-air-toolbox-demo.git

প্রত্যাশিত কনসোল আউটপুট:

student@instance-1:~$ git clone  https://github.com/GoogleCloudPlatform/cymbal-air-toolbox-demo.git
Cloning into 'cymbal-air-toolbox-demo'...
remote: Enumerating objects: 3481, done.
remote: Counting objects: 100% (47/47), done.
remote: Compressing objects: 100% (41/41), done.
remote: Total 3481 (delta 16), reused 7 (delta 5), pack-reused 3434 (from 3)
Receiving objects: 100% (3481/3481), 57.96 MiB | 6.04 MiB/s, done.
Resolving deltas: 100% (2549/2549), done.
student@instance-1:~

আপনার কোন ত্রুটি থাকলে মনোযোগ দিন.

পাইথন পরিবেশ প্রস্তুত করুন এবং প্রয়োজনীয় প্যাকেজ ইনস্টল করুন:

source .venv/bin/activate
cd cymbal-air-toolbox-demo
pip install -r requirements.txt

রিপোজিটরি রুট ফোল্ডারে পাইথন পাথ সেট করুন এবং নমুনা ডেটাসেটের সাথে ডাটাবেস পপুলেট করতে স্ক্রিপ্ট চালান। প্রথম কমান্ডটি আমাদের পরিবেশে আমাদের পাইথন মডিউলগুলির একটি পাথ যোগ করছে এবং দ্বিতীয় কমান্ডটি আমাদের ডাটাবেসকে ডেটা দিয়ে তৈরি করছে।

export PYTHONPATH=$HOME/cymbal-air-toolbox-demo
python data/run_database_init.py

প্রত্যাশিত কনসোল আউটপুট (সংশোধন করা)। আপনি শেষে "ডাটাবেস init সম্পন্ন" দেখতে হবে:

student@instance-1:~$ source .venv/bin/activate
(.venv) student@instance-1:~$ 
(.venv) student@instance-1:~$ cd cymbal-air-toolbox-demo/
(.venv) student@instance-1:~/cymbal-air-toolbox-demo$ pip install -r requirements.txt
python run_database_init.py
Collecting fastapi==0.115.0 (from -r requirements.txt (line 1))
  Downloading fastapi-0.115.0-py3-none-any.whl.metadata (27 kB)
Collecting google-auth==2.40.3 (from -r requirements.txt (line 2))
  Downloading google_auth-2.40.3-py2.py3-none-any.whl.metadata (6.2 kB)
Collecting google-cloud-aiplatform==1.97.0 (from google-cloud-aiplatform[evaluation]==1.97.0->-r requirements.txt (line 3))
  Downloading google_cloud_aiplatform-1.97.0-py2.py3-none-any.whl.metadata (36 kB)
Collecting itsdangerous==2.2.0 (from -r requirements.txt (line 4))
  Downloading itsdangerous-2.2.0-py3-none-any.whl.metadata (1.9 kB)
Collecting jinja2==3.1.5 (from -r requirements.txt (line 5))
  Downloading jinja2-3.1.5-py3-none-any.whl.metadata (2.6 kB)
Collecting langchain-community==0.3.25 (from -r requirements.txt (line 6))
  Downloading langchain_community-0.3.25-py3-none-any.whl.metadata (2.9 kB)
Collecting langchain==0.3.25 (from -r requirements.txt (line 7))
...

(.venv) student@instance-1:~/cymbal-air-toolbox-demo$ 
(.venv) student@instance-1:~/cymbal-air-toolbox-demo$ export PYTHONPATH=$HOME/cymbal-air-toolbox-demo
python data/run_database_init.py
Airports table initialized
Amenities table initialized
Flights table initialized
Tickets table initialized
Policies table initialized
database init done.
(.venv) student@instance-1:~/cymbal-air-toolbox-demo$ 

আপনি এখন এই ট্যাব বন্ধ করতে পারেন.

ভিএম সেশনে কার্যকর করুন:

exit

এবং ক্লাউড শেল সেশনে ctrl+d চাপুন বা চালান:

exit

MCP টুলবক্স চালানোর সাথে প্রথম ট্যাবে টুলবক্স চলমান সেশন থেকে প্রস্থান করতে ctrl+c ইন টিপুন।

ডাটাবেসটি অ্যাপ্লিকেশনের জন্য নমুনা ডেটা দিয়ে তৈরি করা হয়েছে।

আপনি ডাটাবেসের সাথে সংযোগ করে এবং বিমানবন্দরের টেবিলে সারিগুলির সংখ্যা পরীক্ষা করে এটি যাচাই করতে পারেন। আপনি psql ইউটিলিটি ব্যবহার করতে পারেন যেমন আমরা আগে ব্যবহার করেছি বা AlloyDB Studio । এখানে আপনি কিভাবে psql ব্যবহার করে এটি পরীক্ষা করতে পারেন

ssh সেশনে instance-1 VM চালান:

export PGPASSWORD=<Noted AlloyDB password>

REGION=us-central1
ADBCLUSTER=alloydb-aip-01
INSTANCE_IP=$(gcloud alloydb instances describe $ADBCLUSTER-pr --cluster=$ADBCLUSTER --region=$REGION --format="value(ipAddress)")
psql "host=$INSTANCE_IP user=postgres dbname=assistantdemo" -c "SELECT COUNT(*) FROM airports"  

প্রত্যাশিত কনসোল আউটপুট:

student@instance-1:~$ REGION=us-central1
ADBCLUSTER=alloydb-aip-01
INSTANCE_IP=$(gcloud alloydb instances describe $ADBCLUSTER-pr --cluster=$ADBCLUSTER --region=$REGION --format="value(ipAddress)")
psql "host=$INSTANCE_IP user=postgres dbname=assistantdemo" -c "SELECT COUNT(*) FROM airports"
 count 
-------
  7698
(1 row)

ডাটাবেস প্রস্তুত এবং আমরা MCP টুলবক্স স্থাপনে যেতে পারি।

7. ক্লাউড রানে MCP টুলবক্স স্থাপন করুন

এখন আমরা ক্লাউড রানে MCP টুলবক্স স্থাপন করতে পারি। এমসিপি টুলবক্স কিভাবে স্থাপন করা যেতে পারে তা বিভিন্ন উপায় আছে। সবচেয়ে সহজ উপায় হল কমান্ড লাইন থেকে এটি চালানো তবে আমরা যদি এটিকে একটি পরিমাপযোগ্য এবং নির্ভরযোগ্য পরিষেবা হিসাবে পেতে চাই তবে ক্লাউড রান একটি ভাল সমাধান।

ক্লায়েন্ট আইডি প্রস্তুত করুন

অ্যাপ্লিকেশনটির বুকিং কার্যকারিতা ব্যবহার করতে আমাদের ক্লাউড কনসোল ব্যবহার করে OAuth 2.0 ক্লায়েন্ট আইডি প্রস্তুত করতে হবে। এটি ছাড়া আমরা বুকিং করতে এবং ডেটাবেসে বুকিং রেকর্ড করতে আমাদের Google শংসাপত্র দিয়ে অ্যাপ্লিকেশনটিতে সাইন ইন করতে পারি না।

ক্লাউড কনসোলে API এবং পরিষেবাগুলিতে যান এবং "OAuth সম্মতি স্ক্রীন" এ ক্লিক করুন৷ এখানে পৃষ্ঠার একটি লিঙ্ক আছে. এটি Oauth ওভারভিউ পৃষ্ঠা খুলবে যেখানে আমরা Get Started এ ক্লিক করি।

পরবর্তী পৃষ্ঠায় আমরা অ্যাপ্লিকেশনের নাম, ব্যবহারকারী সমর্থন ইমেল প্রদান করি এবং পরবর্তী ক্লিক করুন।

পরবর্তী স্ক্রিনে আমরা আমাদের অ্যাপ্লিকেশনের জন্য অভ্যন্তরীণ নির্বাচন করি এবং আবার পরবর্তীতে ক্লিক করি।

তারপর আবার আমরা যোগাযোগ ইমেল প্রদান এবং পরবর্তী ক্লিক করুন

তারপরে আমরা Google API পরিষেবা নীতিগুলির সাথে সম্মত হই এবং তৈরি করুন বোতামটি চাপুন৷

এটি আমাদের সেই পৃষ্ঠায় নিয়ে যাবে যেখানে আমরা একটি OAuth ক্লায়েন্ট তৈরি করতে পারি।

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

ইউআরআইগুলি অ্যাপ্লিকেশনের জন্য বিশ্বস্ত উত্সগুলিকে প্রতিনিধিত্ব করে এবং তারা নির্ভর করে আপনি কোথা থেকে অ্যাপ্লিকেশনটিতে পৌঁছানোর চেষ্টা করছেন৷ আমরা "http://localhost:8081" কে অনুমোদিত URI হিসেবে এবং "http://localhost:8081/login/google" কে রিডাইরেক্ট URI হিসেবে রাখি। আপনি যদি আপনার ব্রাউজারে সংযোগের জন্য URI হিসেবে "http://localhost:8081" রাখেন তাহলে সেই মানগুলি কাজ করবে। উদাহরণস্বরূপ, যখন আপনি আপনার কম্পিউটার থেকে একটি SSH টানেলের মাধ্যমে সংযোগ করেন। আমি পরে দেখাব কিভাবে এটা করতে হবে.

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

পরে দেখবেন আপনি সেই ক্লায়েন্ট আইডিটি কোথায় দেবেন।

সার্ভিস অ্যাকাউন্ট তৈরি করুন

সমস্ত প্রয়োজনীয় সুবিধা সহ আমাদের ক্লাউড রান পরিষেবার জন্য আমাদের একটি ডেডিকেটেড পরিষেবা অ্যাকাউন্ট প্রয়োজন৷ আমাদের পরিষেবার জন্য আমাদের AlloyDB এবং ক্লাউড সিক্রেট ম্যানেজার অ্যাক্সেস করতে হবে। পরিষেবা অ্যাকাউন্টের নামের জন্য আমরা টুলবক্স-পরিচয় ব্যবহার করতে যাচ্ছি।

উপরের "+" চিহ্নটি ব্যবহার করে আরেকটি ক্লাউড শেল ট্যাব খুলুন।

নতুন ক্লাউড শেল ট্যাবে কার্যকর করুন:

export PROJECT_ID=$(gcloud config get-value project)
gcloud iam service-accounts create toolbox-identity

gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:toolbox-identity@$PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/alloydb.client"
gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:toolbox-identity@$PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/serviceusage.serviceUsageConsumer"
gcloud projects add-iam-policy-binding $PROJECT_ID \
  --member="serviceAccount:toolbox-identity@$PROJECT_ID.iam.gserviceaccount.com" \
  --role="roles/secretmanager.secretAccessor"

আপনার কোন ত্রুটি থাকলে মনোযোগ দিন. কমান্ডটি ক্লাউড চালিত পরিষেবার জন্য একটি পরিষেবা অ্যাকাউন্ট তৈরি করার এবং গোপন ব্যবস্থাপক, ডাটাবেস এবং ভার্টেক্স এআই-এর সাথে কাজ করার সুযোগ-সুবিধা দেওয়ার কথা।

ctrl+d টিপে বা ট্যাবে "exit" কমান্ড প্রয়োগ করে ট্যাবটি বন্ধ করুন:

exit

MCP টুলবক্স কনফিগারেশন প্রস্তুত করুন

MCP টুলবক্সের জন্য কনফিগারেশন ফাইল প্রস্তুত করুন। আপনি ডকুমেন্টেশনে সমস্ত কনফিগারেশন বিকল্পগুলি সম্পর্কে পড়তে পারেন তবে এখানে আমরা নমুনা tools.yaml ফাইলটি ব্যবহার করতে যাচ্ছি এবং কিছু মান যেমন ক্লাস্টার এবং ইনস্ট্যান্স নাম, AlloyDB পাসওয়ার্ড এবং আমাদের প্রকৃত মান দ্বারা প্রকল্প আইডি প্রতিস্থাপন করতে যাচ্ছি।

AlloyDB পাসওয়ার্ড রপ্তানি করুন:

export PGPASSWORD=<noted AlloyDB password>

ক্লায়েন্ট আইডি রপ্তানি করুন যা আমরা পূর্ববর্তী ধাপে প্রস্তুত করেছি:

export CLIENT_ID=<noted OAuth 2.0 client ID for our application>

কনফিগারেশন ফাইল প্রস্তুত করুন।

PROJECT_ID=$(gcloud config get-value project)
ADBCLUSTER=alloydb-aip-01
sed -e "s/project: retrieval-app-testing/project: $(gcloud config get-value project)/g" \
-e "s/cluster: my-alloydb-cluster/cluster: $ADBCLUSTER/g" \
-e "s/instance: my-alloydb-instance/instance: $ADBCLUSTER-pr/g" \
-e "s/password: postgres/password: $PGPASSWORD\\n    ipType: private/g" \
-e "s/^ *clientId: .*/    clientId: $CLIENT_ID/g" \
cymbal-air-toolbox-demo/tools.yaml >~/tools.yaml

আপনি যদি টার্গেট ডেটা সোর্স সংজ্ঞায়িত করে ফাইল বিভাগে তাকান তবে আপনি দেখতে পাবেন যে সংযোগের জন্য ব্যক্তিগত আইপি ব্যবহার করার জন্য আমরা একটি লাইনও যোগ করেছি।

sources:
  my-pg-instance:
    kind: alloydb-postgres
    project: gleb-test-short-003-471020
    region: us-central1
    cluster: alloydb-aip-01
    instance: alloydb-aip-01-pr
    database: assistantdemo
    user: postgres
    password: L23F...
    ipType: private
authServices:
  my_google_service:
    kind: google
    clientId: 96828*******-***********.apps.googleusercontent.com

একটি উৎস হিসাবে tools.yaml কনফিগারেশন ব্যবহার করে একটি গোপন তৈরি করুন।

VM ssh কনসোলে চালান:

gcloud secrets create tools --data-file=tools.yaml

প্রত্যাশিত কনসোল আউটপুট:

student@instance-1:~$ gcloud secrets create tools --data-file=tools.yaml
Created version [1] of the secret [tools].

একটি ক্লাউড রান পরিষেবা হিসাবে MCP টুলবক্স স্থাপন করুন৷

এখন সবকিছুই ক্লাউড রানের পরিষেবা হিসাবে MCP টুলবক্স স্থাপনের জন্য প্রস্তুত। স্থানীয় পরীক্ষার জন্য আপনি "./toolbox –tools-file=./tools.yaml" চালাতে পারেন তবে আমরা যদি আমাদের অ্যাপ্লিকেশনটি ক্লাউডে চালাতে চাই তবে ক্লাউড রানে স্থাপনা অনেক বেশি অর্থবহ।

ভিএম এসএসএইচ সেশনে কার্যকর করুন:

export IMAGE=us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:latest
gcloud run deploy toolbox \
    --image $IMAGE \
    --service-account toolbox-identity \
    --region us-central1 \
    --set-secrets "/app/tools.yaml=tools:latest" \
    --args="--tools-file=/app/tools.yaml","--address=0.0.0.0","--port=8080" \
    --network default \
    --subnet default \
    --no-allow-unauthenticated

প্রত্যাশিত কনসোল আউটপুট:

student@instance-1:~$ export IMAGE=us-central1-docker.pkg.dev/database-toolbox/toolbox/toolbox:latest
gcloud run deploy toolbox \
    --image $IMAGE \
    --service-account toolbox-identity \
    --region us-central1 \
    --set-secrets "/app/tools.yaml=tools:latest" \
    --args="--tools-file=/app/tools.yaml","--address=0.0.0.0","--port=8080" \
    --network default \
    --subnet default \
    --no-allow-unauthenticated
Deploying container to Cloud Run service [toolbox] in project [gleb-test-short-002-470613] region [us-central1]
✓ Deploying new service... Done.                                                                                                                                                                                                
  ✓ Creating Revision...                                                                                                                                                                                                        
  ✓ Routing traffic...                                                                                                                                                                                                          
Done.                                                                                                                                                                                                                           
Service [toolbox] revision [toolbox-00001-l9c] has been deployed and is serving 100 percent of traffic.
Service URL: https://toolbox-868691532292.us-central1.run.app

student@instance-1:~$

পরিষেবাটি যাচাই করুন

এখন আমরা পরীক্ষা করতে পারি যে পরিষেবাটি চালু হয়েছে এবং আমরা শেষ পয়েন্টে অ্যাক্সেস করতে পারি। আমরা পুনরুদ্ধার পরিষেবার শেষ পয়েন্ট এবং প্রমাণীকরণ টোকেন পেতে gcloud ইউটিলিটি ব্যবহার করি। বিকল্পভাবে আপনি ক্লাউড কনসোলে পরিষেবা URI চেক করতে পারেন।

আপনি মানটি অনুলিপি করতে পারেন এবং কার্ল কমান্ডে প্রতিস্থাপন করতে পারেন "$(gcloud run services list –filter="(toolbox)" –format="value(URL)" অংশ।

কমান্ড লাইন থেকে গতিশীলভাবে URL কিভাবে পেতে হয় তা এখানে:

curl -H "Authorization: Bearer $(gcloud auth print-identity-token)" $(gcloud  run services list --filter="(toolbox)" --format="value(URL)")

প্রত্যাশিত কনসোল আউটপুট:

student@instance-1:~$ curl -H "Authorization: Bearer $(gcloud auth print-identity-token)" $(gcloud  run services list --filter="(toolbox)" --format="value(URL)")
🧰 Hello, World! 🧰student@instance-1:~$

আমরা যদি "হ্যালো ওয়ার্ল্ড" বার্তাটি দেখি তবে এর অর্থ হল আমাদের পরিষেবা চলছে এবং অনুরোধগুলি পরিবেশন করছে৷

8. নমুনা অ্যাপ্লিকেশন স্থাপন করুন

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

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

পরিবেশ প্রস্তুত করুন

আমরা একই SSH সেশন ব্যবহার করে আমাদের VM-এ কাজ চালিয়ে যাচ্ছি। আমাদের অ্যাপ্লিকেশন চালানোর জন্য আমাদের কিছু পাইথন মডিউল প্রয়োজন এবং আমরা ইতিমধ্যেই আমাদের ডাটাবেস শুরু করার সময় সেগুলি যোগ করেছি। আসুন আমাদের পাইথন ভার্চুয়াল পরিবেশে স্যুইচ করি এবং অ্যাপ ডিরেক্টরিতে আমাদের অবস্থান পরিবর্তন করি।

ভিএম এসএসএইচ সেশনে কার্যকর করুন:

source ~/.venv/bin/activate
cd cymbal-air-toolbox-demo

প্রত্যাশিত আউটপুট (সংশোধন করা):

student@instance-1:~$ source ~/.venv/bin/activate
cd cymbal-air-toolbox-demo
(.venv) student@instance-1:~/cymbal-air-toolbox-demo$

সহকারী অ্যাপ্লিকেশন চালান

অ্যাপ্লিকেশন শুরু করার আগে আমাদের কিছু পরিবেশ ভেরিয়েবল সেট আপ করতে হবে। অ্যাপ্লিকেশনটির মৌলিক কার্যকারিতা যেমন কোয়েরি ফ্লাইট এবং বিমানবন্দর সুবিধার জন্য শুধুমাত্র TOOLBOX_URL প্রয়োজন যা অ্যাপ্লিকেশনটিকে পুনরুদ্ধার পরিষেবাতে নির্দেশ করে৷ আমরা gcloud কমান্ড ব্যবহার করে এটি পেতে পারি।

ভিএম এসএসএইচ সেশনে কার্যকর করুন:

export TOOLBOX_URL=$(gcloud  run services list --filter="(toolbox)" --format="value(URL)")

প্রত্যাশিত আউটপুট (সংশোধন করা):

student@instance-1:~/cymbal-air-toolbox-demo$ export BASE_URL=$(gcloud  run services list --filter="(toolbox)" --format="value(URL)")

অ্যাপ্লিকেশনটির আরও উন্নত ক্ষমতা যেমন বুকিং এবং ফ্লাইট পরিবর্তন করার জন্য আমাদের Google অ্যাকাউন্ট ব্যবহার করে অ্যাপ্লিকেশনটিতে সাইন-ইন করতে হবে এবং সেই উদ্দেশ্যে আমাদের প্রস্তুত ক্লায়েন্ট আইডি অধ্যায় থেকে OAuth ক্লায়েন্ট আইডি ব্যবহার করে CLIENT_ID পরিবেশ পরিবর্তনশীল প্রদান করতে হবে:

export CLIENT_ID=215....apps.googleusercontent.com

প্রত্যাশিত আউটপুট (সংশোধন করা):

student@instance-1:~/cymbal-air-toolbox-demo$ export CLIENT_ID=215....apps.googleusercontent.com

এবং এখন আমরা আমাদের অ্যাপ্লিকেশন চালাতে পারি:

python run_app.py

প্রত্যাশিত আউটপুট:

student@instance-1:~/cymbal-air-toolbox-demo/llm_demo$ python run_app.py
INFO:     Started server process [2900]
INFO:     Waiting for application startup.
Loading application...
INFO:     Application startup complete.
INFO:     Uvicorn running on http://0.0.0.0:8081 (Press CTRL+C to quit)

অ্যাপ্লিকেশনের সাথে সংযোগ করুন

আপনার কাছে VM এ চলমান অ্যাপ্লিকেশনের সাথে সংযোগ করার বিভিন্ন উপায় রয়েছে। উদাহরণস্বরূপ আপনি ভিপিসি-তে ফায়ারওয়াল নিয়ম ব্যবহার করে ভিএম-এ পোর্ট 8081 খুলতে পারেন বা পাবলিক আইপি দিয়ে একটি লোড ব্যালেন্সার তৈরি করতে পারেন। এখানে আমরা স্থানীয় পোর্ট 8080 কে VM পোর্ট 8081 এ অনুবাদ করে VM-তে একটি SSH টানেল ব্যবহার করতে যাচ্ছি।

স্থানীয় মেশিন থেকে সংযোগ

যখন আমরা একটি স্থানীয় মেশিন থেকে সংযোগ করতে চাই তখন আমাদের একটি SSH টানেল চালাতে হবে। এটি gcloud compute ssh ব্যবহার করে করা যেতে পারে:

gcloud compute ssh instance-1 --zone=us-central1-a -- -L 8081:localhost:8081

প্রত্যাশিত আউটপুট:

student-macbookpro:~ student$ gcloud compute ssh instance-1 --zone=us-central1-a -- -L 8080:localhost:8081
Warning: Permanently added 'compute.7064281075337367021' (ED25519) to the list of known hosts.
Linux instance-1.us-central1-c.c.gleb-test-001.internal 6.1.0-21-cloud-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.1.90-1 (2024-05-03) x86_64

The programs included with the Debian GNU/Linux system are free software;
the exact distribution terms for each program are described in the
individual files in /usr/share/doc/*/copyright.

Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
permitted by applicable law.
student@instance-1:~$

এখন আমরা ব্রাউজার খুলতে পারি এবং আমাদের অ্যাপ্লিকেশনের সাথে সংযোগ করতে http://localhost:8081 ব্যবহার করতে পারি। আমরা অ্যাপ্লিকেশন পর্দা দেখতে হবে.

ক্লাউড শেল থেকে সংযোগ করা হচ্ছে

বিকল্পভাবে আমরা সংযোগ করতে Google ক্লাউড শেল ব্যবহার করতে পারি। উপরের "+" চিহ্নটি ব্যবহার করে আরেকটি ক্লাউড শেল ট্যাব খুলুন।

নতুন ট্যাবে মূলটি পান এবং আপনার ওয়েব ক্লায়েন্টের জন্য gcloud কমান্ড কার্যকর করার জন্য URI পুনঃনির্দেশ করুন:

echo "origin:"; echo "https://8080-$WEB_HOST"; echo "redirect:"; echo "https://8080-$WEB_HOST/login/google"

এখানে প্রত্যাশিত আউটপুট:

student@cloudshell:~ echo "origin:"; echo "https://8080-$WEB_HOST"; echo "redirect:"; echo "https://8080-$WEB_HOST/login/google"
origin:
https://8080-cs-35704030349-default.cs-us-east1-rtep.cloudshell.dev
redirect:
https://8080-cs-35704030349-default.cs-us-east1-rtep.cloudshell.dev/login/google

এবং মূল প্রদত্ত http://localhost:8080 মানগুলি প্রতিস্থাপন বা যোগ করার জন্য "ক্লায়েন্ট আইডি প্রস্তুত করুন" অধ্যায়ে তৈরি করা আমাদের শংসাপত্রগুলির জন্য " অনুমোদিত জাভাস্ক্রিপ্ট অরিজিন " এবং "অনুমোদিত পুনঃনির্দেশ ইউআরআই " হিসাবে URI-এর উত্স এবং পুনঃনির্দেশ ব্যবহার করুন৷

OAuth 2.0 ক্লায়েন্ট আইডি পৃষ্ঠায় "Cymbal Air" এ ক্লিক করুন।

ক্লাউড শেলের জন্য মূল এবং পুনঃনির্দেশিত ইউআরআই রাখুন এবং সংরক্ষণ বোতামটি চাপুন।

নতুন ক্লাউড শেল ট্যাবে gcloud কমান্ডটি কার্যকর করে আপনার VM-এ টানেল চালু করুন:

gcloud compute ssh instance-1 --zone=us-central1-a -- -L 8080:localhost:8081

যদি এটি একটি ত্রুটি দেখায় "অনুরোধ করা ঠিকানা বরাদ্দ করা যায় না" - দয়া করে এটি উপেক্ষা করুন৷

এখানে প্রত্যাশিত আউটপুট:

student@cloudshell:~ gcloud compute ssh instance-1 --zone=us-central1-a -- -L 8080:localhost:8081
bind [::1]:8081: Cannot assign requested address
inux instance-1.us-central1-a.c.gleb-codelive-01.internal 6.1.0-21-cloud-amd64 #1 SMP PREEMPT_DYNAMIC Debian 6.1.90-1 (2024-05-03) x86_64

The programs included with the Debian GNU/Linux system are free software;
the exact distribution terms for each program are described in the
individual files in /usr/share/doc/*/copyright.

Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
permitted by applicable law.
Last login: Sat May 25 19:15:46 2024 from 35.243.235.73
student@instance-1:~$

এটি আপনার ক্লাউড শেল পোর্ট 8080 খোলে যা "ওয়েব প্রিভিউ" এর জন্য ব্যবহার করা যেতে পারে।

আপনার ক্লাউড শেলের ডানদিকের "ওয়েব প্রিভিউ" বোতামে ক্লিক করুন এবং ড্রপ ডাউন মেনু থেকে "পোর্ট 8080 এর পূর্বরূপ" নির্বাচন করুন।

এটি অ্যাপ্লিকেশন ইন্টারফেসের সাথে আপনার ওয়েব ব্রাউজারে একটি নতুন ট্যাব খোলে। আপনি "Cymbal Air Customer Service Assistant" পৃষ্ঠাটি দেখতে সক্ষম হবেন।

অ্যাপ্লিকেশন সাইন ইন করুন

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

এটি একটি পপ-আপ উইন্ডো খুলবে যেখানে আমরা আমাদের শংসাপত্র নির্বাচন করতে পারি।

সাইন ইন করার পরে অ্যাপ্লিকেশনটি প্রস্তুত এবং আপনি উইন্ডোর নীচের ক্ষেত্রটিতে আপনার অনুরোধগুলি পোস্ট করা শুরু করতে পারেন৷

এই ডেমো সিম্বল এয়ার গ্রাহক পরিষেবা সহকারীকে প্রদর্শন করে। সিম্বল এয়ার একটি কাল্পনিক যাত্রীবাহী বিমান সংস্থা। সহকারী হল একটি AI চ্যাটবট যা যাত্রীদের ফ্লাইট পরিচালনা করতে এবং সান ফ্রান্সিসকো ইন্টারন্যাশনাল এয়ারপোর্টে (SFO) সিম্বল এয়ারের হাব সম্পর্কে তথ্য দেখতে সাহায্য করে।

সাইন ইন না করে (CLIENT_ID ছাড়া) এটি ব্যবহারকারীদের প্রশ্নের উত্তর দিতে সাহায্য করতে পারে যেমন:

ডেনভারের পরবর্তী ফ্লাইট কখন?

গেট C28 এর আশেপাশে কি কোন বিলাসবহুল দোকান আছে?

গেট A6 এর কাছে আমি কোথায় কফি পেতে পারি?

আমি কোথায় একটি উপহার কিনতে পারি?

SFO থেকে ডেনভার যাওয়ার একটি ফ্লাইট খুঁজে নিন

আপনি যখন অ্যাপ্লিকেশনটিতে সাইন ইন করেন তখন আপনি ফ্লাইট বুকিং করার মতো অন্যান্য ক্ষমতাগুলি চেষ্টা করতে পারেন বা আপনার জন্য নির্ধারিত আসনটি একটি উইন্ডো বা আইল সিট কিনা তা পরীক্ষা করতে পারেন৷

অ্যাপ্লিকেশানটি সাম্প্রতিক Google ফাউন্ডেশন মডেলগুলি ব্যবহার করে প্রতিক্রিয়া তৈরি করে এবং অপারেশনাল AlloyDB ডাটাবেস থেকে ফ্লাইট এবং সুযোগ-সুবিধা সম্পর্কে তথ্যের মাধ্যমে এটিকে বৃদ্ধি করে৷ আপনি প্রকল্পের Github পৃষ্ঠায় এই ডেমো অ্যাপ্লিকেশন সম্পর্কে আরও পড়তে পারেন।

9. পরিবেশ পরিষ্কার করুন

এখন সব কাজ শেষ হলে আমরা আমাদের পরিবেশ পরিষ্কার করতে পারি

ক্লাউড রান পরিষেবা মুছুন

ক্লাউড শেল চালান:

gcloud run services delete toolbox --region us-central1

প্রত্যাশিত কনসোল আউটপুট:

student@cloudshell:~ (gleb-test-short-004)$ gcloud run services delete retrieval-service --region us-central1
Service [retrieval-service] will be deleted.

Do you want to continue (Y/n)?  Y

Deleting [retrieval-service]...done.                                                                                                                                                                                                                 
Deleted service [retrieval-service].

ক্লাউড রান পরিষেবার জন্য পরিষেবা অ্যাকাউন্ট মুছুন

ক্লাউড শেল চালান:

PROJECT_ID=$(gcloud config get-value project)
gcloud iam service-accounts delete toolbox-identity@$PROJECT_ID.iam.gserviceaccount.com --quiet

প্রত্যাশিত কনসোল আউটপুট:

student@cloudshell:~ (gleb-test-short-004)$ PROJECT_ID=$(gcloud config get-value project)
Your active configuration is: [cloudshell-222]
student@cloudshell:~ (gleb-test-short-004)$ gcloud iam service-accounts delete retrieval-identity@$PROJECT_ID.iam.gserviceaccount.com --quiet
deleted service account [[e-mail]]
student@cloudshell:~ (gleb-test-short-004)$

আপনি ল্যাব দিয়ে সম্পন্ন হলে AlloyDB দৃষ্টান্ত এবং ক্লাস্টার ধ্বংস করুন।

AlloyDB ক্লাস্টার এবং সমস্ত দৃষ্টান্ত মুছুন

আপনি যদি AlloyDB এর ট্রায়াল সংস্করণ ব্যবহার করে থাকেন। ট্রায়াল ক্লাস্টার ব্যবহার করে অন্যান্য ল্যাব এবং সংস্থানগুলি পরীক্ষা করার পরিকল্পনা থাকলে ট্রায়াল ক্লাস্টারটি মুছবেন না। আপনি একই প্রকল্পে অন্য ট্রায়াল ক্লাস্টার তৈরি করতে পারবেন না।

ক্লাস্টারটি অপশন ফোর্স দিয়ে ধ্বংস করা হয় যা ক্লাস্টারের সাথে সম্পর্কিত সমস্ত দৃষ্টান্ত মুছে দেয়।

ক্লাউড শেলে প্রকল্প এবং পরিবেশ ভেরিয়েবলগুলি সংজ্ঞায়িত করুন যদি আপনি সংযোগ বিচ্ছিন্ন হয়ে থাকেন এবং সমস্ত পূর্ববর্তী সেটিংস হারিয়ে যায়:

gcloud config set project <your project id>

export REGION=us-central1
export ADBCLUSTER=alloydb-aip-01
export PROJECT_ID=$(gcloud config get-value project)

ক্লাস্টার মুছুন:

gcloud alloydb clusters delete $ADBCLUSTER --region=$REGION --force

দ্রষ্টব্য: কমান্ডটি কার্যকর হতে 3-5 মিনিট সময় নেয়

প্রত্যাশিত কনসোল আউটপুট:

student@cloudshell:~ (test-project-001-402417)$ gcloud alloydb clusters delete $ADBCLUSTER --region=$REGION --force
All of the cluster data will be lost when the cluster is deleted.

Do you want to continue (Y/n)?  Y

Operation ID: operation-1697820178429-6082890a0b570-4a72f7e4-4c5df36f
Deleting cluster...done.   

AlloyDB ব্যাকআপ মুছুন

ক্লাস্টারের জন্য সমস্ত AlloyDB ব্যাকআপ মুছুন:

দ্রষ্টব্য: কমান্ডটি এনভায়রনমেন্ট ভেরিয়েবলে নির্দিষ্ট নাম সহ ক্লাস্টারের জন্য সমস্ত ডেটা ব্যাকআপ ধ্বংস করবে

for i in $(gcloud alloydb backups list --filter="CLUSTER_NAME: projects/$PROJECT_ID/locations/$REGION/clusters/$ADBCLUSTER" --format="value(name)" --sort-by=~createTime) ; do gcloud alloydb backups delete $(basename $i) --region $REGION --quiet; done

প্রত্যাশিত কনসোল আউটপুট:

student@cloudshell:~ (test-project-001-402417)$ for i in $(gcloud alloydb backups list --filter="CLUSTER_NAME: projects/$PROJECT_ID/locations/$REGION/clusters/$ADBCLUSTER" --format="value(name)" --sort-by=~createTime) ; do gcloud alloydb backups delete $(basename $i) --region $REGION --quiet; done
Operation ID: operation-1697826266108-60829fb7b5258-7f99dc0b-99f3c35f
Deleting backup...done.                                                                                                                                                                                                                                                            

এখন আমরা আমাদের VM ধ্বংস করতে পারি

GCE VM মুছুন

ক্লাউড শেল চালান:

export GCEVM=instance-1
export ZONE=us-central1-a
gcloud compute instances delete $GCEVM \
    --zone=$ZONE \
    --quiet

প্রত্যাশিত কনসোল আউটপুট:

student@cloudshell:~ (test-project-001-402417)$ export GCEVM=instance-1
export ZONE=us-central1-a
gcloud compute instances delete $GCEVM \
    --zone=$ZONE \
    --quiet
Deleted 

GCE VM এবং পুনরুদ্ধার পরিষেবার পরিষেবা অ্যাকাউন্ট মুছুন৷

ক্লাউড শেল চালান:

PROJECT_ID=$(gcloud config get-value project)
gcloud iam service-accounts delete compute-aip@$PROJECT_ID.iam.gserviceaccount.com --quiet

প্রত্যাশিত কনসোল আউটপুট:

student@cloudshell:~ (gleb-test-short-004)$ PROJECT_ID=$(gcloud config get-value project)
gcloud iam service-accounts delete compute-aip@$PROJECT_ID.iam.gserviceaccount.com --quiet
Your active configuration is: [cloudshell-222]
deleted service account [[e-mail]]
student@cloudshell:~ (gleb-test-short-004)$ 

10. অভিনন্দন

কোডল্যাব সম্পূর্ণ করার জন্য অভিনন্দন।

আমরা কভার করেছি কি

• কিভাবে AlloyDB ক্লাস্টার স্থাপন করবেন
• কিভাবে AlloyDB এর সাথে সংযোগ করতে হয়
• এমসিপি টুলবক্স পরিষেবা কীভাবে কনফিগার এবং স্থাপন করবেন
• স্থাপন করা পরিষেবা ব্যবহার করে একটি নমুনা অ্যাপ্লিকেশন কীভাবে স্থাপন করবেন

11. সমীক্ষা

আউটপুট:

আপনি কিভাবে এই টিউটোরিয়াল ব্যবহার করবেন?

শুধুমাত্র এটি মাধ্যমে পড়ুন এটি পড়ুন এবং ব্যায়াম সম্পূর্ণ করুন