Kubernetes টিপস এবং কৌশল: NGINX ইনগ্রেসে কাস্টম ত্রুটি পৃষ্ঠা

এই নিবন্ধে, আমি ব্যক্তিগতকৃত ত্রুটি পৃষ্ঠাগুলি প্রদর্শনের সাথে সম্পর্কিত NGINX প্রবেশের দুটি বৈশিষ্ট্য, সেইসাথে তাদের মধ্যে বিদ্যমান সীমাবদ্ধতা এবং তাদের চারপাশে কাজ করার উপায় সম্পর্কে কথা বলতে চাই।

1. ডিফল্ট ব্যাকএন্ড পরিবর্তন করা

ডিফল্টরূপে, NGINX Ingress ডিফল্ট ব্যাকএন্ড ব্যবহার করে, যা সংশ্লিষ্ট ফাংশন সম্পাদন করে। এর মানে হল যে যখন ইনগ্রেস রিসোর্সে নেই এমন একটি হোস্ট নির্দিষ্ট করে ইনগ্রেসের অনুরোধ করা হয়, তখন আমরা একটি 404 প্রতিক্রিয়া কোড সহ নিম্নলিখিত পৃষ্ঠাটি পাই:

যাইহোক, প্রায়শই আমাদের ক্লায়েন্টরা তাদের পৃষ্ঠাটি একটি কর্পোরেট লোগো এবং অন্যান্য সুযোগ-সুবিধা সহ স্ট্যান্ডার্ড 404 এর পরিবর্তে দেখানোর অনুরোধ নিয়ে আসে। এটি করার জন্য, NGINX ইনগ্রেস আছে অন্তর্নির্মিত ক্ষমতা পুনরায় সংজ্ঞায়িত করা default-backend-service. আমরা একই নামের বিকল্পে একটি যুক্তি হিসাবে বিন্যাস এন্ট্রি পাস করি namespace/servicename. পরিষেবার পোর্ট 80 হওয়া উচিত।

এটি করার জন্য, আপনাকে আপনার অ্যাপ্লিকেশনের সাথে আপনার নিজস্ব পড (বিয়োগ) এবং পরিষেবা তৈরি করতে হবে (YAML-এ উদাহরণ বাস্তবায়ন ingress-nginx সংগ্রহস্থল থেকে), যা ডিফল্ট ব্যাকএন্ডের পরিবর্তে দেওয়া হবে।

এখানে একটি ছোট দৃষ্টান্ত:

~$ curl -i -XGET http://sadsdasdas.kube-cloud.my/
HTTP/1.1 404 Not Found
Date: Mon, 11 Mar 2019 05:38:15 GMT
Content-Type: */*
Transfer-Encoding: chunked
Connection: keep-alive

<span>The page you're looking for could not be found.</span>

তাই সমস্ত ডোমেন যা স্পষ্টভাবে YAML এর মাধ্যমে তৈরি করা হয় না kind: Ingress, ডিফল্ট-ব্যাকএন্ডে পড়ে। উপরের তালিকায়, এই ডোমেইন হয়ে গেল sadsdasdas.

2. ডিফল্ট ব্যাকএন্ড ব্যবহার করে অ্যাপ্লিকেশনে HTTP ত্রুটিগুলি পরিচালনা করা

আরেকটি পরিস্থিতি হল HTTP ত্রুটির (404, 500, 502...) সমাপ্তির অনুরোধ এমন একটি অ্যাপ্লিকেশন যা এই ধরনের পরিস্থিতিতে প্রক্রিয়া করে না (সংশ্লিষ্ট সুন্দর পৃষ্ঠাগুলি তৈরি হয় না)। এটি একাধিক অ্যাপ্লিকেশনে একই ত্রুটি পৃষ্ঠাগুলি পরিবেশন করার জন্য ডেভেলপারদের ইচ্ছার কারণেও হতে পারে।

সার্ভার সাইডে এই কেসটি বাস্তবায়ন করতে আমাদের প্রয়োজন:

1. ডিফল্ট ব্যাকএন্ড সম্পর্কে অনুচ্ছেদ থেকে উপরের নির্দেশাবলী অনুসরণ করুন;
2. nginx-ingress কনফিগারেশন ConfigMap-এ একটি কী যোগ করুন custom-http-errors, উদাহরণস্বরূপ, মান সহ 404,503 (অবশ্যই নতুন নিয়ম দ্বারা আচ্ছাদিত ত্রুটি কোডগুলির সাথে মিলে যায়)।

প্রত্যাশিত ফলাফল অর্জন করা হয়েছে: যখন ক্লায়েন্ট অ্যাপ্লিকেশন চলছে এবং প্রতিক্রিয়া কোড 404 বা 503 সহ একটি ত্রুটি পায়, তখন অনুরোধটি স্বয়ংক্রিয়ভাবে নতুন ডিফল্ট ব্যাকএন্ডে পুনঃনির্দেশিত হবে...

যাইহোক, ডিফল্ট ব্যাকএন্ড এবং কাস্টম-http-ত্রুটির জন্য একটি অ্যাপ্লিকেশন বিকাশ করার সময়, আপনাকে একটি গুরুত্বপূর্ণ বৈশিষ্ট্য বিবেচনা করতে হবে:

!!! Important The custom backend is expected to return the correct HTTP status code instead of 200. NGINX does not change the response from the custom default backend.

আসল বিষয়টি হল যে যখন একটি অনুরোধ পুনর্নির্দেশ করা হয়, তখন শিরোনামগুলিতে পূর্ববর্তী প্রতিক্রিয়া কোড এবং অতিরিক্ত তথ্য সহ দরকারী তথ্য থাকবে (তাদের সম্পূর্ণ তালিকা উপলব্ধ এখানে).

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

বিভিন্ন অ্যাপ্লিকেশনের বিভিন্ন ডিফল্ট ব্যাকএন্ড থাকে

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

1. আমরা ওভাররাইড করতে পারেন default-backend থেকে প্রতিটি ইনগ্রেস এর টীকা ব্যবহার করে;
2. আমরা ওভাররাইড করতে পারেন custom-http-errors থেকে প্রতিটি ইনগ্রেস এর টীকা ব্যবহার করে.

ফলস্বরূপ, ইনগ্রেস রিসোর্সটি এইরকম কিছু দেখাবে:

apiVersion: extensions/v1beta1
kind: Ingress
metadata:
  name: {{ .Chart.Name }}-app2
  annotations:
    kubernetes.io/ingress.class: "nginx"
    nginx.ingress.kubernetes.io/custom-http-errors: "404,502"
    nginx.ingress.kubernetes.io/default-backend: error-pages
spec:
  tls:
  - hosts:
    - app2.example.com
    secretName: wildcard-tls
  rules:
  - host: app2.example.com
    http:
      paths:
      - path: /
        backend:
          serviceName: {{ .Chart.Name }}-app2
          servicePort: 80

এই ক্ষেত্রে, ত্রুটি 404 এবং 502 সমস্ত প্রয়োজনীয় শিরোনাম সহ ত্রুটি-পৃষ্ঠা পরিষেবাতে পুনঃনির্দেশিত হবে।

В Ingress এর পূর্ববর্তী সংস্করণগুলিতে এই বৈশিষ্ট্যটি ছিল না (0.23 এ ভাগ্যবান প্রতিশ্রুতি) এবং যদি আপনার ক্লাস্টারে 2টি সম্পূর্ণ ভিন্ন অ্যাপ্লিকেশন চলমান থাকে এবং আপনি তাদের প্রতিটির জন্য একটি ভিন্ন ডিফল্ট-ব্যাকএন্ড-পরিষেবা এবং বিভিন্ন ত্রুটি কোডের প্রক্রিয়াকরণ নির্দিষ্ট করতে চান, এর জন্য আপনাকে সমাধান ব্যবহার করতে হবে, যার মধ্যে আমাদের দুটি রয়েছে।

প্রবেশ <0.23: প্রথম দিকে

এই বিকল্পটি আরও সহজ। একটি অ্যাপ্লিকেশন হিসাবে এটির পৃষ্ঠাগুলি পরিবেশন করে, আমাদের নিয়মিত এইচটিএমএল রয়েছে, যা শিরোনামগুলি কীভাবে দেখতে হয় এবং সঠিক প্রতিক্রিয়া কোডগুলি ফেরত দেয় তা জানে না৷ এই ধরনের একটি অ্যাপ্লিকেশন url থেকে Ingress দিয়ে রোল আউট করা হয় /error-pages, এবং ক্যাটালগে ws ফিরে আসা HTML হবে।

YAML-এ দৃষ্টান্ত:

apiVersion: extensions/v1beta1
kind: Ingress
metadata:
  name: {{ .Chart.Name }}-app2
  annotations:
    kubernetes.io/ingress.class: "nginx"
    ingress.kubernetes.io/server-snippet: |
      proxy_intercept_errors on;
      error_page 500 501 502 503 504 @error_pages;
      location @error_pages {
        rewrite ^ /error-pages/other/index.html break;
        proxy_pass http://error-pages.prod.svc.cluster.local;
      }
spec:
  tls:
  - hosts:
    - app2.example.com
    secretName: wildcard-tls
  rules:
  - host: app2.example.com
    http:
      paths:
      - path: /
        backend:
          serviceName: {{ .Chart.Name }}-app2
          servicePort: 80

এই স্থাপনার জন্য পরিষেবাটি অবশ্যই ClusterIP প্রকারের হতে হবে।

একই সময়ে, অ্যাপ্লিকেশনটিতে যেখানে আমরা ত্রুটিটি প্রক্রিয়া করব, প্রবেশে আমরা নিম্নলিখিত সামগ্রী সহ একটি সার্ভার-স্নিপেট বা কনফিগারেশন-স্নিপেট যোগ করি:

nginx.ingress.kubernetes.io    /server-snippet: |
      proxy_intercept_errors on;
      error_page 500 501 502 503 504 @error_pages;
      location @error_pages {
        rewrite ^ /error-pages/ws/index.html break;
        proxy_pass http://error-pages.prod.svc.cluster.local;
      }

প্রবেশ <0.23: দ্বিতীয় পদ্ধতি

একটি অ্যাপ্লিকেশনের জন্য একটি বিকল্প যা শিরোনামগুলি প্রক্রিয়া করতে পারে... এবং সাধারণভাবে এটি একটি আরও সঠিক উপায়, কাস্টম-http-ত্রুটি থেকে ধার করা। এটি ম্যানুয়ালি ব্যবহার করা (কপি করা) আপনাকে গ্লোবাল সেটিংস পরিবর্তন না করার অনুমতি দেবে।

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

nginx.ingress.kubernetes.io    /server-snippet: |
      proxy_intercept_errors off;
      error_page 404 = @custom_404;
      error_page 503 = @custom_503;
      location @custom_404 {
        internal;
        proxy_intercept_errors off;
        proxy_set_header       X-Code             404;
        proxy_set_header       X-Format           $http_accept;
        proxy_set_header       X-Original-URI     $request_uri;
        proxy_set_header       X-Namespace        $namespace;
        proxy_set_header       X-Ingress-Name     $ingress_name;
        proxy_set_header       X-Service-Name     $service_name;
        proxy_set_header       X-Service-Port     $service_port;
        proxy_set_header       Host               $best_http_host;
        rewrite ^ /error-pages/ws/index.html break;
        proxy_pass http://error-pages.prod.svc.cluster.local;
      }
      location @custom_503 {
        internal;
        proxy_intercept_errors off;
        proxy_set_header       X-Code             503;
        proxy_set_header       X-Format           $http_accept;
        proxy_set_header       X-Original-URI     $request_uri;
        proxy_set_header       X-Namespace        $namespace;
        proxy_set_header       X-Ingress-Name     $ingress_name;
        proxy_set_header       X-Service-Name     $service_name;
        proxy_set_header       X-Service-Port     $service_port;
        proxy_set_header       Host               $best_http_host;
        rewrite ^ /error-pages/ws/index.html break;
        proxy_pass http://error-pages.prod.svc.cluster.local;
      }

আপনি দেখতে পাচ্ছেন, প্রতিটি ত্রুটির জন্য যা আমরা প্রক্রিয়া করতে চাই, আমাদের নিজস্ব অবস্থান তৈরি করতে হবে, যেখানে সমস্ত প্রয়োজনীয় শিরোনাম সন্নিবেশ করা হবে, যেমন "নেটিভ" একটিতে। কাস্টম-ত্রুটি-পৃষ্ঠা. এইভাবে আমরা এমনকি পৃথক অবস্থান এবং সার্ভারের জন্য বিভিন্ন ব্যক্তিগতকৃত ত্রুটি পৃষ্ঠা তৈরি করতে পারি।

দ্রষ্টব্য

K8s টিপস এবং ট্রিক্স সিরিজের অন্যান্য:

• «হেলম 2 ব্যবস্থাপনায় একটি ক্লাস্টারে চলমান সংস্থান স্থানান্তর";
• «একটি ওয়েব অ্যাপ্লিকেশনে নোড বরাদ্দ এবং লোড সম্পর্কে";
• «ডেভ সাইটগুলিতে অ্যাক্সেস";
• «বড় ডাটাবেসের জন্য বুটস্ট্র্যাপ দ্রুত করা».

আমাদের ব্লগেও পড়ুন:

• «Istio এর সাথে মাইক্রোসার্ভিসে ফিরে যান। অংশ 1";
• «[সচিত্র] কুবারনেটসে নেটওয়ার্কিংয়ের জন্য গাইড। পার্ট 3».

উত্স: www.habr.com