ক্লাউড এসকিউএল-এ একটি স্প্রিং বুট অ্যাপ সংযুক্ত করুন

১. শুরু করার আগে

ক্লাউড এসকিউএল একটি সম্পূর্ণরূপে পরিচালিত ডাটাবেস পরিষেবা যা গুগল ক্লাউডে আপনার রিলেশনাল ডাটাবেস সেট আপ, রক্ষণাবেক্ষণ, পরিচালনা এবং পরিচালনা করা সহজ করে তোলে। আপনি ক্লাউড এসকিউএল মাইএসকিউএলের জন্য ক্লাউড এসকিউএল অথবা পোস্টগ্রেএসকিউএলের জন্য ক্লাউড এসকিউএল ব্যবহার করতে পারেন।

এই কোডল্যাবে, আপনি শিখবেন কিভাবে MySQL ইনস্ট্যান্সের জন্য একটি ক্লাউড SQL সেট আপ করবেন এবং তারপর ক্লাউড SQL ইনস্ট্যান্সকে ব্যাকএন্ড স্টোরেজ হিসেবে ব্যবহার করার জন্য একটি স্প্রিং বুট অ্যাপ আপডেট করবেন। গুগল ক্লাউড SQL এর জন্য স্প্রিং বুট স্টার্টার একটি স্বয়ংক্রিয়ভাবে কনফিগার করা ডেটাসোর্স প্রদান করে, যা আপনাকে আপনার কোডে ন্যূনতম পরিবর্তন সহ সহজেই ক্লাউড SQL এর সুবিধা নিতে দেয়। এই কোডল্যাবটি স্প্রিং পেটক্লিনিক সোর্স কোড ব্যবহার করে।

পূর্বশর্ত

• জাভা প্রোগ্রামিং ভাষা এবং সরঞ্জামগুলির সাথে পরিচিতি
• ভিম, ইম্যাকস এবং ন্যানোর মতো স্ট্যান্ডার্ড লিনাক্স টেক্সট এডিটর সম্পর্কে জ্ঞান থাকা।

তুমি কি করবে

• আপনার স্প্রিং বুট অ্যাপে ক্লাউড এসকিউএল ব্যবহার করুন।

তোমার যা লাগবে

• একটি গুগল ক্লাউড প্রকল্প
• একটি ব্রাউজার, যেমন গুগল ক্রোম বা ফায়ারফক্স

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

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

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

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

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

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

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

ক্লাউড শেল সক্রিয় করুন

1. ক্লাউড কনসোল থেকে, ক্লাউড শেল সক্রিয় করুন ক্লিক করুন .

যদি আপনি প্রথমবারের মতো ক্লাউড শেল শুরু করেন, তাহলে আপনাকে একটি মধ্যবর্তী স্ক্রিন দেখানো হবে যা এটি কী তা বর্ণনা করবে। যদি আপনার কাছে একটি মধ্যবর্তী স্ক্রিন থাকে, তাহলে Continue এ ক্লিক করুন।

ক্লাউড শেলের সাথে সংযোগ স্থাপন এবং সংযোগ স্থাপন করতে মাত্র কয়েক মুহূর্ত সময় লাগবে।

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

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

2. আপনি প্রমাণিত কিনা তা নিশ্চিত করতে ক্লাউড শেলে নিম্নলিখিত কমান্ডটি চালান:

gcloud auth list

কমান্ড আউটপুট

 Credentialed Accounts
ACTIVE  ACCOUNT
*       <my_account>@<my_domain.com>

To set the active account, run:
    $ gcloud config set account `ACCOUNT`

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

3. gcloud কমান্ড আপনার প্রকল্প সম্পর্কে জানে কিনা তা নিশ্চিত করতে ক্লাউড শেলে নিম্নলিখিত কমান্ডটি চালান:

gcloud config list project

কমান্ড আউটপুট

[core]
project = <PROJECT_ID>

যদি তা না হয়, তাহলে আপনি এই কমান্ড দিয়ে এটি সেট করতে পারেন:

gcloud config set project <PROJECT_ID>

কমান্ড আউটপুট

Updated property [core/project].

