প্রতিদিনের ছবি: গুগল নেটিভ জাভা ক্লায়েন্ট লাইব্রেরির মাধ্যমে ছবি সঞ্চয় ও বিশ্লেষণ করুন

১. সংক্ষিপ্ত বিবরণ

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

427de3100de3a61e.png

আপনি যা শিখবেন

  • ক্লাউড স্টোরেজ
  • ক্লাউড রান
  • ক্লাউড ভিশন এপিআই
  • ক্লাউড ফায়ারস্টোর

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

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

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

b35bf95b8bf3d5d8.png

a99b7ace416376c4.png

bd84a6d3004737c5.png

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

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

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

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

55efc1aaa7a4d3ad.png

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

7ffe5cbb04455448.png

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

৩. এপিআই সক্রিয় করুন

এই ল্যাবের জন্য আপনারা ক্লাউড ফাংশন এবং ভিশন এপিআই ব্যবহার করবেন, কিন্তু তার আগে ক্লাউড কনসোল অথবা gcloud ব্যবহার করে এগুলোকে সক্রিয় করে নিতে হবে।

ক্লাউড কনসোলে ভিশন এপিআই সক্রিয় করতে, সার্চ বারে Cloud Vision API লিখে সার্চ করুন:

cf48b1747ba6a6fb.png

আপনি ক্লাউড ভিশন এপিআই পৃষ্ঠায় পৌঁছাবেন:

ba4af419e6086fbb.png

ENABLE বোতামটি ক্লিক করুন।

বিকল্পভাবে, আপনি gcloud কমান্ড লাইন টুল ব্যবহার করে ক্লাউড শেলেও এটি সক্রিয় করতে পারেন।

ক্লাউড শেলের ভিতরে, নিম্নলিখিত কমান্ডটি চালান:

gcloud services enable vision.googleapis.com

অপারেশনটি সফলভাবে সম্পন্ন হতে দেখা উচিত:

Operation "operations/acf.12dba18b-106f-4fd2-942d-fea80ecc5c1c" finished successfully.

Cloud Run এবং Cloud Build-ও সক্রিয় করুন:

gcloud services enable cloudbuild.googleapis.com \
  run.googleapis.com

৪. বাকেটটি তৈরি করুন (কনসোল)

ছবিগুলোর জন্য একটি স্টোরেজ বাকেট তৈরি করুন। আপনি এটি গুগল ক্লাউড প্ল্যাটফর্ম কনসোল ( console.cloud.google.com ) থেকে অথবা ক্লাউড শেল বা আপনার স্থানীয় ডেভেলপমেন্ট এনভায়রনমেন্ট থেকে gsutil কমান্ড লাইন টুল ব্যবহার করে করতে পারেন।

'হ্যামবার্গার' (☰) মেনু থেকে Storage পৃষ্ঠায় যান।

1930e055d138150a.png

আপনার বালতির নাম দিন

CREATE BUCKET বাটনটিতে ক্লিক করুন।

34147939358517f8.png

চালিয়ে CONTINUE ক্লিক করুন।

অবস্থান নির্বাচন করুন

197817f20be07678.png

আপনার পছন্দের অঞ্চলে (এখানে Europe ) একটি বহু-আঞ্চলিক বাকেট তৈরি করুন।

চালিয়ে CONTINUE ক্লিক করুন।

ডিফল্ট স্টোরেজ ক্লাস বেছে নিন

53cd91441c8caf0e.png

আপনার ডেটার জন্য Standard স্টোরেজ ক্লাস বেছে নিন।

চালিয়ে CONTINUE ক্লিক করুন।

অ্যাক্সেস নিয়ন্ত্রণ সেট করুন

8c2b3b459d934a51.png

যেহেতু আপনি সর্বজনীনভাবে প্রবেশযোগ্য ছবি নিয়ে কাজ করবেন, তাই আপনি চাইবেন যে এই বাকেটে সংরক্ষিত আমাদের সমস্ত ছবির জন্য একই রকম প্রবেশাধিকার নিয়ন্ত্রণ ব্যবস্থা থাকুক।

Uniform অ্যাক্সেস কন্ট্রোল বিকল্পটি বেছে নিন।

চালিয়ে CONTINUE ক্লিক করুন।

সুরক্ষা/এনক্রিপশন সেট করুন

d931c24c3e705a68.png

ডিফল্ট ( Google-managed key) রাখুন, যেহেতু আপনি আপনার নিজের এনক্রিপশন কী ব্যবহার করবেন না।

আমাদের বাকেট তৈরি চূড়ান্ত করতে CREATE ক্লিক করুন।

সকল ব্যবহারকারীকে স্টোরেজ ভিউয়ার হিসেবে যুক্ত করুন

Permissions ট্যাবে যান:

d0ecfdcff730ea51.png

নিম্নোক্তভাবে বাকেটটিতে allUsers গ্রুপের একজন সদস্যকে Storage > Storage Object Viewer রোলে যুক্ত করুন:

e9f25ec1ea0b6cc6.png

SAVE ক্লিক করুন।

৫. বাকেটটি তৈরি করুন (gsutil)

এছাড়াও আপনি ক্লাউড শেলে gsutil কমান্ড লাইন টুল ব্যবহার করে বাকেট তৈরি করতে পারেন।

ক্লাউড শেলে, অনন্য বাকেট নামের জন্য একটি ভেরিয়েবল সেট করুন। ক্লাউড শেলে ইতিমধ্যেই GOOGLE_CLOUD_PROJECT আপনার অনন্য প্রজেক্ট আইডি হিসেবে সেট করা আছে। আপনি সেটি বাকেট নামের সাথে যুক্ত করতে পারেন।

উদাহরণস্বরূপ:

export BUCKET_PICTURES=uploaded-pictures-${GOOGLE_CLOUD_PROJECT}

ইউরোপে একটি আদর্শ বহু-অঞ্চল জোন তৈরি করুন:

gsutil mb -l EU gs://${BUCKET_PICTURES}

বালতি স্তরে অভিন্ন প্রবেশাধিকার নিশ্চিত করুন:

gsutil uniformbucketlevelaccess set on gs://${BUCKET_PICTURES}

বাকেটটি সর্বজনীন করুন:

gsutil iam ch allUsers:objectViewer gs://${BUCKET_PICTURES}

