শেল-অপারেটর প্রবর্তন করা হচ্ছে: Kubernetes-এর জন্য অপারেটর তৈরি করা আরও সহজ হয়েছে

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

কেন?

একটি শেল-অপারেটরের ধারণাটি বেশ সহজ: Kubernetes অবজেক্ট থেকে ইভেন্টগুলিতে সদস্যতা নিন এবং এই ইভেন্টগুলি প্রাপ্ত হলে, একটি বহিরাগত প্রোগ্রাম চালু করুন, এটি ইভেন্ট সম্পর্কে তথ্য প্রদান করে:

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

15 মিনিটের মধ্যে অপারেটর

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

যে পডগুলি একটি ব্যক্তিগত রেজিস্ট্রি থেকে ছবি ব্যবহার করে তাদের ম্যানিফেস্টে অবশ্যই রেজিস্ট্রি অ্যাক্সেস করার জন্য ডেটা সহ একটি গোপন লিঙ্ক থাকতে হবে। পড তৈরি করার আগে প্রতিটি নামস্থানে এই গোপনীয়তা তৈরি করতে হবে। এটি ম্যানুয়ালি করা যেতে পারে, তবে আমরা যদি গতিশীল পরিবেশ সেট আপ করি তবে একটি অ্যাপ্লিকেশনের জন্য নামস্থান অনেক হয়ে যাবে। এবং যদি 2-3টি অ্যাপ্লিকেশন না থাকে... গোপন সংখ্যা অনেক বড় হয়ে যায়। এবং গোপনীয়তা সম্পর্কে আরও একটি জিনিস: আমি সময়ে সময়ে রেজিস্ট্রি অ্যাক্সেস করার জন্য কী পরিবর্তন করতে চাই। অবশেষে, ম্যানুয়াল অপারেশন একটি সমাধান হিসাবে সম্পূর্ণ অকার্যকর - আমাদের গোপনীয়তা তৈরি এবং আপডেট করা স্বয়ংক্রিয় করতে হবে।

সহজ অটোমেশন

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

শেল-অপারেটরের সাথে অটোমেশন

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

প্রথমত, স্ক্রিপ্ট তাকান. শেল-অপারেটর পদে স্ক্রিপ্টগুলিকে হুক বলা হয়। একটি পতাকা সঙ্গে চালানো যখন প্রতিটি হুক --config শেল-অপারেটরকে এর বাইন্ডিং সম্পর্কে অবহিত করে, যেমন এটা চালু করা উচিত কি ইভেন্ট. আমাদের ক্ষেত্রে আমরা ব্যবহার করব onKubernetesEvent:

#!/bin/bash
if [[ $1 == "--config" ]] ; then
cat <<EOF
{
"onKubernetesEvent": [
  { "kind": "namespace",
    "event":["add"]
  }
]}
EOF
fi

এখানে বর্ণনা করা হয়েছে যে আমরা ইভেন্ট যোগ করতে আগ্রহী (add) ধরনের বস্তু namespace.

এখন আপনাকে কোডটি যোগ করতে হবে যা ইভেন্টটি ঘটলে কার্যকর করা হবে:

#!/bin/bash
if [[ $1 == "--config" ]] ; then
  # конфигурация
cat <<EOF
{
"onKubernetesEvent": [
{ "kind": "namespace",
  "event":["add"]
}
]}
EOF
else
  # реакция:
  # узнать, какой namespace появился
  createdNamespace=$(jq -r '.[0].resourceName' $BINDING_CONTEXT_PATH)
  # создать в нём нужный секрет
  kubectl create -n ${createdNamespace} -f - <<EOF
apiVersion: v1
kind: Secret
metadata:
  ...
data:
  ...
EOF
fi

দারুণ! ফলাফল একটি ছোট, সুন্দর স্ক্রিপ্ট ছিল. এটিকে "পুনরুজ্জীবিত" করতে, দুটি ধাপ বাকি আছে: চিত্রটি প্রস্তুত করুন এবং ক্লাস্টারে এটি চালু করুন৷