দ্রষ্টব্য: যদি আপনি ক্লাউড শেলের বাইরে এই টিউটোরিয়ালটি সম্পন্ন করেন, তাহলে "সেট আপ অ্যাপ্লিকেশন ডিফল্ট শংসাপত্র" অনুসরণ করুন।

৩. MySQL ইনস্ট্যান্সের জন্য একটি ক্লাউড SQL সেট আপ করুন

1. ক্লাউড শেল চালু হওয়ার পরে, আপনি একটি নতুন ক্লাউড এসকিউএল ইনস্ট্যান্স তৈরি করতে কমান্ড লাইন ব্যবহার করতে পারেন:

$ gcloud sql instances create my-instance

এই অপারেশনটি সম্পন্ন হলে, আপনার ইনস্ট্যান্সটি ব্যবহারের জন্য প্রস্তুত হবে।

2. এখন একটি ডাটাবেস তৈরি করুন যা আপনি পেটক্লিনিক অ্যাপের জন্য ব্যবহার করবেন:

$ gcloud sql databases create petclinic --instance my-instance

আপনি ক্লাউড কনসোলের মাধ্যমেও ইনস্ট্যান্সটি অ্যাক্সেস এবং কনফিগার করতে পারেন।

একটি ক্লাউড এসকিউএল ইনস্ট্যান্স জোনাল। এর অর্থ হল এটি গুগল ক্লাউড জোনের একটিতে চলবে। এই কোডল্যাবে, আপনি জোন বা অঞ্চল নির্দিষ্ট করবেন না। কমান্ড লাইন স্বয়ংক্রিয়ভাবে অঞ্চল হিসাবে us-central ব্যবহার করবে এবং আপনার ডাটাবেস হোস্ট করার জন্য একটি জোন বেছে নেবে। আরও তথ্যের জন্য, gcloud sql instances create দেখুন।

3. নিম্নলিখিত কমান্ডটি চালিয়ে project-id:zone-id:instance-id ফর্ম্যাটে ইনস্ট্যান্স সংযোগের নামটি পান। আপনি পরে আপনার স্প্রিং বুট অ্যাপটি কনফিগার করার সময় এটি ব্যবহার করবেন।

$ gcloud sql instances describe my-instance | grep connectionName

৪. স্থানীয়ভাবে পেটক্লিনিক অ্যাপটি ক্লোন করুন এবং পরীক্ষা করুন

1. আপনি এখন স্থানীয়ভাবে পেটক্লিনিক অ্যাপটি ক্লোন করবেন।

$ git clone https://github.com/spring-projects/spring-petclinic

$ cd spring-petclinic

2. সঠিক জাভা সংস্করণ সেট করা আছে কিনা তা নিশ্চিত করুন এবং স্থানীয়ভাবে পেটক্লিনিক অ্যাপটি চালান।

$ export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64/

$ ./mvnw spring-boot:run

3. ওয়েব প্রিভিউতে ক্লিক করুন ক্লাউড শেল-এ, তারপর পোর্ট 8080-এ প্রিভিউ নির্বাচন করুন।

আপনার ব্রাউজারে এখানে দেখানো পেটক্লিনিক হোমপেজটি দেখতে পাবেন:

4. ঘুরে দেখুন এবং ডেটা যোগ করুন। অ্যাপটি একটি ইন-মেমরি হাইপারএসকিউএল ডাটাবেস ব্যবহার করে। আপনি এখন হাইপারএসকিউএল থেকে ক্লাউড এসকিউএল ডাটাবেস ব্যবহার করতে পারবেন।

৫. পেটক্লিনিকে ক্লাউড এসকিউএল ব্যবহার করুন

Maven pom.xml ফাইলটি আপডেট করুন।

এখানে দেখানো pom.xml ফাইলটি আপডেট করুন। স্টার্টারটি আপনার ক্লাউড SQL ডাটাবেসের সাথে সংযোগ স্থাপনের জন্য একটি স্বয়ংক্রিয়ভাবে কনফিগার করা DataSource অবজেক্ট সরবরাহ করে। ফাইলটি সম্পাদনা করার জন্য আপনি Vim, nano, অথবা Emacs ব্যবহার করতে পারেন।