আপনি যদি কনসোলের Cloud Storage বিভাগে যান, তাহলে আপনার একটি পাবলিক uploaded-pictures বাকেট থাকার কথা:

a98ed4ba17873e40.png

পূর্ববর্তী ধাপে ব্যাখ্যা অনুযায়ী, পরীক্ষা করে দেখুন যে আপনি বাকেটে ছবি আপলোড করতে পারছেন এবং আপলোড করা ছবিগুলো সর্বজনীনভাবে উপলব্ধ আছে।

৬. বাকেটটিতে সর্বসাধারণের প্রবেশাধিকার পরীক্ষা করুন।

স্টোরেজ ব্রাউজারে ফিরে গেলে, আপনি তালিকায় আপনার বাকেটটি দেখতে পাবেন, যেটির অ্যাক্সেস "পাবলিক" হিসেবে সেট করা থাকবে (সাথে একটি সতর্কীকরণ চিহ্নও থাকবে, যা আপনাকে মনে করিয়ে দেবে যে যে কেউ ওই বাকেটের কন্টেন্ট অ্যাক্সেস করতে পারবে)।

89e7a4d2c80a0319.png

আপনার বাকেটটি এখন ছবি গ্রহণের জন্য প্রস্তুত।

বাকেটের নামে ক্লিক করলে আপনি বাকেটের বিস্তারিত তথ্য দেখতে পাবেন।

131387f12d3eb2d3.png

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

e87584471a6e9c6d.png

Public অ্যাক্সেস’ লেবেলটির পাশে আপনি একটি ছোট লিঙ্ক আইকনও দেখতে পাবেন। সেটিতে ক্লিক করলে, আপনার ব্রাউজারটি সেই ছবিটির পাবলিক ইউআরএল-এ চলে যাবে, যা দেখতে এইরকম হবে:

https://storage.googleapis.com/BUCKET_NAME/PICTURE_FILE.png

এখানে BUCKET_NAME হলো আপনার বাকেটের জন্য বেছে নেওয়া বিশ্বব্যাপী অনন্য নাম, এবং তারপরে আপনার ছবির ফাইলের নাম।

ছবির নামের পাশে থাকা চেকবক্সে ক্লিক করলে DELETE বাটনটি সক্রিয় হবে এবং আপনি এই প্রথম ছবিটি মুছে ফেলতে পারবেন।

৭. ডাটাবেস প্রস্তুত করুন।

আপনি ভিশন এপিআই (Vision API) থেকে পাওয়া ছবির তথ্য ক্লাউড ফায়ারস্টোর (Cloud Firestore) ডেটাবেসে সংরক্ষণ করবেন, যা একটি দ্রুত, সম্পূর্ণভাবে পরিচালিত, সার্ভারবিহীন, ক্লাউড-নেটিভ নোএসকিউএল (NoSQL) ডকুমেন্ট ডেটাবেস। ক্লাউড কনসোলের (Cloud Console) Firestore ) বিভাগে গিয়ে আপনার ডেটাবেস প্রস্তুত করুন:

9e4708d2257de058.png

দুটি বিকল্প দেওয়া আছে: Native mode বা Datastore mode । নেটিভ মোড ব্যবহার করুন, যা অফলাইন সাপোর্ট এবং রিয়েল-টাইম সিনক্রোনাইজেশনের মতো অতিরিক্ত সুবিধা প্রদান করে।

SELECT NATIVE MODE এ ক্লিক করুন।

9449ace8cc84de43.png

একটি বহু-অঞ্চলীয় বিকল্প বেছে নিন (এখানে ইউরোপে, তবে আদর্শগতভাবে অন্তত সেই একই অঞ্চল যেখানে আপনার ফাংশন এবং স্টোরেজ বাকেট রয়েছে)।

CREATE DATABASE বাটনটিতে ক্লিক করুন।

ডাটাবেস তৈরি হয়ে গেলে, আপনি নিম্নলিখিত বিষয়গুলো দেখতে পাবেন:

56265949a124819e.png

+ START COLLECTION বাটনে ক্লিক করে একটি নতুন কালেকশন তৈরি করুন।

নাম সংগ্রহের pictures

75806ee24c4e13a7.png

আপনার কোনো ডকুমেন্ট তৈরি করার প্রয়োজন নেই। ক্লাউড স্টোরেজে নতুন ছবি জমা হওয়ার সাথে সাথে এবং ভিশন এপিআই (Vision API) দ্বারা সেগুলো বিশ্লেষণ হওয়ার পর, আপনি প্রোগ্রাম্যাটিকভাবেই সেগুলো যুক্ত করে নেবেন।

Save এ ক্লিক করুন।

ফায়ারস্টোর নতুন তৈরি করা কালেকশনে একটি প্রথম ডিফল্ট ডকুমেন্ট তৈরি করে, আপনি নিরাপদে সেই ডকুমেন্টটি মুছে ফেলতে পারেন কারণ এতে কোনো দরকারি তথ্য থাকে না:

5c2f1e17ea47f48f.png

