Java Technologies Spring Cloud Zuul (Edge Server) গাইড ও নোট

Spring Cloud Zuul একটি Edge Service বা API Gateway হিসেবে কাজ করে, যা মাইক্রোসার্ভিস আর্কিটেকচারে ব্যবহৃত হয়। Zuul একটি রিভার্স প্রক্সি হিসেবে কাজ করে, যা ক্লায়েন্ট রিকোয়েস্টগুলিকে মাইক্রোসার্ভিসগুলির দিকে রিডাইরেক্ট করে, লোড ব্যালেন্সিং, রাউটিং, নিরাপত্তা, এবং অন্যান্য ক্রস-কাটিং কনসার্ন (যেমন, রেট লিমিটিং, অথেন্টিকেশন) পরিচালনা করতে সহায়ক।

Zuul মূলত Netflix Zuul এর উপর ভিত্তি করে তৈরি এবং Spring Cloud এর একটি অংশ হিসেবে কাজ করে, যেটি মাইক্রোসার্ভিস আর্কিটেকচারে এডজ সার্ভিস বা গেটওয়ে হিসেবে কাজ করে।

Spring Cloud Zuul এর প্রধান বৈশিষ্ট্য:

1. API Gateway:
   • Zuul সার্ভিসের মধ্যে সমস্ত রিকোয়েস্ট রাউটিং এবং রিভার্স প্রক্সি সেবা প্রদান করে, যার মাধ্যমে ক্লায়েন্ট রিকোয়েস্টগুলিকে উপযুক্ত মাইক্রোসার্ভিসে পাঠানো হয়।
2. Routing:
   • Zuul রিকোয়েস্টের জন্য কাস্টম রাউটিং নিয়ম সাপোর্ট করে, যা ক্লায়েন্ট রিকোয়েস্টকে সঠিক মাইক্রোসার্ভিসে পৌঁছে দেয়।
3. Load Balancing:
   • Zuul Eureka বা Ribbon এর মাধ্যমে লোড ব্যালেন্সিং সম্পাদন করে। এটি সার্ভিসের মধ্যে লোড সমানভাবে বিতরণ করতে সাহায্য করে।
4. Security:
   • Zuul সার্ভিস গেটওয়ে হিসেবে সমস্ত রিকোয়েস্টের উপর নিরাপত্তা প্রদান করতে পারে, যেমন OAuth2 বা JWT অথেন্টিকেশন।
5. Rate Limiting:
   • Zuul API গেটওয়ে হিসাবে বিভিন্ন রিকোয়েস্ট লিমিটেশন, যেমন রেট লিমিটিং এবং ট্রাফিক ম্যানেজমেন্ট সমর্থন করতে পারে।
6. Fault Tolerance:
   • Zuul সার্ভিসের সাথে Hystrix ব্যবহার করে সার্ভিস ব্যর্থতার প্রতিক্রিয়া হ্যান্ডলিং এবং সার্ভিসের রেজিলিয়েন্স অর্জন করা যায়।

Spring Cloud Zuul সেটআপ করার ধাপ:

১. ডিপেনডেন্সি যুক্ত করুন

প্রথমে, spring-cloud-starter-zuul ডিপেনডেন্সিটি আপনার pom.xml ফাইলে যোগ করুন।

<dependencies>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-zuul</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.cloud</groupId>
        <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
    </dependency>
</dependencies>

এই ডিপেনডেন্সি আপনার অ্যাপ্লিকেশনে Zuul এবং Eureka ক্লায়েন্ট ব্যবহার করার জন্য প্রয়োজনীয় লাইব্রেরি ইনক্লুড করবে।

২. @EnableZuulProxy অ্যানোটেশন ব্যবহার করুন

Zuul সার্ভিস অ্যাপ্লিকেশনটি চালু করতে, আপনি আপনার Spring Boot Application-এ @EnableZuulProxy অ্যানোটেশন ব্যবহার করবেন। এটি Zuul কে সার্ভিস গেটওয়ে হিসেবে কাজ করার জন্য সক্ষম করবে।

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.zuul.EnableZuulProxy;

@SpringBootApplication
@EnableZuulProxy
public class ZuulApiGatewayApplication {
    public static void main(String[] args) {
        SpringApplication.run(ZuulApiGatewayApplication.class, args);
    }
}

এখানে, @EnableZuulProxy অ্যানোটেশনটি Zuul প্রক্রিয়াকে সক্রিয় করবে এবং সার্ভিসের রিকোয়েস্ট রাউটিং প্রক্রিয়া শুরু করবে।

৩. Zuul রাউটিং কনফিগারেশন

Zuul এর মাধ্যমে রিকোয়েস্ট রাউটিং কনফিগার করার জন্য আপনি application.yml বা application.properties ফাইলের মধ্যে রাউটিং কনফিগারেশন করতে পারবেন।

application.yml:

zuul:
  routes:
    userservice:
      path: /user/**
      serviceId: user-service
    orderservice:
      path: /order/**
      serviceId: order-service
  ignored-services: '*'  # All services are handled by Zuul

এখানে, userservice এবং orderservice দুটি সার্ভিসের জন্য রাউটিং কনফিগার করা হয়েছে। যখন /user/** পাথ থেকে কোন রিকোয়েস্ট আসবে, তা user-service তে পাঠানো হবে এবং /order/** পাথ থেকে রিকোয়েস্ট আসলে তা order-service তে যাবে।

৪. Eureka সঙ্গে ইন্টিগ্রেশন (Optional)

Zuul সার্ভিস Eureka সার্ভিস ডিসকভারি এর সাথে ইন্টিগ্রেট হতে পারে, যা সার্ভিস রেজিস্ট্রেশন এবং ডিসকভারি সক্ষম করবে।

application.yml (Eureka এবং Zuul Integration):

spring:
  application:
    name: zuul-api-gateway

eureka:
  client:
    serviceUrl:
      defaultZone: http://localhost:8761/eureka
  instance:
    hostname: zuul-server

zuul:
  routes:
    userservice:
      path: /user/**
      serviceId: user-service
    orderservice:
      path: /order/**
      serviceId: order-service

এখানে, Eureka Client কনফিগার করা হয়েছে, এবং Zuul সার্ভিসকে user-service এবং order-service এর জন্য রাউটিং সেট করা হয়েছে।

৫. Zuul এর মাধ্যমে লোড ব্যালেন্সিং

Zuul Ribbon এর সাথে একত্রিত হয়ে ক্লায়েন্ট-সাইড লোড ব্যালেন্সিং সমর্থন করে। আপনি যদি Eureka ব্যবহার করেন, তবে Zuul স্বয়ংক্রিয়ভাবে সার্ভিস ডিসকভারি এবং লোড ব্যালেন্সিং পরিচালনা করবে।

৬. Zuul Filters (Optional)

Zuul ফিল্টার ব্যবহার করে আপনি সার্ভিস কলের জন্য প্রি/পোস্ট প্রসেসিং এবং রিকোয়েস্ট বা রেসপন্স লগিং, নিরাপত্তা, রেট লিমিটিং ইত্যাদি অ্যাড করতে পারেন।

উদাহরণ: Pre Filter

import com.netflix.zuul.ZuulFilter;
import org.springframework.stereotype.Component;

@Component
public class PreRequestFilter extends ZuulFilter {

    @Override
    public String filterType() {
        return "pre";  // Filter type - 'pre' means before routing the request
    }

    @Override
    public int filterOrder() {
        return 1;  // Filter execution order
    }

    @Override
    public boolean shouldFilter() {
        return true;  // Define when the filter should be applied
    }

    @Override
    public Object run() {
        System.out.println("Pre Filter: Request is about to be routed");
        return null;
    }
}

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

৭. Zuul Error Handling

Zuul API গেটওয়ের মাধ্যমে সার্ভিস ব্যর্থ হলে কাস্টম Error Handling করা যেতে পারে।

উদাহরণ: Error Filter

import com.netflix.zuul.ZuulFilter;
import org.springframework.stereotype.Component;

@Component
public class ErrorFilter extends ZuulFilter {

    @Override
    public String filterType() {
        return "error";  // Filter type - 'error' means error during routing
    }

    @Override
    public int filterOrder() {
        return 1;
    }

    @Override
    public boolean shouldFilter() {
        return true;
    }

    @Override
    public Object run() {
        System.out.println("Error Filter: An error occurred while routing the request");
        return null;
    }
}

এই ফিল্টারটি Zuul এর মাধ্যমে রিকোয়েস্ট রাউটিংয়ের সময় কোনো ত্রুটি হলে তা হ্যান্ডল করতে ব্যবহৃত হয়।

৮. Zuul এর মাধ্যমে নিরাপত্তা (Authentication)

Zuul ক্লায়েন্টের জন্য নিরাপত্তা নিশ্চিত করতে আপনি JWT বা OAuth2 ব্যাবহার করতে পারেন। Zuul এর মাধ্যমে সমস্ত রিকোয়েস্টের উপর নিরাপত্তা বা অথেন্টিকেশন অ্যাড করা যেতে পারে।

উপসংহার:

Spring Cloud Zuul একটি শক্তিশালী API গেটওয়ে সলিউশন, যা মাইক্রোসার্ভিস আর্কিটেকচারে রিকোয়েস্ট রাউটিং, লোড ব্যালেন্সিং, সিকিউরিটি এবং অন্যান্য ক্রস-কাটিং কনসার্নের জন্য কার্যকর। এটি Eureka, Ribbon, Hystrix সহ অন্যান্য স্প্রিং ক্লাউড প্রযুক্তির সাথে ইন্টিগ্রেট হয়ে সিস্টেমের স্থিতিশীলতা এবং স্কেলেবিলিটি নিশ্চিত করে।

Zuul হলো একটি API গেটওয়ে যা Spring Cloud দ্বারা সরবরাহিত, এবং এটি মাইক্রোসার্ভিস আর্কিটেকচারে ব্যবহৃত হয়। এটি মূলত রাউটিং, লোড ব্যালেন্সিং, ফিল্টারিং, সিকিউরিটি, এবং API ম্যানেজমেন্ট এর জন্য ব্যবহৃত হয়। Zuul API গেটওয়ে হিসেবে কাজ করে এবং সমস্ত মাইক্রোসার্ভিসের জন্য একক এক্সপোজার পয়েন্ট তৈরি করে।

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

Zuul এর প্রয়োজনীয়তা এবং ব্যবহার:

1. API গেটওয়ে:
   • Zuul মূলত একটি API গেটওয়ে হিসেবে কাজ করে, যেখানে সমস্ত মাইক্রোসার্ভিসের জন্য একক রাউটিং পয়েন্ট সরবরাহ করা হয়। এটি বিভিন্ন মাইক্রোসার্ভিসের মধ্যে রিকোয়েস্ট রাউট করতে সহায়ক। সব রিকোয়েস্ট প্রথমে Zuul গেটওয়ের মাধ্যমে যায় এবং তারপর Zuul গেটওয়ে রিকোয়েস্টকে সংশ্লিষ্ট মাইক্রোসার্ভিসে ফরওয়ার্ড করে।
2. রাউটিং:
   • Zuul বিভিন্ন মাইক্রোসার্ভিসের মধ্যে HTTP রিকোয়েস্ট রাউট করার জন্য ব্যবহৃত হয়। এটি প্রতিটি রিকোয়েস্টের জন্য সঠিক সার্ভিসে যাওয়ার পথ চিহ্নিত করে দেয়।
3. ফিল্টারিং:
   • Zuul ইনকামিং রিকোয়েস্ট এবং আউটগোইং রেসপন্সগুলোর জন্য ফিল্টার প্রয়োগ করতে সক্ষম। এই ফিল্টারগুলি রিকোয়েস্ট হ্যান্ডলিং, অথেনটিকেশন, অথরাইজেশন, লগিং, এবং ইরর হ্যান্ডলিং সহ বিভিন্ন কাজ করতে পারে।
4. লোড ব্যালেন্সিং:
   • Zuul Ribbon এর সাথে ইন্টিগ্রেটেড হয়ে সার্ভিস কল করার সময় লোড ব্যালেন্সিং নিশ্চিত করতে সক্ষম। যখন একাধিক সার্ভিস ইনস্ট্যান্স থাকে, Zuul তা সঠিকভাবে বাছাই করে।
5. সিকিউরিটি:
   • Zuul API গেটওয়ে হিসাবে সিকিউরিটি ফিচারও সরবরাহ করে। এটি সার্ভিস কলের জন্য অথেনটিকেশন, অথরাইজেশন এবং SSL সুরক্ষা সহজ করে তোলে।
6. ডাইনামিক রাউটিং:
   • Zuul বিভিন্ন সার্ভিসের মধ্যে রাউটিংয়ের জন্য কনফিগারেশন ওডি বা কনফিগারেশন রিপোজিটরি থেকে ডাইনামিকভাবে রাউটিং তথ্য নিয়ে কাজ করতে পারে।

Zuul এর প্রধান বৈশিষ্ট্য:

1. রাউটিং: Zuul সব রিকোয়েস্টের জন্য একক এক্সপোজার পয়েন্ট সরবরাহ করে এবং ইনকামিং রিকোয়েস্টগুলোকে সঠিক মাইক্রোসার্ভিসে রাউট করে। Zuul API গেটওয়ে হিসেবে সমস্ত সার্ভিস কলের জন্য রাউটিং পয়েন্ট হিসেবে কাজ করে।
2. ফিল্টারিং: Zuul বিভিন্ন ফিল্টার সমর্থন করে, যার মাধ্যমে আপনি রিকোয়েস্ট বা রেসপন্স প্রক্রিয়া করতে পারেন। কিছু সাধারণ ফিল্টারিং কার্যক্রম:
   • Authentication: ইউজারের অথেনটিকেশন চেক করা।
   • Logging: রিকোয়েস্ট এবং রেসপন্স লগিং।
   • Rate Limiting: সার্ভিসে রিকোয়েস্টের পরিমাণ সীমাবদ্ধ করা।
   • CORS (Cross-Origin Resource Sharing): CORS সাপোর্ট সংযুক্ত করা।
   • Error Handling: সেন্ট্রালাইজড ত্রুটি হ্যান্ডলিং পরিচালনা করা।
3. লোড ব্যালেন্সিং: Zuul Ribbon এর সাথে ইন্টিগ্রেটেড হয়ে সার্ভিস ইনস্ট্যান্সের মধ্যে লোড ব্যালেন্সিং প্রদান করে, যা সার্ভিসের মধ্যে রিকোয়েস্টগুলো সমানভাবে বিতরণ করতে সহায়ক।
4. ট্রাফিক ম্যানেজমেন্ট: Zuul ট্রাফিকের পরিমাণ কমাতে এবং পরিষেবা উন্নত করতে ব্যবহৃত হয়, বিশেষ করে যখন উচ্চ পরিমাণ ট্রাফিক এবং সার্ভিস রিকোয়েস্ট হ্যান্ডলিং করতে হয়।
5. SSL Termination: Zuul SSL/TLS টার্মিনেশন সাপোর্ট করে, অর্থাৎ Zuul সমস্ত HTTPS রিকোয়েস্ট গ্রহণ করে এবং সেগুলিকে HTTP রিকোয়েস্টে পরিণত করে সার্ভিসগুলির কাছে পাঠিয়ে দেয়।

Zuul কনফিগারেশন উদাহরণ:

1. Zuul API Gateway কনফিগারেশন:

pom.xml (Zuul Dependency):

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-zuul</artifactId>
</dependency>

application.yml (Zuul Configuration):

spring:
  application:
    name: zuul-gateway
  cloud:
    zuul:
      routes:
        my-service:
          path: /my-service/**
          service-id: my-service  # Eureka Service Discovery
      ignored-services: '*'  # Ignore some services

এখানে, my-service এর /my-service/** পাথে রিকোয়েস্ট আসলে তা my-service সার্ভিসে রাউট করা হবে। আপনি চাইলে ইউরেকার মাধ্যমে সার্ভিস ডিস্কভারি করতে পারেন।

2. Zuul ফিল্টার উদাহরণ:

Zuul একটি ফিল্টারিং সিস্টেম ব্যবহার করে, যা ইনকামিং রিকোয়েস্ট এবং আউটগোইং রেসপন্স এর উপর বিভিন্ন ফিল্টার কার্যকর করতে সক্ষম।

Custom Filter Example:

import com.netflix.zuul.ZuulFilter;
import com.netflix.zuul.context.RequestContext;
import org.springframework.stereotype.Component;

@Component
public class MyCustomFilter extends ZuulFilter {

    @Override
    public String filterType() {
        return "pre";  // pre-filter (before routing)
    }

    @Override
    public int filterOrder() {
        return 1;  // filter order
    }

    @Override
    public boolean shouldFilter() {
        return true;  // Always execute the filter
    }

    @Override
    public Object run() {
        RequestContext ctx = RequestContext.getCurrentContext();
        System.out.println("This is a custom Zuul filter!");
        return null;
    }
}

এখানে pre টাইপের ফিল্টার ব্যবহার করা হয়েছে, যা রিকোয়েস্ট সার্ভিসে রাউট করার আগে কার্যকর হবে।

Zuul এর সুবিধা:

1. কেন্দ্রীভূত API গেটওয়ে: সমস্ত মাইক্রোসার্ভিসের জন্য একটি কেন্দ্রীয় API গেটওয়ে হিসেবে কাজ করে।
2. ফিল্টারিং: সার্ভিস রিকোয়েস্ট এবং রেসপন্সের জন্য কাস্টম ফিল্টার তৈরি করা যায়।
3. লোড ব্যালেন্সিং: সার্ভিস রিকোয়েস্টের মধ্যে লোড ব্যালেন্সিং এবং রাউটিং সমর্থিত।
4. সিকিউরিটি: API গেটওয়ে হিসেবে সার্ভিসের সিকিউরিটি সহজতর করা যায়।
5. ডাইনামিক রাউটিং: কনফিগারেশন রিফ্রেশ বা সিস্টেমের চাহিদা অনুযায়ী রাউটিং কনফিগারেশন আপডেট করা যায়।

উপসংহার:

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

Zuul এবং API Gateway (যা Spring Cloud Gateway হিসেবে পরিচিত) হল দুটি ভিন্ন প্রযুক্তি যা মাইক্রোসার্ভিস আর্কিটেকচারের জন্য API গেটওয়ে হিসেবে কাজ করে। উভয়েরই মূল উদ্দেশ্য হলো মাইক্রোসার্ভিসগুলোর মধ্যে রাউটিং, লোড ব্যালেন্সিং, নিরাপত্তা, এবং ফিল্টারিং কাজগুলো পরিচালনা করা। তবে, Zuul এবং Spring Cloud Gateway-এর মধ্যে কিছু গুরুত্বপূর্ণ পার্থক্য রয়েছে।

Zuul vs Spring Cloud Gateway: পার্থক্য

Zuul:

• Netflix Zuul হল একটি পুরানো API গেটওয়ে যা Netflix মাইক্রোসার্ভিস আর্কিটেকচারের জন্য তৈরি করা হয়েছিল।
• এটি সিনক্রোনাস (Blocking) প্রক্রিয়াতে কাজ করে, যেখানে প্রতি HTTP রিকোয়েস্ট ব্লক হয়ে থাকে যতক্ষণ না সার্ভিস থেকে রেসপন্স আসে।
• Zuul 1.x ফিচার প্রদান করে, তবে Zuul 2.x রিলিজ করা হয়েছিল, যা কিছু উন্নত ফিচার এবং পারফরম্যান্স প্রদান করে।
• Zuul-এ Ribbon এবং Eureka ব্যবহার করে লোড ব্যালেন্সিং এবং সার্ভিস ডিসকভারি হয়, এবং এটি Spring Cloud এবং Netflix OSS এর অংশ।

Spring Cloud Gateway:

• Spring Cloud Gateway হল Spring Framework-এর একটি আধুনিক প্রকল্প যা Spring 5 এবং Spring WebFlux-এর উপর ভিত্তি করে তৈরি।
• এটি রিঅ্যাক্টিভ (Non-blocking) আর্কিটেকচার ব্যবহার করে, যা অনেক রিকোয়েস্ট সহজে হ্যান্ডল করতে সক্ষম এবং এটি স্কেলেবিলিটি এবং পারফরম্যান্সের দিক থেকে বেশ কার্যকর।
• Spring Cloud Gateway একটি মডার্ন API গেটওয়ে হিসেবে কাজ করে এবং Spring Boot অ্যাপ্লিকেশনের জন্য কনফিগারেশন এবং ব্যবস্থাপনা সহজ করে।
• এতে বিল্ট-ইন filters রয়েছে যা রিকোয়েস্ট এবং রেসপন্সকে কাস্টমাইজ করার জন্য ব্যবহার করা যায়, যেমন রেট লিমিটিং, সিকিউরিটি চেকস, এবং লগিং।
• Spring Cloud Gateway Spring Boot অ্যাপ্লিকেশনের অংশ হিসেবে সহজে ইন্টিগ্রেট করা যায়।

কখন Zuul ব্যবহার করবেন?

• আপনি যদি পুরানো Netflix stack (Ribbon, Eureka) ব্যবহার করে থাকেন এবং Zuul এর সাথে কাজ করছেন, তবে Zuul উপযুক্ত হতে পারে।
• যেহেতু Zuul একটি সিনক্রোনাস API গেটওয়ে, এটি সেই পরিস্থিতিতে ব্যবহার করা যেতে পারে যেখানে সিঙ্ক্রোনাস অপারেশন সমর্থন করা প্রয়োজন।

কখন Spring Cloud Gateway ব্যবহার করবেন?

• আপনি যদি একটি রিঅ্যাক্টিভ এবং হাই পারফরম্যান্স API গেটওয়ে চান, তাহলে Spring Cloud Gateway ব্যবহার করা উচিত।
• Microservices এবং Cloud-Native Applications তৈরি করার জন্য Spring Cloud Gateway অধিক সুবিধাজনক, যেহেতু এটি Spring Boot অ্যাপ্লিকেশনের সাথে সহজেই ইন্টিগ্রেট করা যায়।

উপসংহার:

• Zuul একটি পুরানো প্রযুক্তি এবং সিনক্রোনাস প্যাটার্নে কাজ করে, যেখানে Spring Cloud Gateway রিঅ্যাক্টিভ এবং নন-ব্লকিং প্রযুক্তি ব্যবহার করে যা অধিক পারফরম্যান্স এবং স্কেলেবিলিটি প্রদান করে।
• Spring Cloud Gateway আধুনিক এবং মডার্ন ফিচার সমর্থন করে এবং এটি Spring Boot অ্যাপ্লিকেশনের সাথে ভালোভাবে কাজ করে, তাই এটি বেশি জনপ্রিয় এবং ব্যবহৃত হচ্ছে।

Spring Cloud Zuul একটি রিভার্স প্রোক্সি সার্ভিস যা মাইক্রোসার্ভিসগুলির মধ্যে রাউটিং এবং ফিল্টারিং ব্যবস্থাপনা সহজ করে। এটি মূলত API গেটওয়ে হিসেবে কাজ করে, যেখানে ক্লায়েন্টদের HTTP রিকোয়েস্ট বিভিন্ন মাইক্রোসার্ভিসে রিডাইরেক্ট বা ফরওয়ার্ড করা হয়। Zuul-এর মাধ্যমে সার্ভিসগুলির মধ্যে লোড ব্যালেন্সিং, রাউটিং, অথেনটিকেশন, লগিং, ফিল্টারিং ইত্যাদি কার্যকরভাবে করা যায়।

এখানে Zuul এর মাধ্যমে Routing এবং Filtering কিভাবে করা যায় তা নিয়ে বিস্তারিত আলোচনা করা হবে।

Spring Cloud Zuul Configuration

Spring Cloud Zuul একটি API Gateway হিসেবে কাজ করে এবং এটি HTTP রিকোয়েস্ট গুলিকে সার্ভিসে রাউট করতে সাহায্য করে।

Zuul-এ Routing কনফিগারেশন

Zuul আপনাকে ক্লায়েন্ট রিকোয়েস্টকে নির্দিষ্ট সার্ভিসে রাউট করতে সাহায্য করে। একটি Zuul Server তৈরি করা হয় যা সব রিকোয়েস্টকে প্রয়োজনীয় সার্ভিসে রিডাইরেক্ট করে।

1. Zuul API Gateway Configuration

Maven Dependency (pom.xml)

Zuul ব্যবহার করতে হলে, আপনাকে spring-cloud-starter-zuul ডিপেনডেন্সি যোগ করতে হবে।

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-zuul</artifactId>
</dependency>

Zuul Server Configuration (application.yml)

Zuul এর জন্য কনফিগারেশন করা হয় যেখানে আপনি রাউটিং লজিক এবং সার্ভিস URL নির্ধারণ করতে পারেন।

server:
  port: 8080

spring:
  application:
    name: zuul-server

zuul:
  routes:
    users-service: # 'users-service' will be routed to the below URI
      path: /users/** 
      url: http://localhost:8081
    orders-service:
      path: /orders/**
      url: http://localhost:8082

• zuul.routes: এখানে আমরা users-service এবং orders-service এর জন্য রাউটিং কনফিগার করেছি।
• path: রিকোয়েস্টের URL প্যাটার্ন। এই প্যাটার্নের সাথে মিলিয়ে রিকোয়েস্ট অন্য সার্ভিসে রাউট করা হবে।
• url: লক্ষ্য সার্ভিসের URL।

2. Zuul Server Enablement

Zuul কে সক্রিয় করার জন্য @EnableZuulProxy অ্যানোটেশন ব্যবহার করতে হয়।

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.zuul.EnableZuulProxy;

@SpringBootApplication
@EnableZuulProxy  // Enable Zuul proxy functionality
public class ZuulServerApplication {
    public static void main(String[] args) {
        SpringApplication.run(ZuulServerApplication.class, args);
    }
}

3. Client Services (User and Order Services)

Zuul API Gateway দিয়ে রাউট করা হবে এমন সার্ভিসের উদাহরণ:

User Service (user-service):

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
@RestController
public class UserServiceApplication {

    public static void main(String[] args) {
        SpringApplication.run(UserServiceApplication.class, args);
    }

    @GetMapping("/users")
    public String getUsers() {
        return "Users from User Service";
    }
}

Order Service (order-service):

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@SpringBootApplication
@RestController
public class OrderServiceApplication {

    public static void main(String[] args) {
        SpringApplication.run(OrderServiceApplication.class, args);
    }

    @GetMapping("/orders")
    public String getOrders() {
        return "Orders from Order Service";
    }
}

Zuul Filtering

Zuul বিভিন্ন ধরনের ফিল্টার প্রদান করে যা রিকোয়েস্ট এবং রেসপন্স প্রক্রিয়া কাস্টমাইজ করার জন্য ব্যবহার করা যেতে পারে। Pre Filter, Route Filter, Post Filter, এবং Error Filter এই ৪টি প্রধান ফিল্টার টাইপ Zuul এ রয়েছে।

4. Pre Filter Example

Pre Filter রিকোয়েস্ট সার্ভিসে পৌঁছানোর আগেই প্রক্রিয়া করা হয়। এটি সাধারণত অথেনটিকেশন বা লগিংয়ের জন্য ব্যবহৃত হয়।

import com.netflix.zuul.ZuulFilter;
import org.springframework.stereotype.Component;

@Component
public class PreFilter extends ZuulFilter {

    @Override
    public String filterType() {
        return "pre"; // This filter will execute before the request is routed to the destination
    }

    @Override
    public int filterOrder() {
        return 1; // Filter order, lower value means higher priority
    }

    @Override
    public boolean shouldFilter() {
        return true; // Always apply this filter
    }

    @Override
    public Object run() {
        System.out.println("Pre Filter: Request is being processed.");
        return null; // Continue with the request processing
    }
}

• filterType(): pre মানে রিকোয়েস্ট সার্ভিসে পৌঁছানোর আগে এটি রান করবে। আপনি route, post, বা error টাইপও ব্যবহার করতে পারেন।
• shouldFilter(): ফিল্টারটি চালানো উচিত কিনা তা চেক করা হয়।
• run(): ফিল্টারের কার্যকলাপ যেখানে আপনি লগিং বা অথেনটিকেশন করতে পারেন।

5. Post Filter Example

Post Filter রিকোয়েস্ট সার্ভিস থেকে রেসপন্স আসার পর এক্সিকিউট হয়। এটি লগিং বা রেসপন্স ট্রান্সফর্ম করতে ব্যবহার করা যেতে পারে।

import com.netflix.zuul.ZuulFilter;
import org.springframework.stereotype.Component;

@Component
public class PostFilter extends ZuulFilter {

    @Override
    public String filterType() {
        return "post"; // This filter will execute after the request is routed to the destination
    }

    @Override
    public int filterOrder() {
        return 1; // Filter order, higher value means lower priority
    }

    @Override
    public boolean shouldFilter() {
        return true; // Always apply this filter
    }

    @Override
    public Object run() {
        System.out.println("Post Filter: Response is being processed.");
        return null; // Continue with the response processing
    }
}

6. Error Filter Example

Error Filter তখন কার্যকর হয় যখন কোনো রিকোয়েস্টে ত্রুটি হয় এবং সার্ভিসে কোনো সমস্যা দেখা দেয়।

import com.netflix.zuul.ZuulFilter;
import org.springframework.stereotype.Component;

@Component
public class ErrorFilter extends ZuulFilter {

    @Override
    public String filterType() {
        return "error"; // This filter will execute in case of an error in the request processing
    }

    @Override
    public int filterOrder() {
        return 1; // Filter order
    }

    @Override
    public boolean shouldFilter() {
        return true; // Always apply this filter
    }

    @Override
    public Object run() {
        System.out.println("Error Filter: An error occurred during the request processing.");
        return null;
    }
}

Zuul Routing and Filtering Best Practices:

1. Security: Zuul API Gateway ব্যবহার করার সময় নিরাপত্তা নিশ্চিত করুন, যেমন অথেনটিকেশন টোকেন যাচাই করা, ডোজ জিপ আক্রমণ প্রতিরোধ করা ইত্যাদি।
2. Logging: প্রতিটি রিকোয়েস্টের জন্য লগিং কার্যকর করুন, যাতে পরে সহজে ট্রাবলশুটিং করা যায়।
3. Error Handling: রাউটিং এবং ফিল্টারিং এ ত্রুটি পরিচালনা করার জন্য কাস্টম ErrorFilter ব্যবহার করুন।
4. Load Balancing: Zuul এর মাধ্যমে লোড ব্যালেন্সিং এবং সার্ভিস ডিসকভারি কনফিগার করুন যাতে আপনার অ্যাপ্লিকেশন স্কেলেবল এবং রেসিলিয়েন্ট হয়।
5. Filter Optimization: ফিল্টারগুলির কার্যকারিতা অপটিমাইজ করুন যাতে রিকোয়েস্ট/রেসপন্স প্রক্রিয়াগুলি দ্রুত এবং নির্ভরযোগ্য হয়।

উপসংহার:

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

Zuul হল একটি API Gateway এবং Edge Service যা স্প্রিং ক্লাউডের অংশ হিসেবে ব্যবহৃত হয়। এটি মাইক্রোসার্ভিস আর্কিটেকচারে সার্ভিসগুলোর মধ্যে রাউটিং, লোড ব্যালান্সিং, সিকিউরিটি, রেট লিমিটিং, এবং অন্যান্য কনসার্নগুলির সমাধান করতে ব্যবহৃত হয়। Zuul মূলত HTTP রিকোয়েস্টের জন্য একটি এন্ট্রি পয়েন্ট হিসেবে কাজ করে এবং ইন্টারনাল সার্ভিসগুলির মধ্যে রাউটিং করে।

Zuul Edge Server Setup

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

ধাপ ১: Zuul Server ডিপেনডেন্সি যোগ করা

spring-cloud-starter-netflix-zuul ডিপেনডেন্সি pom.xml ফাইলে যোগ করুন:

pom.xml (Zuul Server):

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-zuul</artifactId>
</dependency>

ধাপ ২: Zuul Server কনফিগারেশন

Zuul Server সক্রিয় করার জন্য @EnableZuulProxy অ্যানোটেশন ব্যবহার করতে হবে। এটি Zuul কে API গেটওয়ে হিসেবে কনফিগার করে এবং এটি সমস্ত রাউটিং কাজ পরিচালনা করবে।

Zuul Server Application Class:

package com.example.zuulserver;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.netflix.zuul.EnableZuulProxy;

@SpringBootApplication
@EnableZuulProxy
public class ZuulServerApplication {

    public static void main(String[] args) {
        SpringApplication.run(ZuulServerApplication.class, args);
    }
}

এখানে @EnableZuulProxy অ্যানোটেশন Zuul প্রোক্সি সক্রিয় করে দেয়, যা API গেটওয়ে হিসেবে কাজ করবে এবং রাউটিং করবে।

ধাপ ৩: Zuul সার্ভিসের জন্য রাউটিং কনফিগারেশন

application.yml বা application.properties ফাইলে Zuul রাউটিং কনফিগারেশন করতে হবে, যেখানে আপনি মাইক্রোসার্ভিসগুলোর জন্য রাউটিং পথ এবং সার্ভিসের URL উল্লেখ করবেন।

application.yml (Zuul Server):

server:
  port: 8080

spring:
  application:
    name: zuul-server

zuul:
  routes:
    user-service:
      path: /user/**  # 'user-service' এর জন্য /user/** রাউটিং
      service-id: user-service
    product-service:
      path: /product/**  # 'product-service' এর জন্য /product/** রাউটিং
      service-id: product-service
  ribbon:
    ReadTimeout: 5000
    ConnectTimeout: 5000

এখানে:

• zuul.routes: রাউটিং কনফিগারেশন, যেখানে path এবং service-id উল্লেখ করা হয়েছে।
• service-id হল মাইক্রোসার্ভিসের নাম যা Eureka সার্ভিস ডিসকভারি ব্যবহার করলে পাওয়া যাবে।
• /user/** এবং /product/** হল Zuul-এ মাইক্রোসার্ভিসগুলির জন্য এক্সপোজড এন্ডপয়েন্ট।

ধাপ ৪: Eureka Server কনফিগারেশন (Optional)

Zuul সার্ভার Eureka সার্ভিস ডিসকভারি ব্যবহার করতে পারে। যদি আপনি মাইক্রোসার্ভিস রেজিস্ট্রেশন এবং ডিসকভারি করতে চান, তাহলে Eureka Server কনফিগার করতে হবে।

pom.xml (Eureka Client):

<dependency>
    <groupId>org.springframework.cloud</groupId>
    <artifactId>spring-cloud-starter-netflix-eureka-client</artifactId>
</dependency>

application.yml (Zuul Server with Eureka):

spring:
  application:
    name: zuul-server
  cloud:
    discovery:
      enabled: true  # Eureka সার্ভিস ডিসকভারি সক্ষম
    zuul:
      routes:
        user-service:
          path: /user/**
          service-id: user-service
        product-service:
          path: /product/**
          service-id: product-service

এখানে service-id হল Eureka-তে নিবন্ধিত মাইক্রোসার্ভিসের নাম, এবং Zuul সেই সার্ভিসগুলো থেকে রিকোয়েস্ট পাঠাবে।

ধাপ ৫: Zuul Client Service Setup

Zuul Client Service একটি মাইক্রোসার্ভিস হবে যেটি Zuul Server থেকে রাউট হওয়া রিকোয়েস্ট পাবেন।

User Service Example:

UserServiceApplication.java:

package com.example.userservice;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class UserServiceApplication {

    public static void main(String[] args) {
        SpringApplication.run(UserServiceApplication.class, args);
    }
}

application.yml (User Service):

server:
  port: 8081

spring:
  application:
    name: user-service

এখানে, user-service হচ্ছে Eureka বা Zuul সার্ভারে নিবন্ধিত সার্ভিস।

ধাপ ৬: Zuul Server Test

Zuul সার্ভার রান করার পর, আপনি **/user/** এবং /product/** URL পাথের মাধ্যমে মাইক্রোসার্ভিসগুলিতে পৌঁছাতে পারবেন। উদাহরণস্বরূপ:

• http://localhost:8080/user/api/users এই URL-এর মাধ্যমে Zuul User Service এন্ডপয়েন্টে রিকোয়েস্ট পাঠাবে।
• http://localhost:8080/product/api/products এই URL-এর মাধ্যমে Zuul Product Service এন্ডপয়েন্টে রিকোয়েস্ট পাঠাবে।

এখানে, Zuul Server রিকোয়েস্টগুলি user-service এবং product-service মাইক্রোসার্ভিসগুলিতে রাউট করবে।

ধাপ ৭: Zuul Client এর সাথে সিকিউরিটি এবং ফিচার

Zuul সার্ভারের মধ্যে আরও অনেক ফিচার যোগ করা যায়:

• Authentication and Authorization: Zuul সার্ভার এবং মাইক্রোসার্ভিসের মধ্যে সিকিউরিটি ব্যবস্থা প্রয়োগ করতে পারেন।
• Filters: Zuul ফিল্টার ব্যবহার করে রিকোয়েস্ট এবং রেসপন্সে পরিবর্তন বা প্রক্রিয়াকরণ করতে পারেন (যেমন, লগিং, সিকিউরিটি, রেট লিমিটিং ইত্যাদি)।

Example: Zuul Filter

import com.netflix.zuul.ZuulFilter;
import org.springframework.stereotype.Component;

@Component
public class MyZuulFilter extends ZuulFilter {

    @Override
    public String filterType() {
        return "pre"; // রিকোয়েস্ট আসার আগে ফিল্টার কার্যকর হবে
    }

    @Override
    public int filterOrder() {
        return 1;
    }

    @Override
    public boolean shouldFilter() {
        return true;
    }

    @Override
    public Object run() {
        // ফিল্টার লজিক
        System.out.println("Request is being filtered");
        return null;
    }
}

সারাংশ:

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