pom.xml সম্পর্কে

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" ...>
    ...
    <!-- Add Spring Cloud GCP Dependency BOM -->
    <dependencyManagement>
        <dependencies>
          <dependency>
          <groupId>com.google.cloud</groupId>
          <artifactId>spring-cloud-gcp-dependencies</artifactId>
          <version>4.1.4</version>
          <type>pom</type>
          <scope>import</scope>
          </dependency>
      </dependencies>
    </dependencyManagement>
    <dependencies>
      ...
      <!-- Add CloudSQL Starter for MySQL -->
      <dependency>
        <groupId>com.google.cloud</groupId>
        <artifactId>spring-cloud-gcp-starter-sql-mysql</artifactId>
      </dependency>
      ...
    </dependencies>
</project>

application-mysql.properties আপডেট করুন

1. src/main/resources/application-mysql.properties এর কন্টেন্ট নিম্নলিখিত বৈশিষ্ট্য দিয়ে প্রতিস্থাপন করুন । আপনাকে আগের ধাপ থেকে ইনস্ট্যান্স সংযোগের নাম সেট করতে হবে।

src/main/resources/application-mysql.properties

database=mysql

spring.cloud.gcp.sql.database-name=petclinic
spring.cloud.gcp.sql.instance-connection-name=YOUR_CLOUD_SQL_INSTANCE_CONNECTION_NAME

# Initialize the database since the newly created Cloud SQL database has no tables. The following flag is for Spring Boot 2.5+.
spring.sql.init.mode=always  

2. অবশেষে, স্প্রিং বুট অ্যাপে application.properties এর spring.profiles.active প্রপার্টিতে mysql যোগ করে MySQL প্রোফাইলের জন্য একটি ক্লাউড SQL সক্ষম করুন:

src/main/resources/application.properties

# Keep the content of the file the same
...

# In the last line, add mysql to the spring.profiles.active property
spring.profiles.active=mysql

৬. ক্লাউড শেলে অ্যাপটি চালান

1. আপনি স্প্রিং বুট প্লাগইন দিয়ে সাধারণত স্প্রিং বুট অ্যাপটি শুরু করতে পারেন:

$ ./mvnw -DskipTests spring-boot:run

2. অ্যাপটি শুরু হয়ে গেলে, ওয়েব প্রিভিউতে ক্লিক করুন। ক্লাউড শেল টুলবারে, তারপর পোর্ট 8080-এ প্রিভিউ নির্বাচন করুন।

আপনার ব্রাউজারে এখানে দেখানো স্প্রিং পেটক্লিনিক হোমপেজটি আবার দেখতে পাবেন:

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

3. পোষা প্রাণীর মালিকের নাম যোগ করুন।

ঐচ্ছিক: যাচাই করুন যে ক্লাউড SQL ডেটা ধরে রেখেছে।

আপনি যাচাই করতে পারেন যে আপনার প্রবেশ করানো ডেটা এখানে দেখানো হিসাবে ক্লাউড SQL-এ স্থায়ী হয়েছে। পাসওয়ার্ড চাওয়া হলে এন্টার টিপুন।

$ gcloud sql connect my-instance -u root
Whitelisting your IP for incoming connection for 5 minutes...done.
Enter password: <Press Enter, there is no password by default>
...
mysql> use petclinic;
mysql> select * from owners;

ঐচ্ছিক: আপনার ক্লাউড SQL ইনস্ট্যান্স মুছে ফেলুন

একবার আপনার অ্যাপটি বন্ধ করে দিলে, আপনি নিম্নলিখিত কমান্ড ব্যবহার করে ক্লাউড SQL ইনস্ট্যান্সটি মুছে ফেলতে পারেন:

$ gcloud sql instances delete my-instance

৭. অভিনন্দন

তুমি তোমার স্প্রিং বুট অ্যাপে ক্লাউড এসকিউএল-এর সাথে সংযোগ স্থাপন শিখেছ!

আরও জানুন

• ক্লাউড এসকিউএল ডকুমেন্টেশন
• স্প্রিং ক্লাউড জিসিপি
• স্প্রিং ক্লাউড জিসিপি গিটহাব রিপোজিটরি
• গুগল ক্লাউডে জাভা