একটি হুক সঙ্গে একটি ইমেজ প্রস্তুতি

আপনি যদি স্ক্রিপ্টটি দেখেন, আপনি দেখতে পাবেন যে কমান্ডগুলি ব্যবহার করা হয়েছে kubectl и jq. এর মানে হল যে চিত্রটিতে নিম্নলিখিত জিনিসগুলি থাকতে হবে: আমাদের হুক, একটি শেল-অপারেটর যা ঘটনাগুলি শুনবে এবং হুক চালাবে এবং হুক দ্বারা ব্যবহৃত কমান্ডগুলি (kubectl এবং jq)৷ Hub.docker.com-এর ইতিমধ্যেই একটি রেডিমেড ইমেজ রয়েছে যেখানে শেল-অপারেটর, kubectl এবং jq প্যাকেজ করা আছে। যা অবশিষ্ট থাকে তা হল একটি সাধারণ হুক যোগ করা Dockerfile:

$ cat Dockerfile
FROM flant/shell-operator:v1.0.0-beta.1-alpine3.9
ADD namespace-hook.sh /hooks

$ docker build -t registry.example.com/my-operator:v1 . 
$ docker push registry.example.com/my-operator:v1

একটি গুচ্ছ মধ্যে চলমান

আসুন আবার হুকটি দেখি এবং এইবার ক্লাস্টারে কী কী ক্রিয়া এবং কোন বস্তুর সাথে এটি সম্পাদন করে তা লিখুন:

1. নেমস্পেস তৈরির ইভেন্টগুলিতে সদস্যতা নেয়;
2. যেখানে এটি চালু করা হয়েছে তা ছাড়া অন্য নামস্থানে একটি গোপনীয়তা তৈরি করে।

দেখা যাচ্ছে যে যে পডটিতে আমাদের ছবিটি চালু করা হবে তার অবশ্যই এই ক্রিয়াগুলি করার অনুমতি থাকতে হবে। এটি আপনার নিজস্ব ServiceAccount তৈরি করে করা যেতে পারে। অনুমতি ClusterRole এবং ClusterRoleBinding আকারে করা আবশ্যক, কারণ আমরা সমগ্র ক্লাস্টার থেকে বস্তু আগ্রহী.

YAML-এ চূড়ান্ত বিবরণটি এরকম কিছু দেখাবে:

---
apiVersion: v1
kind: ServiceAccount
metadata:
  name: monitor-namespaces-acc

---
apiVersion: rbac.authorization.k8s.io/v1beta1
kind: ClusterRole
metadata:
  name: monitor-namespaces
rules:
- apiGroups: [""]
  resources: ["namespaces"]
  verbs: ["get", "watch", "list"]
- apiGroups: [""]
  resources: ["secrets"]
  verbs: ["get", "list", "create", "patch"]

---
apiVersion: rbac.authorization.k8s.io/v1beta1
kind: ClusterRoleBinding
metadata:
  name: monitor-namespaces
roleRef:
  apiGroup: rbac.authorization.k8s.io
  kind: ClusterRole
  name: monitor-namespaces
subjects:
  - kind: ServiceAccount
    name: monitor-namespaces-acc
    namespace: example-monitor-namespaces

আপনি একত্রিত চিত্রটিকে একটি সাধারণ স্থাপনা হিসাবে চালু করতে পারেন:

apiVersion: extensions/v1beta1
kind: Deployment
metadata:
  name: my-operator
spec:
  template:
    spec:
      containers:
      - name: my-operator
        image: registry.example.com/my-operator:v1
      serviceAccountName: monitor-namespaces-acc

সুবিধার জন্য, একটি পৃথক নামস্থান তৈরি করা হয়েছে যেখানে শেল-অপারেটর চালু হবে এবং তৈরি ম্যানিফেস্টগুলি প্রয়োগ করা হবে:

$ kubectl create ns example-monitor-namespaces
$ kubectl -n example-monitor-namespaces apply -f rbac.yaml
$ kubectl -n example-monitor-namespaces apply -f deployment.yaml

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

সুতরাং, একটি সাধারণ শেল স্ক্রিপ্ট কুবারনেটসের জন্য একটি বাস্তব অপারেটরে পরিণত হয়েছে এবং একটি ক্লাস্টারের অংশ হিসাবে কাজ করে। এবং এই সব গোলং-এ অপারেটর বিকাশের জটিল প্রক্রিয়া ছাড়াই:

এই বিষয়ে আরেকটি দৃষ্টান্ত আছে ...

আমরা নিম্নলিখিত প্রকাশনাগুলির একটিতে আরও বিশদে এর অর্থ প্রকাশ করব।

ফিল্টারিং

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

যখন একটি ইভেন্ট আসে, শেল-অপারেটর বস্তুটির JSON ম্যানিফেস্ট পায়। আমরা এই JSON-এ আমাদের আগ্রহের বৈশিষ্ট্যগুলি নির্বাচন করতে পারি এবং হুক চালাতে পারি শুধুমাত্র যখন তারা পরিবর্তন করে। এর জন্য একটি ক্ষেত্র রয়েছে jqFilter, যেখানে আপনাকে jq এক্সপ্রেশনটি নির্দিষ্ট করতে হবে যা JSON ম্যানিফেস্টে প্রয়োগ করা হবে।

উদাহরণস্বরূপ, ডিপ্লয়মেন্ট অবজেক্টের জন্য লেবেলের পরিবর্তনের প্রতিক্রিয়া জানাতে, আপনাকে ক্ষেত্রটি ফিল্টার করতে হবে labels মাঠের বাইরে metadata. কনফিগারেশন এই মত হবে:

cat <<EOF
{
"onKubernetesEvent": [
{ "kind": "deployment",
  "event":["update"],
  "jqFilter": ".metadata.labels"
}
]}
EOF

এই jqFilter এক্সপ্রেশনটি ডিপ্লয়মেন্টের দীর্ঘ JSON ম্যানিফেস্টকে লেবেল সহ ছোট JSON-এ পরিণত করে:

শেল-অপারেটর শুধুমাত্র হুক চালাবে যখন এই সংক্ষিপ্ত JSON পরিবর্তিত হয়, এবং অন্যান্য বৈশিষ্ট্যের পরিবর্তন উপেক্ষা করা হবে।

হুক লঞ্চ প্রসঙ্গ

হুক কনফিগারেশন আপনাকে ইভেন্টগুলির জন্য বিভিন্ন বিকল্প নির্দিষ্ট করতে দেয় - উদাহরণস্বরূপ, কুবারনেটস থেকে ইভেন্টের জন্য 2টি বিকল্প এবং 2টি সময়সূচী:

{"onKubernetesEvent":[
  {"name":"OnCreatePod",
  "kind": "pod",
  "event":["add"]
  },
  {"name":"OnModifiedNamespace",
  "kind": "namespace",
  "event":["update"],
  "jqFilter": ".metadata.labels"
  }
],
"schedule": [
{ "name":"every 10 min",
  "crontab":"* */10 * * * *"
}, {"name":"on Mondays at 12:10",
"crontab": "* 10 12 * * 1"
]}

একটি ছোট ডিগ্রেশন: হ্যাঁ, শেল-অপারেটর সমর্থন করে চলমান crontab শৈলী স্ক্রিপ্ট. আরো বিস্তারিত পাওয়া যাবে ডকুমেন্টেশন.

কেন হুক চালু করা হয়েছিল তা আলাদা করার জন্য, শেল-অপারেটর একটি অস্থায়ী ফাইল তৈরি করে এবং হুকের পরিবর্তনশীলভাবে এটির পাথ পাস করে। BINDING_CONTEXT_TYPE. ফাইলটিতে হুক চালানোর কারণের একটি JSON বিবরণ রয়েছে। উদাহরণস্বরূপ, প্রতি 10 মিনিটে হুক নিম্নলিখিত বিষয়বস্তু সহ চলবে:

[{ "binding": "every 10 min"}]

... এবং সোমবার এটি এর সাথে শুরু হবে:

[{ "binding": "every 10 min"}, { "binding": "on Mondays at 12:10"}]

থেকে onKubernetesEvent আরো JSON ট্রিগার হবে, কারণ এটি বস্তুর একটি বিবরণ রয়েছে:

[
 {
 "binding": "onCreatePod",
 "resourceEvent": "add",
 "resourceKind": "pod",
 "resourceName": "foo",
 "resourceNamespace": "bar"
 }
]

ক্ষেত্রগুলির বিষয়বস্তু তাদের নাম থেকে বোঝা যায় এবং আরও বিশদ বিবরণ পড়তে পারে ডকুমেন্টেশন. একটি ক্ষেত্র থেকে সম্পদের নাম পাওয়ার একটি উদাহরণ resourceName jq ব্যবহার করা ইতিমধ্যে একটি হুকে দেখানো হয়েছে যা গোপনীয়তার প্রতিলিপি করে:

jq -r '.[0].resourceName' $BINDING_CONTEXT_PATH

আপনি একই ভাবে অন্যান্য ক্ষেত্র পেতে পারেন.

এরপরে কী?

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

প্রমিথিউস ব্যবহার করে মেট্রিক্স সংগ্রহের জন্য সমর্থন রয়েছে - উপলব্ধ মেট্রিক্স বিভাগে বর্ণনা করা হয়েছে মেট্রিকস.

আপনি অনুমান করতে পারেন, শেল-অপারেটরটি Go-তে লেখা এবং একটি ওপেন সোর্স লাইসেন্স (Apache 2.0) এর অধীনে বিতরণ করা হয়েছে। যেকোনো উন্নয়ন সহায়তার জন্য আমরা কৃতজ্ঞ থাকব GitHub এ প্রকল্প: এবং তারা, এবং সমস্যা, এবং অনুরোধ টান.

গোপনীয়তার ঘোমটা তুলে, আমরা আপনাকে জানাব যে শেল-অপারেটর ছোট আমাদের সিস্টেমের অংশ যা কুবারনেটস ক্লাস্টারে ইনস্টল করা অ্যাড-অনগুলিকে আপ টু ডেট রাখতে পারে এবং বিভিন্ন স্বয়ংক্রিয় ক্রিয়া সম্পাদন করতে পারে। এই সিস্টেম সম্পর্কে আরও পড়ুন বলেছে আক্ষরিক অর্থে সোমবার সেন্ট পিটার্সবার্গে HighLoad++ 2019-এ - আমরা শীঘ্রই এই প্রতিবেদনের ভিডিও এবং প্রতিলিপি প্রকাশ করব।

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

সাথে থাকুন!

দ্রষ্টব্য

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

• «কুবারনেটসের জন্য অপারেটর: রাষ্ট্রীয় অ্যাপ্লিকেশনগুলি কীভাবে চালাতে হয়";
• «আমরা গোলং-এ Kubernetes-এর জন্য একটি অপারেটর লিখি";
• «Grafana - স্ট্যাটাসম্যাপ প্যানেলের জন্য একটি নতুন প্লাগইন প্রবর্তন করা হচ্ছে";
• «লগহাউস প্রবর্তন করা হচ্ছে - কুবারনেটে লগের সাথে কাজ করার জন্য একটি ওপেন সোর্স সিস্টেম";
• «আমরা আনুষ্ঠানিকভাবে Dapp উপস্থাপন করি - CI/CD রক্ষণাবেক্ষণের জন্য একটি DevOps ইউটিলিটি».

উত্স: www.habr.com