আমাদের সংগ্রহে প্রোগ্রামগতভাবে যে নথিগুলো তৈরি করা হবে, সেগুলোতে ৪টি ফিল্ড থাকবে:

  • নাম (স্ট্রিং): আপলোড করা ছবির ফাইলের নাম, যা ডকুমেন্টটির কী-ও বটে।
  • লেবেল (স্ট্রিং-এর অ্যারে): ভিশন এপিআই দ্বারা শনাক্তকৃত আইটেমগুলোর লেবেল।
  • color (string): প্রধান রঙের হেক্সাডেসিমাল কোড (যেমন, #ab12ef)
  • তৈরি হওয়ার তারিখ: এই ছবিটির মেটাডেটা সংরক্ষণের সময়কার টাইমস্ট্যাম্প।
  • থাম্বনেইল (বুলিয়ান): একটি ঐচ্ছিক ক্ষেত্র যা তখনই উপস্থিত থাকবে এবং 'ট্রু' হবে, যদি এই ছবিটির জন্য একটি থাম্বনেইল ছবি তৈরি করা হয়ে থাকে।

যেহেতু আমরা ফায়ারস্টোরে থাম্বনেইলসহ ছবি খুঁজব এবং তৈরির তারিখ অনুসারে সাজাব, তাই আমাদের একটি সার্চ ইনডেক্স তৈরি করতে হবে।

আপনি ক্লাউড শেলে নিম্নলিখিত কমান্ডের মাধ্যমে ইনডেক্সটি তৈরি করতে পারেন:

gcloud firestore indexes composite create \
  --collection-group=pictures \
  --field-config field-path=thumbnail,order=descending \
  --field-config field-path=created,order=descending

অথবা আপনি ক্লাউড কনসোল থেকেও এটি করতে পারেন। এর জন্য, বাম দিকের নেভিগেশন কলামে থাকা Indexes এ ক্লিক করে, নিচে দেখানো পদ্ধতি অনুযায়ী একটি কম্পোজিট ইনডেক্স তৈরি করুন:

ecb8b95e3c791272.png

Create এ ক্লিক করুন। ইনডেক্স তৈরি হতে কয়েক মিনিট সময় লাগতে পারে।

৮. কোডটি ক্লোন করুন

আগের কোড ল্যাবে যদি কোডটি ক্লোন না করে থাকেন, তবে এবার তা করুন:

git clone https://github.com/GoogleCloudPlatform/serverless-photosharing-workshop

এরপর আপনি ল্যাব তৈরি করা শুরু করতে সার্ভিসটি থাকা ডিরেক্টরিতে যেতে পারেন:

cd serverless-photosharing-workshop/services/image-analysis/java

পরিষেবাটির জন্য আপনার কাছে নিম্নলিখিত ফাইল বিন্যাস থাকবে:

f79613aff479d8ad.png

৯. পরিষেবা কোডটি অন্বেষণ করুন

আপনি BOM ব্যবহার করে pom.xml এ জাভা ক্লায়েন্ট লাইব্রেরিগুলি কীভাবে সক্রিয় করা হয়েছে তা দেখে শুরু করবেন:

প্রথমে, pom.xml ফাইলটি সম্পাদনা করুন, যেখানে আমাদের জাভা ফাংশনের নির্ভরতাগুলির তালিকা রয়েছে। Cloud Vision API Maven নির্ভরতাটি যোগ করতে কোডটি আপডেট করুন:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>cloudfunctions</groupId>
  <artifactId>gcs-function</artifactId>
  <version>1.0-SNAPSHOT</version>

  <properties>
    <maven.compiler.target>11</maven.compiler.target>
    <maven.compiler.source>11</maven.compiler.source>
  </properties>

  <dependencyManagement>
    <dependencies>
      <dependency>
        <groupId>com.google.cloud</groupId>
        <artifactId>libraries-bom</artifactId>
        <version>26.1.1</version>
        <type>pom</type>
        <scope>import</scope>
      </dependency>
    </dependencies>
  </dependencyManagement>

  <dependencies>
    <dependency>
      <groupId>com.google.cloud.functions</groupId>
      <artifactId>functions-framework-api</artifactId>
      <version>1.0.4</version>
      <type>jar</type>
    </dependency>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>google-cloud-firestore</artifactId>
    </dependency>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>google-cloud-vision</artifactId>
    </dependency>
    <dependency>
      <groupId>com.google.cloud</groupId>
      <artifactId>google-cloud-storage</artifactId>
    </dependency>
  </dependencies>

এই কার্যকারিতাটি EventController ক্লাসে প্রয়োগ করা হয়েছে। প্রতিবার বাকেটে একটি নতুন ছবি আপলোড হওয়ার সময়, সার্ভিসটি প্রসেস করার জন্য একটি নোটিফিকেশন পাবে:

@RestController
public class EventController {
  private static final Logger logger = Logger.getLogger(EventController.class.getName());
    
  private static final List<String> requiredFields = Arrays.asList("ce-id", "ce-source", "ce-type", "ce-specversion");

  @RequestMapping(value = "/", method = RequestMethod.POST)
  public ResponseEntity<String> receiveMessage(
    @RequestBody Map<String, Object> body, @RequestHeader Map<String, String> headers) throws IOException, InterruptedException, ExecutionException {
...
}

কোডটি Cloud Events হেডারগুলো যাচাই করতে অগ্রসর হবে:

System.out.println("Header elements");
for (String field : requiredFields) {
    if (headers.get(field) == null) {
    String msg = String.format("Missing expected header: %s.", field);
    System.out.println(msg);
    return new ResponseEntity<String>(msg, HttpStatus.BAD_REQUEST);
    } else {
    System.out.println(field + " : " + headers.get(field));
    }
}

System.out.println("Body elements");
for (String bodyField : body.keySet()) {
    System.out.println(bodyField + " : " + body.get(bodyField));
}

if (headers.get("ce-subject") == null) {
    String msg = "Missing expected header: ce-subject.";
    System.out.println(msg);
    return new ResponseEntity<String>(msg, HttpStatus.BAD_REQUEST);
} 

এখন একটি অনুরোধ তৈরি করা যেতে পারে এবং কোডটি Vision API তে পাঠানোর জন্য সেরকমই একটি অনুরোধ প্রস্তুত করবে:

try (ImageAnnotatorClient vision = ImageAnnotatorClient.create()) {
    List<AnnotateImageRequest> requests = new ArrayList<>();
    
    ImageSource imageSource = ImageSource.newBuilder()
        .setGcsImageUri("gs://" + bucketName + "/" + fileName)
        .build();

    Image image = Image.newBuilder()
        .setSource(imageSource)
        .build();

    Feature featureLabel = Feature.newBuilder()
        .setType(Type.LABEL_DETECTION)
        .build();
    Feature featureImageProps = Feature.newBuilder()
        .setType(Type.IMAGE_PROPERTIES)
        .build();
    Feature featureSafeSearch = Feature.newBuilder()
        .setType(Type.SAFE_SEARCH_DETECTION)
        .build();
        
    AnnotateImageRequest request = AnnotateImageRequest.newBuilder()
        .addFeatures(featureLabel)
        .addFeatures(featureImageProps)
        .addFeatures(featureSafeSearch)
        .setImage(image)
        .build();
    
    requests.add(request);

আমরা ভিশন এপিআই-এর তিনটি প্রধান সক্ষমতা জানতে চাইছি:

  • লেবেল শনাক্তকরণ : ঐ ছবিগুলোতে কী আছে তা বোঝার জন্য
  • ছবির বৈশিষ্ট্য : ছবির আকর্ষণীয় গুণাবলী তুলে ধরতে (আমরা ছবির প্রধান রঙটি জানতে আগ্রহী)
  • নিরাপদ অনুসন্ধান : ছবিটি দেখানোর জন্য নিরাপদ কিনা তা জানতে (এতে প্রাপ্তবয়স্ক / চিকিৎসা সংক্রান্ত / উত্তেজক / হিংসাত্মক বিষয়বস্তু থাকা উচিত নয়)

এই পর্যায়ে, আমরা ভিশন এপিআই-কে কল করতে পারি:

...
logger.info("Calling the Vision API...");
BatchAnnotateImagesResponse result = vision.batchAnnotateImages(requests);
List<AnnotateImageResponse> responses = result.getResponsesList();
...

তথ্যসূত্র হিসেবে, ভিশন এপিআই থেকে প্রাপ্ত প্রতিক্রিয়াটি দেখতে এইরকম:

{
  "faceAnnotations": [],
  "landmarkAnnotations": [],
  "logoAnnotations": [],
  "labelAnnotations": [
    {
      "locations": [],
      "properties": [],
      "mid": "/m/01yrx",
      "locale": "",
      "description": "Cat",
      "score": 0.9959855675697327,
      "confidence": 0,
      "topicality": 0.9959855675697327,
      "boundingPoly": null
    },
     - - - 
  ],
  "textAnnotations": [],
  "localizedObjectAnnotations": [],
  "safeSearchAnnotation": {
    "adult": "VERY_UNLIKELY",
    "spoof": "UNLIKELY",
    "medical": "VERY_UNLIKELY",
    "violence": "VERY_UNLIKELY",
    "racy": "VERY_UNLIKELY",
    "adultConfidence": 0,
    "spoofConfidence": 0,
    "medicalConfidence": 0,
    "violenceConfidence": 0,
    "racyConfidence": 0,
    "nsfwConfidence": 0
  },
  "imagePropertiesAnnotation": {
    "dominantColors": {
      "colors": [
        {
          "color": {
            "red": 203,
            "green": 201,
            "blue": 201,
            "alpha": null
          },
          "score": 0.4175916016101837,
          "pixelFraction": 0.44456374645233154
        },
         - - - 
      ]
    }
  },
  "error": null,
  "cropHintsAnnotation": {
    "cropHints": [
      {
        "boundingPoly": {
          "vertices": [
            { "x": 0, "y": 118 },
            { "x": 1177, "y": 118 },
            { "x": 1177, "y": 783 },
            { "x": 0, "y": 783 }
          ],
          "normalizedVertices": []
        },
        "confidence": 0.41695669293403625,
        "importanceFraction": 1
      }
    ]
  },
  "fullTextAnnotation": null,
  "webDetection": null,
  "productSearchResults": null,
  "context": null
}

যদি কোনো ত্রুটি ফেরত না আসে, তাহলে আমরা এগিয়ে যেতে পারি, আর এই কারণেই আমাদের এই if ব্লকটি রয়েছে:

if (responses.size() == 0) {
    logger.info("No response received from Vision API.");
    return new ResponseEntity<String>(msg, HttpStatus.BAD_REQUEST);
}

AnnotateImageResponse response = responses.get(0);
if (response.hasError()) {
    logger.info("Error: " + response.getError().getMessage());
    return new ResponseEntity<String>(msg, HttpStatus.BAD_REQUEST);
}

আমরা ছবিতে শনাক্ত করা জিনিস, বিভাগ বা বিষয়বস্তুর নামগুলো জেনে নেব:

List<String> labels = response.getLabelAnnotationsList().stream()
    .map(annotation -> annotation.getDescription())
    .collect(Collectors.toList());
logger.info("Annotations found:");
for (String label: labels) {
    logger.info("- " + label);
}

আমরা ছবিটির প্রধান রঙটি জানতে আগ্রহী:

String mainColor = "#FFFFFF";
ImageProperties imgProps = response.getImagePropertiesAnnotation();
if (imgProps.hasDominantColors()) {
    DominantColorsAnnotation colorsAnn = imgProps.getDominantColors();
    ColorInfo colorInfo = colorsAnn.getColors(0);

    mainColor = rgbHex(
        colorInfo.getColor().getRed(), 
        colorInfo.getColor().getGreen(), 
        colorInfo.getColor().getBlue());

    logger.info("Color: " + mainColor);
}

চলুন দেখে নেওয়া যাক ছবিটি দেখানো নিরাপদ কিনা:

boolean isSafe = false;
if (response.hasSafeSearchAnnotation()) {
    SafeSearchAnnotation safeSearch = response.getSafeSearchAnnotation();

    isSafe = Stream.of(
        safeSearch.getAdult(), safeSearch.getMedical(), safeSearch.getRacy(),
        safeSearch.getSpoof(), safeSearch.getViolence())
    .allMatch( likelihood -> 
        likelihood != Likelihood.LIKELY && likelihood != Likelihood.VERY_LIKELY
    );

    logger.info("Safe? " + isSafe);
}

আমরা প্রাপ্তবয়স্ক / ব্যঙ্গাত্মক / চিকিৎসা সংক্রান্ত / সহিংস / উত্তেজক বৈশিষ্ট্যগুলো যাচাই করে দেখছি যে সেগুলো অসম্ভাব্য নাকি অত্যন্ত সম্ভাব্য

নিরাপদ অনুসন্ধানের ফলাফল ঠিক থাকলে, আমরা ফায়ারস্টোরে মেটাডেটা সংরক্ষণ করতে পারি:

// Saving result to Firestore
if (isSafe) {
    FirestoreOptions firestoreOptions = FirestoreOptions.getDefaultInstance();
    Firestore pictureStore = firestoreOptions.getService();

    DocumentReference doc = pictureStore.collection("pictures").document(fileName);

    Map<String, Object> data = new HashMap<>();
    data.put("labels", labels);
    data.put("color", mainColor);
    data.put("created", new Date());

    ApiFuture<WriteResult> writeResult = doc.set(data, SetOptions.merge());

    logger.info("Picture metadata saved in Firestore at " + writeResult.get().getUpdateTime());
}

১০. GraalVM ব্যবহার করে অ্যাপ ইমেজ তৈরি করুন (ঐচ্ছিক)

এই ঐচ্ছিক ধাপে, আপনি GraalVM ব্যবহার করে প্রথমে একটি JIT(JVM) based app image এবং তারপর একটি AOT(Native) Java app image তৈরি করবেন।

বিল্ডটি চালানোর জন্য, আপনাকে নিশ্চিত করতে হবে যে আপনার একটি উপযুক্ত JDK এবং নেটিভ-ইমেজ বিল্ডার ইনস্টল ও কনফিগার করা আছে। এর জন্য বেশ কয়েকটি বিকল্প উপলব্ধ রয়েছে।

To start , GraalVM 22.2.x কমিউনিটি এডিশনটি ডাউনলোড করুন এবং GraalVM ইনস্টলেশন পৃষ্ঠার নির্দেশাবলী অনুসরণ করুন।

SDKMAN-এর সাহায্যে এই প্রক্রিয়াটি অনেক সহজ করা যায়!

SDKman ব্যবহার করে উপযুক্ত JDK ডিস্ট্রিবিউশন ইনস্টল করতে, প্রথমে এই install কমান্ডটি ব্যবহার করুন:

sdk install java 22.2.r17-grl

JIT এবং AOT উভয় বিল্ডের জন্য SDKman-কে এই সংস্করণটি ব্যবহার করার নির্দেশ দিন:

sdk use java 22.2.0.r17-grl

GraalVM-এর জন্য native-image utility ইনস্টল করুন:

gu install native-image

আপনার সুবিধার জন্য, Cloudshell আপনি এই সহজ কমান্ডগুলো ব্যবহার করে GraalVM এবং নেটিভ-ইমেজ ইউটিলিটি ইনস্টল করতে পারেন:

# install GraalVM in your home directory
cd ~

# download GraalVM
wget https://github.com/graalvm/graalvm-ce-builds/releases/download/vm-22.2.0/graalvm-ce-java17-linux-amd64-22.2.0.tar.gz
ls
tar -xzvf graalvm-ce-java17-linux-amd64-22.2.0.tar.gz

# configure Java 17 and GraalVM 22.2
echo Existing JVM: $JAVA_HOME
cd graalvm-ce-java17-22.2.0
export JAVA_HOME=$PWD
cd bin
export PATH=$PWD:$PATH

echo JAVA HOME: $JAVA_HOME
echo PATH: $PATH

# install the native image utility
java -version
gu install native-image

cd ../..

প্রথমে, GCP প্রজেক্টের এনভায়রনমেন্ট ভেরিয়েবলগুলো সেট করুন:

export GOOGLE_CLOUD_PROJECT=$(gcloud config get-value project)

এরপর আপনি ল্যাব তৈরি করা শুরু করতে সার্ভিসটি থাকা ডিরেক্টরিতে যেতে পারেন:

cd serverless-photosharing-workshop/services/image-analysis/java

JIT(JVM) অ্যাপ্লিকেশন ইমেজ তৈরি করুন:

./mvnw package -Pjvm

টার্মিনালে বিল্ড লগটি পর্যবেক্ষণ করুন:

...
[INFO] --- spring-boot-maven-plugin:2.7.3:repackage (repackage) @ image-analysis ---
[INFO] Replacing main artifact with repackaged archive
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  24.009 s
[INFO] Finished at: 2022-09-26T22:17:32-04:00
[INFO] ------------------------------------------------------------------------

AOT(নেটিভ) ইমেজটি তৈরি করুন:

./mvnw package -Pnative -DskipTests

টার্মিনালে বিল্ড লগটি পর্যবেক্ষণ করুন, যার মধ্যে নেটিভ ইমেজ বিল্ড লগও অন্তর্ভুক্ত রয়েছে:

মনে রাখবেন যে, আপনি কোন মেশিনে পরীক্ষা করছেন তার উপর নির্ভর করে বিল্ড হতে বেশ কিছুটা বেশি সময় লাগে।

...
[2/7] Performing analysis...  [**********]                                                              (95.4s @ 3.57GB)
  23,346 (94.42%) of 24,725 classes reachable
  44,625 (68.71%) of 64,945 fields reachable
 163,759 (70.79%) of 231,322 methods reachable
     989 classes, 1,402 fields, and 11,032 methods registered for reflection
      63 classes,    69 fields, and    55 methods registered for JNI access
       5 native libraries: -framework CoreServices, -framework Foundation, dl, pthread, z
[3/7] Building universe...                                                                              (10.0s @ 5.35GB)
[4/7] Parsing methods...      [***]                                                                      (9.7s @ 3.13GB)
[5/7] Inlining methods...     [***]                                                                      (4.5s @ 3.29GB)
[6/7] Compiling methods...    [[6/7] Compiling methods...    [********]                                                                (67.6s @ 5.72GB)
[7/7] Creating image...                                                                                  (8.7s @ 4.59GB)
  62.21MB (54.80%) for code area:   100,371 compilation units
  50.98MB (44.91%) for image heap:  465,035 objects and 365 resources
 337.09KB ( 0.29%) for other data
 113.52MB in total
------------------------------------------------------------------------------------------------------------------------
Top 10 packages in code area:                               Top 10 object types in image heap:
   2.36MB com.google.protobuf                                 12.70MB byte[] for code metadata
   1.90MB i.g.xds.shaded.io.envoyproxy.envoy.config.core.v3    6.66MB java.lang.Class
   1.73MB i.g.x.shaded.io.envoyproxy.envoy.config.route.v3     6.47MB byte[] for embedded resources
   1.67MB sun.security.ssl                                     4.61MB byte[] for java.lang.String
   1.54MB com.google.cloud.vision.v1                           4.37MB java.lang.String
   1.46MB com.google.firestore.v1                              3.38MB byte[] for general heap data
   1.37MB io.grpc.xds.shaded.io.envoyproxy.envoy.api.v2.core   1.96MB com.oracle.svm.core.hub.DynamicHubCompanion
   1.32MB i.g.xds.shaded.io.envoyproxy.envoy.api.v2.route      1.80MB byte[] for reflection metadata
   1.09MB java.util                                          911.80KB java.lang.String[]
   1.08MB com.google.re2j                                    826.48KB c.o.svm.core.hub.DynamicHub$ReflectionMetadata
  45.91MB for 772 more packages                                6.45MB for 3913 more object types
------------------------------------------------------------------------------------------------------------------------
                        15.1s (6.8% of total time) in 56 GCs | Peak RSS: 7.72GB | CPU load: 4.37
------------------------------------------------------------------------------------------------------------------------
Produced artifacts:
 /Users/ddobrin/work/dan/serverless-photosharing-workshop/services/image-analysis/java/target/image-analysis (executable)
 /Users/ddobrin/work/dan/serverless-photosharing-workshop/services/image-analysis/java/target/image-analysis.build_artifacts.txt (txt)
========================================================================================================================
Finished generating 'image-analysis' in 3m 41s.
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  03:56 min
[INFO] Finished at: 2022-09-26T22:22:29-04:00
[INFO] ------------------------------------------------------------------------

১১. কন্টেইনার ইমেজ তৈরি এবং প্রকাশ করুন

চলুন দুটি ভিন্ন সংস্করণে একটি কন্টেইনার ইমেজ তৈরি করি: একটি JIT(JVM) image হিসেবে এবং অন্যটি AOT(Native) Java image হিসেবে।

প্রথমে, GCP প্রজেক্টের এনভায়রনমেন্ট ভেরিয়েবলগুলো সেট করুন:

export GOOGLE_CLOUD_PROJECT=$(gcloud config get-value project)

JIT(JVM) ইমেজটি তৈরি করুন:

./mvnw package -Pjvm-image

টার্মিনালে বিল্ড লগটি পর্যবেক্ষণ করুন:

[INFO]     [creator]     Adding layer 'process-types'
[INFO]     [creator]     Adding label 'io.buildpacks.lifecycle.metadata'
[INFO]     [creator]     Adding label 'io.buildpacks.build.metadata'
[INFO]     [creator]     Adding label 'io.buildpacks.project.metadata'
[INFO]     [creator]     Adding label 'org.opencontainers.image.title'
[INFO]     [creator]     Adding label 'org.opencontainers.image.version'
[INFO]     [creator]     Adding label 'org.springframework.boot.version'
[INFO]     [creator]     Setting default process type 'web'
[INFO]     [creator]     Saving docker.io/library/image-analysis-jvm:r17...
[INFO]     [creator]     *** Images (03a44112456e):
[INFO]     [creator]           docker.io/library/image-analysis-jvm:r17
[INFO]     [creator]     Adding cache layer 'paketo-buildpacks/syft:syft'
[INFO]     [creator]     Adding cache layer 'cache.sbom'
[INFO] 
[INFO] Successfully built image 'docker.io/library/image-analysis-jvm:r17'
[INFO] 
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  02:11 min
[INFO] Finished at: 2022-09-26T13:09:34-04:00
[INFO] ------------------------------------------------------------------------

AOT(নেটিভ) ইমেজটি তৈরি করুন:

./mvnw package -Pnative-image

টার্মিনালে বিল্ড লগটি পর্যবেক্ষণ করুন, যার মধ্যে নেটিভ ইমেজ বিল্ড লগ এবং UPX ব্যবহার করে ইমেজ কম্প্রেশন অন্তর্ভুক্ত রয়েছে।

মনে রাখবেন যে, আপনি কোন মেশিনে পরীক্ষা করছেন তার উপর নির্ভর করে বিল্ড হতে বেশ কিছুটা বেশি সময় লাগে।

...
[INFO]     [creator]     [2/7] Performing analysis...  [***********]                    (147.6s @ 3.10GB)
[INFO]     [creator]       23,362 (94.34%) of 24,763 classes reachable
[INFO]     [creator]       44,657 (68.67%) of 65,029 fields reachable
[INFO]     [creator]      163,926 (70.76%) of 231,656 methods reachable
[INFO]     [creator]          981 classes, 1,402 fields, and 11,026 methods registered for reflection
[INFO]     [creator]           63 classes,    68 fields, and    55 methods registered for JNI access
[INFO]     [creator]            4 native libraries: dl, pthread, rt, z
[INFO]     [creator]     [3/7] Building universe...                                      (21.1s @ 2.66GB)
[INFO]     [creator]     [4/7] Parsing methods...      [****]                            (13.7s @ 4.16GB)
[INFO]     [creator]     [5/7] Inlining methods...     [***]                              (9.6s @ 4.20GB)
[INFO]     [creator]     [6/7] Compiling methods...    [**********]                     (107.6s @ 3.36GB)
[INFO]     [creator]     [7/7] Creating image...                                         (14.7s @ 4.87GB)
[INFO]     [creator]       62.24MB (51.35%) for code area:   100,499 compilation units
[INFO]     [creator]       51.99MB (42.89%) for image heap:  473,948 objects and 473 resources
[INFO]     [creator]        6.98MB ( 5.76%) for other data
[INFO]     [creator]      121.21MB in total
[INFO]     [creator]     --------------------------------------------------------------------------------
[INFO]     [creator]     Top 10 packages in code area:           Top 10 object types in image heap:
[INFO]     [creator]        2.36MB com.google.protobuf             12.71MB byte[] for code metadata
[INFO]     [creator]        1.90MB i.g.x.s.i.e.e.config.core.v3     7.59MB byte[] for embedded resources
[INFO]     [creator]        1.73MB i.g.x.s.i.e.e.config.route.v3    6.66MB java.lang.Class
[INFO]     [creator]        1.67MB sun.security.ssl                 4.62MB byte[] for java.lang.String
[INFO]     [creator]        1.54MB com.google.cloud.vision.v1       4.39MB java.lang.String
[INFO]     [creator]        1.46MB com.google.firestore.v1          3.66MB byte[] for general heap data
[INFO]     [creator]        1.37MB i.g.x.s.i.e.envoy.api.v2.core    1.96MB c.o.s.c.h.DynamicHubCompanion
[INFO]     [creator]        1.32MB i.g.x.s.i.e.e.api.v2.route       1.80MB byte[] for reflection metadata
[INFO]     [creator]        1.09MB java.util                      910.41KB java.lang.String[]
[INFO]     [creator]        1.08MB com.google.re2j                826.95KB c.o.s.c.h.DynamicHu~onMetadata
[INFO]     [creator]       45.94MB for 776 more packages            6.69MB for 3916 more object types
[INFO]     [creator]     --------------------------------------------------------------------------------
[INFO]     [creator]         20.4s (5.6% of total time) in 81 GCs | Peak RSS: 6.75GB | CPU load: 4.53
[INFO]     [creator]     --------------------------------------------------------------------------------
[INFO]     [creator]     Produced artifacts:
[INFO]     [creator]      /layers/paketo-buildpacks_native-image/native-image/services.ImageAnalysisApplication (executable)
[INFO]     [creator]      /layers/paketo-buildpacks_native-image/native-image/services.ImageAnalysisApplication.build_artifacts.txt (txt)
[INFO]     [creator]     ================================================================================
[INFO]     [creator]     Finished generating '/layers/paketo-buildpacks_native-image/native-image/services.ImageAnalysisApplication' in 5m 59s.
[INFO]     [creator]         Executing upx to compress native image
[INFO]     [creator]                            Ultimate Packer for eXecutables
[INFO]     [creator]                               Copyright (C) 1996 - 2020
[INFO]     [creator]     UPX 3.96        Markus Oberhumer, Laszlo Molnar & John Reiser   Jan 23rd 2020
[INFO]     [creator]     
[INFO]     [creator]             File size         Ratio      Format      Name
[INFO]     [creator]        --------------------   ------   -----------   -----------
 127099880 ->  32416676   25.50%   linux/amd64   services.ImageAnalysisApplication
...
[INFO]     [creator]     ===> EXPORTING
...
[INFO]     [creator]     Adding cache layer 'paketo-buildpacks/native-image:native-image'
[INFO]     [creator]     Adding cache layer 'cache.sbom'
[INFO] 
[INFO] Successfully built image 'docker.io/library/image-analysis-native:r17'
------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  05:28 min
[INFO] Finished at: 2022-09-26T13:19:53-04:00
[INFO] ------------------------------------------------------------------------

ইমেজগুলো বিল্ড হয়েছে কিনা তা যাচাই করুন:

docker images | grep image-analysis

ছবি দুটি ট্যাগ করে GCR-এ পাঠান:

# JIT(JVM) image
docker tag image-analysis-jvm:r17 gcr.io/${GOOGLE_CLOUD_PROJECT}/image-analysis-jvm:r17
docker push gcr.io/${GOOGLE_CLOUD_PROJECT}/image-analysis-jvm:r17

# AOT(Native) image
docker tag image-analysis-native:r17 gcr.io/${GOOGLE_CLOUD_PROJECT}/image-analysis-native:r17
docker push  gcr.io/${GOOGLE_CLOUD_PROJECT}/image-analysis-native:r17

১২. ক্লাউড রানে স্থাপন করুন

সার্ভিসটি ডেপ্লয় করার সময় হয়েছে।

আপনি সার্ভিসটি দুইবার ডেপ্লয় করবেন, একবার JIT (JVM) ইমেজ ব্যবহার করে এবং দ্বিতীয়বার AOT (নেটিভ) ইমেজ ব্যবহার করে। তুলনার উদ্দেশ্যে, উভয় সার্ভিস ডেপ্লয়মেন্টই বাকেট থেকে একই ইমেজ সমান্তরালভাবে প্রসেস করবে।

প্রথমে, GCP প্রজেক্টের এনভায়রনমেন্ট ভেরিয়েবলগুলো সেট করুন:

export GOOGLE_CLOUD_PROJECT=$(gcloud config get-value project)
gcloud config set project ${GOOGLE_CLOUD_PROJECT}
gcloud config set run/region 
gcloud config set run/platform managed
gcloud config set eventarc/location europe-west1

JIT(JVM) ইমেজটি ডিপ্লয় করুন এবং কনসোলে ডিপ্লয়মেন্ট লগটি পর্যবেক্ষণ করুন:

gcloud run deploy image-analysis-jvm \
     --image gcr.io/${GOOGLE_CLOUD_PROJECT}/image-analysis-jvm:r17 \
     --region europe-west1 \
     --memory 2Gi --allow-unauthenticated

...
Deploying container to Cloud Run service [image-analysis-jvm] in project [...] region [europe-west1]
✓ Deploying... Done.                                                                                                                                                               
  ✓ Creating Revision...                                                                                                                                                           
  ✓ Routing traffic...                                                                                                                                                             
  ✓ Setting IAM Policy...                                                                                                                                                          
Done.                                                                                                                                                                              
Service [image-analysis-jvm] revision [image-analysis-jvm-00009-huc] has been deployed and is serving 100 percent of traffic.
Service URL: https://image-analysis-jvm-...-ew.a.run.app

AOT(Native) ইমেজটি ডিপ্লয় করুন এবং কনসোলে ডিপ্লয়মেন্ট লগটি পর্যবেক্ষণ করুন:

gcloud run deploy image-analysis-native \
     --image gcr.io/${GOOGLE_CLOUD_PROJECT}/image-analysis-native:r17 \
     --region europe-west1 \
     --memory 2Gi --allow-unauthenticated 
...
Deploying container to Cloud Run service [image-analysis-native] in project [...] region [europe-west1]
✓ Deploying... Done.                                                                                                                                                               
  ✓ Creating Revision...                                                                                                                                                           
  ✓ Routing traffic...                                                                                                                                                             
  ✓ Setting IAM Policy...                                                                                                                                                          
Done.                                                                                                                                                                              
Service [image-analysis-native] revision [image-analysis-native-00005-ben] has been deployed and is serving 100 percent of traffic.
Service URL: https://image-analysis-native-...-ew.a.run.app

১৩. ইভেন্টআর্ক ট্রিগার সেটআপ করুন

ইভেন্টআর্ক বিচ্ছিন্ন মাইক্রোসার্ভিসগুলোর মধ্যে স্টেট পরিবর্তনের প্রবাহ, যা ইভেন্ট নামে পরিচিত, পরিচালনা করার জন্য একটি প্রমিত সমাধান প্রদান করে। ট্রিগার হলে, ইভেন্টআর্ক এই ইভেন্টগুলোকে পাব/সাব সাবস্ক্রিপশনের মাধ্যমে বিভিন্ন গন্তব্যে (এই ডকুমেন্টে, ‘ইভেন্ট গন্তব্য’ দেখুন) পাঠিয়ে দেয় এবং একই সাথে আপনার জন্য ডেলিভারি, নিরাপত্তা, অনুমোদন, পর্যবেক্ষণযোগ্যতা এবং ত্রুটি-পরিচালনা পরিচালনা করে।

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

প্রথমে, GCP প্রজেক্টের এনভায়রনমেন্ট ভেরিয়েবলগুলো সেট করুন:

export GOOGLE_CLOUD_PROJECT=$(gcloud config get-value project)
gcloud config set project ${GOOGLE_CLOUD_PROJECT}
gcloud config set run/region 
gcloud config set run/platform managed
gcloud config set eventarc/location europe-west1

ক্লাউড স্টোরেজ পরিষেবা অ্যাকাউন্টে pubsub.publisher অনুমতি প্রদান করুন:

SERVICE_ACCOUNT="$(gsutil kms serviceaccount -p ${GOOGLE_CLOUD_PROJECT})"

gcloud projects add-iam-policy-binding ${GOOGLE_CLOUD_PROJECT} \
    --member="serviceAccount:${SERVICE_ACCOUNT}" \
    --role='roles/pubsub.publisher'

ইমেজটি প্রসেস করার জন্য JVM(JIT) এবং AOT(Native) উভয় সার্ভিস ইমেজের জন্য Eventarc ট্রিগার সেট আপ করুন:

gcloud eventarc triggers list --location=eu

gcloud eventarc triggers create image-analysis-jvm-trigger \
     --destination-run-service=image-analysis-jvm \
     --destination-run-region=europe-west1 \
     --location=eu \
     --event-filters="type=google.cloud.storage.object.v1.finalized" \
     --event-filters="bucket=uploaded-pictures-${GOOGLE_CLOUD_PROJECT}" \
     --service-account=${PROJECT_NUMBER}-compute@developer.gserviceaccount.com

gcloud eventarc triggers create image-analysis-native-trigger \
     --destination-run-service=image-analysis-native \
     --destination-run-region=europe-west1 \
     --location=eu \
     --event-filters="type=google.cloud.storage.object.v1.finalized" \
     --event-filters="bucket=uploaded-pictures-${GOOGLE_CLOUD_PROJECT}" \
     --service-account=${PROJECT_NUMBER}-compute@developer.gserviceaccount.com    

লক্ষ্য করুন যে দুটি ট্রিগার তৈরি করা হয়েছে:

gcloud eventarc triggers list --location=eu

১৪. পরীক্ষার পরিষেবা সংস্করণ

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

Cloud Storage ফিরে যান এবং ল্যাবের শুরুতে আমরা যে বাকেটটি তৈরি করেছিলাম সেটিতে ক্লিক করুন:

ff8a6567afc76235.png

বাকেট ডিটেইলস পেজে প্রবেশ করার পর, একটি ছবি আপলোড করার জন্য Upload files বাটনে ক্লিক করুন।

উদাহরণস্বরূপ, আপনার কোডবেসের সাথে /services/image-analysis/java ফোল্ডারে একটি GeekHour.jpeg ইমেজ দেওয়া আছে। একটি ইমেজ সিলেক্ট করুন এবং Open button চাপুন:

347b76e8b775f2f5.png

এখন আপনি প্রথমে image-analysis-jvm এবং তারপরে image-analysis-native সার্ভিসটির কার্যকারিতা পরীক্ষা করতে পারেন।

'হ্যামবার্গার' (☰) মেনু থেকে Cloud Run > image-analysis-jvm সার্ভিসটিতে যান।

লগ-এ ক্লিক করুন এবং আউটপুটটি পর্যবেক্ষণ করুন:

810a8684414ceafa.png

এবং প্রকৃতপক্ষে, লগগুলির তালিকায় আমি দেখতে পাচ্ছি যে JIT(JVM) পরিষেবা image-analysis-jvm আহ্বান করা হয়েছিল।

লগগুলো সার্ভিসটির কার্য সম্পাদনের শুরু এবং শেষ নির্দেশ করে। এবং এর মাঝে, আমরা আমাদের ফাংশনে INFO লেভেলের লগ স্টেটমেন্ট দিয়ে রাখা লগগুলো দেখতে পারি। আমরা দেখতে পাই:

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

আপনি image-analysis-native সার্ভিসটির জন্য প্রক্রিয়াটি পুনরাবৃত্তি করবেন।

'হ্যামবার্গার' (☰) মেনু থেকে Cloud Run > image-analysis-native সার্ভিসটিতে যান।

লগ-এ ক্লিক করুন এবং আউটপুটটি পর্যবেক্ষণ করুন:

b80308c7d0f55a3.png

এখন আপনাকে লক্ষ্য করতে হবে যে ছবির মেটাডেটা ফায়ারস্টোরে সংরক্ষিত হয়েছে কি না।

আবার 'হ্যামবার্গার' (☰) মেনু থেকে, Firestore বিভাগে যান। Data উপবিভাগে (যা ডিফল্টরূপে দেখানো হয়), আপনি pictures কালেকশনটি দেখতে পাবেন, যেখানে আপনার এইমাত্র আপলোড করা ছবিটির সাথে সম্পর্কিত একটি নতুন ডকুমেন্ট যুক্ত থাকবে:

933a20a9709cb006.png

১৫. পরিষ্কার করা (ঐচ্ছিক)

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

বাকেটটি মুছে ফেলুন:

gsutil rb gs://${BUCKET_PICTURES}

ফাংশনটি মুছে ফেলুন:

gcloud functions delete picture-uploaded --region europe-west1 -q

কালেকশন থেকে 'ডিলিট কালেকশন' নির্বাচন করে ফায়ারস্টোর কালেকশনটি মুছে ফেলুন:

410b551c3264f70a.png

বিকল্পভাবে, আপনি পুরো প্রজেক্টটি মুছে ফেলতে পারেন:

gcloud projects delete ${GOOGLE_CLOUD_PROJECT} 

১৬. অভিনন্দন!

অভিনন্দন! আপনি প্রকল্পের প্রথম মূল পরিষেবাটি সফলভাবে বাস্তবায়ন করেছেন!

আমরা যা আলোচনা করেছি

  • ক্লাউড স্টোরেজ
  • ক্লাউড রান
  • ক্লাউড ভিশন এপিআই
  • ক্লাউড ফায়ারস্টোর
  • নেটিভ জাভা ইমেজ

পরবর্তী পদক্ষেপ